<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0"
    xmlns:atom="http://www.w3.org/2005/Atom"
    xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Work on jbetzen.net</title>
    <link>https://jbetzen.net/topics/work/</link>
    <description>Recent content in Work on jbetzen.net</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>de</language>
    
    <lastBuildDate>Fri, 14 Nov 2025 12:48:16 +0200</lastBuildDate><atom:link href="https://jbetzen.net/topics/work/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>iLogic: Ende der Artikelserie</title>
      <link>https://jbetzen.net/posts/ilogic-serienende/</link>
      <pubDate>Fri, 14 Nov 2025 12:48:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-serienende/</guid>
      <description>Die Serie zum Thema iLogic und Inventor wird mit diesem Beitrag ihr vorläufiges Ende finden. Ich habe diesen Monat meinen Job verloren und nur noch eingeschränkten Zugriff auf Autodesk Produkte und deren Lizenzen.</description>
      <content:encoded><![CDATA[ <p>Dieser Post gehört wohl in die Kategorie <em><strong>In eigener Sache</strong></em> und kann vorerst notgedrungen nur das Ende der <a href="/series/inventor-ilogic/" >Artikelserie iLogic mit Autodesk Inventor</a> auf diesem Blog bedeuten.</p>
<p><strong>Ich habe diesen Monat unerwartet meinen Job als Konstrukteur und CAD Power User verloren und werde mich beruflich neu umschauen müssen.</strong></p>
<p>Derzeit habe ich nur noch eingeschränkten Zugriff auf Autodesk Vault und Inventor, was ich selber schwer bedauere, da ich eine komplette Serie zum Umgang der <a href="https://aps.autodesk.com/developer/overview/vault"  target="_blank" rel="noreferrer">Vault API</a> mittels PowerShell und der neuen spannenden <a href="https://aps.autodesk.com/developer/overview/vault-data-api"  target="_blank" rel="noreferrer">Vault Data API</a> in der Mache hatte. Dies kann und wird nun nicht mehr stattfinden können.</p>
<p>Ob ich einen neuen Arbeitgeber finde, der Autodesk Produkte produktiv einsetzt, ist für mich derzeit nicht absehbar. Primär gilt es für mich beruflich nach Vorne zu schauen. Zeitgleich lohnt aber auch ein Rückblick auf die existierenden <a href="/series/inventor-ilogic/" ><strong>25 Beiträge</strong></a> der iLogic Artikelserie, die über die letzten 3 Jahre entstanden sind, denn sie vermitteln gutes Basiswissen für Anfänger und auch Anwendungsfälle, die weit über iLogic Funktionalitäten hinausgehen.</p>

<h2 class="relative group">Wie kam es zu der Serie?
    <div id="wie-kam-es-zu-der-serie" class="anchor"></div>
    
</h2>
<p>Ich habe damals in meiner Firma nicht aktiv darum gebeten die iLogics zu schreiben und zu betreuen, sondern bin notgedrungen in diese Rolle geraten. Ursprünglich wurde der Code durch den Administrator der Vault Datenbank geschrieben und auch per Vault Data Standard beim Startvorgang von Vault an die User ausgerollt.</p>
<p>Es stellte sich bedauerlicherweise zunehmend heraus, dass der Administrator weder die Fähigkeiten, noch den erforderlichen Willen, besaß, sich in das Thema iLogic hineinzudenken, geschweige denn die persönliche Größe, diesen Zustand offen zuzugeben und Verantwortung für seinen Code zu übernehmen.</p>
<p><strong>Das Resultat waren:</strong></p>
<ul>
<li>unzählige tagesaktuelle Fehlermeldungen, die bei mir als CAD Power User aufliefen, und kontinuierlichen User Support hervorriefen</li>
<li>iLogics, die sich selber widersprachen und gegeneinander arbeiteten, da konzeptfrei, strukturlos und tagesaktuell ohne Versionshistorie gearbeitet wurde</li>
<li>iLogics, die unzählige unnötige Revisionen erforderten, da sie automatisiert fehlerhafte Produktdaten erzeugten, die anschließend in die Freigabe gingen</li>
<li>iLogics, die kontinuierlich <em>on the fly</em> modifiziert wurden, ohne die Nutzer oder mich in Kenntnis zu setzen</li>
</ul>
<p>Über zwei Jahre hinweg blieb jede Verbesserung der Situation aus. Ich nahm mich der Thematik an, weil es sonst keiner getan hätte und weil es mir zunehmend zutiefst zuwider war, tagesaktuellen Support für Fehlmeldungen zu leisten, die ich selber nicht produziert hatte.</p>
<p>Im Ingenieursstudium hatte ich zwei Semester VBA-Programmierung mit Excel. Einen realen Anwendungsfall habe ich dafür im Berufsleben nie gefunden. Daher war die Auseinandersetzung mit dem Thema iLogic eine willkommene Abwechslung zum Alltag als Konstrukteur, da die Thematik Realbezug aufwies und iLogic <a href="/posts/ilogic-010-ilogic-vba-vbnet/" >Schnittmengen mit VBA</a> besitzt.</p>

<h2 class="relative group">Farewell
    <div id="farewell" class="anchor"></div>
    
</h2>
<p>Rückwirkend betrachtet bedeutet mir die Serie viel, da sie für mich selber eine kleine chronologische Dokumentation meines beruflichen Schaffens darstellt und zeitgleich Zeuge meiner persönlichen Lernkurve ist. Nahezu alle Beiträge waren inspiriert durch tagesaktuelle Probleme oder Hürden, die es zu meistern galt. Ich habe diverse Mails anderer Konstrukteure erhalten, die sich ebenfalls an iLogic versucht haben und fand den Gedanken immer schön, dass meine Serie auch anklang in der Welt gefunden hat.</p>
<p>An dieser Stelle möchte ich auch jeden Konstrukteur ermutigen, sich offen dem Thema iLogic zu stellen, denn es ist ein mächtiges Werkzeug, das Zeitersparnis produzieren kann und zeitgleich lernt man die Funktionsweise von Inventor aus Sicht der Programmierschnittstelle kennen. Die Schnittstelle zwischen Engineering und Programmierung ist ein spannendes Themenfeld, das in vielen Unternehmen bis heute noch nicht ausreichend wertgeschätzt, und in Zukunft zunehmend an Bedeutung gewinnen wird.</p>
<p>Sollte ich in Zukunft erneut beruflich mit Inventor arbeiten, werde ich die Serie ggf. fortsetzen. Bis dahin bleibt jedoch nur eins zu sagen: <em>&ldquo;Adieu iLogic!&rdquo;</em></p>


  

<figure class="centered"><img src="/posts/ilogic-serienende/picard-bye.gif"
    alt="Captain Picard winkt zum Abschied.">
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Datums- und Zeitangaben</title>
      <link>https://jbetzen.net/posts/ilogic-date-time/</link>
      <pubDate>Fri, 14 Nov 2025 10:48:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-date-time/</guid>
      <description>iLogic bietet die Möglichkeit mit Datums- und Zeitangaben zu arbeiten. Dies kann sinnvoll sein, wenn bspw. berechnet werden soll, vor wie vielen Tagen eine Datei erzeugt wurde oder um zu ermitteln, wann eine iLogic das letzte mal gelaufen ist.</description>
      <content:encoded><![CDATA[ <p>iLogic bietet im <a href="/posts/ilogic-editor/" >iLogic Editor</a> einige vordefinierte Snippets für die Arbeit mit Datums- und Zeitangaben:</p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/date-time-snippets.png"
    alt="iLogic Snippets für Datums- und Zeitangaben">
</figure>


<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Methode</th>
					<th style="text-align: center">Datentyp</th>
					<th>Beschreibung von Autodesk</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>Now()</code></td>
					<td style="text-align: center">String</td>
					<td>Returns a string containing Current Date and Time.</td>
			</tr>
			<tr>
					<td><code>DateString</code></td>
					<td style="text-align: center">String</td>
					<td>Returns the current Date.</td>
			</tr>
			<tr>
					<td><code>TimeString</code></td>
					<td style="text-align: center">String</td>
					<td>Returns the current Time.</td>
			</tr>
	</tbody>
</table>
</div>
<p>Die Ausgabeformate sind in Teilen jedoch abhängig von global gesetzten <em>Region Settings</em> im Betriebssystem und unterliegen auch <a href="https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo?view=net-8.0"  target="_blank" rel="noreferrer">kulturellen Gepflogenheiten</a>. So kennt jeder die amerikanischen Unsitten ein Datum im Format <a href="https://de.wikipedia.org/wiki/Terroranschl%C3%A4ge_am_11._September_2001"  target="_blank" rel="noreferrer">MM-DD-YYYY</a> anzugeben und auch sonst alles zu geben, um nicht mit dem metrischen System in Kontakt zu kommen:</p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/murica.jpg"
    alt="Bill Gates zum Launch von Windows XP vor einem Schild mit amerikanischen Datumsangabe">
</figure>



<h2 class="relative group">iLogic Snippets
    <div id="ilogic-snippets" class="anchor"></div>
    
</h2>
<p>Die eingebauten Snippets können einfach über den <a href="/posts/ilogic-logger/" >iLogic Logger</a> getestet werden und liefern ohne zusätzliche Parameter folgende Ausgaben:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sNow</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">Now</span><span class="p">()</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDate</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">DateString</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sTime</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">TimeString</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;&#39;Now()&#39; liefert: {0}&#34;</span><span class="p">,</span> <span class="n">sNow</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;&#39;DateString&#39; liefert: {0}&#34;</span><span class="p">,</span> <span class="n">sDate</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;&#39;TimeString&#39; liefert: {0}&#34;</span><span class="p">,</span> <span class="n">sTime</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/snippets-output.png">
</figure>



<h2 class="relative group">Ausgabe Formatieren
    <div id="ausgabe-formatieren" class="anchor"></div>
    
</h2>
<p>Zur Formatierung der Zeitangaben stehen <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime?view=net-9.0#methods"  target="_blank" rel="noreferrer">sämtliche Methoden</a> des <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime.now?view=net-9.0"  target="_blank" rel="noreferrer">DateTime Namespace</a> zur Verfügung. Am geläufigsten unter iLogic Code-Beispielen im Inventor Forum ist die Methode <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime.tostring?view=net-9.0"  target="_blank" rel="noreferrer">DateTime.ToString</a>. Mit ihr können die Ausgaben leicht mittels <a href="https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings#table-of-format-specifiers"  target="_blank" rel="noreferrer">Date &amp; Time Format Specifiers</a> den eigenen Ansprüchen angepasst werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="n">Now</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;dd.MM.yyyy&#34;</span><span class="p">)</span>        <span class="c">&#39; 23.05.2025
</span></span></span><span class="line"><span class="cl"><span class="n">Now</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;MMMM d, yyyy&#34;</span><span class="p">)</span>      <span class="c">&#39; May 23, 2025
</span></span></span><span class="line"><span class="cl"><span class="n">Now</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;dddd, MMMM dd&#34;</span><span class="p">)</span>     <span class="c">&#39; Friday, May 23
</span></span></span><span class="line"><span class="cl"><span class="n">Now</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;yyyy-MM-dd HH:mm&#34;</span><span class="p">)</span>  <span class="err">&#39;</span> <span class="n">2025</span><span class="o">-</span><span class="n">05</span><span class="o">-</span><span class="n">23</span> <span class="n">14</span><span class="p">:</span><span class="n">30</span></span></span></code></pre></div></div>
<p>Auch stehen die Methoden <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime.tolongdatestring?view=net-9.0"  target="_blank" rel="noreferrer">ToLongDateString</a>, <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime.toshortdatestring?view=net-9.0"  target="_blank" rel="noreferrer">ToShortDateString</a>, <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime.toshorttimestring?view=net-9.0"  target="_blank" rel="noreferrer">ToShortTimeString</a> und <a href="https://learn.microsoft.com/en-us/dotnet/api/system.datetime.tolongtimestring?view=net-9.0"  target="_blank" rel="noreferrer">ToLongTimeString</a> zur Verfügung:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">Now</span><span class="p">.</span><span class="n">ToShortTimeString</span><span class="p">)</span>  <span class="c">&#39; 16:02
</span></span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">Now</span><span class="p">.</span><span class="n">ToLongTimeString</span><span class="p">)</span>   <span class="c">&#39; 16:02:39
</span></span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">Now</span><span class="p">.</span><span class="n">ToShortDateString</span><span class="p">)</span>  <span class="c">&#39; 23.05.2025
</span></span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">Now</span><span class="p">.</span><span class="n">ToLongDateString</span><span class="p">)</span>   <span class="err">&#39;</span> <span class="n">14</span><span class="p">.</span> <span class="n">Mai</span> <span class="n">2025</span></span></span></code></pre></div></div>
<p>Das Problem beider Beispiele wird schnell ersichtlich, denn sie wurden auf zwei unterschiedlich konfigurierten Computern ausgeführt und berücksichtigen die <strong>Region Settings</strong> des Betriebssystems:</p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/region-settings.png"
    alt="Windows Region Settings">
</figure>


<p>Monatsangaben erscheinen bspw. einmal auf Englisch (<code>May</code>) und im zweiten Beispiel auf Deutsch (<code>Mai</code>). Dies kann zu Problemen in internationalen Unternehmen führen, da die gewohnten Ausgabeformate für Zeit- und Datumsangaben kulturell variieren und der gemeine Nutzer sein Betriebssystem in der eigenen Landessprache betreibt.</p>
<p>Möchte man ungeachtet der Region Settings immer ein einheitliches Ausgabeformat erzwingen, muss zusätzlich die <a href="https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo?view=net-9.0"  target="_blank" rel="noreferrer">CultureInfo Class</a> aus dem <a href="https://learn.microsoft.com/en-us/dotnet/api/system.globalization?view=net-9.0"  target="_blank" rel="noreferrer">System.Globalization Namespace</a> hinzugezogen werden.</p>
<p>Das folgende Beispiel formatiert die Ausgaben gemäß amerikanischer Notation (<code>en-US</code>):</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Imports</span> <span class="nn">System.Globalization</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Beispieldatum: 28.05.2024
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">dDate</span> <span class="ow">As</span> <span class="kt">Date</span> <span class="o">=</span> <span class="k">New</span> <span class="kt">Date</span><span class="p">(</span><span class="n">2024</span><span class="p">,</span> <span class="n">05</span><span class="p">,</span> <span class="n">28</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">culture</span> <span class="ow">As</span> <span class="n">CultureInfo</span> <span class="o">=</span> <span class="n">CultureInfo</span><span class="p">.</span><span class="n">GetCultureInfo</span><span class="p">(</span><span class="s">&#34;en-US&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDateWithoutCulture</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">dDate</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;MMMM d, yyyy&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDateCulture</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">dDate</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;MMMM d, yyyy&#34;</span><span class="p">,</span> <span class="n">culture</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Ohne Culture Info: {0}&#34;</span><span class="p">,</span> <span class="n">sDateWithoutCulture</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Mit Culture Info: {0}&#34;</span><span class="p">,</span> <span class="n">sDateCulture</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/cultureinfo-output.png"
    alt="Ausgabe mit und ohne CultureInfo">
</figure>



<h2 class="relative group">Zeitdifferenzen berechnen
    <div id="zeitdifferenzen-berechnen" class="anchor"></div>
    
</h2>
<p>Zeitdifferenzen können ebenfalls einfach berechnet werden. Das folgende Beispiel ermittelt die vergangenen Tage zwischen dem Datum <code>05.10.2025</code> und <code>14.11.2025</code>:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">dStartDate</span> <span class="ow">As</span> <span class="kt">Date</span> <span class="o">=</span> <span class="k">New</span> <span class="kt">Date</span><span class="p">(</span><span class="n">2025</span><span class="p">,</span> <span class="n">10</span><span class="p">,</span> <span class="n">05</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">dEndDate</span> <span class="ow">As</span> <span class="kt">Date</span> <span class="o">=</span> <span class="k">New</span> <span class="kt">Date</span><span class="p">(</span><span class="n">2025</span><span class="p">,</span> <span class="n">11</span><span class="p">,</span> <span class="n">14</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">iDaysDifference</span> <span class="ow">As</span> <span class="kt">Integer</span> <span class="o">=</span> <span class="p">(</span><span class="n">dEndDate</span> <span class="o">-</span> <span class="n">dStartDate</span><span class="p">).</span><span class="n">Days</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Differenz: {0} Tage&#34;</span><span class="p">,</span> <span class="n">iDaysDifference</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/datediff-output.png"
    alt="Augabe der Differenzberechnung zweiter Daten">
</figure>



<h2 class="relative group">Zeiten Stoppen
    <div id="zeiten-stoppen" class="anchor"></div>
    
</h2>
<p>Man kann zusätzlich mit der <a href="https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.stopwatch?view=net-9.0"  target="_blank" rel="noreferrer">StopWatch Class</a> die Zeit messen, die für die Ausführung einer iLogic benötigt wird. Das kann sinnvoll sein, wenn man unterschiedliche Lösungsansätze für ein Problem gegeneinander auf Performance testen möchte.</p>
<p>Das folgende Beispiel ermittelt, wie lang eine Schleife mit dem Startwert <code>1</code>, dem Endwert <code>5</code>, einem Inkrement von <code>1</code> und einem künstlichem Delay von <code>500 ms</code> mittels <a href="https://learn.microsoft.com/en-us/dotnet/api/system.threading.thread.sleep?view=net-9.0"  target="_blank" rel="noreferrer">Thread.Sleep Method</a> zur Ausführung benötigt.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sw</span> <span class="ow">As</span> <span class="k">New</span> <span class="n">Stopwatch</span><span class="p">()</span>
</span></span><span class="line"><span class="cl"><span class="n">sw</span><span class="p">.</span><span class="n">Start</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="n">i</span> <span class="ow">As</span> <span class="kt">Integer</span> <span class="o">=</span> <span class="n">1</span> <span class="k">To</span> <span class="n">5</span> <span class="k">Step</span> <span class="n">1</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Schleife {0}&#34;</span><span class="p">,</span> <span class="n">i</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">Threading</span><span class="p">.</span><span class="n">Thread</span><span class="p">.</span><span class="n">Sleep</span><span class="p">(</span><span class="n">500</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">sw</span><span class="p">.</span><span class="n">Stop</span><span class="p">()</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Elapsed Time: &#34;</span> <span class="o">&amp;</span> <span class="n">sw</span><span class="p">.</span><span class="n">ElapsedMilliseconds</span> <span class="o">&amp;</span> <span class="s">&#34; ms&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-date-time/stopwatch-output.png"
    alt="Output einer StopWatch Messung">
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Dateien und Dateipfade</title>
      <link>https://jbetzen.net/posts/ilogic-dateien-pfade/</link>
      <pubDate>Wed, 12 Nov 2025 18:44:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-dateien-pfade/</guid>
      <description>Geöffnete Dokumente in Inventor haben eine Repräsentation als Datei im lokalen Dateisystem. Diese Dateien haben Dateiendungen, Dateinamen und Pfade, die einfach mittels iLogic ausgelesen und genutzt werden können.</description>
      <content:encoded><![CDATA[ <p>Die Arbeit mit Dateien und Pfadangaben ist in iLogic ein leichtes Spiel. Es stehen diverse vordefinierte Snippets bereit. Zusätzlich kann auch die gesamte Bandbreite an Funktionen des Namespace <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io?view=net-9.0"  target="_blank" rel="noreferrer">System.IO</a> aus VB.NET genutzt werden.</p>
<p>Als Beispiel dient eine in Inventor geöffnete Datei mit dem Namen <code>LST_Bender.ipt</code>. Anhand dieser Datei werden die beiden unterschiedlichen Herangehensweisen erläutert.</p>

<h2 class="relative group">iLogic Snippets
    <div id="ilogic-snippets" class="anchor"></div>
    
</h2>
<p>iLogic stellt vordefinierte Snippets bereit, die den Umgang mit Dateien und Pfaden spielerisch leicht gestalten. Die Snippets sind in der Dokumentation in der Sektion <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-622DED58-5CCB-423C-89E6-57ABBEB139A5"  target="_blank" rel="noreferrer">Document Functions Reference</a> gelistet. Zur Verfügung stehen:</p>
<table>
	<thead>
			<tr>
					<th>Snippet</th>
					<th>Funktionsweise</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>ThisDoc.FileName(False)</code></td>
					<td>Liefert den Dateinamen ohne Dateiendung.</td>
			</tr>
			<tr>
					<td><code>ThisDoc.FileName(True)</code></td>
					<td>Liefert den Dateinamen mit Dateiendung.</td>
			</tr>
			<tr>
					<td><code>ThisDoc.Path</code></td>
					<td>Liefert den Dateipfad, in dem die Datei abgelegt ist.</td>
			</tr>
			<tr>
					<td><code>ThisDoc.PathAndFileName(False)</code></td>
					<td>Liefert einen absoluten Pfad, inkl. Dateiname, jedoch ohne Dateiendung.</td>
			</tr>
			<tr>
					<td><code>ThisDoc.PathAndFileName(True)</code></td>
					<td>Liefert einen absoluten Pfad, inkl. Dateiname und Dateiendung.</td>
			</tr>
	</tbody>
</table>
<p>Die zurückgelieferten Werte können einfach im <a href="/posts/ilogic-logger/" >iLogic Logger</a> betrachtet werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">False</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Path</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">ThisDoc</span><span class="p">.</span><span class="n">PathAndFileName</span><span class="p">(</span><span class="k">False</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">ThisDoc</span><span class="p">.</span><span class="n">PathAndFileName</span><span class="p">(</span><span class="k">True</span><span class="p">))</span></span></span></code></pre></div></div>
<p><strong>Das Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-dateien-pfade/logger-output.png"
    alt="Logger Output">
</figure>



<h2 class="relative group">System.IO.Path
    <div id="systemiopath" class="anchor"></div>
    
</h2>
<p>Die eingebauten iLogic Snippets können in VB.NET auch identisch über die Klasse <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io.path.changeextension?view=net-9.0"  target="_blank" rel="noreferrer">System.IO.Path</a> ermittelt werden. Die Klasse bietet zusätzlich noch deutlich mehr Funktionen, bspw. das erfragen der Dateiendung.</p>
<p>Genutzt wird das Property <code>FullFileName</code>, das letzten Endes dem iLogic Snippet <code>ThisDoc.PathAndFileName(True)</code> entspricht und eine absolute Pfadangabe als String liefert:</p>


  

<figure class="centered"><img src="/posts/ilogic-dateien-pfade/api-fullfilename.png"
    alt="API Property FullFileName">
</figure>


<p>Der folgende Code liefert den identischen Logger Output, wie im Beispiel der <a href="/posts/ilogic-dateien-pfade/#ilogic-snippets" >iLogic Snippets</a>:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sFullFileName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">FullFileName</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileNameWithoutExtension</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetDirectoryName</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">Combine</span><span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetDirectoryName</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">),</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileNameWithoutExtension</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">)))</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFullPath</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">))</span></span></span></code></pre></div></div>
<p>Für das iLogic Snippet <code>ThisDoc.PathAndFileName(False)</code> steht keine native VB.NET-Methode zur Verfügung. Das gewünschte Ergebnis kann aber mittel der Methode <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io.path.combine?view=net-9.0"  target="_blank" rel="noreferrer">Path.Combine</a> erzielt werden.</p>

<h2 class="relative group">Anwendungsfall
    <div id="anwendungsfall" class="anchor"></div>
    
</h2>
<p>Ein naheliegender Anwendungsfall in größeren Baugruppen ist die Prüfung, ob alle verbauten Komponenten in den korrekten Ablagepfaden - bspw. der Ordnerstruktur in Vault - abgelegt sind. Da die Pfadangaben Strings sind, kann einfach mit der Methode <a href="https://learn.microsoft.com/de-de/dotnet/api/system.string.contains?view=net-9.0"  target="_blank" rel="noreferrer">String.Contains</a> geprüft werden, ob der gewünschte Ablagepfad identisch mit dem realen Ablagepfad der aktiven Datei ist.</p>
<p>Das folgende Beispiel prüft, ob der <code>FullFileName</code> die Pfadangabe <code>C:\Users\horst\Documents\Inventor\</code> enthält:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sFullFileName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">FullFileName</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">sFullFileName</span><span class="p">.</span><span class="n">Contains</span><span class="p">(</span><span class="s">&#34;C:\Users\horst\Documents\Inventor\&#34;</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Der Pfad der Datei &#39;{0}&#39; ist korrekt.&#34;</span><span class="p">,</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="k">Else</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="s">&#34;Der Pfad der Datei &#39;{0}&#39; ist nicht korrekt.&#34;</span><span class="p">,</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">))</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>
<p>Eine solche Prüfung kann auch über alle verbauten Komponenten einer Baugruppe erfolgen. Dazu muss die <code>If-Else-Schleife</code> nur auf die <code>AllReferencedDocuments</code> angewendet werden. Mehr zu diesem Thema ist im vorangegangen Post <a href="/posts/ilogic-referenced-docs/">iLogic: Referenzierte Dokumente in Baugruppen</a> zu finden.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Referenzierte Dokumente in Baugruppen</title>
      <link>https://jbetzen.net/posts/ilogic-referenced-docs/</link>
      <pubDate>Tue, 11 Nov 2025 17:44:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-referenced-docs/</guid>
      <description>Die Inventor API stellt in Baugruppen verschiedene Wege und Möglichkeiten bereit Auskunft über verbaute Dokumente in Baugruppen zu geben. Dabei geht es im Wesentlichen darum, das Konzept von Occurrences und Referenced Files zu verstehen.</description>
      <content:encoded><![CDATA[ <p>Die Inventor API erlaubt es mit einfachen Mitteln über verbaute Komponenten in Baugruppen zu iterieren. Dies kann nützlich sein, wenn eine Konstruktion finalisiert wird und man bspw. Prüfen möchte, ob alle verbauten Komponenten sauber gepflegte Properties, Stücklistenoptionen, etc. gesetzt haben.</p>
<p>Autodesk hat eine ausführliche Hilfeseite, die sich dem Thema widmet und das programmspezifische Wording erläutert: <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-0123304B-EC33-4430-B4F1-CBF225CB5B8F"  target="_blank" rel="noreferrer">File and Document References</a></p>
<p>Grundsätzlich wird unterschieden zwischen <code>File Obejects</code> und <code>Document Objects</code>. Ersteres behandelt die referenzierten Komponenten auf Datei- und Arbeitsspeicherebene, zweiteres auf Dokumentenebene. In diesem Post werden die <code>Document Objects</code> genutzt, genauer gesagt die Properties:</p>
<ul>
<li><a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=Document_AllReferencedDocuments"  target="_blank" rel="noreferrer">AllReferencedDocuments</a>, die rekursiv Komponenten aller Baugruppenebenen auflistet.</li>
<li><a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=Document_ReferencedDocuments"  target="_blank" rel="noreferrer">ReferencedDocuments</a>, die nur die erste Ebene verbauter Komponenten auflistet.</li>
</ul>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/document-object.png"
    alt="Tabelle mit API Endpunkten für das Document Object">
</figure>


<p>Zusätzlich gibt es noch das Konzept der <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=ComponentDefinition_Occurrences"  target="_blank" rel="noreferrer">Occurrences</a>, das Inventor unter der <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-ComponentDefinition"  target="_blank" rel="noreferrer">Component Definition</a> eines Baugruppendokuments bereit stellt. Die Properties <code>AllReferencedDocuments</code> und <code>ReferencedDocuments</code> liefern immer eine eindeutige Liste mit referenzierten Dokumenten, können aber <strong>keine</strong> Auskunft darüber geben, wie oft eine Komponente verbaut ist. Dies kann für die erste Baugruppenebene über die <code>Occurrences</code> erfolgen.</p>

<h2 class="relative group">Beispielbaugruppe
    <div id="beispielbaugruppe" class="anchor"></div>
    
</h2>
<p>Für die folgenden drei Code-Beispiele wird die Beispielhafte Baugruppe <code>Nested Assembly.iam</code> mit insgesamt <strong>3</strong> verschachtelten Baugruppenebenen und <strong>7</strong> einzigarten Komponenten verwendet.</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/beispielbaugruppe.png"
    alt="Ansicht Model Browser einer Beispielbaugruppe in Inventor">
</figure>


<p>Der strukturelle Baugruppenaufbau als <a href="https://tree.nathanfriend.com/?s=%28%27options!%28%27fancy!true~fullPath5~trailingSlash5~rootDot5%29~7%28%277%27Nest2Weld2-3-40-Alphabet8--A0--B66034C%27%29~version!%271%27%29*%5Cn--%20%200C*2ed%20Assembly83SheetMetal904Revolved95!false60LST_Bender7source!8.iam*9PartC.ipt%01C987654320-*"  target="_blank" rel="noreferrer">Tree Diagram</a>:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">Nested Assembly.iam
</span></span><span class="line"><span class="cl">├── Welded Assembly.iam
</span></span><span class="line"><span class="cl">│   ├── SheetMetalPart.ipt
</span></span><span class="line"><span class="cl">│   ├── RevolvedPart.ipt
</span></span><span class="line"><span class="cl">│   └── Alphabet.iam
</span></span><span class="line"><span class="cl">│       ├── A.ipt
</span></span><span class="line"><span class="cl">│       └── B.ipt
</span></span><span class="line"><span class="cl">├── LST_Bender.ipt
</span></span><span class="line"><span class="cl">├── LST_Bender.ipt
</span></span><span class="line"><span class="cl">├── SheetMetalPart.ipt
</span></span><span class="line"><span class="cl">└── RevolvedPart.ipt</span></span></code></pre></div></div>

<h2 class="relative group">Code-Beispiele
    <div id="code-beispiele" class="anchor"></div>
    
</h2>
<p>Die folgenden drei Beispiele zeigen sowohl die Methodik mittels <code>AllReferencedDocuments</code>, <code>ReferencedDocuments</code> und <code>Occurrences</code>. Es gilt zu beachten, wie alle drei Methoden eine unterschiedliche Anzahl an referenzierten Dokumenten im Property <code>Count</code> zurückliefern.</p>
<p>Zum besseren Verständnis werden für alle drei Methoden identischer Code demonstriert, der für jedes referenzierte Dokument den Dateinamen im iLogic Logger ausgibt.</p>

<h3 class="relative group">AllReferencedDocuments
    <div id="allreferenceddocuments" class="anchor"></div>
    
</h3>
<p>Diese Methode nutzt das <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-DocumentsEnumerator"  target="_blank" rel="noreferrer">DocumentsEnumerator Object</a>, um über alle referenzierten Dokumente zu iterieren:</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/AllReferencedDocuments.png"
    alt="API für den Endpoint AllReferencedDocuments">
</figure>


<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oAllRefDocs</span> <span class="ow">As</span> <span class="n">DocumentsEnumerator</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">AllReferencedDocuments</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oRefDoc</span> <span class="ow">As</span> <span class="kt">Object</span> <span class="ow">In</span> <span class="n">oAllRefDocs</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sFileName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">oRefDoc</span><span class="p">.</span><span class="n">FullFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Filename: {0}&#34;</span><span class="p">,</span> <span class="n">sFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span></span></span></code></pre></div></div>
<p>Es werden alle <strong>7 Dokumente</strong>, über alle Baugruppenebenen, in einer Liste mit eindeutigen Werten zurückgeliefert:</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/logger-allrefrerenceddocuments.png"
    alt="Logger Output für AllReferencedDocuments Property">
</figure>


<p>Die Methode eignet sich hervorragend, wenn man alle verbauten Komponenten, über alle Baugruppenebenen, auf bestimmte Bedingungen prüfen möchte.</p>

<h3 class="relative group">ReferencedDocuments
    <div id="referenceddocuments" class="anchor"></div>
    
</h3>
<p>Diese Methode nutzt ebenfalls das <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-DocumentsEnumerator"  target="_blank" rel="noreferrer">DocumentsEnumerator Object</a>, um über alle referenzierten Dokumente der <strong>ersten</strong> Baugruppenebene zu iterieren:</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/ReferencedDocuments.png"
    alt="API für den Endpoint ReferencedDocuments">
</figure>


<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oRefDocs</span> <span class="ow">As</span> <span class="n">DocumentsEnumerator</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ReferencedDocuments</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oRefDoc</span> <span class="ow">As</span> <span class="kt">Object</span> <span class="ow">In</span> <span class="n">oRefDocs</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sFileName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">oRefDoc</span><span class="p">.</span><span class="n">FullFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Filename: {0}&#34;</span><span class="p">,</span> <span class="n">sFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span></span></span></code></pre></div></div>
<p>Es werden lediglich <strong>4 Dokumente</strong> in einer Liste mit eindeutigen Werten zurückgeliefert, die identisch mit den verbauten Komponenten auf der ersten Baugruppenebene ist. Untergeordnete Bauteile und weitere verschachtelte Baugruppen, abseits der ersten Baugruppenebene, werden <strong>nicht</strong> berücksichtigt:</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/logger-refrerenceddocuments.png"
    alt="Logger Output für ReferencedDocuments Property">
</figure>



<h3 class="relative group">Occurrences
    <div id="occurrences" class="anchor"></div>
    
</h3>
<p>Occurrences sind, wie bereits erwähnt, ein Sonderfall, da sie keine eindeutige Liste zurückliefern, sondern auch Auskunft über die <strong>Anzahl</strong> der verbauten Komponenten auf der ersten Baugruppenebene geben können.</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/Occurrences.png"
    alt="API für den Endpoint Occurrences">
</figure>


<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oOccurences</span> <span class="ow">As</span> <span class="n">ComponentOccurrences</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">Occurrences</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oOccurrence</span> <span class="ow">As</span> <span class="n">ComponentOccurrence</span> <span class="ow">In</span> <span class="n">oOccurences</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sFileName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">oOccurrence</span><span class="p">.</span><span class="n">Definition</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">FullFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Filename: {0}&#34;</span><span class="p">,</span> <span class="n">sFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span></span></span></code></pre></div></div>
<p>Es werden <strong>5 Dokumente</strong> zurückgeliefert, das das Bauteil <code>LST_Bender.ipt</code> auf der ersten Baugruppenebene zweimal platziert wurde:</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/logger-occurrences.png"
    alt="Logger Output für Occurrences Property">
</figure>



<h2 class="relative group">Anwendungsfall
    <div id="anwendungsfall" class="anchor"></div>
    
</h2>
<p>Möchte man bspw. herausfinden, ob eine der verbauten Komponenten ein bestimmtes Property <strong>nicht</strong> gepflegt hat, kann man dafür das <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=Document_AllReferencedDocuments"  target="_blank" rel="noreferrer">AllReferencedDocuments Property</a> nutzen. Zum besseren Verständnis von Inventors Property Sets sei an dieser Stelle der Post <a href="/posts/ilogic-propertysets/">iLogic: Propertysets</a> empfohlen.</p>
<p>Als Beispiel werden alle Bauteile gelistet, die <strong>keinen</strong> Eintrag im Project Property <code>Part Number</code> besitzen. Exemplarisch haben alle Dokumente einen gepflegten Wert im Property <code>Part Number</code> bis auf das Bauteil <code>LST_Bender.ipt</code>:</p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/example-partnumber-missing.png"
    alt="Fehlender Eintrag im Property Part Number">
</figure>


<p>Für die Abfrage werden zwei kombinierte Methoden aus dem Namespace <code>System.String</code> verwendet. <a href="https://learn.microsoft.com/de-de/dotnet/api/system.string.isnullorwhitespace?view=net-9.0"  target="_blank" rel="noreferrer">IsNullOrWhiteSpace()</a> prüft ob ein Wert vorhanden ist und ob dieser ein Leerzeichen ist und <a href="https://learn.microsoft.com/de-de/dotnet/api/system.string.isnullorempty?view=net-9.0"  target="_blank" rel="noreferrer">IsNullOrEmpty()</a> prüft ob ein Wert vorhanden ist und dieser gar kein hinterlegtes Zeichen besitzt:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oAllRefDocs</span> <span class="ow">As</span> <span class="n">DocumentsEnumerator</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">AllReferencedDocuments</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oRefDoc</span> <span class="ow">As</span> <span class="kt">Object</span> <span class="ow">In</span> <span class="n">oAllRefDocs</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sFileName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetFileName</span><span class="p">(</span><span class="n">oRefDoc</span><span class="p">.</span><span class="n">FullFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sPartNumber</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oRefDoc</span><span class="p">.</span><span class="n">PropertySets</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;Design Tracking Properties&#34;</span><span class="p">).</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;Part Number&#34;</span><span class="p">).</span><span class="n">Value</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="p">(</span><span class="n">System</span><span class="p">.</span><span class="n">String</span><span class="p">.</span><span class="n">IsNullOrWhiteSpace</span><span class="p">(</span><span class="n">sPartNumber</span><span class="p">)</span> <span class="ow">Or</span> <span class="n">System</span><span class="p">.</span><span class="n">String</span><span class="p">.</span><span class="n">IsNullOrEmpty</span><span class="p">(</span><span class="n">sPartNumber</span><span class="p">))</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Filename: {0} hat keinen Eintrag im Property &#39;Part Number&#39;.&#34;</span><span class="p">,</span> <span class="n">sFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span></span></span></code></pre></div></div>
<p><strong>Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-referenced-docs/logger-missing-partnumber.png"
    alt="Logger Output für alle Komponenten ohne gepglegtes Property Part Number">
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Masse in Custom Property eintragen</title>
      <link>https://jbetzen.net/posts/ilogic-mass-property/</link>
      <pubDate>Mon, 03 Nov 2025 11:44:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-mass-property/</guid>
      <description>Inventor kann die Masse einer Konstruktion automatisch in Abhängigkeit von Geometrie und Dichte berechnen und stellt diese Angabe als Variable in Zeichnungen bereit. Man kann die Masse zusätzlich mit einfachen Mitteln in ein Custom Property schreiben.</description>
      <content:encoded><![CDATA[ <p>Inventor stellt die Angabe über die Masse der Konstruktion über das <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-MassProperties"  target="_blank" rel="noreferrer">MassProperties Object</a> bereit. Die Angabe erfolgt in Gramm.</p>


  

<figure class="centered"><img src="/posts/ilogic-mass-property/mass-properties-api.png">
</figure>


<p>Dieser Wert kann auch auf Zeichnungen als Textbaustein mittels <code>Physical Properties - Model &gt; MASS</code> genutzt werden:</p>


  

<figure class="centered"><img src="/posts/ilogic-mass-property/mass-property-variable.png">
</figure>


<p>Der Massenwert, den die API liefert ist trügerisch, denn er stellt nur den letzten Wert dar, der erfolgreich berechnet werden konnte. Wurde bspw. eine Unterkomponente nicht sauber aktualisiert, bescheinigt Inventor dies mit einem Blitz-Icon und liefert in der Application keinen sauberen Massenwert, sondern <code>N/A</code> zurück:</p>


  

<figure class="centered"><img src="/posts/ilogic-mass-property/mass-na-update.png">
</figure>


<p>Das Thema wird seit Jahren lang und breit im Inventor-Forum diskutiert und sorgt oftmals für fehlende Masseangaben in Schriftköpfen:</p>
<ul>
<li><a href="https://forums.autodesk.com/t5/inventor-forum/doesnt-always-update-mass-on-drawing/td-p/6813187"  target="_blank" rel="noreferrer">Doesnt always update Mass on drawing</a></li>
<li><a href="https://forums.autodesk.com/t5/inventor-ideas/weight-mass-n-a/idi-p/7744862"  target="_blank" rel="noreferrer">Weight/Mass N/A</a></li>
<li><a href="https://forums.autodesk.com/t5/inventor-forum/mass-property-n-a-for-iassembly/td-p/7435279"  target="_blank" rel="noreferrer">Mass property N/A for iAssembly</a></li>
<li><a href="https://forums.autodesk.com/t5/inventor-forum/losing-mass-property-constantly/td-p/6751058"  target="_blank" rel="noreferrer">Losing Mass property constantly</a></li>
</ul>
<p>Autodesk hat dazu ebenfalls ein Support-Dokument veröffentlicht <a href="https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Physical-properties-of-model-are-shown-as-NA-in-Inventor-drawing.html"  target="_blank" rel="noreferrer">Properties are shown as N/A in Inventor drawing and Vault batch plot</a> und nennt wortkarg folgenden Grund:</p>
<blockquote><p>Physical properties are not updated in the model and also shown as N/A.</p>
</blockquote><p>Der Grund liegt, wie bereits erwähnt, in nicht sauber aktualisierten Unterkomponenten. Weist man einer Unterkomponente ein neues Material zu, ändern sich folgerichtig auch die Massenwerte der übergeordneten Komponente. Inventor erfordert nun ein auschecken und eine neue Speicherung der übergeordneten Komponente. Das kann bei kleinen Konstruktionen ein schneller Akt sein, stößt aber bei größeren Designs mit Freigabeprozessen schnell auf langwierige Hürden.</p>

<h2 class="relative group">Code Beispiele
    <div id="code-beispiele" class="anchor"></div>
    
</h2>
<p>Im folgenden sind zwei Methoden aufgelistet, um den Massenwert zu ermitteln, auf drei Nachkommastellen zu runden und in ein Custom Property mit dem Namen <code>Masse</code> zu schreiben. Dieses Property kann dann als <em>dreckiger Workaround</em> bspw. in den Schriftköpfen von Zeichnungen verwendet werden.</p>

<h3 class="relative group">iLogic Snippet iProperties.Mass
    <div id="ilogic-snippet-ipropertiesmass" class="anchor"></div>
    
</h3>
<p>iLogic hat ein natives Snippet <code>iProperties.Mass</code>, das den Massenwert ermitteln kann. Es hat jedoch einen kritischen <strong>Nachteil</strong>, denn es liefert den Rückgabewert immer in der Masseneinheit, die in den Document Settings hinterlegt ist:</p>


  

<figure class="centered"><img src="/posts/ilogic-mass-property/mass-shortcut-docsettings.png">
</figure>


<p>Möchte man dieses Snippet benutzen, sollte vorher <strong>immer</strong> sichergestellt sein, dass ein einheitliches Einheitensystem in jedem Bauteil vorhanden ist, um zu verhindern dass Werte mal in Gramm und mal in Kilogramm rausgeschrieben werden. Wie das geht wurde bereits im Post <a href="/posts/ilogic-uom/">iLogic: Units of Measurement</a> beschrieben. Anschließend kann das Snippet folgendermaßen benutzt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">dMass</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Mass</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;Masse&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="n">Round</span><span class="p">(</span><span class="n">dMass</span><span class="p">,</span> <span class="n">3</span><span class="p">)</span></span></span></code></pre></div></div>

<h3 class="relative group">Alternative: Inventor API
    <div id="alternative-inventor-api" class="anchor"></div>
    
</h3>
<p>Eine alternative Methode besteht darin, dass man den letzten ermittelbaren Wert der Masse über die API ausliest:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">UOM</span> <span class="ow">As</span> <span class="n">UnitsOfMeasure</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">dMass</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">MassProperties</span><span class="p">.</span><span class="n">Mass</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Konvertiere Masse in Kilogramm
</span></span></span><span class="line"><span class="cl"><span class="n">dMass</span> <span class="o">=</span> <span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">dMass</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseMassUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kKilogramMassUnits</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="c">&#39; Runde Massenwert auf 3 Nachkommastellen
</span></span></span><span class="line"><span class="cl"><span class="n">dMass</span> <span class="o">=</span> <span class="n">Round</span><span class="p">(</span><span class="n">dMass</span><span class="p">,</span> <span class="n">3</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;Masse&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="n">dMass</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Masse: {0} [kg]&#34;</span><span class="p">,</span> <span class="n">dMass</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Der Code liefert verlässlich unabhängig von der Masseneinheit in den Document Settings eine Massenwert in der Einheit <code>kg</code>, der auf drei Nachkommastellen gerundet ist.</p>
<hr>
<p><strong>Achtung:</strong> Sollte die iLogic automatisch mit einem Trigger ausgelöst werden, darf sie nicht einer Zeichnung zugeordnet sein, denn diese haben keinen Massenwert. Alternativ kann man den Code umschreiben und explizit den Dokumententyp abfragen, wie im Post <a href="/posts/ilogic-documenttypes/">iLogic: Dokumententypen</a> beschrieben.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Modelldimensionen per RangeBox ermitteln</title>
      <link>https://jbetzen.net/posts/ilogic-rangebox/</link>
      <pubDate>Sat, 01 Nov 2025 21:44:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-rangebox/</guid>
      <description>Eine Bounding Box beschreibt einen virtuellen Rahmen um ein 3D-Modell. Die Bestimmung der Abmaße können hilfreich bei der Planung notwendigen Lagerplatzes sein und werden in Inventor über Box Objekte bestimmt.</description>
      <content:encoded><![CDATA[ <p>Das Konzept einer <a href="https://de.wikipedia.org/wiki/Minimal_umgebendes_Rechteck"  target="_blank" rel="noreferrer">Bounding Box</a> ist in der CAD-Welt geläufig. Es stellt einen virtuellen umschließenden Rahmen um ein 3D-Modell dar, dessen Werte Aufschluss über dessen Größe geben und bspw. bei der Planung von etwaigen Lagerplatz hilfreich sein kann.</p>
<p>Die Inventor API nutzt zur Bestimmung ein sogenanntes <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-Box"  target="_blank" rel="noreferrer">Box Objekt</a>. Dieses definiert die Bounding Box über zwei Werte (Max/Min) pro Achse und kann über das <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-ComponentDefinition"  target="_blank" rel="noreferrer">ComponentDefinition Objekt</a> auf zweierlei Weisen benutzt werden:</p>

<h2 class="relative group">RangeBox vs. PreciseRangeBox
    <div id="rangebox-vs-preciserangebox" class="anchor"></div>
    
</h2>
<p>Neben der <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=ComponentDefinition_RangeBox"  target="_blank" rel="noreferrer"><strong>RangeBox:</strong></a> stellt Inventor <a href="https://help.autodesk.com/view/INVNTOR/2023/ENU/?guid=GUID-36B1FFB5-5291-4532-8F11-90E912769B34"  target="_blank" rel="noreferrer">seit Version 2023</a> eine <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=ComponentDefinition_PreciseRangeBox"  target="_blank" rel="noreferrer"><strong>PreciseRangeBox</strong></a> zur Ermittlung der Bounding Box bereit.</p>


  

<figure class="centered"><img src="/posts/ilogic-rangebox/rangebox.png"
    alt="RangeBox in der Inventor API">
</figure>


<p>Autodesk definiert sie in ihrer Funktionsweise folgendermaßen:</p>
<dl>
<dt><strong>RangeBox:</strong></dt>
<dd><blockquote><p>Property that returns a Box object which contains the opposing points of a rectangular box that is guaranteed to enclose this object.</p>
</blockquote></dd>
<dt><strong>PreciseRangeBox:</strong></dt>
<dd><blockquote><p>Gets a bounding box that tightly encloses all the solid and surface bodies under the ComponentDefinition.</p>
</blockquote></dd>
</dl>
<p>Der elementare Unterschied besteht darin, dass die <code>PreciseRangeBox</code> auch dann ein korrektes <em>minimal umgebendes Rechteck</em> liefert, wenn Teile <em>schief im Raum</em> und nicht entlang der Achsen modelliert wurden. Nachteil ist, dass die <code>PreciseRangeBox</code> in großen Baugruppen spürbar rechenintensiver ist. Auch <a href="https://forums.autodesk.com/t5/inventor-programming-forum/what-is-more-precise-about-preciserangebox-compared-to-rangebox/m-p/11445994/highlight/true#M32382"  target="_blank" rel="noreferrer">exkludiert</a> sie <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-E0C11929-0C49-4923-84E7-1138C8D8014F"  target="_blank" rel="noreferrer">Work Features</a>, wie Ebenen, Achsen und Punkte.</p>

<h2 class="relative group">Code
    <div id="code" class="anchor"></div>
    
</h2>
<p>Der folgende Code ermittelt die Werte der Bounding Box in Abhängigkeit des Dokumententyps. Siehe dazu: <a href="/posts/ilogic-documenttypes/">iLogic: Dokumententypen</a>.</p>
<p>Für Bauteile wird die <code>PreciseRangeBox</code> verwendet, für Baugruppen die <code>RangeBox</code>. Die ermittelten Werte werden anschließend, wie bereit im Post <a href="/posts/ilogic-uom/">iLogic: Units of Measurement</a> erläutert, von Inventors interner Längeneinheit Zentimeter in Millimeter konvertiert und mit der <code>Ceil()</code>-Methode auf den nächst höheren Ganzzahlwert gerundet. Der ermittelte Wert wird anschließend in ein Custom Property namens <code>Dimensionen</code> geschrieben.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">UOM</span> <span class="ow">As</span> <span class="n">UnitsOfMeasure</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oRangeBox</span> <span class="ow">As</span> <span class="n">Box</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Select</span> <span class="k">Case</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span>
</span></span><span class="line"><span class="cl">        <span class="k">Case</span> <span class="n">DocumentTypeEnum</span><span class="p">.</span><span class="n">kPartDocumentObject</span>
</span></span><span class="line"><span class="cl">            <span class="n">oRangeBox</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">PreciseRangeBox</span>
</span></span><span class="line"><span class="cl">        <span class="k">Case</span> <span class="n">DocumentTypeEnum</span><span class="p">.</span><span class="n">kAssemblyDocumentObject</span>
</span></span><span class="line"><span class="cl">            <span class="n">oRangeBox</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">RangeBox</span>
</span></span><span class="line"><span class="cl">        <span class="k">Case</span> <span class="k">Else</span>
</span></span><span class="line"><span class="cl">            <span class="k">Exit</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">    <span class="nf">End</span> <span class="k">Select</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Max Werte
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Xmax</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oRangeBox</span><span class="p">.</span><span class="n">MaxPoint</span><span class="p">.</span><span class="n">X</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Ymax</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oRangeBox</span><span class="p">.</span><span class="n">MaxPoint</span><span class="p">.</span><span class="n">Y</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Zmax</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oRangeBox</span><span class="p">.</span><span class="n">MaxPoint</span><span class="p">.</span><span class="n">Z</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Min Werte
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Xmin</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oRangeBox</span><span class="p">.</span><span class="n">MinPoint</span><span class="p">.</span><span class="n">X</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Ymin</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oRangeBox</span><span class="p">.</span><span class="n">MinPoint</span><span class="p">.</span><span class="n">Y</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Zmin</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oRangeBox</span><span class="p">.</span><span class="n">MinPoint</span><span class="p">.</span><span class="n">Z</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Konvertiere in &#39;mm&#39; und runde auf nächsten Ganzzahlwert
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">X</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">Xmax</span> <span class="o">-</span> <span class="n">Xmin</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Y</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">Ymax</span> <span class="o">-</span> <span class="n">Ymin</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Z</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">Zmax</span> <span class="o">-</span> <span class="n">Zmin</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Erzeuge String im Format &#39;X x Y x Z [mm]&#39;
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">Dimensions</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="kt">String</span><span class="p">.</span><span class="n">Format</span><span class="p">(</span><span class="s">&#34;{0} x {1} x {2} [mm]&#34;</span><span class="p">,</span> <span class="n">X</span><span class="p">,</span> <span class="n">Y</span><span class="p">,</span> <span class="n">Z</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Schreibe Abmaße in Property und Logger
</span></span></span><span class="line"><span class="cl">    <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;Dimensionen&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="n">Dimensions</span>
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Dimensionen: {0}&#34;</span><span class="p">,</span> <span class="n">Dimensions</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>

<h2 class="relative group">Ergebnis
    <div id="ergebnis" class="anchor"></div>
    
</h2>


  

<figure class="centered"><img src="/posts/ilogic-rangebox/result.png">
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Material über InputListBox zuweisen</title>
      <link>https://jbetzen.net/posts/ilogic-material-inputlistbox/</link>
      <pubDate>Fri, 31 Oct 2025 16:44:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-material-inputlistbox/</guid>
      <description>Dieser Post behandelt einen Lösungsvorschlag für ein Realproblem von Felix Rodermund, der in einem Youtube-Video versucht über iLogic und ein InputListBox-Dialogfenster eine Materialzuweisung per Listenauswahl zu realisieren.</description>
      <content:encoded><![CDATA[ <p>Der empfehlenswerte <a href="https://www.youtube.com/@r-kon"  target="_blank" rel="noreferrer">Youtube Kanal</a> von <a href="https://r-kon.de/"  target="_blank" rel="noreferrer">Felix Rodermund</a> wurde auf diesem Blog bereits im Post <a href="/posts/inventor-top-down-design/">Inventor: Top-Down-Konstruktion</a> empfohlen, da er eine schöne Serie zur Konstruktionsmethodik mit der Top-Down-Methode veröffentlicht hat.</p>
<p>Durch Zufall bin ich heute erneut über ein Video von ihm gestoßen, das ein augenscheinlich einfaches alltägliches Problem mit iLogic zu lösen versucht:</p>
<lite-youtube videoid="y739jWsr_fg" playlabel="y739jWsr_fg" params=""></lite-youtube>

<dl>
<dt><strong>Die Problemstellung:</strong></dt>
<dd>Wie kann man mit einem <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=b8c1d959-a08d-09fa-cbc3-3f05d828bf71"  target="_blank" rel="noreferrer">InputListBox</a>-Dialogfenster die verfügbaren Materialien der Standard Inventor Materialbibliothek auflisten und diese durch eine Listenauswahl zuweisen?</dd>
</dl>
<p>Das InputListBox-Dialogfenster ist dem aufmerksamen Leser dieser Serie bereit bekannt aus dem Post <a href="/posts/ilogic-user-interaction/">iLogic: User Interaktion</a>.</p>
<p>Felix versucht in seinem initialen Code alle verfügbaren Materialien über das <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-MaterialAsset"  target="_blank" rel="noreferrer">MaterialAssets Object</a> als Liste anzusprechen und diese an eine InputListBox zu übergeben. Das Problem über das er stolpert stellt sich in der Form dar, dass Materialien in Inventor auf programmatischer Ebene <strong>Objekte</strong> sind. Folgerichtig bekommt er auch eine Liste an Objekten in der InputListBox angezeigt, die jedoch dem Endanwender nichtssagende Informationen enthalten:</p>


  

<figure class="centered"><img src="/posts/ilogic-material-inputlistbox/inputlistbox-objects.png"
    alt="Screenshot InputListBox">
</figure>


<p>Wie bereits angeschnitten, ist ein <code>MaterialAsset</code> in Inventor nicht nur lediglich ein Materialname, sondern besitzt zusätzlich viele Eigenschaften, bspw. einen Namen, einen Anzeigenamen, Texturangaben oder aber auch physische Eigenschaften, wie die Dichte:</p>


  

<figure class="centered"><img src="/posts/ilogic-material-inputlistbox/material-asset.png"
    alt="Screenshot InputListBox">
</figure>


<p>Felix umgeht das Problem mit einem gesunden Maß an <em>Overengineering</em> und nutzt letzten Endes eine flexible <em>Wrapper Class</em>, die er auf seiner Webseite <a href="https://r-kon.de/cad-auswahldialog.php"  target="_blank" rel="noreferrer">dokumentiert</a> hat.</p>

<h2 class="relative group">Meine Lösung
    <div id="meine-lösung" class="anchor"></div>
    
</h2>
<p>Im Kern kann das Problem auch relativ einfach in iLogic gelöst werden. Man muss lediglich:</p>
<ol>
<li>eine leere Liste <code>listMaterials</code> deklarieren</li>
<li>über alle <code>MaterialAssets</code> iterieren und jeden Anzeigenamen des jeweiligen Materials in die Liste einfügen</li>
<li>diese Liste an die InputListBox übergeben und die Auswahl als <em>Return Value</em> in eine Variable speichern</li>
<li>im finalen Schritt den iLogic Shortcut <code>iProperties.Material</code> benutzen. Dieser akzeptiert für eine Materialzuweisung den Anzeigenamen eines Materials.</li>
</ol>
<p><strong>Der Code:</strong></p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oMaterialAssets</span> <span class="ow">As</span> <span class="n">AssetsEnumerator</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">AssetLibraries</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">3</span><span class="p">).</span><span class="n">MaterialAssets</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">listMaterials</span> <span class="ow">As</span> <span class="k">New</span> <span class="n">List</span><span class="p">(</span><span class="k">Of</span> <span class="kt">String</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oMaterialAsset</span> <span class="ow">As</span> <span class="n">MaterialAsset</span> <span class="ow">In</span> <span class="n">oMaterialAssets</span>
</span></span><span class="line"><span class="cl">        <span class="n">listMaterials</span><span class="p">.</span><span class="n">Add</span><span class="p">(</span><span class="n">oMaterialAsset</span><span class="p">.</span><span class="n">DisplayName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">selection</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">InputListBox</span><span class="p">(</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Welches Material soll zugewiesen werden?&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">listMaterials</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">listMaterials</span><span class="p">(</span><span class="n">0</span><span class="p">),</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Materialauswahl&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Material&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">480</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">0</span>
</span></span><span class="line"><span class="cl">    <span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="k">Not</span> <span class="kt">String</span><span class="p">.</span><span class="n">IsNullOrEmpty</span><span class="p">(</span><span class="n">selection</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">iProperties</span><span class="p">.</span><span class="n">Material</span> <span class="o">=</span> <span class="n">selection</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p><strong>Das Ergebnis:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-material-inputlistbox/assign-material.gif"
    alt="Materialzuweisung über InputListBox">
</figure>



<h2 class="relative group">Optimierte Lösung
    <div id="optimierte-lösung" class="anchor"></div>
    
</h2>
<p>Idealerweise prüft man vorangestellt, ob es sich beim aktiven Dokument um ein Bauteil (<code>PartDocument</code>) handelt, denn Baugruppen kann kein Material (abseits <a href="https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Changing-default-weld-material.html"  target="_blank" rel="noreferrer">Material für Schweißwerkstoffe</a>) zugewiesen werden. Wie dies funktioniert wurde bereits im Post <a href="/posts/ilogic-documenttypes/">iLogic: Dokumententypen</a> erläutert:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">&lt;&gt;</span> <span class="n">DocumentTypeEnum</span><span class="p">.</span><span class="n">kPartDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">MessageBox</span><span class="p">.</span><span class="n">Show</span><span class="p">(</span>
</span></span><span class="line"><span class="cl">            <span class="s">&#34;Dieser Code funktioniert nur in Bauteilen.&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">            <span class="s">&#34;Falscher Dokumententyp&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">            <span class="n">MessageBoxButtons</span><span class="p">.</span><span class="n">OK</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">            <span class="n">MessageBoxIcon</span><span class="p">.</span><span class="n">Error</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">            <span class="n">MessageBoxDefaultButton</span><span class="p">.</span><span class="n">Button1</span>
</span></span><span class="line"><span class="cl">        <span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">Exit</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">    <span class="nf">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oMaterialAssets</span> <span class="ow">As</span> <span class="n">AssetsEnumerator</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">AssetLibraries</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">3</span><span class="p">).</span><span class="n">MaterialAssets</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">listMaterials</span> <span class="ow">As</span> <span class="k">New</span> <span class="n">List</span><span class="p">(</span><span class="k">Of</span> <span class="kt">String</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oMaterialAsset</span> <span class="ow">As</span> <span class="n">MaterialAsset</span> <span class="ow">In</span> <span class="n">oMaterialAssets</span>
</span></span><span class="line"><span class="cl">        <span class="n">listMaterials</span><span class="p">.</span><span class="n">Add</span><span class="p">(</span><span class="n">oMaterialAsset</span><span class="p">.</span><span class="n">DisplayName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">selection</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">InputListBox</span><span class="p">(</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Welches Material soll zugewiesen werden?&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">listMaterials</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">listMaterials</span><span class="p">(</span><span class="n">0</span><span class="p">),</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Materialauswahl&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Material&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">480</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">        <span class="n">0</span>
</span></span><span class="line"><span class="cl">    <span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="k">Not</span> <span class="kt">String</span><span class="p">.</span><span class="n">IsNullOrEmpty</span><span class="p">(</span><span class="n">selection</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">iProperties</span><span class="p">.</span><span class="n">Material</span> <span class="o">=</span> <span class="n">selection</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Wird der Code nun in einer Baugruppe oder Zeichnung ausgeführt, erscheint eine Warnmeldung:</p>


  

<figure class="centered"><img src="/posts/ilogic-material-inputlistbox/warning.png"
    alt="Warnmeldung für einen falschen Dokumententyp">
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Import BOM Settings</title>
      <link>https://jbetzen.net/posts/ilogic-import-bom-settings/</link>
      <pubDate>Thu, 30 Oct 2025 21:44:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-import-bom-settings/</guid>
      <description>Baugruppen in Inventor erlauben die Stückliste anzuzeigen. Die dargestellten Properties in der Stücklistenansicht sind am Dokument gespeichert und können daher variieren. Sie können aber mittels iLogic manipuliert und harmonisiert werden.</description>
      <content:encoded><![CDATA[ <p>Wie im Post <a href="/posts/ilogic-bom/">iLogic: Stücklisten</a> beschrieben, erlauben Baugruppen in Inventor über <code>Assemble &gt; Bill of Materials</code> auf die Stückliste zuzugreifen. In der Stücklistenansicht werden definierte Properties angezeigt. Welche Properties angezeigt werden, wird am Dokument und <strong>nicht</strong> global gespeichert. Daher können die angezeigten Properties von Dokument zu Dokument zu variieren.</p>
<p>Inventor erlaubt eine vordefinierte Config im XML-Format über den Button <kbd>Import&hellip;</kbd> zu importieren:</p>


  

<figure class="centered"><img src="/posts/ilogic-import-bom-settings/btn-import-settings.png">
</figure>


<p>Eine solche Config für darzustellende Properties muss zuvor in einem Dokument definiert und anschließen über den Button <kbd>Export&hellip;</kbd> exportiert und kann anschließend maßgebend in anderen Baugruppen genutzt werden.</p>
<p>Da das händische Importieren einer solchen Datei einen Akt zeitraubener Klickarbeit darstellt, kann der Import auch mit iLogic automatisiert werden.</p>

<h2 class="relative group">Code zum Import der BOM Settings
    <div id="code-zum-import-der-bom-settings" class="anchor"></div>
    
</h2>
<p>Die BOM Settings können über das <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-BOM"  target="_blank" rel="noreferrer">BOM Object </a> manipuliert werden. Für den Import einer Settings-Datei stellt die Inventor API explizit die Methode <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=BOM_ImportBOMCustomization"  target="_blank" rel="noreferrer">BOM.ImportBOMCustomization</a> bereit. Diese erwartet als einzigen Parameter einen absoluten Dateipfad zur Settings-Datei als String:</p>


  

<figure class="centered"><img src="/posts/ilogic-import-bom-settings/ImportBOMCustomization.png"
    alt="ImportBOMCustomization Method zum Import einer BOM Settings Datei">
</figure>


<p>Im realen Anwendungsfall kann ales Beispiel eine BOM-Setting-Datei mit dem Namen <code>BOM-Settings.xml</code> herhalten. Der absolute Pfad dieser beispielhaften Datei soll lauten: <code>C:\foo\BOM-Settings.xml</code></p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Sicherstellen, dass Import nur in Baugruppen erfolgt
</span></span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oBOM</span> <span class="ow">As</span> <span class="n">BOM</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOM</span>
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Absoluter Pfad zur BOM-Settings-Datei
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sBOMSettingsFile</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;C:\foo\BOM-Settings.xml&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Import der Datei im aktiven Baugruppendokument
</span></span></span><span class="line"><span class="cl">    <span class="n">oBOM</span><span class="p">.</span><span class="n">ImportBOMCustomization</span><span class="p">(</span><span class="n">sBOMSettingsFile</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>

<h2 class="relative group">BOM nach Import öffnen
    <div id="bom-nach-import-öffnen" class="anchor"></div>
    
</h2>
<p>Möchte man die BOM nach dem Import einer Setting-Datei öffnen, kann auch dies mit iLogic erfolgen. Dabei muss die BOM über das <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-ControlDefinition"  target="_blank" rel="noreferrer">ControlDefinition Object</a> angesprochen und geöffnet werden. Um dies zu bewerkstelligen muss der zuvor gezeigte Code um lediglich 2 Zeilen erweitert werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oBOMControlDef</span> <span class="ow">As</span> <span class="n">ControlDefinition</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">CommandManager</span><span class="p">.</span><span class="n">ControlDefinitions</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;AssemblyBillOfMaterialsCmd&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oBOMControlDef</span><span class="p">.</span><span class="n">Execute2</span><span class="p">(</span><span class="k">True</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Wichtig an der Stelle ist, dass die Methode <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=ControlDefinition_Execute2"  target="_blank" rel="noreferrer">ControlDefinition.Execute2</a> und nicht <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=ControlDefinition_Execute"  target="_blank" rel="noreferrer">ControlDefinition.Execute</a> verwendet wird, da eine synchrone Ausführung des Befehls zur Laufzeit des iLogic Codes erfolgen muss.</p>
<p>Der Finale Code könnte dergestalt sein:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Sicherstellen, dass Import nur in Baugruppen erfolgt
</span></span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oBOMControlDef</span> <span class="ow">As</span> <span class="n">ControlDefinition</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">CommandManager</span><span class="p">.</span><span class="n">ControlDefinitions</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;AssemblyBillOfMaterialsCmd&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oBOM</span> <span class="ow">As</span> <span class="n">BOM</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOM</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sBOMSettingsFile</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;C:\foo\BOM-Settings.xml&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Import der Datei im aktiven Baugruppendokument
</span></span></span><span class="line"><span class="cl">    <span class="n">oBOM</span><span class="p">.</span><span class="n">ImportBOMCustomization</span><span class="p">(</span><span class="n">sBOMSettingsFile</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="c">&#39; BOM Aufrufen
</span></span></span><span class="line"><span class="cl">    <span class="n">oBOMControlDef</span><span class="p">.</span><span class="n">Execute2</span><span class="p">(</span><span class="k">True</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Schreibschutz von Dateien prüfen</title>
      <link>https://jbetzen.net/posts/ilogic-schreibschutz/</link>
      <pubDate>Thu, 23 Oct 2025 21:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-schreibschutz/</guid>
      <description>Vault nutzt den Dateischreibschutz im lokalen Workspace, um anzuzeigen, ob eine Datei schreibbar (checked out) ist. Diese Information kann mit iLogic ausgelesen und sichergestellt werden, dass Code nur in schreibbaren Dateien ausgeführt wird.</description>
      <content:encoded><![CDATA[ <p>Autodesk Vault verfolgt das geläufige PDM Konzept eines <a href="https://help.autodesk.com/view/VAULT/2024/ENU/?guid=GUID-4723870E-9E95-4141-8682-8332B3FD4A6F"  target="_blank" rel="noreferrer">lokalen Workspace</a>, in den Dateien heruntergeladen werden, wenn sie aus Vault geöffnet werden. Checkt man eine Datei nach dem Öffnungsbefehl nicht aus, sondern betrachtet sie lediglich, setzt Vault für diese Datei einen Schreibschutz im Dateisystem. Folgerichtig wird die Schreibbarkeit einer Datei nach einem Check-Out darüber geregelt, dass der Schreibschutz auf Dateisystemebene entfernt wird:</p>


  

<figure class="centered"><img src="/posts/ilogic-schreibschutz/file-read-only.png"
    alt="Read Only Dateistatus"><figcaption>
      <p>Eingecheckte Datei mit Read Only Attribute</p>
    </figcaption>
</figure>


<p>Man kann auf zweierlei Weise mittels iLogic prüfen, ob eine Datei ausgechecked ist:</p>
<dl>
<dt><strong>Methode 1 | Abfrage über die Vault API</strong></dt>
<dd>Seit Inventor 2024 stellt Autodesk die Möglichkeit bereit über iLogic Abfragen an die Vault API zu senden. Dafür steht die <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=33786554-75a9-06db-a868-b42f2883a355"  target="_blank" rel="noreferrer">iLogicVaultClass Class</a> bereit und besitzt auch eine Methode <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=476739ae-ab9a-ba83-8aab-b605ea0d74ff"  target="_blank" rel="noreferrer">iLogicVaultClass.GetVaultFileStatus</a>, um Informationen zum Dateistatus zu erhalten. Autodesk stellt Beispiel-Code in Form einer Funktion bereit, die als Return Value ein Dictionary liefert, in denen alle Informationen zum Dateistatus enthalten sind:
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Public</span> <span class="k">Function</span> <span class="nf">GetVaultFileStatus</span><span class="p">(</span>
</span></span><span class="line"><span class="cl">    <span class="n">LocalFullFileName</span> <span class="ow">As</span> <span class="kt">String</span>
</span></span><span class="line"><span class="cl"><span class="p">)</span> <span class="ow">As</span> <span class="n">Dictionary</span><span class="p">(</span><span class="k">Of</span> <span class="kt">String</span><span class="p">,</span> <span class="kt">String</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Problem:</strong> Ich habe nicht länger Zugriff auf eine laufende Vault Instanz und kann über die Funktionsweise keinerlei Auskunft geben. ¯\<em>(ツ)</em>/¯</p>
</dd>
<dt><strong>Methode 2 | Abfrage des Schreibschutzes der Datei</strong></dt>
<dd>Über iLogic kann dem aktiven Dokument der volle Pfad über das Property <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=Document_FullFileName"  target="_blank" rel="noreferrer">Document.FullFileName</a> entnommen werden. Dieser Pfad kann mittels der <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io.fileinfo?view=net-9.0"  target="_blank" rel="noreferrer">FileInfo Class</a> genutzt werden, um über das Property <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io.fileinfo.isreadonly?view=net-9.0#system-io-fileinfo-isreadonly"  target="_blank" rel="noreferrer">FileInfo.IsReadOnly</a> einen bool&rsquo;schen Wert über den Status des Schreibschutzes zu erhalten.</dd>
</dl>
<p>Die zweite Methode wird in diesem Post näher erklärt.</p>

<h2 class="relative group">Funktion mit Boolean Return Value
    <div id="funktion-mit-boolean-return-value" class="anchor"></div>
    
</h2>
<p>Der einfachste Weg zum Erfragen des Schreibschutzstatus ist die Auslagerung der gesamten Logik in eine eigene Funktion, die am Ende einen bool&rsquo;schen Wert als Return Value liefert. Als Funktionsparameter wird der <code>FullFileName</code> übergeben. Ist die Datei schreibgeschützt, wird der Wert <code>True</code> zurückgegeben.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsWriteProtected</span><span class="p">(</span><span class="n">FullFileName</span> <span class="ow">As</span> <span class="kt">String</span><span class="p">)</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oFileInfo</span> <span class="ow">As</span> <span class="k">New</span> <span class="n">IO</span><span class="p">.</span><span class="n">FileInfo</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oFileInfo</span><span class="p">.</span><span class="n">IsReadOnly</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span></span></span></code></pre></div></div>
<p>Zum Thema Funktionen ist in dieser Serie bereits ein Post erschienen: <a href="/posts/ilogic-struktur/">iLogic: Struktureller Aufbau</a></p>

<h2 class="relative group">Vollständiges Beispiel
    <div id="vollständiges-beispiel" class="anchor"></div>
    
</h2>
<p>Diese Funktion kann nun in einer Hauptroutine genutzt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">IsWriteProtected</span><span class="p">(</span><span class="n">oDoc</span><span class="p">.</span><span class="n">FullFileName</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="s">&#34;Datei ist schreibgeschützt.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">Exit</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">    <span class="nf">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Datei ist nicht schreibgeschützt.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Hier kann Code platziert werden, der nur
</span></span></span><span class="line"><span class="cl">        <span class="c">&#39; in ausgecheckten Dateien ausgeführt wird.
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsWriteProtected</span><span class="p">(</span><span class="n">sFullFileName</span> <span class="ow">As</span> <span class="kt">String</span><span class="p">)</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oFileInfo</span> <span class="ow">As</span> <span class="k">New</span> <span class="n">IO</span><span class="p">.</span><span class="n">FileInfo</span><span class="p">(</span><span class="n">sFullFileName</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oFileInfo</span><span class="p">.</span><span class="n">IsReadOnly</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span></span></span></code></pre></div></div>

<h2 class="relative group">Zu Beachten
    <div id="zu-beachten" class="anchor"></div>
    
</h2>
<p>Der Schreibschutz auf Dateiebene ist kein 100% sicherer Marker, ob eine Datei wirklich ausgechecked ist. Am Ende gibt es immer noch den wild-klickenden unbedarften User, der es am Ende schafft eine eingecheckte Datei <a href="https://help.autodesk.com/view/VAULT/2024/ENU/?guid=GUID-3621EE8C-4CC6-44F8-8111-314ADE6D2AB3"  target="_blank" rel="noreferrer">lokal zu modifizieren</a>:</p>


  

<figure class="centered"><img src="/posts/ilogic-schreibschutz/modified-file.png">
</figure>


<p>Im Falle einer lokalen Modifikation würde eine iLogic beim Ausführen der Funktion <code>IsWriteProtected()</code> melden, dass die Datei schreibbar ist, obwohl sie nicht auf den aktuellen User ausgechecked ist. Der iLogic Code würde laufen. Gleichzeitig würden aber die Änderungen, die eine iLogic am Dokument vorgenommen hat, nicht in Vault vorhanden sein.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Displayname anpassen</title>
      <link>https://jbetzen.net/posts/ilogic-displayname/</link>
      <pubDate>Thu, 23 Oct 2025 10:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-displayname/</guid>
      <description>Inventor erlaubt das Setzen eines Anzeigenamen für CAD-Dokumente. Dieser Displayname taucht im Model Browser von Inventor auf, kann mittels iLogic angepasst werden und dazu beitragen verbaute Dokumente leichter zu identifizieren.</description>
      <content:encoded><![CDATA[ <p>Inventor nutzt als Default den Dateinamen als Displayname (Anzeigename) im Model Browser:</p>


  

<figure class="centered"><img src="/posts/ilogic-displayname/displayname-filename.png"
    alt="Filename als Displayname">
</figure>


<p>Dateinamen und insbesondere lange kryptische Dateinamen, bspw. aus importierten Dateien, können den Model Browser schnell überfrachten und zur generellen Unübersichtlichkeit beitragen. Es kann daher Sinn ergeben ein einheitliches Format zu erzwingen und mittels iLogic beim Speichervorgang zu setzen.</p>
<p>Der Displayname ist dem <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-Document"  target="_blank" rel="noreferrer">Document Object</a> zugehörig und steht als eigenes Property <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=Document_DisplayName"  target="_blank" rel="noreferrer">Document.DisplayName</a> zur Verfügung. An dieses Property muss lediglich ein String übergeben werden, um den Displaynamen anzupassen:</p>


  

<figure class="centered"><img src="/posts/ilogic-displayname/displayname-property.png"
    alt="DisplayName Property">
</figure>



<h2 class="relative group">Beispielszenario
    <div id="beispielszenario" class="anchor"></div>
    
</h2>
<p>Im Post <a href="/posts/ilogic-propertysets/">iLogic: Propertysets</a> wurden bereits alle Inventor <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-PropertySets"  target="_blank" rel="noreferrer">Property Sets</a> beschrieben. Für das folgende Beispiel wird die Datei <code>LST_Bender.ipt</code> verwendet. Dieses Bauteil hat fiktiv gepflegte Werte in den Project Properties:</p>


  

<figure class="centered"><img src="/posts/ilogic-displayname/example-project-properties.png"
    alt="Beispiel anhand von Project Properties">
</figure>


<p>Die Werte für die Properties <code>Part Number</code>, <code>Description</code> und <code>Revision Number</code> sollen nun in einem kombinierten String in den Displaynamen geschrieben werden. Als Beispiel wird das folgende Format gewählt:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">{Description} - {Part Number} - Rev.{Revision Number}</span></span></code></pre></div></div>
<p>Am konkreten Beispiel sähe das Resultat folgerichtig folgendermaßen aus:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">LST Bender - 25785 - Rev.A</span></span></code></pre></div></div>

<h2 class="relative group">Displayname anpassen
    <div id="displayname-anpassen" class="anchor"></div>
    
</h2>
<p>Wie bereits erwähnt, wurde im Post <a href="/posts/ilogic-propertysets/">iLogic: Propertysets</a> die Inventor Property Sets beschrieben. Zusätzlich wurde dort auch der iLogic Shortcut vorgestellt, mit dem einfach Property Werte ausgelesen und geschrieben werden können. Der Befehlt lautet:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;$PropertySet&#34;</span><span class="p">,</span> <span class="s">&#34;$PropertyName&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Im konkreten Fall muss also das Project Property Set ausgelesen und die darin enthaltenen Werte in Variablen gespeichert und als String kombiniert werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDescription</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Project&#34;</span><span class="p">,</span> <span class="s">&#34;Description&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sPartnumber</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Project&#34;</span><span class="p">,</span> <span class="s">&#34;Part Number&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sRevision</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Project&#34;</span><span class="p">,</span> <span class="s">&#34;Revision Number&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Erzeuge String für kombinierten Displayname
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDisplayname</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="kt">String</span><span class="p">.</span><span class="n">Format</span><span class="p">(</span><span class="s">&#34;{0} - {1} - Rev.{2}&#34;</span><span class="p">,</span> <span class="n">sDescription</span><span class="p">,</span> <span class="n">sPartnumber</span><span class="p">,</span> <span class="n">sRevision</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Setze Displayname
</span></span></span><span class="line"><span class="cl"><span class="n">oDoc</span><span class="p">.</span><span class="n">DisplayName</span> <span class="o">=</span> <span class="n">sDisplayname</span></span></span></code></pre></div></div>
<p><strong>Das Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-displayname/result-displayname.png"
    alt="Mit iLogic angepasster Displayname"><figcaption>
      <p>Displayname: Vorher (links) und nachher (rechts)</p>
    </figcaption>
</figure>



<h2 class="relative group">Displayname zurücksetzen
    <div id="displayname-zurücksetzen" class="anchor"></div>
    
</h2>
<p>Ein bereits gesetzter Displayname kann einfach gelöscht werden, indem man das Bauteil im Model Browser selektiert und mittels Umbenennen <kbd>F2</kbd> den gesetzten Namenstext löscht:</p>


  

<figure class="centered"><img src="/posts/ilogic-displayname/reset-displayname.gif"
    alt="Displayname zurücksetzen"><figcaption>
      <p>Reset Displayname</p>
    </figcaption>
</figure>


<p>Ein Reset des Displayname kann auch auf einfachste Weise mit iLogic geschehen, indem schlichtweg ein leerer String übergeben wird:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">DisplayName</span> <span class="o">=</span> <span class="s">&#34;&#34;</span></span></span></code></pre></div></div>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Trigger Before Check-In</title>
      <link>https://jbetzen.net/posts/ilogic-before-check-in/</link>
      <pubDate>Wed, 22 Oct 2025 09:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-before-check-in/</guid>
      <description>Autodesk Vault erlaubt seit Version 2025 iLogics vor dem dem Check-In auszuführen. Der neue Trigger bietet Vorteile, hat aber auch seine Tücken und erzeugt im schlimmsten Fall ein Dokument, das sich nicht mehr in Vault einchecken lässt.</description>
      <content:encoded><![CDATA[ <p>Autodesk Vault 2025 hat einen <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-AB407A72-1C02-4C89-B2D0-72A7E962FB90"  target="_blank" rel="noreferrer">neuen Event-Trigger</a> <code>Before Vault Check-In</code> eingeführt, der es erlaubt iLogics vor dem Check-In-Vorgang auszuführen. Siehe: <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-A5262025-BB42-4707-8BA0-C0ED830FF3BD"  target="_blank" rel="noreferrer">Event Trigger Reference</a></p>
<p>Die <a href="https://forums.autodesk.com/t5/inventor-ideas/ilogic-events-trigger-before-check-in/idi-p/5701514"  target="_blank" rel="noreferrer">ursprüngliche Bitte</a> an Autodesk einen solchen Trigger einzuführen, stammt bereits aus dem Jahr 2015. Die Gründe sind nachvollziehbar, da vor diesem Trigger lediglich ein wirklich brauchbarer Event vorhanden war, um effektiv iLogics laufen zu lassen und zwar <code>Before Save Document</code>. iLogics bei jedem Speichervorgang laufen zu lassen ist und war nie wirklich zielführend. Insbesondere, wenn man eine große Menge an iLogics aktiv an die User ausgerollt hat, können diese die Dauer des Speichervorgangs spürbar beeinträchtigen. Viele iLogics kontrollieren, korrigieren oder setzen Property-Werte und oftmals ist es ausreichend dies <strong>nicht</strong> bei jedem Speichern erfolgen zu lassen, denn ein einmaliger Lauf vor dem Check-In in die Vault Datenbank führt zu selbigem Ergebnis.</p>

<h2 class="relative group">Tücken des Triggers
    <div id="tücken-des-triggers" class="anchor"></div>
    
</h2>
<p>Kurz nach den ersten Testvorgängen, stellte sich schnell Ernüchterung auf meiner Seite ein. Es ist relativ schnell und einfach möglich mit diesem neuen Trigger ein Dokument zu erzeugen, dass sich nicht mehr in Vault einchecken lässt. Ich hatte bspw. einen Fall in der alten iLogic Codebase, der nicht länger benötigte Custom Properties bereinigt hat, wie in diesem Post <a href="/posts/ilogic-delete-properties/">iLogic: Alte Properties automatisiert löschen</a> beschrieben. Zeitgleich hat eine andere iLogic aber ein eben bereinigtes Property erneut in das Dokument geschrieben. Ersteres geschah beim Speichervorgang. Zweiteres beim Einchecken.</p>
<p><strong>Das Resultat:</strong> Zirkellogik und ein Dokument, das nie aktuell ist und sich daher auch nicht sauber in Vault einchecken lässt:</p>


  

<figure class="centered"><img src="/posts/ilogic-before-check-in/file-was-modified-by-a-rule.png"
    alt="Error Message: File was modified by a rule"><figcaption>
      <p>Error: The file was modified by a rule that ran on check-in</p>
    </figcaption>
</figure>


<p>Da scheinbar mehrere User über dieses Problem gestolpert sind, hat Autodesk bereits ein eigenes Support-Dokument veröffentlicht: <a href="https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/The-file-was-modified-by-a-rule-that-ran-on-check-in-when-check-in-file-from-Inventor.html"  target="_blank" rel="noreferrer">The file was modified by a rule that ran on check-in</a></p>
<p>Dort wird die Ursache des Problems wie folgt beschrieben:</p>
<blockquote><p>When using trigger &ldquo;Before Vault Check-In&rdquo; or &ldquo;After Save Document&rdquo;, it is not allowed to change (the already saved) Inventor file. Writing properties or any other information in the current file is not allowed for these triggers as it causes that the file needs a save operation again.</p>
</blockquote><p>Das Kernproblem, welches an dieser Stelle entsteht, ist mangelnde <em>Verbosity</em>, denn die Aussage, dass die Datei während des Check-Ins modifiziert wurde, ist schlichtweg unpräzise und liefert keinerlei Hilfestellungen zur Lösung des Problems. Welche Regel das Dokument modifiziert hat oder was überhaupt modifiziert wurde ist nicht klar ersichtlich. Wer einen guten Überblick über seinen iLogic Code hat und diesen bis ins Detail kennt, mag darin kein Problem sehen. Wer aber eine komplett undokumentierte und unstrukturierte Codebase von 2800 Zeilen Code übernimmt, muss man dann erst mal Haare raufen und sich auf die Suche der Ursache begeben.</p>

<h2 class="relative group">Anwendungsfälle für den Trigger
    <div id="anwendungsfälle-für-den-trigger" class="anchor"></div>
    
</h2>
<p>Wie bereits erwähnt, kann der Trigger bei Dokumentenmodifikation zu Problemen führen. Daraus folgt aber auch, dass alle iLogic Tasks, die das Dokument <strong>nicht</strong> modifizieren, als idealer Anwendungsfall dienen. An dieser Stelle möchte ich zwei reale Anwendungsfälle aufzeigen, die nicht mit dem aktiven Dokument arbeiten, sondern lediglich die Inventor Anwendung per iLogic ansprechen:</p>
<dl>
<dt><a href="/posts/ilogic-before-check-in/#isometrische-ansicht-f%c3%bcr-3d-bauteile" ><strong>FALL 1 - 3D Bauteile in Iso-Ansicht schwenken</strong></a></dt>
<dd>Für Bauteile und Baugruppen kann über den Trigger sichergestellt werden, dass das Modell vor dem Einchecken immer in die isometrische Ansicht gedreht wird. Somit findet jeder, der das Dokument aus Vault öffnet dieses einheitlich in identischer Ansicht vor.</dd>
<dt><a href="/posts/ilogic-before-check-in/#seite-1-aktivieren-f%c3%bcr-zeichnungen" ><strong>FALL 2 - Erste Seite einer Zeichnung aktivieren</strong></a></dt>
<dd>Für Zeichnungen kann der Trigger genutzt werden, um vor dem Einchecken die erste Seite der Zeichnung zu aktivieren. Dies sorgt ebenfalls für ein einheitliches Öffnungsverhalten beim Laden aus Vault und sorgt zusätzlich dafür, dass die erste Seite als Thumbnail in Vault hinterlegt wird.</dd>
</dl>
<p>Beide Fälle werden im Folgetext mit Code-Beispielen erläutert.</p>

<h3 class="relative group">Isometrische Ansicht für 3D-Bauteile
    <div id="isometrische-ansicht-für-3d-bauteile" class="anchor"></div>
    
</h3>
<p>Um die Inventor Anwendung mittels iLogic zu überreden die aktive Ansicht in die Iso-Ansicht zu schwenken, muss als erstes auf das <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-Camera"  target="_blank" rel="noreferrer">Camera Object</a> zurückgegriffen werden. Dieses definiert die Ansicht des Modells in der Inventor Application. Das <code>Camera Object</code> hat ein Property namens <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=Camera_ViewOrientationType"  target="_blank" rel="noreferrer">Camera.ViewOrientationType</a>, mit dem eine spezifische Ansicht gewählt werden kann. Für letzteres ist dann der <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=ViewOrientationTypeEnum"  target="_blank" rel="noreferrer">ViewOrientationTypeEnum</a> wichtig. Der <code>ViewOrientationTypeEnum</code> stellt Standard-Asichten, wie die Vorderansicht, Seitenansicht etc., zur Verfügung, die dem Inventor-Anwender auch vom <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-B266056E-5E88-42A0-B29C-7BB25C377BD3"  target="_blank" rel="noreferrer">ViewCube</a> bekannt sein sollten. Er stellt aber auch spezifischere Ansichten bereit, bspw. Blechansichten oder aber die gewünschten Iso-Ansichten:</p>


  

<figure class="centered"><img src="/posts/ilogic-before-check-in/ViewOrientationTypeEnum.png">
</figure>


<p>Im folgenden Beispiel wird der <code>ViewOrientationTypeEnum</code> mit dem Wert <code>kIsoTopRightViewOrientation</code> genutzt:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">SetIsoView3d</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oApp</span> <span class="ow">As</span> <span class="n">Application</span> <span class="o">=</span> <span class="n">ThisApplication</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Select</span> <span class="k">Case</span> <span class="n">oApp</span><span class="p">.</span><span class="n">ActiveDocument</span><span class="p">.</span><span class="n">DocumentType</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Nur in Bauteilen und Baugruppen ausführen
</span></span></span><span class="line"><span class="cl">        <span class="k">Case</span> <span class="n">DocumentTypeEnum</span><span class="p">.</span><span class="n">kPartDocumentObject</span><span class="p">,</span> <span class="n">DocumentTypeEnum</span><span class="p">.</span><span class="n">kAssemblyDocumentObject</span>
</span></span><span class="line"><span class="cl">            <span class="k">Dim</span> <span class="n">oCamera</span> <span class="ow">As</span> <span class="n">Camera</span> <span class="o">=</span> <span class="n">oApp</span><span class="p">.</span><span class="n">ActiveView</span><span class="p">.</span><span class="n">Camera</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">            <span class="c">&#39; Schwenke in Iso Ansicht (Top Right)
</span></span></span><span class="line"><span class="cl">            <span class="n">oCamera</span><span class="p">.</span><span class="n">ViewOrientationType</span> <span class="o">=</span> <span class="n">ViewOrientationTypeEnum</span><span class="p">.</span><span class="n">kIsoTopRightViewOrientation</span>
</span></span><span class="line"><span class="cl">            <span class="n">oCamera</span><span class="p">.</span><span class="n">Apply</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">            <span class="c">&#39; View auf aktuelle Fenstergröße anpassen
</span></span></span><span class="line"><span class="cl">            <span class="n">oApp</span><span class="p">.</span><span class="n">ActiveView</span><span class="p">.</span><span class="n">Fit</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">Select</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p><strong>Das Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-before-check-in/result-iso-view-fit.gif">
</figure>



<h3 class="relative group">Seite 1 aktivieren für Zeichnungen
    <div id="seite-1-aktivieren-für-zeichnungen" class="anchor"></div>
    
</h3>
<p>Für Zeichnungen ist das aktivieren des ersten Zeichnungsblattes leicht möglich. Man muss lediglich über das <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-Sheets"  target="_blank" rel="noreferrer">Sheets Object</a> das erste <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=GUID-Sheet"  target="_blank" rel="noreferrer">Sheet Object</a> (Blatt 1) adressieren und über die Methode <a href="https://help.autodesk.com/view/INVNTOR/2025/ENU/?guid=Sheet_Activate"  target="_blank" rel="noreferrer"><code>Sheet.Activate()</code></a> aktivieren:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">ActivateDrawingSheet1</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oApp</span> <span class="ow">As</span> <span class="n">Application</span> <span class="o">=</span> <span class="n">ThisApplication</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Try</span>
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Sheet 1 aktivieren
</span></span></span><span class="line"><span class="cl">        <span class="n">oApp</span><span class="p">.</span><span class="n">ActiveDocument</span><span class="p">.</span><span class="n">Sheets</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">1</span><span class="p">).</span><span class="n">Activate</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">        <span class="c">&#39; View auf aktuelle Fenstergröße anpassen
</span></span></span><span class="line"><span class="cl">        <span class="n">oApp</span><span class="p">.</span><span class="n">ActiveView</span><span class="p">.</span><span class="n">Fit</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Catch</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="s">&#34;Could not activate Sheet 1&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">Try</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p><strong>Das Resultat:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-before-check-in/result-drawing-sheet1.gif">
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Stile bereinigen</title>
      <link>https://jbetzen.net/posts/ilogic-purge-styles/</link>
      <pubDate>Wed, 15 Oct 2025 09:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-purge-styles/</guid>
      <description>An Bauteilen und Zeichnungen kann eine Historie alter Stile gespeichert sein, die nicht länger benötigt werden oder den Vorgaben der entsprechenden Bibliotheken entsprechen. Zur Bereinigung stellt Inventor die Funktion Purge Styles bereit.</description>
      <content:encoded><![CDATA[ <p>Inventor hält an Bauteilen und Zeichnungen eine Historie zugewiesener Stile vor. Das können bspw. Materialien sein, die einem Bauteil zugewiesen und anschließend geändert, oder auch Zeichnungsstile, die im Verlauf der Konstruktion gewechselt wurden.</p>
<p>Es gehört zum <em>guten Stil</em> diese Altlasten vor Freigaben zu entfernen. Inventor stellt dafür unter dem Tab <code>Manage</code> eine Funktion namens <code>Purge</code> bereit:</p>


  

<figure class="centered"><img src="/posts/ilogic-purge-styles/button-purge-styles.png"
    alt="Purge Styles Button">
</figure>


<p>Sind an einem Dokument alte Stile vorhanden, werden diese in einem neuen Fenster gelistet und können mit einem Klick auf <kbd>OK</kbd> gelöscht werden:</p>


  

<figure class="centered"><img src="/posts/ilogic-purge-styles/purge-styles-list.png"
    alt="Purge Styles Button">
</figure>


<p>Was in Inventors grafischer Oberfläche augenscheinlich einfach erscheint, stellte sich programmatisch mittels iLogic als nicht so einfach heraus. Es gab zu diesem Anwendungsfall bereits ein Post <a href="https://forums.autodesk.com/t5/inventor-programming-forum/ilogic-to-purge-styles/m-p/11712945"  target="_blank" rel="noreferrer">iLogic to purge styles</a> im Inventor Forum, der bereits mehrere Jahre alt war, aber zu keiner gescheiten Lösung geführt hat. Vier Jahre nach Erstellung des Posts stand ich vor selbigem Problem und konnte es <a href="https://forums.autodesk.com/t5/inventor-programming-forum/ilogic-to-purge-styles/m-p/11712945/highlight/true#M68730"  target="_blank" rel="noreferrer">lösen</a>.</p>
<p>Alte Zeichnungsstile und Stile an 3D Bauteilen müssen grundsätzlich anders programmatisch mit iLogic bereinigt werden:</p>

<h2 class="relative group">Zeichnungsstile bereinigen
    <div id="zeichnungsstile-bereinigen" class="anchor"></div>
    
</h2>
<p>Für Zeichnungsstile stellt die Inventor API den <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-StylesManager"  target="_blank" rel="noreferrer"><code>Styles Manager</code></a> bereit. Dieser Verwaltet jeden Zeichnungsstil als <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-Style"  target="_blank" rel="noreferrer"><code>Style Object</code></a> und bietet auch die Methode <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=Style_Delete"  target="_blank" rel="noreferrer"><code>Delete</code></a> an, um Stile zu löschen.</p>
<p>Die Styles einer Zeichnung sind erreichbar unter <code>oDoc.StylesManager.Styles</code>:</p>


  

<figure class="centered"><img src="/posts/ilogic-purge-styles/drawing-styles.png"
    alt="Drawing Styles">
</figure>


<p>Um alte Stile eindeutig erkennen und auslesen zu können, müssen zwei Bedingungen erfüllt sein:</p>
<ol>
<li>
<p>Das Property <code>InUse</code> muss den Wert <code>False</code> besitzen. Damit ist sichergestellt, dass der Stil nicht aktiv im Zeichnungsdokument verwendet wird.</p>
</li>
<li>
<p>Die <code>StyleLocation</code>, darf nicht der aktiven Stilbibliothek  entsprechen. Auskunft darüber gibt der sogenannte <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=StyleLocationEnum"  target="_blank" rel="noreferrer"><code>StyleLocationEnum</code></a>, der generell drei mögliche Werte kennt:</p>
<ul>
<li><code>kLocalStyleLocation</code>: Der Stil ist nur lokal vorhanden und nicht in der aktiven Bibliotheken enthalten.</li>
<li><code>kLibraryStyleLocation</code>: Der Stil stammt aus einer aktiven Bibliothek.</li>
<li><code>kBothStyleLocation</code>: Der Stil ist lokal am Dokument vorhanden, entspricht aber den Vorgaben einer aktiven Bibliothek.</li>
</ul>
</li>
</ol>
<p>In Code geschrieben sehen diese Bedingungen so aus:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">PurgeDrawingStylesHistory</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oStyles</span> <span class="ow">As</span> <span class="n">Styles</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">StylesManager</span><span class="p">.</span><span class="n">Styles</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oStyle</span> <span class="ow">As</span> <span class="n">Style</span> <span class="ow">In</span> <span class="n">oStyles</span>
</span></span><span class="line"><span class="cl">        <span class="k">If</span> <span class="p">(</span><span class="n">oStyle</span><span class="p">.</span><span class="n">InUse</span> <span class="o">=</span> <span class="k">False</span> <span class="ow">And</span> <span class="n">oStyle</span><span class="p">.</span><span class="n">StyleLocation</span> <span class="o">&lt;&gt;</span> <span class="n">StyleLocationEnum</span><span class="p">.</span><span class="n">kLibraryStyleLocation</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">            <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Removed unused style: &#34;</span> <span class="o">&amp;</span> <span class="n">oStyle</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">            <span class="n">oStyle</span><span class="p">.</span><span class="n">Delete</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>

<h2 class="relative group">Bauteilstile bereinigen
    <div id="bauteilstile-bereinigen" class="anchor"></div>
    
</h2>
<p>Für Bauteile und Baugruppen ist der Vorgang ein Anderer. Um in diesem Fall die Historie an Stilen zu löschen, muss auf das <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-Assets"  target="_blank" rel="noreferrer">Assets Object</a> zurückgegriffen werden. Dieses steht unter <code>oDoc.Assets</code> zur Verfügung. Jedes Asset (Material, Appearance, etc.) wird dort als <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=Asset_AssetType"  target="_blank" rel="noreferrer"><code>AssetType</code></a> gelistet. Die Art des Assets wird über den <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=AssetTypeEnum"  target="_blank" rel="noreferrer"><code>AssetTypeEnum</code></a> ermittelt. Grundsätzlich stehen vier Auswahlmöglichkeiten an AssetTypes zur Auswahl:</p>
<ol>
<li><code>kAssetTypeAppearance</code>: Darstellungseinstellungen, wie bspw. ein Material gerendert werden soll.</li>
<li><code>kAssetTypeMaterial</code>: Ein Material, das zuweisbar ist.</li>
<li><code>kAssetTypePhysicalProperties</code>: Die physischen Eigenschaften des Materials, bspw. Dichte.</li>
<li><code>kAssetTypeUnknown</code>: Ein nicht näher definierbares Asset.</li>
</ol>


  

<figure class="centered"><img src="/posts/ilogic-purge-styles/assets-types.png"
    alt="Purge Styles Button">
</figure>


<p>Relevant sind lediglich <code>kAssetTypeAppearance</code>, <code>kAssetTypeMaterial</code> und die beiden Properties <code>IsReadOnly</code> und <code>IsUsed</code>. Nur ein schreibbares Asset (<code>IsReadOnly = False</code>) kann auch gelöscht werden und, wie auch bei den <a href="/posts/ilogic-purge-styles/#zeichnungsstile-bereinigen" >Zeichnungsstilen</a>, kann nur ein Asset gelöscht werden, das nicht aktive in Verwendung (<code>IsUsed = False</code>) ist.</p>
<p>Zusätzlich gibt es ein Verhalten in Inventor, das eine strikte Einhaltung bei der Löschung der Stile erforderlich macht: Material Assets müssen <strong>vor</strong> den Appearance Assets gelöscht werden.</p>
<p>Mit diesen Erkenntnissen kann eine Sub-Routine bspw. folgendermaßen aussehen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">PurgePartStylesHistory</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oAssets</span> <span class="ow">As</span> <span class="n">Assets</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">Assets</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Clean Material Assets first
</span></span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oAsset</span> <span class="ow">As</span> <span class="n">Asset</span> <span class="ow">In</span> <span class="n">oAssets</span>
</span></span><span class="line"><span class="cl">        <span class="k">Try</span>
</span></span><span class="line"><span class="cl">            <span class="k">If</span> <span class="p">(</span><span class="n">oAsset</span><span class="p">.</span><span class="n">AssetType</span> <span class="o">=</span> <span class="n">AssetTypeEnum</span><span class="p">.</span><span class="n">kAssetTypeMaterial</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsReadOnly</span> <span class="o">=</span> <span class="k">False</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsUsed</span> <span class="o">=</span> <span class="k">False</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">                <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Removed unused Material Asset: &#34;</span> <span class="o">&amp;</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">                <span class="n">oAsset</span><span class="p">.</span><span class="n">Delete</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">            <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">        <span class="k">Catch</span>
</span></span><span class="line"><span class="cl">            <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Error when removing unused Material Asset.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">Try</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Clean Appearance Assets second
</span></span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oAsset</span> <span class="ow">As</span> <span class="n">Asset</span> <span class="ow">In</span> <span class="n">oAssets</span>
</span></span><span class="line"><span class="cl">        <span class="k">Try</span>
</span></span><span class="line"><span class="cl">            <span class="k">If</span> <span class="p">(</span><span class="n">oAsset</span><span class="p">.</span><span class="n">AssetType</span> <span class="o">=</span> <span class="n">AssetTypeEnum</span><span class="p">.</span><span class="n">kAssetTypeAppearance</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsReadOnly</span> <span class="o">=</span> <span class="k">False</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsUsed</span> <span class="o">=</span> <span class="k">False</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">                <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Removed unused Appearance Asset: &#34;</span> <span class="o">&amp;</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">                <span class="n">oAsset</span><span class="p">.</span><span class="n">Delete</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">            <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">        <span class="k">Catch</span>
</span></span><span class="line"><span class="cl">            <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Error when removing unused Appearance Asset.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">Try</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Das wäre aber zu einfach! Bei Bauteilen und Baugruppen kommt noch eine Besonderheit zum Tragen und zwar die <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-8E771DBE-1107-4AE8-BE3E-AF3A7977F3C6"  target="_blank" rel="noreferrer">Model States</a>, die seit Version 2022 in Inventor zur Verfügung stehen. Diese können zur Variantenkonstruktion genutzt werden, sprich in einem Bauteil können unterschiedliche Materialien einem Model State zugewiesen werden. Es gilt daher zu beachten, dass lediglich der aktive Model State des Dokuments bereinigt wird.</p>

<h2 class="relative group">iLogic für Zeichnungen und Bauteile
    <div id="ilogic-für-zeichnungen-und-bauteile" class="anchor"></div>
    
</h2>
<p>Im Post <a href="/posts/ilogic-documenttypes/">iLogic: Dokumententypen</a> wurde bereits erläutert, wie Dokumententypen eindeutig identifiziert wurde. Möchte man nun den gezeigten Code in einer iLogic laufen lassen und zweitgleich Bauteile und Zeichnungen adressieren, kann dies folgendermaßen aussehen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kPartDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">PurgePartStylesHistory</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span> <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kDrawingsDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">PurgeDrawingStylesHistory</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">PurgePartStylesHistory</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oAssets</span> <span class="ow">As</span> <span class="n">Assets</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">Assets</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Clean Material Assets first
</span></span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oAsset</span> <span class="ow">As</span> <span class="n">Asset</span> <span class="ow">In</span> <span class="n">oAssets</span>
</span></span><span class="line"><span class="cl">        <span class="k">Try</span>
</span></span><span class="line"><span class="cl">            <span class="k">If</span> <span class="p">(</span><span class="n">oAsset</span><span class="p">.</span><span class="n">AssetType</span> <span class="o">=</span> <span class="n">AssetTypeEnum</span><span class="p">.</span><span class="n">kAssetTypeMaterial</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsReadOnly</span> <span class="o">=</span> <span class="k">False</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsUsed</span> <span class="o">=</span> <span class="k">False</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">                <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Removed unused Material Asset: &#34;</span> <span class="o">&amp;</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">                <span class="n">oAsset</span><span class="p">.</span><span class="n">Delete</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">            <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">        <span class="k">Catch</span>
</span></span><span class="line"><span class="cl">            <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Fil</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Error when removing unused Material Asset.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">Try</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Clean Appearance Assets second
</span></span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oAsset</span> <span class="ow">As</span> <span class="n">Asset</span> <span class="ow">In</span> <span class="n">oAssets</span>
</span></span><span class="line"><span class="cl">        <span class="k">Try</span>
</span></span><span class="line"><span class="cl">            <span class="k">If</span> <span class="p">(</span><span class="n">oAsset</span><span class="p">.</span><span class="n">AssetType</span> <span class="o">=</span> <span class="n">AssetTypeEnum</span><span class="p">.</span><span class="n">kAssetTypeAppearance</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsReadOnly</span> <span class="o">=</span> <span class="k">False</span> <span class="ow">And</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">IsUsed</span> <span class="o">=</span> <span class="k">False</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">                <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Removed unused Appearance Asset: &#34;</span> <span class="o">&amp;</span> <span class="n">oAsset</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">                <span class="n">oAsset</span><span class="p">.</span><span class="n">Delete</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">            <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">        <span class="k">Catch</span>
</span></span><span class="line"><span class="cl">            <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Error when removing unused Appearance Asset.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">Try</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">PurgeDrawingStylesHistory</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oStyles</span> <span class="ow">As</span> <span class="n">Styles</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">StylesManager</span><span class="p">.</span><span class="n">Styles</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oStyle</span> <span class="ow">As</span> <span class="n">Style</span> <span class="ow">In</span> <span class="n">oStyles</span>
</span></span><span class="line"><span class="cl">        <span class="k">If</span> <span class="p">(</span><span class="n">oStyle</span><span class="p">.</span><span class="n">InUse</span> <span class="o">=</span> <span class="k">False</span> <span class="ow">And</span> <span class="n">oStyle</span><span class="p">.</span><span class="n">StyleLocation</span> <span class="o">&lt;&gt;</span> <span class="n">StyleLocationEnum</span><span class="p">.</span><span class="n">kLibraryStyleLocation</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">            <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Removed unused style: &#34;</span> <span class="o">&amp;</span> <span class="n">oStyle</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">            <span class="n">oStyle</span><span class="p">.</span><span class="n">Delete</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Dieser Code könnte somit auf einen <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-B14A47F4-81D2-4627-A973-2BC7F790DF89"  target="_blank" rel="noreferrer">Event Trigger</a>, bspw. <code>Before Save Document</code>, für alle Dokumente gelegt werden und würde bei jedem Speichern die Stilhistorie bereinigen.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Alte Properties automatisiert löschen</title>
      <link>https://jbetzen.net/posts/ilogic-delete-properties/</link>
      <pubDate>Sun, 05 Oct 2025 11:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-delete-properties/</guid>
      <description>Im Laufe eines Projekts sammeln sich häufig Properties an, die im Verlauf keinerlei Verwendung mehr finden. Diese können mittels einer Liste und iLogic automatisiert gelöscht werden.</description>
      <content:encoded><![CDATA[ <p>Der Post <a href="/posts/ilogic-propertysets/">iLogic: Propertysets</a> hat bereits die <strong>4 Property Sets</strong> aus Inventor vorgestellt. Im Konstruktionsalltag spielen hauptsächlich die <strong>Custom Properties</strong>, auch <em>User Defined Properties</em> genannt, eine Rolle, da sie dem User erlauben dort Werte zu hinterlegen, die später auf Stücklisten oder Zeichnungen sichtbar werden.</p>

<h2 class="relative group">Anwendungsfall
    <div id="anwendungsfall" class="anchor"></div>
    
</h2>
<p>Oftmals zeigt sich der Fall auf, dass Properties im Laufe eine Projekts angelegt, später aber nicht länger benötigt werden. Ursachen für diesen Zustand gibt es viele, bspw. das Überarbeiten bestehender Prozesse, konzeptfrei arbeitende Vault Admins oder aber der Wechsel eines Vault Admins in der Firma. Das händische Löschen von Properties ist in einem solchen Fall ein zeitraubender Task, den iLogic geflissentlich übernehmen kann.</p>

<h2 class="relative group">Code zum Löschen der Properties
    <div id="code-zum-löschen-der-properties" class="anchor"></div>
    
</h2>
<p>Das folgende Beispiel definiert eine Liste <code>listOutdatedPropertyNames</code> mit alten Propertynamen, die nicht länger benötigt werden. Diese Liste ist beispielhaft und kann mit Propertynamen aus realen Anwendungsfällen gefüllt werden. Wichtig und zu beachten dabei ist lediglich, dass der letzte Propertyname <strong>nicht</strong> mit dem Zeichen <code>,</code> beendet wird.</p>
<p>Der Code iteriert über alle Custom Properties, die im aktiven Dokument vorhanden sind und prüft jedes einzeln, ob es in der definierten Liste enthalten ist und löscht es, sofern dies der Fall ist:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Liste mit alten Propertynamen definieren, die
</span></span></span><span class="line"><span class="cl"><span class="c">&#39; durch die iLogic entfernt werden sollen
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">listOutdatedPropertyNames</span> <span class="o">=</span> <span class="k">New</span> <span class="kt">String</span><span class="p">(){</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Adhesive Assembly&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Adhesived Assembly&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Approved By&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Area&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Author&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Batch Number Relevant&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Blechabmessung&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Fläche&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="s">&#34;Hurz&#34;</span>
</span></span><span class="line"><span class="cl"><span class="p">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Adressiere das Custom Property Set
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oPropSet</span> <span class="ow">As</span> <span class="n">PropertySet</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">PropertySets</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;Inventor User Defined Properties&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oProperty</span> <span class="ow">In</span> <span class="n">oPropSet</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">listOutdatedPropertyNames</span><span class="p">.</span><span class="n">Contains</span><span class="p">(</span><span class="n">oProperty</span><span class="p">.</span><span class="n">Name</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">oProperty</span><span class="p">.</span><span class="n">Delete</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span></span></span></code></pre></div></div>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>Inventor: Zeichnungsrevisionen vergleichen</title>
      <link>https://jbetzen.net/posts/inventor-pdf-diff/</link>
      <pubDate>Tue, 03 Jun 2025 20:26:58 +0100</pubDate>
      
      <guid>https://jbetzen.net/posts/inventor-pdf-diff/</guid>
      <description>pdf-diff ist ein quelloffenes und kostenfreies Kommandozeilentool, das es erlaubt den Inhalt zweier PDFs zu vergleichen. Das ist nützlich, wenn man die Änderungen zweier Revisionen von Zeichnungen auswerten möchte.</description>
      <content:encoded><![CDATA[ <p><a href="https://vslavik.github.io/diff-pdf/"  target="_blank" rel="noreferrer">diff-pdf</a> ist ein quelloffenes und kostenfreies Kommandozeilentool, das es erlaubt den Inhalt zweier PDFs als grafisches Overlay zu vergleichen. Das ist nützlich, wenn man die Änderungen zweier Revisionen von Zeichnungen auswerten möchte oder die Korrektheit vorliegender Änderungsmitteilungen für eine Zeichnungsrevision prüfen möchte.</p>


  

<figure class="centered"><img src="/posts/inventor-pdf-diff/diff.png"
    alt="Beispiel Diff zweier PDFs erstellt mit diff-pdf"><figcaption>
      <p>Beispiel Diff zweier PDFs erstellt mit diff-pdf</p>
    </figcaption>
</figure>



<h2 class="relative group">diff-pdf herunterladen
    <div id="diff-pdf-herunterladen" class="anchor"></div>
    
</h2>
<p>Das Tool liegt als kompilierte <code>exe</code> bei <a href="https://github.com/vslavik/diff-pdf"  target="_blank" rel="noreferrer">Github</a> vor und kann über <a href="https://github.com/vslavik/diff-pdf/releases/download/v0.5.2/diff-pdf-win-0.5.2.zip"  target="_blank" rel="noreferrer">diesen Link</a> direkt heruntergeladen werden. Anschließend muss der Ordner entpackt und in <code>diff-pdf</code> umbenannt werden.</p>
<p>Da das Tool keinen Installer besitzt, macht es Sinn es an einen Ort im Benutzerverzeichnis abzulegen und die Pfadvariablen von Windows so zu setzen, dass es für den User im Terminal verfügbar ist. Dazu den Windows Explorer öffnen und in die Pfadzeile <code>%USERPROFILE%</code> eintragen. Dort einen Ordner namens <code>Apps</code> anlegen und den Ordner <code>diff-pdf</code> hinein kopieren.</p>


  

<figure class="centered"><img src="/posts/inventor-pdf-diff/folder-copy.png"
    alt="Ordner in Nutzerverzeichnis kopieren">
</figure>



<h2 class="relative group">Pfadvariablen setzen
    <div id="pfadvariablen-setzen" class="anchor"></div>
    
</h2>
<p>Damit im Terminal nicht immer der volle Pfad zur <code>exe</code> eingegeben werden muss, wird eine neue Pfadvariable gesetzt:</p>
<ol>
<li>In die Windows Suche <code>environment variables for</code> eingeben und den Eintrag <code>Edit environment variables for your account</code> wählen:

    
      
    
    <figure class="img-list"><img src="/posts/inventor-pdf-diff/env-vars-search.png">
    </figure>
    
</li>
<li>Einen Doppelklick auf die Zeile <code>Path</code> machen:

    
      
    
    <figure class="img-list"><img src="/posts/inventor-pdf-diff/env-vars-path.png">
    </figure>
    
</li>
<li>Ein Klick auf <code>New</code> und mittels <code>Browse...</code> den Ordner <code>diff-pdf</code> im Benutzerverzeichnis auswählen:

    
      
    
    <figure class="img-list"><img src="/posts/inventor-pdf-diff/env-vars-add.png">
    </figure>
    
</li>
</ol>
<p>Von nun an steht das Kommando <code>diff-pdf.exe</code> im Terminal zur Verfügung.</p>

<h2 class="relative group">PDFs vergleichen
    <div id="pdfs-vergleichen" class="anchor"></div>
    
</h2>
<ol>
<li>Einen Ordner erstellen, bspw. auf dem Desktop und dort zwei PDFs hinein kopieren, die verglichen werden sollen. In meinem Beispiel heißen die Dateien <code>LST_Bender_RevA.pdf</code> und <code>LST_Bender_RevB.pdf</code>:

  
    
  
  <figure class="img-list"><img src="/posts/inventor-pdf-diff/folder-pdfs.png">
  </figure>
  
</li>
<li>Einen Rechtsklick auf eine leere Fläche des Ordners machen und <code>Open in Terminal</code> auswählen:

  
    
  
  <figure class="img-list"><img src="/posts/inventor-pdf-diff/folder-open-in-terminal.png">
  </figure>
  
</li>
</ol>
<p>Das Terminal öffnet sich und erwartet einen Befehl. Im Umgang mit <code>diff-pdf</code> stehen nun folgende Auswahlmöglichkeiten über Parameter und Argumente zur Verfügung:</p>

<h3 class="relative group">Grafischer Viewer
    <div id="grafischer-viewer" class="anchor"></div>
    
</h3>
<p>Ein einfacher grafischen Viewer kann mit dem Argument <code>--view</code> geöffnet werden. Dieser zeigt grafisch die detektierten Änderungen und erlaubt das Zoomen innerhalb der Anzeige:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ps1" data-lang="ps1"><span class="line"><span class="cl"><span class="nb">diff-pdf</span><span class="p">.</span><span class="py">exe</span> <span class="p">-</span><span class="n">-view</span> <span class="p">.\</span><span class="n">LST_Bender_RevB</span><span class="p">.</span><span class="py">pdf</span> <span class="p">.\</span><span class="n">LST_Bender_RevA</span><span class="p">.</span><span class="n">pdf</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/inventor-pdf-diff/diff-pdf-gui-differences.png">
</figure>


<p>Das farbliche Overlay kann mit gedrückter <kbd>CTRL</kbd> und den Pfeiltasten verschoben werden.</p>

  
  
  
  



<div
  
    class="flex px-4 py-3 rounded-md shadow bg-primary-100 dark:bg-primary-900"
  
  >
  <span
    
      class="text-primary-400 pe-3 flex items-center"
    
    >
    <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M256 0C114.6 0 0 114.6 0 256s114.6 256 256 256s256-114.6 256-256S397.4 0 256 0zM256 128c17.67 0 32 14.33 32 32c0 17.67-14.33 32-32 32S224 177.7 224 160C224 142.3 238.3 128 256 128zM296 384h-80C202.8 384 192 373.3 192 360s10.75-24 24-24h16v-64H224c-13.25 0-24-10.75-24-24S210.8 224 224 224h32c13.25 0 24 10.75 24 24v88h16c13.25 0 24 10.75 24 24S309.3 384 296 384z"/></svg>
</span>
  </span>

  <span
    
      class="dark:text-neutral-300"
    
    >Es empfiehlt sich die neuere Revision einer Zeichnung als ersten Parameter an <code>diff-pdf.exe</code> zu übergeben. Im Falle des aufgezeigten Beispiels zuerst die Revision B <code>LST_Bender_RevB.pdf</code>. Das erste Document wird mit roter Farbe im Diff-View gerendert, das zweite mit einer (nicht immer gut erkennbaren) türkisen Farbe.</span>
</div>


<h3 class="relative group">PDF der Änderungen erzeugen
    <div id="pdf-der-änderungen-erzeugen" class="anchor"></div>
    
</h3>
<p>Möchte man den grafischen Output als PDF abspeichern, kann das Argument <code>--output-diff=diff.pdf</code> verwendet werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ps1" data-lang="ps1"><span class="line"><span class="cl"><span class="nb">diff-pdf</span><span class="p">.</span><span class="py">exe</span> <span class="p">-</span><span class="n">-output-diff</span><span class="p">=</span><span class="n">diff</span><span class="p">.</span><span class="py">pdf</span> <span class="p">.\</span><span class="n">LST_Bender_RevB</span><span class="p">.</span><span class="py">pdf</span> <span class="p">.\</span><span class="n">LST_Bender_RevA</span><span class="p">.</span><span class="n">pdf</span></span></span></code></pre></div></div>
<p>Das Kommando erzeugt dann eine Datei mit dem Namen <code>diff.pdf</code>:


  

<figure class="centered"><img src="/posts/inventor-pdf-diff/folder-pdfs-output.png">
</figure>

</p>

<h2 class="relative group">Anmerkungen
    <div id="anmerkungen" class="anchor"></div>
    
</h2>
<p>Arbeitet man im Ökosystem von Autodesk und nutzt Vault als PDM-Datenbank, kann <code>diff-pdf</code> auch auf dem Jobserver eingesetzt werden. Wechselt eine Zeichnung bspw. in einen Status zur Aufforderung der Zeichnungsprüfung werden in der Regel bereits PDF-Exporte vom Job Server erstellt und liegen somit in der Vault Datenbank vor. Ein vorhandener Job kann somit erweitert werden, zusätzlich das PDF der vorherigen Revision abrufen und direkt gegen den neuen Stand der aktuellen Freigabe ein Diff erzeugen.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Plain Text Exporte</title>
      <link>https://jbetzen.net/posts/ilogic-text-export/</link>
      <pubDate>Sun, 01 Jun 2025 11:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-text-export/</guid>
      <description>Mittels des StreamWriters können Textdateien in iLogic erzeugt, geschrieben und direkt geöffnet werden. Die eignet sich hervorragend für Plain Text Exporte, bspw. um CSV-Dateien zu erzeugen oder Einträge der Inventor Bibliotheken auszuleiten.</description>
      <content:encoded><![CDATA[ <p>Da in iLogic auch .NET-Klassen aus dem <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io?view=net-9.0"  target="_blank" rel="noreferrer">Namespace</a> <code>System.IO</code> zur Verfügung stehen, können diese genutzt werden, um <a href="https://en.wikipedia.org/wiki/Plain_text"  target="_blank" rel="noreferrer">Plain-Text-Dateien</a> mittels <a href="https://learn.microsoft.com/en-us/dotnet/api/system.io.streamwriter?view=net-9.0"  target="_blank" rel="noreferrer">StreamWriter</a> oder <a href="https://learn.microsoft.com/en-us/dotnet/api/microsoft.visualbasic.fileio.filesystem.writealltext?view=net-8.0"  target="_blank" rel="noreferrer">WriteAllText</a> zu erzeugen und zu schreiben.</p>
<p>Die Methoden unterscheiden sich grundsätzlich in ihrer Funktion und Anwendungsfall:</p>
<dl>
<dt><strong><code>StreamWriter</code></strong></dt>
<dd>Öffnet einen Stream, der es erlaubt kontinuierlich Daten Zeile-für-Zeile wegzuschreiben. Dies ist nützlich in iterativen Vorgängen.</dd>
<dt><strong><code>WriteAllText</code></strong></dt>
<dd>Schreibt direkt einen Text in eine Datei.</dd>
</dl>

<h2 class="relative group">Minimalbeispiel StreamWriter
    <div id="minimalbeispiel-streamwriter" class="anchor"></div>
    
</h2>
<p>Im folgenden ein Minimalbeispiel, dass eine Textdatei <code>hallo.txt</code> im Pfad <code>C:/iLogicOutput/</code> erzeugt, die Zeichenfolge <code>Hallo</code> schreibt und nach dem Schreibvorgang das Dokument automatisch öffnet. Vorangestellt ist eine Prüfung die sicherstellt, dass der Ausgabepfad bereits existiert und legt diesen ggf. an, bevor der Schreibvorgang startet.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oFile</span> <span class="ow">As</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">File</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oWrite</span> <span class="ow">As</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">StreamWriter</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sFilePath</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;C:/iLogicOutput/hallo.txt&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDirectory</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetDirectoryName</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="k">Not</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">Exists</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">CreateDirectory</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span> <span class="o">=</span> <span class="n">oFile</span><span class="p">.</span><span class="n">CreateText</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;Hallo&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">Close</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Launch</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Die letzte Zeile <code>ThisDoc.Launch()</code> öffnet final die erzeugte Textdatei.</p>

<h2 class="relative group">Minimalbeispiel WriteAllText
    <div id="minimalbeispiel-writealltext" class="anchor"></div>
    
</h2>
<p>Das folgende Minimalbeispiel schreibt das heutige Datum in eine Textdatei:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sFilePath</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;C:/iLogicOutput/hallo.txt&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDirectory</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetDirectoryName</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">currentDate</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">Now</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;dd.MM.yyyy&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="k">Not</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">Exists</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">CreateDirectory</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">IO</span><span class="p">.</span><span class="n">File</span><span class="p">.</span><span class="n">WriteAllText</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">,</span> <span class="n">currentDate</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Launch</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span></span></span></code></pre></div></div>

<h2 class="relative group">Anwendungsbeispiele
    <div id="anwendungsbeispiele" class="anchor"></div>
    
</h2>

<h3 class="relative group">Blechregeln als CSV-Export
    <div id="blechregeln-als-csv-export" class="anchor"></div>
    
</h3>
<p>Dieses Beispiel exportiert sämtliche Blechregeln als <a href="https://en.wikipedia.org/wiki/Comma-separated_values"  target="_blank" rel="noreferrer">CSV-Datei</a>. Als Trennzeichen (<a href="https://de.wikipedia.org/wiki/Trennzeichen"  target="_blank" rel="noreferrer"><em>Delimiter</em></a>) wird in diesem Fall ein Semikolon <code>;</code> verwendet und kann ggf. in den Zeilen <code>oWrite.WriteLine()</code> angepasst werden, sofern ein Komma als Trennzeichen erwünscht ist. Das Beispiel ist ein <em>Quick-and-Dirty-Lösung</em>, die den CSV-Header und die Wertezeilen rausschreibt. Die CSV-Datei kann dann theoretisch auch in Excel importiert werden - <em>wenn</em> man das denn will.</p>
<p>Das Blechteil wird, wie bereits im Post <a href="/posts/ilogic-documenttypes/">iLogic: Dokumententypen</a> erläutert, über die <code>DocumentSubTypeID</code> ermittelt.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Check if Sheet Metal Part is currently open in Inventor
</span></span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentSubType</span><span class="p">.</span><span class="n">DocumentSubTypeID</span> <span class="o">&lt;&gt;</span> <span class="s">&#34;{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}&#34;</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">MessageBox</span><span class="p">.</span><span class="n">Show</span><span class="p">(</span>
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Please open a Sheet Metal Part and try again&#34;</span><span class="p">,</span> _
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Not a Sheet Metal Part&#34;</span><span class="p">,</span> _
</span></span><span class="line"><span class="cl">        <span class="n">MessageBoxButtons</span><span class="p">.</span><span class="n">OK</span><span class="p">,</span> _
</span></span><span class="line"><span class="cl">        <span class="n">MessageBoxIcon</span><span class="p">.</span><span class="n">Error</span>
</span></span><span class="line"><span class="cl">    <span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Exit</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl"><span class="nf">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Get SheetMetalStyles object
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oSheetMetalStyles</span> <span class="ow">As</span> <span class="n">SheetMetalStyles</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">SheetMetalStyles</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Streamwriter
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oFile</span> <span class="ow">As</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">File</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oWrite</span> <span class="ow">As</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">StreamWriter</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sFilePath</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;C:/iLogicOutput/SheetMetalRules.csv&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDirectory</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetDirectoryName</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="k">Not</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">Exists</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">CreateDirectory</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span> <span class="o">=</span> <span class="n">oFile</span><span class="p">.</span><span class="n">CreateText</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; CSV Header
</span></span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;&#34;&#34;Sheet Metal Rule&#34;&#34;;&#34;&#34;Material&#34;&#34;;&#34;&#34;Thickness&#34;&#34;;&#34;&#34;Bend Radius&#34;&#34;;&#34;&#34;Unfold Rule&#34;&#34;;&#34;&#34;kFactor&#34;&#34;&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; CSV Row Data
</span></span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oSheetMetalStyle</span> <span class="ow">As</span> <span class="n">SheetMetalStyle</span> <span class="ow">In</span> <span class="n">oSheetMetalStyles</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sRuleName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oSheetMetalStyle</span><span class="p">.</span><span class="n">Name</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sMaterial</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oSheetMetalStyle</span><span class="p">.</span><span class="n">Material</span><span class="p">.</span><span class="n">Name</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sThickness</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oSheetMetalStyle</span><span class="p">.</span><span class="n">Thickness</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sBendRadius</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oSheetMetalStyle</span><span class="p">.</span><span class="n">BendRadius</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sUnfoldRule</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oSheetMetalStyle</span><span class="p">.</span><span class="n">UnfoldMethod</span><span class="p">.</span><span class="n">Name</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sKFactor</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oSheetMetalStyle</span><span class="p">.</span><span class="n">UnfoldMethod</span><span class="p">.</span><span class="n">kFactor</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;&#34;&#34;{0}&#34;&#34;;&#34;&#34;{1}&#34;&#34;;&#34;&#34;{2}&#34;&#34;;&#34;&#34;{3}&#34;&#34;;&#34;&#34;{4}&#34;&#34;;&#34;&#34;{5}&#34;&#34;&#34;</span><span class="p">,</span> _
</span></span><span class="line"><span class="cl">                     <span class="n">sRuleName</span><span class="p">,</span> <span class="n">sMaterial</span><span class="p">,</span> <span class="n">sThickness</span><span class="p">,</span> <span class="n">sBendRadius</span><span class="p">,</span> <span class="n">sUnfoldRule</span><span class="p">,</span> <span class="n">sKFactor</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">Close</span><span class="p">()</span>
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Launch</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span></span></span></code></pre></div></div>

<h3 class="relative group">Materialbibliothek als Markdown-Tabelle
    <div id="materialbibliothek-als-markdown-tabelle" class="anchor"></div>
    
</h3>
<p>Dieses Beispiel exportiert die Materialbibliothek in eine <a href="https://www.markdownguide.org/extended-syntax/#tables"  target="_blank" rel="noreferrer">Markdown Tabelle</a>. Dazu wird nicht das aktive Dokument genutzt, sondern die Inventor Application, die sämtliche Bibliotheken (<code>AssetLibraries</code>) verwaltet:</p>


  

<figure class="centered"><img src="/posts/ilogic-text-export/api-materialassets.png"
    alt="Eine gerenderte Markdown Tabelle"><figcaption>
      <p>MaterialAssets in AssetLibraries</p>
    </figcaption>
</figure>


<p>Zusätzlich wird der Zeitpunkt des Exports im Dateinamen im Format <code>Materials_2025-06-01.txt</code> festgehalten.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vbnet" data-lang="vbnet"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oApp</span> <span class="ow">As</span> <span class="n">Application</span> <span class="o">=</span> <span class="n">ThisApplication</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oMaterialLibrary</span> <span class="ow">As</span> <span class="n">AssetsEnumerator</span> <span class="o">=</span> <span class="n">oApp</span><span class="p">.</span><span class="n">AssetLibraries</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;Autodesk Material Library&#34;</span><span class="p">).</span><span class="n">MaterialAssets</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">formattedDate</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">Now</span><span class="p">.</span><span class="n">ToString</span><span class="p">(</span><span class="s">&#34;yyyy-MM-dd&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sFilePath</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;C:/iLogicOutput/Materials_&#34;</span> <span class="o">&amp;</span> <span class="n">formattedDate</span> <span class="o">&amp;</span> <span class="s">&#34;.txt&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">sDirectory</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Path</span><span class="p">.</span><span class="n">GetDirectoryName</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oFile</span> <span class="ow">As</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">File</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oWrite</span> <span class="ow">As</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">StreamWriter</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="k">Not</span> <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">Exists</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">System</span><span class="p">.</span><span class="n">IO</span><span class="p">.</span><span class="n">Directory</span><span class="p">.</span><span class="n">CreateDirectory</span><span class="p">(</span><span class="n">sDirectory</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span> <span class="o">=</span> <span class="n">oFile</span><span class="p">.</span><span class="n">CreateText</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;Export date: **&#34;</span> <span class="o">&amp;</span> <span class="n">formattedDate</span> <span class="o">&amp;</span> <span class="s">&#34;**&#34;</span> <span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;This table is a Markdown Table. Paste it into your Markdown renderer of choice like https://dillinger.io or vscode.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;| Material Name | Material Category | Density [kg/m^3^]|&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">&#34;| ------------- | ----------------- | ---------------: |&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="k">Each</span> <span class="n">oMaterialAsset</span> <span class="ow">As</span> <span class="n">MaterialAsset</span> <span class="ow">in</span> <span class="n">oMaterialLibrary</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sLineData</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;| &#34;</span> <span class="o">&amp;</span> <span class="n">oMaterialAsset</span><span class="p">.</span><span class="n">DisplayName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">oMaterialAsset</span><span class="p">.</span><span class="n">CategoryName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">oMaterialAsset</span><span class="p">.</span><span class="n">PhysicalPropertiesAsset</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;structural_Density&#34;</span><span class="p">).</span><span class="n">Value</span> <span class="o">&amp;</span>  <span class="s">&#34; |&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="n">oWrite</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="n">sLineData</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oWrite</span><span class="p">.</span><span class="n">Close</span><span class="p">()</span>
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Launch</span><span class="p">(</span><span class="n">sFilePath</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Der Output ist als <a href="https://www.markdownguide.org/extended-syntax/#tables"  target="_blank" rel="noreferrer">Markdown Tabelle</a> formatiert und kann mit einem Markdown Renderer wie <a href="https://code.visualstudio.com/docs/languages/markdown#_markdown-preview"  target="_blank" rel="noreferrer">Visual Studio Code</a> oder Onlinediensten wie <a href="https://dillinger.io/"  target="_blank" rel="noreferrer">dillinger.io</a> gerendert werden:</p>


  

<figure class="centered"><img src="/posts/ilogic-text-export/table-render-dillinger.png"
    alt="Eine gerenderte Markdown Tabelle"><figcaption>
      <p>Gerenderte Markdown Tabelle mit <a href="https://dillinger.io/"  target="_blank" rel="noreferrer">dillinger.io</a></p>
    </figcaption>
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>Inventor Team Web mit MkDocs</title>
      <link>https://jbetzen.net/posts/inventor-teamweb/</link>
      <pubDate>Wed, 13 Dec 2023 20:26:58 +0100</pubDate>
      
      <guid>https://jbetzen.net/posts/inventor-teamweb/</guid>
      <description>Inventor bietet die Möglichkeit eine begleitende Webseite im Team Web direkt in der Application darzustellen. Dieser Post erläutert, wie man eine Webseite mit dem Static Site Generator MkDocs erstellen und einen zentrale Ort des Wissen für konstruktionsrelevante Themen schaffen kann.</description>
      <content:encoded><![CDATA[ <details
      class="admonition relative overflow-hidden rounded-lg border-l-4 my-3 px-4 py-3 shadow-sm group"
      data-type="warning"
      open>
      <summary class="flex items-center gap-2 font-semibold text-inherit cursor-pointer">
        <div class="flex shrink-0 h-5 w-5 items-center justify-center text-lg"><span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
</span></div>
        <div class="grow">
          Das Projekt &ldquo;Material for MkDocs&rdquo; ist Geschichte.
        </div>
        <div
          class="ms-auto flex h-5 w-5 items-center justify-center transition-transform ease-in-out -rotate-90 group-open:rotate-0 print:hidden"><span class="relative block icon"><svg
  xmlns="http://www.w3.org/2000/svg"
  viewBox="0 0 20 20"
  fill="currentColor"
  aria-hidden="true"
>
  <path
    fill-rule="evenodd"
    d="M5.23 7.21a.75.75 0 011.06.02L10 11.168l3.71-3.938a.75.75 0 111.08 1.04l-4.25 4.5a.75.75 0 01-1.08 0l-4.25-4.5a.75.75 0 01.02-1.06z"
    clip-rule="evenodd"
  />
</svg>
</span></div>
      </summary><div class="admonition-content mt-3 text-base leading-relaxed text-inherit"><p>In diesem Post wird das Setup einer begleitenden Webseite für Autodesk Inventor mit dem Tool <a href="https://squidfunk.github.io/mkdocs-material/"  target="_blank" rel="noreferrer">Material for MkDocs</a> beschrieben. Dieses Projekt ist <a href="https://github.com/squidfunk/mkdocs-material/issues/8523"  target="_blank" rel="noreferrer">nicht länger aktiv</a>, da es <a href="https://fpgmaas.com/blog/collapse-of-mkdocs/"  target="_blank" rel="noreferrer">Verwerfungen</a> unter den Maintainern und divergente Ansichten über die <a href="https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/#we-raised-concerns-early"  target="_blank" rel="noreferrer">zukünftige Ausrichtung</a> der Software gab. Der spirituelle Nachfolger heißt <a href="https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/"  target="_blank" rel="noreferrer">Zensical</a> und strebt an vollständige <a href="https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/#maximum-compatibility"  target="_blank" rel="noreferrer">Kompatibilität</a> zu MkDocs for Material herzustellen.</p>
<p><strong>Was heißt das im Detail:</strong> Die beschriebene <a href="/posts/inventor-teamweb/#mkdocs-starter-template" >Starter Template</a> funktioniert auch mit Zensical.</p></div></details>
<h2 class="relative group">Was ist Team Web?
    <div id="was-ist-team-web" class="anchor"></div>
    
</h2>
<p><a href="https://help.autodesk.com/view/INVNTOR/2024/DEU/?guid=GUID-278F58BB-D6F2-42BC-B9C8-279323F081B2"  target="_blank" rel="noreferrer">Team Web</a> ist ein nützliches Feature um Inventor-spezifische Themen, Anleitungen oder Hilfestellungen direkt in der Inventor Applikation darzustellen. Inventor wird somit zu einem kleinen Webbrowser, der HTML rendern und als zentrale Anlaufstelle für Konstruktionsthemen oder als News-Feed dienen kann. Oftmals anderweitig vorhandene fragmentiere Anleitungen und Handbücher finden im Team Web eine potentielle neue Heimat und sind dort indexiert, einfach suchbar und schnell zur Hand, ohne die Inventor Anwendung verlassen zu müssen.</p>
<p>Grundlage des dargestellten Inhalts ist eine HTML-Webseite, die entweder lokal vom Dateisystem oder über eine 


<abbr title="Fully Qualified Domain Name">FQDN</abbr> serviert wird. Da in Firmennetzwerken das Beantragen eines Domain-Namens, sowie die Bereitstellung eines Webservers gut und gerne auch mal etwas länger dauern kann, fokussiert dieser Post das ausliefern des HTML über einen Dateiordner in einem Netzwerkpfad, der in den Inventor Applikationseinstellungen gesetzt werden muss.</p>

<h2 class="relative group">Wie baut man als Laie Webseiten?
    <div id="wie-baut-man-als-laie-webseiten" class="anchor"></div>
    
</h2>
<p>Die einfachste Wahl um schnell und dynamisch statisches HTML zu generieren sind sogenannte <a href="https://en.wikipedia.org/wiki/Static_site_generator"  target="_blank" rel="noreferrer">Static Site Generators</a>, wie bspw. <a href="https://gohugo.io/"  target="_blank" rel="noreferrer">Hugo</a>, der diesen Blog generiert, oder <a href="https://www.mkdocs.org/"  target="_blank" rel="noreferrer">MkDocs</a>.</p>
<p>In diesem Beispiel wird <strong>MkDocs</strong> verwendet. Da Webseiten, die mit MkDocs generiert sind ein wenig <em>altbacken</em> daher kommen, wird zusätzlich das feature-reiche <a href="https://squidfunk.github.io/mkdocs-material/"  target="_blank" rel="noreferrer">MkDocs Material</a> als Theme benutzt. Dieses Theme erzeugt zeitgemäßes responsives HTML im <a href="https://m2.material.io/"  target="_blank" rel="noreferrer">Material Design Look</a> und bietet zusätzlich nützliche Funktionen, wie eine <a href="https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/"  target="_blank" rel="noreferrer">globale Suche</a>, vielseitige <a href="https://squidfunk.github.io/mkdocs-material/reference/formatting/"  target="_blank" rel="noreferrer">Formatierungsoptionen</a>, <a href="https://squidfunk.github.io/mkdocs-material/reference/diagrams/"  target="_blank" rel="noreferrer">Diagramme</a> oder <a href="https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/"  target="_blank" rel="noreferrer">Emoji-Support</a>.</p>
<p>Was alle <em>Static Site Generators</em> eint ist die Tatsache, dass es nicht erforderlich ist HTML beherrschen zu müssen. Stattdessen wird auf eine vereinfachte <a href="https://de.wikipedia.org/wiki/Auszeichnungssprache"  target="_blank" rel="noreferrer">Auszeichnungssprache</a> (Markup Language) - in der Regel <a href="https://www.markdownguide.org/cheat-sheet/"  target="_blank" rel="noreferrer">Markdown</a> - zurückgegriffen, die von MkDocs in HTML übersetzt wird. Markdown benötigt nur eine <a href="https://www.markdownguide.org/basic-syntax/"  target="_blank" rel="noreferrer">handvoll leicht zu erlernender Anweisung</a> zur Formatierung und Strukturierung von Textinhalten und wird einfach in Plain-Text-Dateien geschrieben und gespeichert.</p>

<h2 class="relative group">Software Requirements
    <div id="software-requirements" class="anchor"></div>
    
</h2>
<p>Um eine Webseite mit MkDocs zu erstellen, muss auf der Nutzermaschine folgende Software installiert sein. Für Python und Visual Studio Code sollten die <a href="https://de.wikipedia.org/wiki/Umgebungsvariable"  target="_blank" rel="noreferrer">Umgebungsvariablen</a> (<code>PATH</code>) gesetzt werden. Dafür benötigt man in der Regel die Firmen IT mit Administratorrechten.</p>
<ul>
<li>
<p><a href="https://www.python.org/downloads/"  target="_blank" rel="noreferrer">Python</a>, samt dem eigenen Paketmanager <code>pip</code>, muss installiert sein. <code>pip</code> ist in dem Python-Installer für Windows enthalten.</p>
</li>
<li>
<p><a href="https://code.visualstudio.com/"  target="_blank" rel="noreferrer">Visual Studio Code</a> als Text-Editor.</p>
</li>
<li>
<p>Die offizielle <a href="https://marketplace.visualstudio.com/items?itemName=ms-python.python"  target="_blank" rel="noreferrer">Python Extension</a> für Visual Studio Code.

  <figure>
          <img
            class="my-0 rounded-md img-list"
            src="/posts/inventor-teamweb/extension-python.png"
            alt="Python Extension"
          />
    
    
    </figure></p>
</li>
<li>
<p><strong>Optional</strong>, aber mit klarer Empfehlung: Die VSCode Extension <a href="https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one"  target="_blank" rel="noreferrer">Markdown All in One</a>, die das Arbeiten mit Markdown durch Shortcuts erheblich erleichtert.

    <figure>
            <img
              class="my-0 rounded-md img-list"
              src="/posts/inventor-teamweb/extension-markdown-aio.png"
              alt="Markdown All-in-One Extension"
            />
      
      
      </figure></p>
<p>Weitere empfohlene Extensions sind dem Projekt in der Datei <code>.vscode/extensions.json</code> beigelegt und können in VSCode über den Filter <kbd>Recommended</kbd> angezeigt und installiert werden:

    <figure>
            <img
              class="my-0 rounded-md centered"
              src="/posts/inventor-teamweb/extensions-recommendations.png"
              alt="VSCode recommended extensions"
            />
      
      
      </figure></p>
</li>
</ul>

<h2 class="relative group">MkDocs Starter Template
    <div id="mkdocs-starter-template" class="anchor"></div>
    
</h2>

  



<div
  
    class="flex px-4 py-3 rounded-md shadow bg-primary-100 dark:bg-primary-900"
  
  >
  <span
    
      class="text-primary-400 pe-3 flex items-center"
    
    >
    <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
</span>
  </span>

  <span
    
      class="dark:text-neutral-300"
    
    >Die Template ist auf die Benutzung über ein <a href="https://squidfunk.github.io/mkdocs-material/plugins/offline"  target="_blank" rel="noreferrer">Dateisystem</a> optimiert - sprich ohne Domain und Webserver - und kann einfach in einem Netzwerkordner abgelegt und in Inventor eingebunden werden. Dieses Vorgehen erlaubt einem Poweruser maximale Autonomie zum Ändern der dargestellten Inhalte.</span>
</div>

<p>Um das Vorhaben zur Erstellung einer Team Web Webseite zu vereinfachen, habe ich eine minimale Starter-Template erstellt, die als Grundlage für alle folgenden Schritte gilt und unbedarften Usern als niederschwellige Einstiegshürde in die magische Welt der <em>Static Site Generators</em> dient.</p>
<p>Die Starter Template ist bei Github verfügbar und kann dort <a href="https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo"  target="_blank" rel="noreferrer">geforked</a> oder als <code>zip</code> Archiv <a href="https://github.com/schneekluth/teamweb-inventor-mkdocs/archive/refs/heads/main.zip"  target="_blank" rel="noreferrer">heruntergeladen</a> werden:</p>
<div class="github-card-wrapper">
    <a id="github-7c6e930275238e3e568a135157122948" target="_blank" href="https://github.com/schneekluth/teamweb-inventor-mkdocs" class="cursor-pointer">
      <div
        class="w-full md:w-auto p-0 m-0 border border-neutral-200 dark:border-neutral-700 border rounded-md shadow-2xl"><div class="w-full nozoom">
            <img
              src="https://opengraph.githubassets.com/0/schneekluth/teamweb-inventor-mkdocs"
              alt="GitHub Repository Thumbnail"
              class="nozoom mt-0 mb-0 w-full h-full object-cover">
          </div><div class="w-full md:w-auto pt-3 p-5">
          <div class="flex items-center">
            <span class="text-2xl text-neutral-800 dark:text-neutral me-2">
              <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path fill="currentColor" d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
</span>
            </span>
            <div
              id="github-7c6e930275238e3e568a135157122948-full_name"
              class="m-0 font-bold text-xl text-neutral-800 decoration-primary-500 hover:underline hover:underline-offset-2 dark:text-neutral">
              schneekluth/teamweb-inventor-mkdocs
            </div>
          </div>

          <p id="github-7c6e930275238e3e568a135157122948-description" class="m-0 mt-2 text-md text-neutral-800 dark:text-neutral">
            
          </p>

          <div class="m-0 mt-2 flex items-center">
            <span class="mr-1 inline-block h-3 w-3 rounded-full language-dot" data-language="default"></span>
            <div class="m-0 mr-5 text-md text-neutral-800 dark:text-neutral">
              null
            </div>

            <span class="text-md mr-1 text-neutral-800 dark:text-neutral">
              <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><path fill="currentColor" d="M287.9 0C297.1 0 305.5 5.25 309.5 13.52L378.1 154.8L531.4 177.5C540.4 178.8 547.8 185.1 550.7 193.7C553.5 202.4 551.2 211.9 544.8 218.2L433.6 328.4L459.9 483.9C461.4 492.9 457.7 502.1 450.2 507.4C442.8 512.7 432.1 513.4 424.9 509.1L287.9 435.9L150.1 509.1C142.9 513.4 133.1 512.7 125.6 507.4C118.2 502.1 114.5 492.9 115.1 483.9L142.2 328.4L31.11 218.2C24.65 211.9 22.36 202.4 25.2 193.7C28.03 185.1 35.5 178.8 44.49 177.5L197.7 154.8L266.3 13.52C270.4 5.249 278.7 0 287.9 0L287.9 0zM287.9 78.95L235.4 187.2C231.9 194.3 225.1 199.3 217.3 200.5L98.98 217.9L184.9 303C190.4 308.5 192.9 316.4 191.6 324.1L171.4 443.7L276.6 387.5C283.7 383.7 292.2 383.7 299.2 387.5L404.4 443.7L384.2 324.1C382.9 316.4 385.5 308.5 391 303L476.9 217.9L358.6 200.5C350.7 199.3 343.9 194.3 340.5 187.2L287.9 78.95z"/></svg></span>
            </span>
            <div id="github-7c6e930275238e3e568a135157122948-stargazers" class="m-0 mr-5 text-md text-neutral-800 dark:text-neutral">
              0
            </div>

            <span class="text-md mr-1 text-neutral-800 dark:text-neutral">
              <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path fill="currentColor" d="M80 104c13.3 0 24-10.7 24-24s-10.7-24-24-24S56 66.7 56 80s10.7 24 24 24zm80-24c0 32.8-19.7 61-48 73.3V192c0 17.7 14.3 32 32 32H304c17.7 0 32-14.3 32-32V153.3C307.7 141 288 112.8 288 80c0-44.2 35.8-80 80-80s80 35.8 80 80c0 32.8-19.7 61-48 73.3V192c0 53-43 96-96 96H256v70.7c28.3 12.3 48 40.5 48 73.3c0 44.2-35.8 80-80 80s-80-35.8-80-80c0-32.8 19.7-61 48-73.3V288H144c-53 0-96-43-96-96V153.3C19.7 141 0 112.8 0 80C0 35.8 35.8 0 80 0s80 35.8 80 80zm208 24c13.3 0 24-10.7 24-24s-10.7-24-24-24s-24 10.7-24 24s10.7 24 24 24zM248 432c0-13.3-10.7-24-24-24s-24 10.7-24 24s10.7 24 24 24s24-10.7 24-24z"/></svg></span>
            </span>
            <div id="github-7c6e930275238e3e568a135157122948-forks" class="m-0 mr-5 text-md text-neutral-800 dark:text-neutral">
              0
            </div>
          </div>
        </div>
      </div>
      
      
      <script
        async
        type="text/javascript"
        src="/js/fetch-repo.min.dc5533c50cefd50405344b235937142271f26229fe39cbee27fd4960e8bb897a0beebfad77a1091ca91cd0d1fb14e70fc37cc114dd9674fb2c32e0ab512ec8a4.js"
        integrity="sha512-3FUzxQzv1QQFNEsjWTcUInHyYin&#43;OcvuJ/1JYOi7iXoL7r&#43;td6EJHKkc0NH7FOcPw3zBFN2WdPssMuCrUS7IpA=="
        data-repo-url="https://api.github.com/repos/schneekluth/teamweb-inventor-mkdocs"
        data-repo-id="github-7c6e930275238e3e568a135157122948"></script>
    </a>
  </div>
<p>Die Ordnerstruktur der Starter Template sieht <a href="https://tree.nathanfriend.com/?s=%28%27options%21%28%27fancy%21true%7EfullPath%21false%7EtrailingSlash%21true%7ErootDot%21false%29%7EB%28%27B%27C-inventor-mkA4AEblog6postF*2023-05-23-8md6.authors.yml69*assetFcsF*extra.csFbanner76favicon.ico6firmenlogo.svgEimg6hund76katze76maus7E9includesEabbreviations.mdE8xlsx4mkA.yml4requirements.txt4C.code-workspace%27%29%7Eversion%21%271%27%29*&#43;&#43;4%5Cn*6E*7.jpg8beispiel.9index.md4AdocsBsource%21CteamwebE4*Fs6%01FECBA98764*"  target="_blank" rel="noreferrer">wie folgt</a> aus:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">teamweb-inventor-mkdocs/
</span></span><span class="line"><span class="cl">├── docs/
</span></span><span class="line"><span class="cl">│   ├── blog/
</span></span><span class="line"><span class="cl">│   │   ├── posts/
</span></span><span class="line"><span class="cl">│   │   │   └── 2023-05-23-beispiel.md
</span></span><span class="line"><span class="cl">│   │   ├── .authors.yml
</span></span><span class="line"><span class="cl">│   │   └── index.md
</span></span><span class="line"><span class="cl">│   ├── assets/
</span></span><span class="line"><span class="cl">│   │   ├── css/
</span></span><span class="line"><span class="cl">│   │   │   └── extra.css
</span></span><span class="line"><span class="cl">│   │   ├── banner.jpg
</span></span><span class="line"><span class="cl">│   │   ├── favicon.ico
</span></span><span class="line"><span class="cl">│   │   └── firmenlogo.svg
</span></span><span class="line"><span class="cl">│   ├── img/
</span></span><span class="line"><span class="cl">│   │   ├── hund.jpg
</span></span><span class="line"><span class="cl">│   │   ├── katze.jpg
</span></span><span class="line"><span class="cl">│   │   └── maus.jpg
</span></span><span class="line"><span class="cl">│   └── index.md
</span></span><span class="line"><span class="cl">├── includes/
</span></span><span class="line"><span class="cl">│   ├── abbreviations.md
</span></span><span class="line"><span class="cl">│   └── beispiel.xlsx
</span></span><span class="line"><span class="cl">├── mkdocs.yml
</span></span><span class="line"><span class="cl">├── requirements.txt
</span></span><span class="line"><span class="cl">└── teamweb.code-workspace</span></span></code></pre></div></div>
<p>Alle Dateien und Ordner und ihre Funktion:</p>
<table>
	<thead>
			<tr>
					<th>Datei / Ordner</th>
					<th>Erläuterung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>docs/</code></td>
					<td>Der Hauptordner in dem alle Markdown-Dokumente, Bilder und Assets für die Webseite liegen.</td>
			</tr>
			<tr>
					<td><code>blog/</code></td>
					<td>Beinhaltet alle Blogposts und zusätzlich eine Datei namens <code>.authors.yml</code> in der ein Autorenverzeichnis für die Blog-Beiträge angelegt werden kann. Die Datei <code>index.md</code> erzeugt automatisch eine Übersicht aller vorhandenen Blog-Beiträge.</td>
			</tr>
			<tr>
					<td><code>assets/</code></td>
					<td>Enthält Firmenlogo, ein Bannerbild für die Startseite und ein Browser Icon (Favicon). Zusätzlich können CSS Stylings in der Datei <code>extra.css</code> vorgenommen werden. Ein Beispiel zum zentrieren des Footers und für Tabellen ist in der Template vorhanden.</td>
			</tr>
			<tr>
					<td><code>img/</code></td>
					<td>In diesem Ordner werden alle Bilder abgelegt, die in der Webseite verwendet werden.</td>
			</tr>
			<tr>
					<td><code>includes/</code></td>
					<td>In der Datei <code>abbreviations.md</code> können Abkürzungen hinterlegt werden, deren Volltext automatisch erscheint, wenn mit der Maus über den 


<abbr title="Beispieltext">Text</abbr> gefahren wird. Zusätzlich befindet sich eine Excel-Tabelle <code>beispiel.xlsx</code> in dem Verzeichnis, dessen Inhalt mit MkDocs automatisch eingelesen und dargestellt werden kann. Ein Beispiel dafür ist in der Template vorhanden.</td>
			</tr>
			<tr>
					<td><code>mkdocs.yml</code></td>
					<td>Über diese Datei wird MkDocs konfiguriert und der strukturelle Aufbau der Webseite definiert. Dazu wird eine einfache Sprache namens <a href="https://de.wikipedia.org/wiki/YAML"  target="_blank" rel="noreferrer">YAML</a> verwendet.</td>
			</tr>
			<tr>
					<td><code>requirements.txt</code></td>
					<td>Beinhaltet eine Liste an Python-Paketen, die für das generieren der HTML für das Team Web benötigt werden.</td>
			</tr>
			<tr>
					<td><code>teamweb.code-workspace</code></td>
					<td>Diese Datei beinhaltet nützliche Einstellungen für den Text-Editor Visual Studio Code.</td>
			</tr>
	</tbody>
</table>

<h2 class="relative group">Python Virtual Environment erzeugen
    <div id="python-virtual-environment-erzeugen" class="anchor"></div>
    
</h2>
<p>Python bietet eine Funktion namens <a href="https://virtualenv.pypa.io/en/latest/"  target="_blank" rel="noreferrer">Virtual Environments</a> (<code>venv</code>), die es erlaubt Python-Pakete isoliert und projektspezifisch in bestimmten Versionen zu installieren. Somit wird vermieden, dass systemweit installierte Pakete mit denen von dem lokalen Team Web Projekt in Konflikt geraten.</p>
<p>Der einfachste Weg ein solches <em>Virtual Environment</em> anzulegen und die benötigten Pakete zu installieren ist über Visual Studio Code. Dazu einen Rechtsklick auf den Ordner <code>teamweb-inventor-mkdocs/</code> machen und im Kontextmenü den Eintrag <code>Mit Code öffnen</code> auswählen:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/oeffnen-mit-code.png"
    alt="Öffnen mit VSCode">
</figure>


<p>Beim erstmaligen Öffnen wird Visual Studio Code einmalig Fragen, ob dem Autoren des Ordnerinhaltes vertraut werden soll. Diese Meldung muss mit einem Klick auf den Button <code>Yes, I trust the authors</code> bestätigt werden:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/trust-author.png"
    alt="Trust Author">
</figure>


<p>In VSCode muss nun die Tastenkombination <kbd>STRG</kbd>+<kbd>SHIFT</kbd>+<kbd>P</kbd> gedrückt werden. Es öffnet sich ein Eingabefeld, dass mit dem Zeichen <code>&gt;</code> beginnt. In dieses Feld wird folgendes eingetippt: <code>Python: Create Environment</code>. Anschließend mit <kbd>Enter</kbd> bestätigen:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/venv-create.png"
    alt="Create venv">
</figure>


<p>Anschließend fragt VSCode, welcher Typ von Environment erstellt werden soll. Es muss <code>.venv</code> ausgewählt und mit <kbd>Enter</kbd> bestätigt werden:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/venv-type.png"
    alt="venv type">
</figure>


<p>Im folgenden Schritt muss definiert werden, welcher Python Interpreter benutzt werden soll. An dieser Stelle muss der global installierte Python Interpreter ausgewählt werden:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/venv-interpreter.png"
    alt="venv interpreter">
</figure>


<p>Im letzten Schritt bietet Visual Studio Code die Möglichkeit an alle erforderlichen Python-Pakete und Abhängigkeiten zu installieren. Diese sind in der mitgelieferten Datei <code>requirements.txt</code> definiert. Es werden die folgenden Pakete installiert:</p>
<table>
	<thead>
			<tr>
					<th>Paket</th>
					<th>Erläuterung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><a href="https://squidfunk.github.io/mkdocs-material/"  target="_blank" rel="noreferrer">mkdocs-material</a></td>
					<td>Die Theme, die die Team Web Webseite ansehnlich macht.</td>
			</tr>
			<tr>
					<td><a href="https://timvink.github.io/mkdocs-table-reader-plugin/"  target="_blank" rel="noreferrer">mkdocs-table-reader-plugin</a></td>
					<td>Zum importieren von Excel Tabellenwerten.</td>
			</tr>
			<tr>
					<td><a href="https://blueswen.github.io/mkdocs-glightbox/"  target="_blank" rel="noreferrer">mkdocs-glightbox</a></td>
					<td>Zum zoomen eingebundener Grafiken</td>
			</tr>
			<tr>
					<td><a href="https://openpyxl.readthedocs.io/en/stable/"  target="_blank" rel="noreferrer">openpyxl</a></td>
					<td>Zum importieren von Excel Tabellenwerten im <code>xlsx</code> Format.</td>
			</tr>
	</tbody>
</table>
<p>Die Datei <code>requirements.txt</code> muss explizit in der Checkbox aktiviert und anschließen mit <kbd>OK</kbd> bestätigt werden:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/venv-dependencies.png"
    alt="venv dependencies">
</figure>


<p>VSCode erstellt nun ein Virtual Environment samt aller benötigten Pakete und legt dieses im Ordner <code>teamweb-inventor-mkdocs</code> im Unterordner <code>.venv/</code> an:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/venv-creating.png"
    alt="Creating venv">
</figure>


<p>Nach der Installation sollte Visual Studio Code einmal geschlossen und anschließend über einen Doppelklick auf die Datei <code>teamweb.code-workspace</code> neu geöffnet werden. Der Grund ist, dass diese Datei Anweisungen für VSCode für die Arbeit mit Virtual Environments enthält, die aber gerade erst erzeugt wurden.</p>

<h2 class="relative group">Das Terminal
    <div id="das-terminal" class="anchor"></div>
    
</h2>
<p>Niemand sollte sich von der Arbeit mit dem Terminal abschrecken lassen. Ja, es wirkt in erster Linie immer einschüchternd und ja, es birgt gefahren und man kann sehr schnell Dummheiten anrichten. Unachtsamkeiten werden nicht verziehen und einen <em>Rückgängig</em>-Knopf wird man vergebens suchen. Das sollte aber kein Grund sein sich mit diesem mächtigen Werkzeug vertraut zu machen, mit dem die ersten Jahrzehnte Computer bedient wurden.</p>
<p>In heutiger Zeit sind Nutzer, insbesondere <a href="https://www.quora.com/Why-is-Windows-considered-more-idiot-proof-than-Linux-despite-the-fact-that-Linux-is-usually-a-much-more-stable-operating-system"  target="_blank" rel="noreferrer">Windows-Nutzer</a>, an grafische <em>Klicki-Bunti-Oberflächen</em> mit Knöpfen gewöhnt. Oberflächen, die keine Neugierde mehr wecken, was da eigentlich auf dem Computer gerade passiert. Für Linux-Nutzer ist das Terminal ein Werkzeug, das in den Alltag gehört wie Sand zwischen den Zehen an einem ausgiebigen Tag am Strand. Seid neugierig und wagt euch Dinge anders zu tun. Ein modernes Team Web baut man nun einmal <strong>nicht</strong> in Excel, Word oder PowerPoint.</p>
<p>Für die Arbeit mit MkDocs sollte ein PowerShell Terminal gewählt werden und nicht ein klassisches Command Prompt, da PowerShell mehr Annehmlichkeiten mit sich bringt, bspw. farblichen Terminal output. Visual Studio Code hat praktischerweise ein <a href="https://code.visualstudio.com/docs/terminal/basics"  target="_blank" rel="noreferrer">integriertes Terminal</a>. Somit kann die Pflege des Team Web Contents und die Erzeugung des HTMLs direkt in einer Anwendung stattfinden.</p>
<p>Über die Menüleiste in VSCode kann mittels <code>Terminal &gt; New Terminal</code> oder die Tastenkombination <kbd>STRG</kbd>+<kbd>SHIFT</kbd>+<kbd>Ö</kbd> eine neue Terminal Session geöffnet werden. Im unteren Bereich der Applikation öffnet sich nun ein integriertes Terminal-Fenster. An dieser Stelle kann geprüft werden, ob es sich um ein PowerShell-Terminal handelt:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/terminal-new.png"
    alt="New Terminal">
</figure>


<p>Handelt es sich bei dem neuen Terminal Fenster nicht um ein Powershell Terminal, kann dies im Handumdrehen geändert werden:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/terminal-change.png"
    alt="Change Terminal">
</figure>



<h2 class="relative group">Virtual Environment aktivieren
    <div id="virtual-environment-aktivieren" class="anchor"></div>
    
</h2>
<p><strong>Wichtig:</strong> Python Virtual Environments müssen explizit pro Terminal-Session aktiviert werden, ansonsten wird nicht mit einer isolierten Umgebung für Pakete und Abhängigkeiten gearbeitet, sondern mit den global installierten Paketen.</p>
<p><strong>Die gute Nachricht:</strong> Die Team Web Starter Template enthält in der Datei <code>teamweb.code-workspace</code> eine Anweisung, die eine automatische Aktivierung des Environments in jedem aktiven Terminal Fenster in Visual Studio Code vornimmt:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">&#34;python.terminal.activateEnvInCurrentTerminal&#34;: true</span></span></code></pre></div></div>
<p>Wer sichergehen möchte ob das Virtual Environment aktiv ist, muss nur einen Blick ins Terminal werfen. Dies wird angedeutet durch einen grünen Text, der den Ausdruck <code>.venv</code> voranstellt:</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/venv-activated.png"
    alt="venv active">
</figure>


<p>Ist dies nicht der Fall kann einfach in Visual Studio Code die Datei <code>teamweb.code-workspace</code> angeklickt werden und auf den Button <code>Open Workspace</code> geklickt werden</p>


  

<figure class="centered"><img src="/posts/inventor-teamweb/open-workspace.png"
    alt="Open Workspace">
</figure>


<p>oder man gibt folgendes Kommando in das Terminal ein:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-Powershell" data-lang="Powershell"><span class="line"><span class="cl"><span class="p">.\.</span><span class="n">venv</span><span class="p">\</span><span class="n">Scripts</span><span class="p">\</span><span class="n">Activate</span><span class="p">.</span><span class="n">ps1</span></span></span></code></pre></div></div>

<h2 class="relative group">Webseitenstruktur
    <div id="webseitenstruktur" class="anchor"></div>
    
</h2>
<p>Die Webseitenstruktur wird über die zentrale Datei <code>mkdocs.yml</code> in der Sektion <code>nav:</code> mittel einer Sprache namens <a href="https://de.wikipedia.org/wiki/YAML"  target="_blank" rel="noreferrer">YAML</a> definiert:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/inventor-teamweb/webseite-struktur.png"
          alt="Webseite Struktur"
        />
  
  
  </figure>
<p>Dieses Kapitel in der MkDocs Material Dokumentation ist eine genauere Einsicht wert. Wer Beispielsweise oben keine horizontal angeordneten Tabs haben möchte, sollte sich die Sektion <a href="https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/"  target="_blank" rel="noreferrer">Setting Up Navigation</a> genauer anschauen.</p>

<h2 class="relative group">Workflow für die Arbeit am Teamweb
    <div id="workflow-für-die-arbeit-am-teamweb" class="anchor"></div>
    
</h2>
<p>Ein normaler Workflow gestaltet sich so, dass man im ersten Schritt eine Änderung des Content einbringen möchte. Man startet dazu den <a href="/posts/inventor-teamweb/#entwicklungsserver-starten" >lokalen Entwicklungsserver</a> von MkDocs und kann prüfen, ob die eingebrachten Änderungen den eigenen Ansprüchen genügen. Ist letzteres der Fall wird der Entwicklungsserver beendet und MkDocs angewiesen das statische HTML zu generieren.</p>

<h3 class="relative group">Entwicklungsserver Starten
    <div id="entwicklungsserver-starten" class="anchor"></div>
    
</h3>
<p>MkDocs beinhaltet ein nützliches Feature um Änderungen an der Webseite direkt im Browser live zu begutachten. MkDocs nutzt dazu einen lokalen Server, der die Webseite über <code>127.0.0.1:8000</code> ausliefert. Um den Dev Server zu starten muss im Terminal folgendes Kommando ausgeführt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ps1" data-lang="ps1"><span class="line"><span class="cl"><span class="n">mkdocs</span> <span class="n">serve</span></span></span></code></pre></div></div>
<p>Öffnet man nun den Webbrowser seines vertrauen und tippt als URL <a href="http://127.0.0.1:8000/"  target="_blank" rel="noreferrer"><code>127.0.0.1:8000</code></a> ein, erscheint ein Preview der Team Web Webseite. Ändert man eine Datei und speichert diese, lädt der Dev Server die Änderungen sofort neu durch und man kann das Ergebnis direkt im Browser begutachten:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/inventor-teamweb/template-preview.png"
          alt="Preview der Template"
        />
  
  
  </figure>
<p>Stoppen kann man den Dev Server mit der Tastenkombination <kbd>STRG</kbd>+<kbd>C</kbd> im aktiven Terminal-Fenster.</p>

<h3 class="relative group">Log Messages beachten
    <div id="log-messages-beachten" class="anchor"></div>
    
</h3>
<p>Der Entwicklungsserver gibt kontinuierlich Rückmeldung in Form von Log Messages. Entsteht bspw. ein Fehler, der es nicht ermöglicht die Webseite zu bauen, erscheinen diese mit dem Präfix <code>ERROR</code> und müssen behoben werden:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/inventor-teamweb/log-error.png"
          alt="Beispiel: Log Error"
        />
  
  
  </figure>
<p>Eine erfolgreiche Konfiguration hingegen wird über die Ausgabe <code>INFO  Documentation built in X seconds</code> angezeigt:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/inventor-teamweb/log-success.png"
          alt="Beispiel: Log Success"
        />
  
  
  </figure>

<h3 class="relative group">Webseiten HTML erzeugen
    <div id="webseiten-html-erzeugen" class="anchor"></div>
    
</h3>
<p>Sind alle Änderungen eingebracht, ist es an der Zeit das statische HTML zu erzeugen. MkDocs stellt dafür das Kommando <code>mkdocs build</code> bereit. Diese erzeugt standardmäßig das HTML in einem neuen Unterordner namens <code>site/</code> direkt im <code>teamweb-inventor-mkdocs/</code> Ordner. Damit läge die Webseite aber nur lokal auf der eigenen Nutzermaschine und kann nicht global verfügbar an die User ausgerollt werden.</p>
<p>Es macht daher Sinn die IT auf einen Kaffee einzuladen und Schreibrechte auf einem öffentlich zugängigen Netzwerkpfad zu besorgen. Dieser Pfad muss dann für das Team Web in den Inventor-Einstellungen gesetzt werden.</p>
<p>Ist ein allgemein zugänglicher Netzwerkpfad vorhanden, kann MkDocs direkt angewiesen werden das HTML an dieser Stelle zu generieren und abzulegen. Dazu wird dem Kommando <code>build</code> die <a href="https://www.mkdocs.org/user-guide/cli/#mkdocs-build"  target="_blank" rel="noreferrer">Option</a> <code>-d</code> (Kurznotation für <code>--site-dir</code>) angestellt und der Netzwerkpfad angegeben:</p>
<p>Ein Beispiel für einen fiktiven Netzwerkpfad auf einer Maschine namens <code>SERVER-X</code>:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">mkdocs</span> <span class="n">build</span> <span class="n">-d</span> <span class="s2">&#34;\\SERVER-X\Teamweb&#34;</span></span></span></code></pre></div></div>

<h2 class="relative group">Inventor Settings für Team Web
    <div id="inventor-settings-für-team-web" class="anchor"></div>
    
</h2>
<p>In den Inventor Application Settings findet sich im Reiter <code>File</code> eine Option den Pfad für das Team Web anzugeben. Dort wird nun einfach zu dem Netzwerkpfad navigiert und die Datei <code>index.html</code> angegeben.</p>
<p>Es ist durchaus sinnvoll den Haken bei der Checkbox <code>Show Team Web on Startup</code> zu setzen. Damit ist sichergestellt, dass jeder User einmal beim Neustart der Applikation das Team Web Fenster in Inventor sieht.</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/inventor-teamweb/inventor-settings.png"
          alt="Inventor Team Web Settings"
        />
  
  
  </figure>
<p><strong>Tip:</strong> Wer direkt auf die Blog Sektion im Team Web verlinken möchte, um die User mit Neuigkeiten zu versorgen, kann dies auch einfach tun. Dazu den Eintrag in den Inventor-Einstellungen folgendermaßen abändern:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">\\SERVER-X\Teamweb\blog\index.html</span></span></code></pre></div></div>
<p><strong>Et voilà!</strong> Schon befindet sich das erzeugte HTML direkt im Inventor:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/inventor-teamweb/teamweb-in-inventor.png"
          alt="Inventor Team Web"
        />
  
  
  </figure>

<h2 class="relative group">Updates installieren
    <div id="updates-installieren" class="anchor"></div>
    
</h2>
<p>Sowohl <a href="https://github.com/mkdocs/mkdocs/releases"  target="_blank" rel="noreferrer">MkDocs</a>, also auch die verwendete Theme <a href="https://github.com/squidfunk/mkdocs-material/releases"  target="_blank" rel="noreferrer">MkDocs Material</a> erhalten fortlaufend updates. Updates können einfach über das Kommando <a href="https://pip.pypa.io/en/stable/cli/pip_install"  target="_blank" rel="noreferrer"><code>pip install</code></a> <a href="https://squidfunk.github.io/mkdocs-material/upgrade/"  target="_blank" rel="noreferrer">eingespielt</a> werden. Dazu wieder in VSCode ein PowerShell Terminal aufrufen, sicherstellen dass das Virtual Environment aktiv ist und folgendes Kommando ausführen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ps1" data-lang="ps1"><span class="line"><span class="cl"><span class="n">pip</span> <span class="n">install</span> <span class="n">-U</span> <span class="p">-</span><span class="n">-force-reinstall</span> <span class="n">-r</span> <span class="p">.\</span><span class="n">requirements</span><span class="p">.</span><span class="n">txt</span></span></span></code></pre></div></div>
<p>Die Optionen für das Kommando <code>pip install</code> im Detail:</p>
<table>
	<thead>
			<tr>
					<th>Option</th>
					<th>Erläuterung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>-U</code></td>
					<td>Kurznotation für <code>--upgrade</code>, also dem installieren von neueren Paketversionen.</td>
			</tr>
			<tr>
					<td><code class="nowrap">--force-reinstall</code></td>
					<td>Erzwinge kein bloßes Update der Pakete, sondern eine komplette Neuinstallation. Dies wird von MkDocs Material <a href="https://squidfunk.github.io/mkdocs-material/upgrade/"  target="_blank" rel="noreferrer">empfohlen</a>.</td>
			</tr>
			<tr>
					<td><code>-r</code></td>
					<td>Kurznotation für <code>--requirements</code>. In diesem Fall wird die <code>requirements.txt</code> eingelesen, die alle benötigten Pakete enthält.</td>
			</tr>
	</tbody>
</table>

<h2 class="relative group">Anregungen
    <div id="anregungen" class="anchor"></div>
    
</h2>
<p>Ich habe dieses Jahr bei meinem derzeitigen Arbeitgeber ein solches Team Web in Inventor realisiert und etabliert. Die Vorteile lagen für mich mit der zentralen Bündelung und Durchsuchbarkeit von Informationen auf der Hand.</p>
<p>Sicherlich ersetzt ein Team Web kein Konstruktionshandbuch - erstrecht nicht in einem strukturell rückständigen Land wie Deutschland, in dem lineare Papierstrukturen auf Totholzerzeugnissen immer noch die Norm sind. Aber es ist ein einfach zu realisierender Gegenvorschlag, der einfach zu Pflegen ist und schnell und effizient fragmentierte Informationen bündeln kann.</p>

<h3 class="relative group">Anwendungsfälle für Team Web
    <div id="anwendungsfälle-für-team-web" class="anchor"></div>
    
</h3>
<p>Da sich Anwendungsfälle immer schwer generalisieren lassen, sind im folgenden einige Anwendungsfälle aus meinem Berufsalltag gelistet:</p>
<ul>
<li>
<p><strong>Troubleshooting:</strong> Ich sammle darin häufige Fehlermeldung aus Vault und Inventor, deren Ursachen und Lösungswege. Durch die eingebaute Suche können die User den Fehlermeldungstext direkt in das Suchfeld tippen und erhalten sofort den Link, der sie zur Lösung führt.</p>
</li>
<li>
<p><strong>FAQ / Anwenderfragen:</strong> Ich verwende eine eigene Sektion für Fragen von PDM-Benutzern. Oftmals traut sich der Anwender im Direktgespräche nicht zu Fragen und macht dann lieber irgendwelchen Quatsch. Ich habe in der Sektion einen Button, der direkt eine Mail-Template startet in denen die User Fragen stellen können. Sind diese von Relevanz oder tragen zum allgemeinen Verständnis bei, nehme ich sie in dieser Sektion auf.</p>
</li>
<li>
<p><strong>Vault Listeneinträge:</strong> Wer mit großen Listen in Autodesk Vault Properties arbeitet, kann ein Lied davon singen, dass diese nur <a href="https://forums.autodesk.com/t5/vault-customization/get-list-of-values-for-vault-property/td-p/10464516"  target="_blank" rel="noreferrer">schwer zu durchsuchen</a> sind. Wir nutzen ein selbstgehacktes Export-Tool, dass mittels der Vault API alle Listeneinträge ausliest und in das CSV-Format konvertiert. Die CSV-Datei lassen wir automatisch von MkDocs <a href="https://timvink.github.io/mkdocs-table-reader-plugin/readers/#read_csv"  target="_blank" rel="noreferrer">einlesen und darstellen</a>.</p>
</li>
<li>
<p><strong>News:</strong> Das <a href="https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/"  target="_blank" rel="noreferrer">Blog-Feature</a> von MkDocs Material eignet sich hervorragend dafür User über anstehende Änderungen, Neuigkeiten oder einfach nur sinnvolle Tipps oder konstruktionsrelevante Youtube Tutorial zu informieren. Youtube Videos können direkt ohne Aufwand in der Webseite eingebunden werden. Ein Beispiel zur Einbindung ist in der Starter Template enthalten.</p>
</li>
</ul>

<h3 class="relative group">Weiterführende Gedanken
    <div id="weiterführende-gedanken" class="anchor"></div>
    
</h3>
<ul>
<li>
<p>Das von mir erstellte Template ist nur ein minimales Showcase, was die Theme MkDocs Material alles zu bieten hat. Die Dokumentation hat eine wunderbar anschauliche Sektion namens <a href="https://squidfunk.github.io/mkdocs-material/reference/"  target="_blank" rel="noreferrer">Reference</a>, in der alle Funktionalität direkt an Beispielen erläutert werden. Ich kann diese Sektion jedem empfehlen, der meine Template erweitern möchte.</p>
</li>
<li>
<p>Für die Arbeit in einem internationalen Unternehmen kann MkDocs Material auch eine <a href="https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#site-language-selector"  target="_blank" rel="noreferrer">mehrsprachige Dokumentation</a> erstellen. Die Sprache kann dann - pro angezeigter Seite - über einen <em>Language Selector</em> ausgewählt werden. Bitte immer im Hinterkopf behalten, dass sich der Schreibaufwand und die Pflege der Inhalte pro zusätzlicher Sprache proportional erhöht.</p>
</li>
<li>
<p>Das schöne an der Arbeit mit Markdown-Dateien ist, dass es schlichtweg schnörkellose ehrliche Plain-Text-Dateien sind und nicht verkopfte und überladene proprietäre Textdarstellungsformate wie Word-Dokumente. Die Natur einer Plain-Text-Datei erlaubt bspw. eine einfache Kollaboration mehrerer Bearbeiter mittel <a href="https://git-scm.com/"  target="_blank" rel="noreferrer"><code>Git</code></a>. So kann man effizient zusammen an einem Team Web arbeiten, mit dem zusätzlichen Obolus eine ISO-9001 konforme Änderungshistorie zur Hand zu haben, die durch den Git Server automatisch und ohne Mehraufwand erzeugt wird.</p>
<p>MkDocs Material biete darüber hinaus sogar die Möglichkeit zur Anzeige älterer Versionsstände des Team Webs. Das sogenannte <a href="https://squidfunk.github.io/mkdocs-material/setup/setting-up-versioning"  target="_blank" rel="noreferrer">Versioning</a> wird in diesem Fall mittels einer Software namens <a href="https://github.com/jimporter/mike"  target="_blank" rel="noreferrer"><code>mike</code></a> vollzogen.</p>
</li>
<li>
<p><strong>Kosten:</strong> Alle verwendeten Tools sind Open-Source und kostenfrei verfügbar. Ein Webserver sollte in jedem Unternehmen im 21. Jahrhundert bereits zur Verfügung stehen. Selbst wenn dies nicht der Fall ist kann man sich mit dem eingebauten <a href="https://learn.microsoft.com/en-us/iis/get-started/introduction-to-iis/iis-web-server-overview"  target="_blank" rel="noreferrer">IIS-Server</a> von Windows behelfen und darüber das HTML bereitstellen. Während Microsoft gerade ihren Dienst Sharepoint für die nutzung als Intranet pusht, ist man mit einem lokal laufenden und selbstverwalteten Team Web mit MkDocs losgelöst von kontinuierlicher Kostensteigerung bei Microsoft und zusätzlich Herr über die bereitgestellten Daten.</p>
</li>
<li>
<p>Das Erstellen eines Team Webs mit MkDocs bietet viele thematische Facetten und eine einfache Lernkurve, die sich auf zukünftige Projekte übertragen lassen, z.B.:</p>
<ul>
<li>Das Arbeiten mit dem Terminal.</li>
<li>Der Umgang mit Python, Virtual Environments, sowie dem Paketmanager <code>pip</code>.</li>
<li>Das Arbeiten mit Visual Studio Code.</li>
<li>Das Arbeiten mit einem lokalen Entwicklungs-Server.</li>
<li>Das Erlernen von Markdown, das weit verbreitet Anwendung im Weltnetz findet.</li>
<li>Grundsätzliche Funktionsweisen von Static Site Generators.</li>
<li>Das Erstellen von Dokumentationen jenseits von gruseligen Bloatware-Anwendungen wie Microsoft Word.</li>
</ul>
</li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Blechbauteile</title>
      <link>https://jbetzen.net/posts/ilogic-sheetmetal/</link>
      <pubDate>Wed, 26 Apr 2023 21:43:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-sheetmetal/</guid>
      <description>Blechbauteile haben in Inventor eine eigene Konstruktionsumgebung die blechspezifische Funktionen und Features bereitstellt. Dazu gehören Abwicklungen und die Abwicklungsabmaße, die mit iLogic erzeugt und ausgelesen werden können.</description>
      <content:encoded><![CDATA[ <p>Wie bereits im Post <a href="/posts/ilogic-documenttypes/">iLogic: Dokumententypen</a> erwähnt, stellen Blechteile eine Sonderform des <code>PartDocument</code> dar.</p>
<p>Blechteile besitzen im Inventor eine eigene Modellierungsumgebung, Features und Konzepte. Für nachfolgende ERP-Systeme sind oftmals die Maße der Abwicklung und die eingesetzte Stärke des Blechs relevant. Diese können leicht unter der Hilfenahme von iLogic und der Inventor API ermittelt und in ein Custom iProperty geschrieben werden.</p>
<p><strong>Im folgenden zeige ich wie man:</strong></p>
<ul>
<li>Blechbauteile eindeutig identifiziert</li>
<li>prüft, ob im Dokument bereits eine Abwicklung vorhanden ist und falls nicht</li>
<li>eine Abwicklung mit iLogic erstellt</li>
<li>die Abmaße der Abwicklung (<em>Flat Pattern Extents</em>) ermittelt</li>
<li>die Stärke des Blechs ausliest</li>
<li>aus der Stärke und den Abmessungen einen kombinierten String erstellt und in ein Custom Property schreibt</li>
</ul>
<p>Als Beispielbauteil dient ein einfach gelaschtes Blechteil mit Laschenlängen von <code>120mm</code> und <code>220mm</code>, die beidseitig über eine Länge von <code>480mm</code> ausgetragen wurde. Die Blechstärke wurde mit <code>5mm</code> angesetzt.</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-example.png"
    alt="Screenshot of example sheet metal part">
</figure>



<h2 class="relative group">Blechteile identifizieren
    <div id="blechteile-identifizieren" class="anchor"></div>
    
</h2>
<p>Blechteile können nicht direkt über den <code>DocumentType</code> ermittelt, sondern lediglich über die <code>DocumentSubTypeID</code> eindeutig identifiziert werden. Für Blechbauteile lautet diese ID <code>{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}</code> und kann in der API unter <code>oDoc.DocumentSubType.DocumentSubTypeID</code> ausgelesen werden.</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-subtypeid.png"
    alt="API Overview Location for DocumentSubType">
</figure>


<p>Mit dieser Information können über eine simple If-Schleife ausschließlich Blechbauteile im Code adressiert werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentSubType</span><span class="p">.</span><span class="n">DocumentSubTypeID</span> <span class="o">=</span> <span class="s">&#34;{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}&#34;</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">   <span class="c">&#39;  Hier kommt der Code hin, der im Blechteil laufen soll
</span></span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>

<h2 class="relative group">Prüfen, ob Abwicklung bereits vorhanden
    <div id="prüfen-ob-abwicklung-bereits-vorhanden" class="anchor"></div>
    
</h2>
<p>Ob bereits eine Abwicklung in einem Dokument vorhanden ist, lässt sich optisch leicht dem Modellbrowser entnehmen. Ist dort der Eintrag <code>Flat Pattern</code> vorhanden, wurde bereits im Blechteil eine Abwicklung erstellt. Diese kann beispielsweise direkt in einer Zeichnungsansicht verwendet werden.</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-flatpattern-modelbrowser.png"
    alt="Screenshot of sheet metal part example">
</figure>


<p>Auch die API bietet ein bool&rsquo;sches Property an, mit dem das Vorhandensein einer Abwicklung ermittelt werden kann. Die ist zu finden unter <code>oDoc.ComponentDefinition.HasFlatPattern</code>. Der Wert des Properties ist ein Boolean und kann demnach nur die Werte <code>True</code> und <code>False</code> annehmen. Ist der Wert <code>True</code>, ist eine Abwicklung im Dokument vorhanden.</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-hasflatpattern.png"
    alt="API Overview Location HasFlatPattern Property">
</figure>



<h2 class="relative group">Abwicklung mit iLogic erstellen
    <div id="abwicklung-mit-ilogic-erstellen" class="anchor"></div>
    
</h2>
<p>Die Information, ob bereits eine Abwicklung vorhanden ist, kann nun genutzt werden um diese automatisch zu erstellen, sofern sie noch nicht vorhanden ist. Dazu kann eine Subroutine geschrieben werden, die folgendermaßen aussieht und folgendes tut:</p>
<ol>
<li>Prüfung, ob Abwicklung vorhanden ist und wenn nicht..</li>
<li>&hellip;erstelle die Abwicklung mittels der Methode <code>Unfold()</code></li>
<li>wechsle aus der Abwicklungsansicht zurück in das &ldquo;gefaltete&rdquo; Modell mittels der Methode <code>FlatPattern.ExitEdit()</code></li>
<li>Update das Part, um alle Änderungen in das Blechbauteil zu übertragen mit dem iLogic Shortcut <code>InventorVb.DocumentUpdate()</code></li>
</ol>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">ErstelleAbwicklung</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oSheetMetalCompDef</span> <span class="ow">As</span> <span class="n">SheetMetalComponentDefinition</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">ComponentDefinition</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">HasFlatPattern</span><span class="p">()</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Eine Abwicklung ist bereits vorhanden.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Eine Abwicklung ist nicht vorhanden und wird erstellt.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">Unfold</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">        <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">FlatPattern</span><span class="p">.</span><span class="n">ExitEdit</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Aktualisiere das Blechteil nach Abwicklungserstellung
</span></span></span><span class="line"><span class="cl">        <span class="n">InventorVb</span><span class="p">.</span><span class="n">DocumentUpdate</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Näheres zum strukturellen Aufbau einer iLogic, Funktionen und Subroutinen wurde bereits im Post <a href="/posts/ilogic-struktur/">iLogic: Struktureller Aufbau</a> ausführlich beschrieben.</p>

<h2 class="relative group">Abwicklungsdimensionen ermitteln
    <div id="abwicklungsdimensionen-ermitteln" class="anchor"></div>
    
</h2>
<p>Zur Ermittlung der abgewickelten Dimensionen ist es <strong>zwingend</strong> erforderlich, dass im Bauteil bereits eine Abwicklung vorhanden ist.</p>
<p>Zusätzlich gilt es immer zu bedenken, dass die Inventor API intern mit dem Längenmaß <code>cm</code> als Einheit arbeitet, die im Engineering eher untypisch ist und in <code>mm</code> konvertiert werden muss. Dies wurde bereits im Post <a href="/posts/ilogic-uom/">iLogic: Units of Measurement</a> erläutert. Zur Umrechnung kommt auch an dieser Stelle die Methode <code>ConvertUnits()</code> zum Einsatz.</p>

<h3 class="relative group">Abgewickelte Länge und Breite
    <div id="abgewickelte-länge-und-breite" class="anchor"></div>
    
</h3>
<p>Zur Verfügung stehen zwei Properties mit den Namen <code>Width</code>und <code>Length</code>. Beide sind vom Datentyp <code>Double</code> und in der API unter <code>oDoc.ComponentDefinition.FlatPattern</code> zu finden.</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-api-flatpatternextents.png"
    alt="API Overview Location for Length and Width Properties">
</figure>


<p>Wie man im Screenshot im Wert <code>Width</code> gut erkennen kann, haben <em>Double Precision Values</em> potentiell viele Nachkommastellen. Bei Blechteilen ist es in der Regel so, dass auf den nächst höheren Ganzzahlwert gerundet wird, um sicherzustellen, dass nicht zu wenig Ausgangsmaterial des Bleches bestellt wird. Daher schleichen sich bei vielen Nachkommastellen potentiell Fehler bei Rundungen ein, wenn bspw. ein Breitenwert von <code>0.00000000001</code> vorhanden ist auf den nächst höheren Ganzzahlwert <code>1</code> gerundet wird. Dies gilt es zu berücksichtigen und abzufangen.</p>

<h3 class="relative group">Blechstärke ermitteln
    <div id="blechstärke-ermitteln" class="anchor"></div>
    
</h3>
<p>Die Blechtstärke besitzt in der API ein eigenes Property <code>Thickness</code>, ebenfalls vom Typ <code>Double</code>, das unter <code>oDoc.ComponentDefinition.Thickness</code> zur Verfügung steht.</p>
<p>Dieses Property ist <strong>ausschließlich</strong> bei Blech- und nicht bei Standardbauteilen verfügbar und Teil der <code>SheetMetalComponentDefinition</code>.</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-thickness.png"
    alt="API Overview Location for Thickness Property">
</figure>



<h3 class="relative group">Dimensionen in Property schreiben
    <div id="dimensionen-in-property-schreiben" class="anchor"></div>
    
</h3>
<p>Wenn Blechstärke, Länge und Breite bekannt sind können diese leicht in die Einheit <code>mm</code> konvertiert, zu einem kombinierten String zusammengefügt und in ein Property geschrieben werden. Auch hierfür kommt eine eigene Subroutine zum Einsatz, die folgendes tut:</p>
<ol>
<li>Blechstärke, Länge und Breite der Abwicklung ermitteln</li>
<li>Die ermittelten Werte von <code>cm</code> in <code>mm</code> konvertiert und auf eine Nachkommastelle gerundet.</li>
<li>Länge und Breite werden auf ganzzahlige Millimeter aufgerundet.</li>
<li>Es wird ein kombinierter String erstellt mit dem Schema <code>Blech Stärke x Länge x Breite</code>.</li>
<li>Der kombinierte String wird in ein Custom Property mit dem Namen <code>Blechabmessungen</code> geschrieben.</li>
</ol>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">ErmittleAbwicklungsdimensionen</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oSheetMetalCompDef</span> <span class="ow">As</span> <span class="n">SheetMetalComponentDefinition</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">ComponentDefinition</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">UOM</span> <span class="ow">As</span> <span class="n">UnitsOfMeasure</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">UnitsOfMeasure</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oFlatPattern</span> <span class="ow">As</span> <span class="n">FlatPattern</span> <span class="o">=</span> <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="o">**</span><span class="n">FlatPattern</span><span class="o">**</span>
</span></span><span class="line"><span class="cl">    
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dThickness</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">Thickness</span><span class="p">.</span><span class="n">Value</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dFlatPatternLength</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Length</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dFlatPatternWidth</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Width</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dThickness</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">dThickness</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Konvertiere cm in mm und runde Millimeterangaben auf eine Nachkommastelle
</span></span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternLength</span> <span class="o">=</span> <span class="n">Round</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Length</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">),</span> <span class="n">1</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternWidth</span> <span class="o">=</span> <span class="n">Round</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Width</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">),</span> <span class="n">1</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Rund auf nächst höheren Ganzzahlwert
</span></span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternWidth</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">dFlatPatternWidth</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternLength</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">dFlatPatternLength</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Erstelle kombinierten String mit dem Schema: Stärke x Länge x Breite
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sCombinedString</span> <span class="ow">As</span> <span class="kt">String</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="n">sCombinedString</span> <span class="o">=</span> <span class="s">&#34;Blech &#34;</span> <span class="o">&amp;</span> <span class="n">dThickness</span> <span class="o">&amp;</span> <span class="s">&#34; x &#34;</span> <span class="o">&amp;</span> <span class="n">dFlatPatternLength</span> <span class="o">&amp;</span> <span class="s">&#34; x &#34;</span> <span class="o">&amp;</span> <span class="n">dFlatPatternWidth</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Schreibe kombinierten String in ein Custom Property mit dem Namen &#34;Blechabmessungen&#34;
</span></span></span><span class="line"><span class="cl">    <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;Blechabmessungen&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="n">sCombinedString</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Blechabmessungen: &#34;</span> <span class="o">&amp;</span> <span class="n">sCombinedString</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>

<h2 class="relative group">Vollständiges Codebeispiel
    <div id="vollständiges-codebeispiel" class="anchor"></div>
    
</h2>
<p>Es kann nun in einer iLogic eine Hauptroutine erstellt werden, die im ersten Schritt prüft, ob es sich um ein Blechbauteil handelt und anschließend beide Subroutinen aufruft:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentSubType</span><span class="p">.</span><span class="n">DocumentSubTypeID</span> <span class="o">=</span> <span class="s">&#34;{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}&#34;</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">ErstelleAbwicklung</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">        <span class="n">ErmittleAbwicklungsdimensionen</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">ErstelleAbwicklung</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oSheetMetalCompDef</span> <span class="ow">As</span> <span class="n">SheetMetalComponentDefinition</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">ComponentDefinition</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">HasFlatPattern</span><span class="p">()</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Eine Abwicklung ist bereits vorhanden.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">Logger</span><span class="p">.</span><span class="n">Warn</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Eine Abwicklung ist nicht vorhanden und wird erstellt.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">Unfold</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">        <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">FlatPattern</span><span class="p">.</span><span class="n">ExitEdit</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Update Document, nach Erzeugung der Blechabwicklung
</span></span></span><span class="line"><span class="cl">        <span class="n">InventorVb</span><span class="p">.</span><span class="n">DocumentUpdate</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">ErmittleAbwicklungsdimensionen</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oSheetMetalCompDef</span> <span class="ow">As</span> <span class="n">SheetMetalComponentDefinition</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">ComponentDefinition</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">UOM</span> <span class="ow">As</span> <span class="n">UnitsOfMeasure</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">UnitsOfMeasure</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oFlatPattern</span> <span class="ow">As</span> <span class="n">FlatPattern</span> <span class="o">=</span> <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="o">**</span><span class="n">FlatPattern</span><span class="o">**</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dThickness</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oSheetMetalCompDef</span><span class="p">.</span><span class="n">Thickness</span><span class="p">.</span><span class="n">Value</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dFlatPatternLength</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Length</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dFlatPatternWidth</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Width</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">dThickness</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">dThickness</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Konvertiere cm in mm und runde Millimeterangaben auf eine Nachkommastelle
</span></span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternLength</span> <span class="o">=</span> <span class="n">Round</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Length</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">),</span> <span class="n">1</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternWidth</span> <span class="o">=</span> <span class="n">Round</span><span class="p">(</span><span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">oFlatPattern</span><span class="p">.</span><span class="n">Width</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">),</span> <span class="n">1</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Rund auf nächst höheren Ganzzahlwert
</span></span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternWidth</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">dFlatPatternWidth</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">dFlatPatternLength</span> <span class="o">=</span> <span class="n">Ceil</span><span class="p">(</span><span class="n">dFlatPatternLength</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Erstelle kombinierten String mit dem Schema: Stärke x Länge x Breite
</span></span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">sCombinedString</span> <span class="ow">As</span> <span class="kt">String</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="n">sCombinedString</span> <span class="o">=</span> <span class="s">&#34;Blech &#34;</span> <span class="o">&amp;</span> <span class="n">dThickness</span> <span class="o">&amp;</span> <span class="s">&#34; x &#34;</span> <span class="o">&amp;</span> <span class="n">dFlatPatternLength</span> <span class="o">&amp;</span> <span class="s">&#34; x &#34;</span> <span class="o">&amp;</span> <span class="n">dFlatPatternWidth</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Schreibe kombinierten String in ein Custom Property mit dem Namen &#34;Blechabmessungen&#34;
</span></span></span><span class="line"><span class="cl">    <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;Blechabmessungen&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="n">sCombinedString</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34; | &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | Blechabmessungen: &#34;</span> <span class="o">&amp;</span> <span class="n">sCombinedString</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Der iLogic Log zeigt bei Ausführung des Codes die ermittelten Werte an:</p>


  

<figure class="centered"><img src="/posts/ilogic-sheetmetal/sheetmetal-logger.png"
    alt="Screenshot of iLogic Log Output">
</figure>


<p>Wer mehr über die Logging Funktionalität von iLogic erfahren möchte kann den vorangegangenen Post <a href="/posts/ilogic-logger/">iLogic: Logging</a> lesen.</p>

<h2 class="relative group">Links
    <div id="links" class="anchor"></div>
    
</h2>
<ul>
<li><a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-SheetMetalComponentDefinition"  target="_blank" rel="noreferrer">Inventor API: SheetMetalComponentDefinition</a></li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Propertysets</title>
      <link>https://jbetzen.net/posts/ilogic-propertysets/</link>
      <pubDate>Mon, 07 Nov 2022 19:50:27 +0100</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-propertysets/</guid>
      <description>Jedes Konstruktionsdokument in Inventor enthält vier Propertysets, die Konstruktionsdaten oder benutzerdefinierte Daten enthalten und auf die Mittels iLogic zugegriffen werden kann. iLogic bietet die Möglichkeit zur Manipulation der Werte.</description>
      <content:encoded><![CDATA[ <p>iProperties sind wie Key-Value-Stores zu betrachten. Ein iProperty hat eine Bezeichnung und einen zugehörigen Wert. Der Wert kann dabei vom Typ String, Boolean, Date oder ein Zahlenwert sein. Grundsätzlich wird zwischen 4 Propertysets unterschieden:</p>
<ol>
<li>Inventor Summary Information</li>
<li>Inventor Document Summary Information</li>
<li>Design Tracking Properties</li>
<li>Inventor User Defined Properties</li>
</ol>
<p>Die ersten 3 Sets sind von Autodesk Definiert. Im konstruktiven Alltag spielt hauptsächlich das 4. Set, die <strong>Inventor User Defined Properties</strong> - auch <strong>Custom Properties</strong> genannt - eine Rolle. Diese sind frei zuweisbar, hängen stets direkt am Konstruktionsdokument und sind essentiell für den Übertrag in Folgesysteme wie ERP.</p>

<h2 class="relative group">Propertysets
    <div id="propertysets" class="anchor"></div>
    
</h2>
<p>Das jeweilige Propertyset kann in einer Datei im Inventor aufgerufen werden, indem man einen Sekundärklick auf das geöffnete Konstruktionsdokument ausführt und den Eintrag <code>iProperties</code> auswählt.</p>
<p>Im Folgenden die einzelnen Propertysets und deren Bezeichnungen:</p>

<h3 class="relative group">Inventor Summary Information
    <div id="inventor-summary-information" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th style="text-align: left">Property Name</th>
					<th style="text-align: left">Type</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td style="text-align: left">Author</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Comments</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Keywords</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Last Saved By</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Thumbnail</td>
					<td style="text-align: left">IPictureDisp</td>
			</tr>
			<tr>
					<td style="text-align: left">Revision Number</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Subject</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Title</td>
					<td style="text-align: left">String</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Inventor Document Summary Information
    <div id="inventor-document-summary-information" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th style="text-align: left">Property Name</th>
					<th style="text-align: left">Type</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td style="text-align: left">Category</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Company</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Manager</td>
					<td style="text-align: left">String</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Design Tracking Properties
    <div id="design-tracking-properties" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th style="text-align: left">Property Name</th>
					<th style="text-align: left">Type</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td style="text-align: left">Authority</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Catalog Web Link</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Categories</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Checked By</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Cost</td>
					<td style="text-align: left">Currency</td>
			</tr>
			<tr>
					<td style="text-align: left">Cost Center</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Creation Time</td>
					<td style="text-align: left">Date</td>
			</tr>
			<tr>
					<td style="text-align: left">Date Checked</td>
					<td style="text-align: left">Date</td>
			</tr>
			<tr>
					<td style="text-align: left">Defer Updates</td>
					<td style="text-align: left">Boolean</td>
			</tr>
			<tr>
					<td style="text-align: left">Description</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Design Status</td>
					<td style="text-align: left">Long</td>
			</tr>
			<tr>
					<td style="text-align: left">Designer</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Document SubType</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Document SubType Name</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Engineer</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Engr Approved By</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Engr Date Approved</td>
					<td style="text-align: left">Date</td>
			</tr>
			<tr>
					<td style="text-align: left">External Property Revision Id</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Language</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Manufacturer</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Material</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Mfg Approved By</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Mfg Date Approved</td>
					<td style="text-align: left">Date</td>
			</tr>
			<tr>
					<td style="text-align: left">Parameterized Template</td>
					<td style="text-align: left">Boolean</td>
			</tr>
			<tr>
					<td style="text-align: left">Part Icon</td>
					<td style="text-align: left">IPictureDisp</td>
			</tr>
			<tr>
					<td style="text-align: left">Part Number</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Part Property Revision Id</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Project</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Proxy Refresh Date</td>
					<td style="text-align: left">Date</td>
			</tr>
			<tr>
					<td style="text-align: left">Size Designation</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Standard</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Standard Revision</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Standards Organization</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Stock Number</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Template Row</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">User Status</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Vendor</td>
					<td style="text-align: left">String</td>
			</tr>
			<tr>
					<td style="text-align: left">Weld Material</td>
					<td style="text-align: left">String</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Inventor User Defined Properties
    <div id="inventor-user-defined-properties" class="anchor"></div>
    
</h3>
<p>Dieses Set an Properties kann frei zugewiesen werden. Ein paar Beispielhafte Einträge:</p>


  

<figure class="centered"><img src="/posts/ilogic-propertysets/propset-custom.png">
</figure>



<h2 class="relative group">iLogic Shortcuts
    <div id="ilogic-shortcuts" class="anchor"></div>
    
</h2>
<p>Grundsätzlich kann über iLogic sehr komfortabel auf iProperties zugegriffen werden. Das Grundschema sieht so aus:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Set Name in iLogic&#34;</span><span class="p">,</span> <span class="s">&#34;Property Name&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Zu beachten ist, dass auch die Bezeichnungen der Sets eigene Kurzformen haben. Diese lauten:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Set Name</th>
					<th>Set Name in iLogic</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Inventor Summary Information</td>
					<td>Summary</td>
			</tr>
			<tr>
					<td>Inventor Document Summary Information</td>
					<td>Project</td>
			</tr>
			<tr>
					<td>Design Tracking Properties</td>
					<td>Design</td>
			</tr>
			<tr>
					<td>Inventor User Defined Properties</td>
					<td>Custom</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Beispiel
    <div id="beispiel" class="anchor"></div>
    
</h3>
<p>Folgende Properties sollen anhand des Beispiels im folgenden Screenshot ausgelesen und in eine Variable gespeichert werden. Anschließend wird der Wert der Variable über den Logger, der im vorangegangenen Post <a href="/posts/ilogic-logger/">iLogic: Logging</a> vorgestellt wurde, ausgegeben:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Property Name</th>
					<th>Set</th>
					<th>Value</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Author</td>
					<td>Summary</td>
					<td>D.Hasselhoff</td>
			</tr>
			<tr>
					<td>Description</td>
					<td>Project</td>
					<td>Ein Schalter, der kippt.</td>
			</tr>
			<tr>
					<td>Partnumber</td>
					<td>Design</td>
					<td>420</td>
			</tr>
			<tr>
					<td>LED</td>
					<td>Custom</td>
					<td>12 Volt</td>
			</tr>
	</tbody>
</table>
</div>


  

<figure class="centered"><img src="/posts/ilogic-propertysets/propset-example.png">
</figure>


<p>Zu sehen ist, dass direkt über den iLogic Shortcut und dem entsprechenden Reiternamen auf das gewünschte Property und dessen Wer zugegriffen werden kann:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">Author</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Summary&#34;</span><span class="p">,</span> <span class="s">&#34;Author&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">Description</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Project&#34;</span><span class="p">,</span> <span class="s">&#34;Description&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">Partnumber</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Status&#34;</span><span class="p">,</span> <span class="s">&#34;Part Number&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">LED</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;LED&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Author: &#34;</span> <span class="o">&amp;</span> <span class="n">Author</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Description: &#34;</span> <span class="o">&amp;</span> <span class="n">Description</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;Part Number: &#34;</span> <span class="o">&amp;</span> <span class="n">Partnumber</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;LED Version: &#34;</span> <span class="o">&amp;</span> <span class="n">LED</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Ergebnis:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-propertysets/propset-example-result.png">
</figure>



<h2 class="relative group">Links
    <div id="links" class="anchor"></div>
    
</h2>
<ul>
<li><a href="https://modthemachine.typepad.com/my_weblog/2010/02/accessing-iproperties.html"  target="_blank" rel="noreferrer">Mod the machine: Accessing iProperties</a></li>
<li><a href="https://knowledge.autodesk.com/de/support/inventor-products/learn-explore/caas/CloudHelp/cloudhelp/2015/DEU/Inventor-Help/files/GUID-8CAEA21E-A604-4D0A-8F06-3FA5B693CE6B-htm.html"  target="_blank" rel="noreferrer">iProperties-Funktionen in iLogic</a></li>
<li><a href="https://adndevblog.typepad.com/manufacturing/2018/04/accessing-iproperties-through-ilogic-code.html"  target="_blank" rel="noreferrer">Accessing iProperties through iLogic code</a></li>
<li><a href="https://modthemachine.typepad.com/files/ipropertiesandparameters.pdf"  target="_blank" rel="noreferrer">Inventor API: Exploring iProperties and Parameters</a></li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: iLogic, VBA, VB.NET</title>
      <link>https://jbetzen.net/posts/ilogic-010-ilogic-vba-vbnet/</link>
      <pubDate>Thu, 22 Sep 2022 15:44:18 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-010-ilogic-vba-vbnet/</guid>
      <description>Auf der Suche nach iLogic Code findet häufig die Begriffe VBA, VB.NET oder auch einfach iLogic. Doch was ist damit genau gemeint? Was hat iLogic mit VB.NET zu tun und wie unterscheidet es sich von VBA? Wie trennt man diese Begriffe von einander?</description>
      <content:encoded><![CDATA[ 
<h2 class="relative group">VBA - Das Urgestein
    <div id="vba---das-urgestein" class="anchor"></div>
    
</h2>
<p>Im ersten Post dieser Serie <a href="/posts/ilogic-basics/">iLogic: Erste Schritte mit der Inventor API</a> wurde bereits ein VBA-Code vorgestellt. VBA steht für <em>Visual Basic for Applications</em> und ist eine Programmiersprache, die aus dem Ökosystem der Microsoft Office Anwendungen entsprungen ist. VBA-Code wird in einem eigens dafür kreierten Editor geschrieben, dem VBE-Editor (Visual Basic Environment). Im ersten Post wurde auch bereits erläutert, dass man mit dem Shortcut <kbd>ALT</kbd> + <kbd>F11</kbd> diesen Editor starten kann. Dies Funktioniert in allen Office Anwendungen aus dem Hause Microsoft.</p>
<p>Mit VBA haben viele Konstrukteure im Studium erste Berührung. Am Häufigsten wird es im Zusammenspiel mit Microsoft Excel gelehrt und in der Regel sind es freudenlose Aufgabenstellungen für Probleme, die niemand im Arbeitsleben wiederfindet. VBA ist eine alte Programmiersprache aus dem Jahre 1993 und gerade <em>in Puncto</em> Error Handling eine nicht hinnehmbare Zumutung. Das hat auch Microsoft erkannt und die Sprache mit dem letzten Release <em>VBA 6</em> den Tabellenknechten des Strafplaneten Excel überlassen und sich entschlossen fortwährend VB.NET zuzuwenden.</p>

<h2 class="relative group">VB.NET - Die Weiterentwicklung
    <div id="vbnet---die-weiterentwicklung" class="anchor"></div>
    
</h2>
<p>Während VBA auszog, um eine einheitliche Programmierumgebung innerhalb der Office-Anwendungen zu bieten, ist VB.net eine mächtigere Programmiersprache. Sie kann auch außerhalb vom VBA-Editor verwendet und in <em>standalone EXE</em> Files kompiliert werden. VB.net kann VBA gänzlich ersetzen und bietet viele Vorteile und erweiterten Funktionsumfang, bspw. in der Gestaltung von Steuerelementen oder der Handhabung von Fehlern. Ein anschauliches Beispiel aus dem <a href="/posts/ilogic-user-interactions/" >Post über Benutzerinteraktionen</a> sind Messageboxes. VBA bietet lediglich die Möglichkeit einen Titel und einen Messagebody zu senden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Titel&#34;</span><span class="p">,</span> <span class="s">&#34;Messagebody&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p>VB.net hingegen erlaubt zusätzlich noch die Definition von Icons, Buttons mit Default-Belegung, etc., wie im vorangegangenen Post <a href="/posts/ilogic-user-interaction/">iLogic: User Interaktion</a> vorgestellt wurde. Der iLogic Editor, der ebenfalls bereits im Post <a href="/posts/ilogic-editor/">iLogic: Der Editor</a> vorgestellt wurde, kann ebenfalls VB.net ausführen. Auch kann beliebig VB.net und iLogic Code in diesem Editor kombiniert werden.</p>

<h2 class="relative group">iLogic - Ein VB.NET Subset
    <div id="ilogic---ein-vbnet-subset" class="anchor"></div>
    
</h2>
<p>Was genau ist also iLogic? iLogic ist ein sogenanntes <em>Subset</em> von VB.net. Eine Sammlung nützlicher spezifischer <em>Shortcuts</em>, die explizit die Handhabung und Funktionalität von Inventor betreffen. Diese Shortcuts bieten erleichtert Zugang zu den Funktionalitäten der Inventor API.</p>
<p>Ein paar Beispiele, die iLogic und die API-Variante gegenüberstellen:</p>

<h3 class="relative group">iProperties
    <div id="iproperties" class="anchor"></div>
    
</h3>
<p>In iLogic kann ein <em>Custom</em> iPoperty mit dem beispielhaften Namen <code>Titel</code> sehr einfach ausgelesen werden.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="c">&#39; iLogic
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">Titel</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">iProperties</span><span class="p">.</span><span class="n">Value</span><span class="p">(</span><span class="s">&#34;Custom&#34;</span><span class="p">,</span> <span class="s">&#34;Titel&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; API Variante
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">Titel</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">PropertySets</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="s">&#34;Inventor User Defined Properties).Item(&#34;</span><span class="n">Titel</span><span class="s">&#34;).Value</span></span></span></code></pre></div></div>

<h3 class="relative group">Zugriff auf Zeichnungsmodelle
    <div id="zugriff-auf-zeichnungsmodelle" class="anchor"></div>
    
</h3>
<p>In iLogic kann einfach auf das Modelldokument einer Zeichnung zugegriffen werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="c">&#39; iLogic
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oModelDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDrawing</span><span class="p">.</span><span class="n">ModelDocument</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; API Variante
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oModelDoc</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ReferencedFiles</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">1</span><span class="p">)</span></span></span></code></pre></div></div>

<h2 class="relative group">Links
    <div id="links" class="anchor"></div>
    
</h2>
<ul>
<li><a href="https://software-solutions-online.com/vba-vs-vb-net/"  target="_blank" rel="noreferrer">VBA vs VB.NET</a></li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: User Interaktion</title>
      <link>https://jbetzen.net/posts/ilogic-user-interaction/</link>
      <pubDate>Sun, 18 Sep 2022 10:43:23 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-user-interaction/</guid>
      <description>iLogic bietet die Nutzung grafischer Elemente, die dem User präsentiert werden und abhängig von einer User-Auswahl die Logik des Codes beeinflussen können. In diesem Post werden MsgBox, InputBox, etc. erläutert.</description>
      <content:encoded><![CDATA[ <p>In den vorherigen Posts <a href="/posts/ilogic-logger/">iLogic: Logging</a> und <a href="/posts/ilogic-progressbar/">iLogic: Progressbar</a> wurden zwei Methoden vorgestellt, um dem Anwender Ausgaben zu präsentieren. Mit dem User in Interaktion treten kann man über <em>Logger</em> und <em>Progressbars</em> jedoch nicht. Für interaktive Abfragen stehen weitere grafische Elemente zur Verfügung. Basierend auf einer User-Auswahl, kann somit auch Einfluss auf die Ausführung des Codes einer iLogic genommen werden.</p>

<h2 class="relative group">MessageBox
    <div id="messagebox" class="anchor"></div>
    
</h2>
<p>Eine Messagebox kann mit dem Befehl <code>MessageBox.Show()</code> aufgerufen werden. Die Methode erwartet nur einen Pflichtparameter und zwar den <em>Message Body</em>. Alle anderen Parameter sind optional.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">MessageBox</span><span class="p">.</span><span class="n">Show</span><span class="p">(</span><span class="s">&#34;Message Body&#34;</span><span class="p">,</span> <span class="s">&#34;Title&#34;</span><span class="p">,</span> <span class="n">MessageBoxButtons</span><span class="p">.</span><span class="n">OKCancel</span><span class="p">,</span> <span class="n">MessageBoxIcon</span><span class="p">.</span><span class="n">Information</span><span class="p">,</span> <span class="n">MessageBoxDefaultButton</span><span class="p">.</span><span class="n">Button2</span><span class="p">)</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/messagebox-basic.png"
    alt="Beispiel einer Messagebox">
</figure>


<p>Die einzelnen Parameter, in Reihenfolge der Klammeranweisung, erläutert:</p>
<table>
	<thead>
			<tr>
					<th>Parameter</th>
					<th>Erläuterung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Message Body</td>
					<td>Der Text, der in der Messagebox ausgegeben werden soll.</td>
			</tr>
			<tr>
					<td>Title</td>
					<td>Der Titel, der in der Statusbar der Messagebox dargestellt wird.</td>
			</tr>
			<tr>
					<td>MessageBoxButtons</td>
					<td>Die Auswahl, welche Buttons in der Messagebox angezeigt werden sollen.</td>
			</tr>
			<tr>
					<td>MessageBoxIcon</td>
					<td>Die Auswahl, welches Icon in der Messagebox angezeigt werden soll.</td>
			</tr>
			<tr>
					<td>MessageBoxDefaultButton</td>
					<td><p>Die Auswahl, welcher Button als <em>Default</em> aktiviert sein soll, abhängig von der Auswahl <code>MessageBoxButtons</code>.</p><p>Button <kbd>OK</kbd> im obigen Beispiel entspräche <code>Button1</code>. <kbd>Abbrechen</kbd> entspräche <code>Button2</code>.</p></td>
			</tr>
	</tbody>
</table>

<h3 class="relative group">Icons
    <div id="icons" class="anchor"></div>
    
</h3>
<p>Es stehen folgende vier Icons zur Auswahl. Einige haben doppelte und dreifache Bezeichnungen. Die fettgedruckten Werte werden für alle Beispiele in folgenden Posts verwendet:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th style="text-align: center">Icon Grafik</th>
					<th>Bezeichnung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td style="text-align: center">
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-icons/messagebox-asterisk.png"
          alt=""
        />
  
  
  </figure></td>
					<td>Asterisk, <strong>Information</strong></td>
			</tr>
			<tr>
					<td style="text-align: center">
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-icons/messagebox-error.png"
          alt=""
        />
  
  
  </figure></td>
					<td><strong>Error</strong>, Hand, Stop</td>
			</tr>
			<tr>
					<td style="text-align: center">
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-icons/messagebox-exclamation.png"
          alt=""
        />
  
  
  </figure></td>
					<td>Exclamation, <strong>Warning</strong></td>
			</tr>
			<tr>
					<td style="text-align: center">
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-icons/messagebox-question.png"
          alt=""
        />
  
  
  </figure></td>
					<td><strong>Question</strong></td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Buttons
    <div id="buttons" class="anchor"></div>
    
</h3>
<p>Es stehen folgende sechs Button-Darstellungen zur Verfügung:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Button Darstellung</th>
					<th>Bezeichnung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-buttons/btn-abortretryignore.png"
          alt=""
        />
  
  
  </figure></td>
					<td>AbortRetryIgnore</td>
			</tr>
			<tr>
					<td>
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-buttons/btn-ok.png"
          alt=""
        />
  
  
  </figure></td>
					<td>OK</td>
			</tr>
			<tr>
					<td>
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-buttons/btn-okcancel.png"
          alt=""
        />
  
  
  </figure></td>
					<td>OKCancel</td>
			</tr>
			<tr>
					<td>
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-buttons/btn-retrycancel.png"
          alt=""
        />
  
  
  </figure></td>
					<td>RetryCancel</td>
			</tr>
			<tr>
					<td>
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-buttons/btn-yesno.png"
          alt=""
        />
  
  
  </figure></td>
					<td>YesNo</td>
			</tr>
			<tr>
					<td>
<figure>
        <img
          class="my-0 rounded-md"
          src="/posts/ilogic-user-interaction/msgbox-buttons/btn-yesnocancel.png"
          alt=""
        />
  
  
  </figure></td>
					<td>YesNoCancel</td>
			</tr>
	</tbody>
</table>
</div>
<p>Es stehen folgende <a href="https://learn.microsoft.com/de-de/office/vba/language/reference/user-interface-help/msgbox-constants#msgbox-return-values"  target="_blank" rel="noreferrer">Rückgabewerte</a> für das Klicken auf einen Button zur Verfügung. Diese Rückgabewerte können genutzt werden um Entscheidungslogiken im iLogic Code zu steuern:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Rückgabe</th>
					<th>Beschreibung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>vbOK</td>
					<td><kbd>OK</kbd> wurde geklickt</td>
			</tr>
			<tr>
					<td>vbCancel</td>
					<td><kbd>Abbrechen</kbd> wurde geklickt</td>
			</tr>
			<tr>
					<td>vbAbort</td>
					<td><kbd>Beenden</kbd> wurde geklickt</td>
			</tr>
			<tr>
					<td>vbRetry</td>
					<td><kbd>Wiederholen</kbd> wurde geklickt</td>
			</tr>
			<tr>
					<td>vbIgnore</td>
					<td><kbd>Ignorieren</kbd> wurde geklickt</td>
			</tr>
			<tr>
					<td>vbYes</td>
					<td><kbd>Ja</kbd> wurde geklickt</td>
			</tr>
			<tr>
					<td>vbNo</td>
					<td><kbd>Nein</kbd> wurde geklickt</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Interaktion bei Button-Klick
    <div id="interaktion-bei-button-klick" class="anchor"></div>
    
</h3>
<p>Erzeugt man eine Messagebox und fordert den User damit zu einer interaktiven Eingabe auf, kann in iLogic ausgelesen welcher Button geklickt wurde (Rückgabewerte) und daraufhin Code ausführen.</p>
<p>Im folgenden fiktiven Beispiel wird eine Situation aus dem Post <a href="/posts/ilogic-bom/">iLogic: Stücklisten</a> aufgegriffen:</p>
<ol>
<li>Der User bearbeitet eine Baugruppe und vergisst die Strukturstückliste zu aktivieren.</li>
<li>Die ilogic prüft, ob die Strukturstückliste aktiviert ist. Wenn dies nicht der Fall ist, wird eine Messagebox erzeugt.</li>
<li>Klickt der User auf den Button <kbd>OK</kbd> wird die Strukturstückliste aktiviert.</li>
</ol>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">bStrucutredViewEnabled</span> <span class="ow">As</span> <span class="kt">Boolean</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOM</span><span class="p">.</span><span class="n">StructuredViewEnabled</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">bStrucutredViewEnabled</span> <span class="o">=</span> <span class="k">False</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">question</span> <span class="o">=</span> <span class="n">MessageBox</span><span class="p">.</span><span class="n">Show</span><span class="p">(</span><span class="s">&#34;Die Strukturstuecklistenansicht ist nicht aktiviert. Soll sie aktiviert werden?&#34;</span><span class="p">,</span> <span class="s">&#34;StructuredView aktivieren?&#34;</span><span class="p">,</span> <span class="n">MessageBoxButtons</span><span class="p">.</span><span class="n">OKCancel</span><span class="p">,</span> <span class="n">MessageBoxIcon</span><span class="p">.</span><span class="n">Warning</span><span class="p">,</span> <span class="n">MessageBoxDefaultButton</span><span class="p">.</span><span class="n">Button1</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">question</span> <span class="o">=</span> <span class="n">vbOK</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOM</span><span class="p">.</span><span class="n">StructuredViewEnabled</span> <span class="o">=</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/messagebox-example-bom.gif">
</figure>



<h2 class="relative group">InputBox
    <div id="inputbox" class="anchor"></div>
    
</h2>
<p>Eine <em>Inputbox</em> erwarten, wie auch die <em>Messagebox</em>, Eingangsparameter. Diese sind analog ein <em>Message Body</em>, ein Titel und ein Parameter für einen <em>Default</em>-Wert:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">InputBox</span><span class="p">(</span><span class="s">&#34;Message Body&#34;</span><span class="p">,</span> <span class="s">&#34;Title&#34;</span><span class="p">,</span> <span class="s">&#34;Default Entry&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Beispiel für die Verwendung einer InputBox:</strong></p>
<ol>
<li>Als Basismodell dient ein einfacher Zylinder mit einer modellierten Fase. Die Fase hat eine Größe von <code>5mm</code> und den Modellparameternamen <code>d3</code>.</li>
<li>Eine InputBox soll erscheinen und den User interaktiv nach der Größe der Fase fragen.</li>
<li>Nach der Eingabe eines Größenwerts, wird die Eingabe an den Parameter <code>d3</code> übergeben.</li>
<li>Das Modell wird anschließend neu aufgebaut, um die Änderung der Fasengröße darzustellen.</li>
</ol>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/inputbox-chamfer-example.png">
</figure>


<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">Parameter</span><span class="p">(</span><span class="s">&#34;d3&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="n">InputBox</span><span class="p">(</span><span class="s">&#34;Wähle die Dimension der Fase.&#34;</span><span class="p">,</span> <span class="s">&#34;Fase&#34;</span><span class="p">,</span> <span class="n">5</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">Rebuild</span><span class="p">()</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/inputbox-chamfer-example.gif">
</figure>



<h2 class="relative group">InputListBox
    <div id="inputlistbox" class="anchor"></div>
    
</h2>
<p><em>InputListBox</em> ist quasi gleichzusetzen mit der <em>InputBox</em>, jedoch bietet sie eine vordefinierte Liste aus auswählbaren Einträgen an.</p>
<p><strong>Beispiel für die Verwendung einer <em>InputListBox</em>:</strong><br>
Ein liebevoll modelliertes Toastbrot erhält ein Prägungs-Feature, das stellvertretend für den Aufschnitt steht. Eine Prägung (<em>Emboss</em>) erfordert eine Skizze - in diesem Fall der Textblock - und eine Fläche auf dem diese platziert wird. Der Textwert des Aufschnitts ist in der API unter <code>ComponentDefinition.Sketches</code> zu finden. In meinem Fall war der Endpunkt unter <code>ComponentDefinition.Sketches.Item(2).TextBoxes.Item(1).Text</code> zu erreichen. Es wird eine Liste mit verfügbaren Aufschnitten erzeugt. Anschließend wird die <em>InputListBox</em> aufgerufen und die Auswahl in einen String gewandelt, da sonst nur ein Index zurückgegeben würde. Die Auswahl wird anschließend an die Prägungsskizze übergeben. Da es sich, wie schon im Beispiel zuvor, um eine Änderung der Modellgeometrie handelt muss als letzter Befehl <code>ThisDoc.Document.Rebuild()</code> gesendet werden, um das Modell neu aufzubauen.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oSketches</span> <span class="ow">As</span> <span class="n">PlanarSketches</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">Sketches</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">listAufschnitt</span> <span class="o">=</span> <span class="k">New</span> <span class="kt">String</span><span class="p">(){</span><span class="s">&#34;Wurst&#34;</span><span class="p">,</span> <span class="s">&#34;Käse&#34;</span><span class="p">,</span> <span class="s">&#34;Mett&#34;</span><span class="p">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">aufschnitt</span> <span class="o">=</span> <span class="n">InputListBox</span><span class="p">(</span><span class="s">&#34;Wählen Sie!&#34;</span><span class="p">,</span> <span class="n">listAufschnitt</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oSketches</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">2</span><span class="p">).</span><span class="n">TextBoxes</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">1</span><span class="p">).</span><span class="n">Text</span> <span class="o">=</span> <span class="n">aufschnitt</span><span class="p">.</span><span class="n">ToString</span>
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">Rebuild</span><span class="p">()</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/inputlistbox-example-toast.gif">
</figure>



<h2 class="relative group">InputRadioBox
    <div id="inputradiobox" class="anchor"></div>
    
</h2>
<p>Eine <em>InputRadioBox</em> bietet die Möglichkeit aus zwei gelisteten Werten zu entscheiden. Die Grundstruktur ist einfach beschrieben. Geliefert wird ein <em>bool&rsquo;scher</em> Rückgabewert. Der Parameter <code>True</code> besagt, ob gegen die erste (<code>True</code>) oder zweite (<code>False</code>) Auswahlmöglichkeit geprüft wird.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">bResult</span> <span class="o">=</span> <span class="n">InputRadioBox</span><span class="p">(</span><span class="s">&#34;Prompt&#34;</span><span class="p">,</span> <span class="s">&#34;Button1 Label&#34;</span><span class="p">,</span> <span class="s">&#34;Button2 Label&#34;</span><span class="p">,</span> <span class="k">True</span><span class="p">,</span> <span class="n">Title</span> <span class="p">:</span><span class="o">=</span><span class="s">&#34;Title&#34;</span><span class="p">)</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/inputradiobox-basic.png"
    alt="Beispiel InputRadioBox">
</figure>


<p><strong>Ein Beispiel für die Verwendung einer InputRadioBox:</strong><br>
Ein modellierter Donut hat zwei Modellparameter:  <strong>Donutgrösse:</strong>, also der Durchmesser des Donuts und <strong>Teigquerschnitt:</strong>, also Durchmesser der Teigfläche.</p>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/inputradiobox-example-donut-params.png">
</figure>


<p>Es wird eine <em>InputRadioBox</em> ausgegeben, die erfragt wie groß der Hunger ist. Es besteht die Auswahl zwischen einem kleinen und einem großen Donut. Basierend auf der Wahl werden die Parameter <em>Donutgröße</em> und <em>Teigquerschnitt</em> angepasst und das Modell neu aufgebaut:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">bResult</span> <span class="o">=</span> <span class="n">InputRadioBox</span><span class="p">(</span><span class="s">&#34;Wie groß ist der Hunger?&#34;</span><span class="p">,</span> <span class="s">&#34;Kleiner Donut!&#34;</span><span class="p">,</span> <span class="s">&#34;Großer Donut!&#34;</span><span class="p">,</span> <span class="k">True</span><span class="p">,</span> <span class="n">Title</span> <span class="p">:</span><span class="o">=</span><span class="s">&#34;Wähle einen Donut&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">bResult</span> <span class="o">=</span> <span class="k">True</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">Parameter</span><span class="p">(</span><span class="s">&#34;Donutgrösse&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="s">&#34;50mm&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="n">Parameter</span><span class="p">(</span><span class="s">&#34;Teigquerschnitt&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="s">&#34;30mm&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">Else</span>
</span></span><span class="line"><span class="cl">    <span class="n">Parameter</span><span class="p">(</span><span class="s">&#34;Donutgrösse&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="s">&#34;80mm&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="n">Parameter</span><span class="p">(</span><span class="s">&#34;Teigquerschnitt&#34;</span><span class="p">)</span> <span class="o">=</span> <span class="s">&#34;50mm&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">Rebuild</span><span class="p">()</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-user-interaction/inputradiobox-example-donut.gif">
</figure>



<h2 class="relative group">Links
    <div id="links" class="anchor"></div>
    
</h2>
<ul>
<li><a href="https://knowledge.autodesk.com/support/inventor-products/learn-explore/caas/CloudHelp/cloudhelp/2014/ENU/Inventor/files/GUID-1A217E8E-FE3A-4E84-9926-8E11C81D60D9-htm.html"  target="_blank" rel="noreferrer">Message Box functions in iLogic reference</a></li>
<li><a href="https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.messageboxicon?redirectedfrom=MSDN&amp;view=windowsdesktop-6.0#remarks"  target="_blank" rel="noreferrer">Messagebox Icons</a></li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Progressbar</title>
      <link>https://jbetzen.net/posts/ilogic-progressbar/</link>
      <pubDate>Sat, 17 Sep 2022 10:42:49 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-progressbar/</guid>
      <description>Fortschrittsanzeigen (Progressbars) können als eigenständige Fenster oder in der Statusleiste von Inventors ausgegeben werden und den User darüber informieren, wie viel Zeit oder Schritte eine Operation in Anspruch nimmt.</description>
      <content:encoded><![CDATA[ <p>Im vorherigen Post <a href="/posts/ilogic-logger/">iLogic: Logging</a> wurde bereits die <em>iLogic Log</em>-Funktionalität vorgestellt, die <em>Log Statements</em> in einem eigenen Tab ausgeben kann. Mit der <em>Progressbar</em> steht eine weitere Möglichkeit zur Verfügung dem Anwender auskunft über laufende iLogic Prozesse zu geben. <em>Progressbars</em> nutzen kein Dokumentenobjekt, sondern direkt Inventor und werden entweder unten Links im Hauptfenster angezeigt oder als eigenständiges Fenster ausgegeben.</p>

<h2 class="relative group">Anatomie einer Progressbar
    <div id="anatomie-einer-progressbar" class="anchor"></div>
    
</h2>
<p>Progressbars müssen eingangs deklariert werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oProgressBar</span> <span class="ow">As</span> <span class="n">Inventor</span><span class="p">.</span><span class="n">ProgressBar</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">CreateProgressBar</span><span class="p">(</span><span class="k">True</span><span class="p">,</span> <span class="n">10</span><span class="p">,</span> <span class="s">&#34;Titel&#34;</span><span class="p">,)</span></span></span></code></pre></div></div>
<p>Es werden drei Pflicht-Parameter erwartet. Zusätzlich stehen zwei weitere optionale Anweisungen zur Verfügung. Die optionalen angaben sind in der Tabelle mit einem <code>*</code> gekennzeichnet. In ihrer Reihenfolge in der Klammerangabe lauten diese:</p>
<table>
	<thead>
			<tr>
					<th>Parameter</th>
					<th>Typ</th>
					<th>Erläuterung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>1</td>
					<td>Boolean</td>
					<td>Dieser Wert gibt an, ob die Ausgabe in der Statusbar (<code>True</code>) oder in einem eigenen dedizierten Fenster (<code>False</code>) erfolgen soll.</td>
			</tr>
			<tr>
					<td>2</td>
					<td>Integer</td>
					<td>Anzahl der Schritte, die durchlaufen werden sollen.</td>
			</tr>
			<tr>
					<td>3</td>
					<td>String</td>
					<td>Der Titel der Progressbar</td>
			</tr>
			<tr>
					<td>4*</td>
					<td>Boolean</td>
					<td>Optionale Angabe, ob ein <em>Cancel</em>-Button dargestellt werden soll (<code>True</code>) oder ob dieser entfallen soll (<code>True</code>).</td>
			</tr>
			<tr>
					<td>5*</td>
					<td>Integer</td>
					<td>Eine Referenz auf das Dialogfeld, die die Progressbar ausgelöst hat. Funktioniert nur, wenn Parameter 1 auf <code>False</code> gesetzt wird.</td>
			</tr>
	</tbody>
</table>

<h2 class="relative group">Progressbar als eigenes Fenster
    <div id="progressbar-als-eigenes-fenster" class="anchor"></div>
    
</h2>
<p>Ein gutes Beispiel für eine <em>Progressbar</em> in dediziertem Fenster liefert Autodesk auf der eigenen <a href="https://knowledge.autodesk.com/support/inventor/learn-explore/caas/simplecontent/content/create-use-progressbar-within-ilogic-rule.html"  target="_blank" rel="noreferrer">Homepage</a>. Das Beispiel von Autodesk nutzt <em>Threading</em> um eine Pause von einer Sekunde zwischen den einzelnen Fortschrittsschritten zu erzielen. Es werden 10 Schritte für einen vollen Fortschritt definiert und diese, beginnend beim Wert 1, durchiteriert:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">iSteps</span> <span class="ow">As</span> <span class="kt">Integer</span> <span class="o">=</span> <span class="n">10</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oProgressBar</span> <span class="ow">As</span> <span class="n">Inventor</span><span class="p">.</span><span class="n">ProgressBar</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">CreateProgressBar</span><span class="p">(</span><span class="k">False</span><span class="p">,</span> <span class="n">iSteps</span><span class="p">,</span> <span class="s">&#34;Beispiel: Progressbar&#34;</span><span class="p">,</span> <span class="k">True</span><span class="p">,)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Startmeldung definieren
</span></span></span><span class="line"><span class="cl"><span class="n">oProgressBar</span><span class="p">.</span><span class="n">Message</span> <span class="o">=</span> <span class="s">&#34;Starting a process...&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="n">iStep</span> <span class="ow">As</span> <span class="kt">Integer</span> <span class="o">=</span> <span class="n">1</span> <span class="k">To</span> <span class="n">iSteps</span>
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Beschreibung oder Update der Beschreibung des aktuellen Schritts
</span></span></span><span class="line"><span class="cl">    <span class="n">oProgressBar</span><span class="p">.</span><span class="n">Message</span> <span class="o">=</span> <span class="s">&#34;Processing Step &#34;</span> <span class="o">&amp;</span> <span class="n">iStep</span> <span class="o">&amp;</span> <span class="s">&#34; of &#34;</span> <span class="o">&amp;</span> <span class="n">iSteps</span>
</span></span><span class="line"><span class="cl">    <span class="n">System</span><span class="p">.</span><span class="n">Threading</span><span class="p">.</span><span class="n">Thread</span><span class="p">.</span><span class="n">Sleep</span><span class="p">(</span><span class="k">New</span> <span class="n">TimeSpan</span><span class="p">(</span><span class="n">0</span><span class="p">,</span><span class="n">0</span><span class="p">,</span><span class="n">1</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Progressbar-Fortschritt updaten
</span></span></span><span class="line"><span class="cl">    <span class="n">oProgressBar</span><span class="p">.</span><span class="n">UpdateProgress</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oProgressBar</span><span class="p">.</span><span class="n">Message</span> <span class="o">=</span> <span class="s">&#34;Processing Finished&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Nachdem alle Schritte erfolgt sind, wird die Progress Bar geschlossen
</span></span></span><span class="line"><span class="cl"><span class="n">oProgressBar</span><span class="p">.</span><span class="n">Close</span></span></span></code></pre></div></div>
<p><strong>Das Ergebnis:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-progressbar/progressbar.gif"
    alt="Beispiel Progressbar">
</figure>



<h2 class="relative group">Progressbar in Statusleiste
    <div id="progressbar-in-statusleiste" class="anchor"></div>
    
</h2>
<p>Das gleiche Beispiel kann auch verwendet werden, um eine <em>Progressbar</em> unten am Inventor-Fenster anzuzeigen. Es muss lediglich die Code-Zeile angepasst werden, die die Progressbar initialisiert.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">iSteps</span> <span class="ow">As</span> <span class="kt">Integer</span> <span class="o">=</span> <span class="n">10</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oProgressBar</span> <span class="ow">As</span> <span class="n">Inventor</span><span class="p">.</span><span class="n">ProgressBar</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">CreateProgressBar</span><span class="p">(</span><span class="k">True</span><span class="p">,</span> <span class="n">iSteps</span><span class="p">,</span> <span class="s">&#34;Beispiel: Progressbar&#34;</span><span class="p">,</span> <span class="k">True</span><span class="p">,)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Startmeldung definieren
</span></span></span><span class="line"><span class="cl"><span class="n">oProgressBar</span><span class="p">.</span><span class="n">Message</span> <span class="o">=</span> <span class="s">&#34;Starting a process...&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">For</span> <span class="n">iStep</span> <span class="ow">As</span> <span class="kt">Integer</span> <span class="o">=</span> <span class="n">1</span> <span class="k">To</span> <span class="n">iSteps</span>
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Beschreibung oder Update der Beschreibung des aktuellen Schritts
</span></span></span><span class="line"><span class="cl">    <span class="n">oProgressBar</span><span class="p">.</span><span class="n">Message</span> <span class="o">=</span> <span class="s">&#34;Processing Step &#34;</span> <span class="o">&amp;</span> <span class="n">iStep</span> <span class="o">&amp;</span> <span class="s">&#34; of &#34;</span> <span class="o">&amp;</span> <span class="n">iSteps</span>
</span></span><span class="line"><span class="cl">    <span class="n">System</span><span class="p">.</span><span class="n">Threading</span><span class="p">.</span><span class="n">Thread</span><span class="p">.</span><span class="n">Sleep</span><span class="p">(</span><span class="k">New</span> <span class="n">TimeSpan</span><span class="p">(</span><span class="n">0</span><span class="p">,</span><span class="n">0</span><span class="p">,</span><span class="n">1</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="c">&#39; Progressbar-Fortschritt updaten
</span></span></span><span class="line"><span class="cl">    <span class="n">oProgressBar</span><span class="p">.</span><span class="n">UpdateProgress</span>
</span></span><span class="line"><span class="cl"><span class="k">Next</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oProgressBar</span><span class="p">.</span><span class="n">Message</span> <span class="o">=</span> <span class="s">&#34;Processing Finished&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Nachdem alle Schritte erfolgt sind, wird die Progress Bar geschlossen
</span></span></span><span class="line"><span class="cl"><span class="n">oProgressBar</span><span class="p">.</span><span class="n">Close</span></span></span></code></pre></div></div>
<p><strong>Das Ergebnis:</strong></p>


  

<figure class="centered"><img src="/posts/ilogic-progressbar/progressbar-statusbar.gif"
    alt="Beispiel Progressbar Statusbar">
</figure>



<h2 class="relative group">Links
    <div id="links" class="anchor"></div>
    
</h2>
<ul>
<li><a href="https://clintbrown.co.uk/2019/02/22/progressbar/"  target="_blank" rel="noreferrer">iLogic: Hacking the Progress Bar</a></li>
<li><a href="https://knowledge.autodesk.com/support/inventor/learn-explore/caas/simplecontent/content/create-use-progressbar-within-ilogic-rule.html"  target="_blank" rel="noreferrer">Create &amp; Use A ProgressBar Within An iLogic Rule</a></li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Logging</title>
      <link>https://jbetzen.net/posts/ilogic-logger/</link>
      <pubDate>Fri, 16 Sep 2022 23:57:35 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-logger/</guid>
      <description>Inventor stellt mit dem iLogic Log ein nützliches Werkzeug bereit, das bei Code Ausführung Log-Messages ausgeben und das Debuggen von iLogic Code erleichtern kann. Dieser Post zeigt Beispiele, wie man den Log und die verschiedenen Log Level verwenden kann.</description>
      <content:encoded><![CDATA[ <p>Neben dem <em>Model Browser</em> stellt Inventor einen eigenen Tab zur Einsicht des <em>iLogic Log</em> bereit. In dieser Umgebung können <em>Log Statements</em> während der Ausführung von einer iLogic eingesehen werden:</p>


  

<figure class="centered"><img src="/posts/ilogic-logger/ilogiclog.png"
    alt="iLogic Log Fenster aktivieren">
</figure>



<h2 class="relative group">Logger Settings
    <div id="logger-settings" class="anchor"></div>
    
</h2>
<p>Logging Funktionen unterstützen naturgemäß verschiedene Level. Es gibt Logstatements, die lediglich zur Information dienen, aber auch kritischere Statements, die ggf, die Aufmerksam und das Eingreifen des Users erfordern. Unter <code>Tools &gt; Options &gt; iLogic Configuration</code> kann der <em>Log Level</em> definiert werden. Die Einträge sind hierarchisch zu betrachten und loggen stets nur alle <em>Level</em>, die <strong>unter</strong> dem gewählten Levels verortet sind.</p>
<p><strong>Die verfügbaren Log Level lauten:</strong></p>
<ul>
<li><code>Trace</code></li>
<li><code>Debug</code></li>
<li><code>Info</code></li>
<li><code>Warn</code></li>
<li><code>Error</code></li>
<li><code>Fatal</code></li>
<li><code>None</code></li>
</ul>


  

<figure class="centered"><img src="/posts/ilogic-logger/ilogiclog-settings.png"
    alt="Einstellungen für den iLogic Log">
</figure>


<dl>
<dt><strong>Beispiel:</strong></dt>
<dd>Wählt man den <em>Log Level</em> <code>Info</code> aus, erscheinen <strong>keine</strong> Meldungen mit dem <em>Level</em> <code>Debug</code>und <code>Trace</code>. Es erscheinen lediglich Logs zu den Leveln <code>Info</code>, <code>Warn</code>, <code>Error</code>, <code>Fatal</code>und <code>None</code>.</dd>
</dl>

<h2 class="relative group">Log Statement erzeugen
    <div id="log-statement-erzeugen" class="anchor"></div>
    
</h2>
<p>Welchen <em>Log Level</em> einem <em>Log Statement</em> zugewiesen wird, legt der Nutzer in seinem iLogic Code selber fest. Um ein einfaches Log Statement zu erzeugen reicht folgendes Kommando:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="s">&#34;This is an info message shown in the logger.&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p>Natürlich können auch Variablen in Logstatements integriert werden. Auch bietet iLogic ein nützliches <em>Subset</em> an Funktionen, die ein Debuggen erleichtern können. Zwei dieser Funktionen sollen hiermit vorgestellt werden:</p>
<dl>
<dt><code>ThisDoc.Filename()</code></dt>
<dd>Gibt den Dateinamen aus, in dem der iLogic Code ausgeführt wird. Setzt man in den Klammern den Wert <code>True</code>, wird der gesamte Dateiname inkl. Dateiendung ausgegeben. Setzt man den Wert <code>False</code> wird auf die Dateiendung verzichtet.</dd>
<dt><code>iLogicVb.RuleName</code></dt>
<dd>Gibt den Namen der iLogic aus, die ausgeführt wird.</dd>
</dl>
<p>Kombiniert man diese beiden Funktionen und setzt diese direkt als erste Zeile in eine iLogic, kann man dem Logger entnehmen, ob die iLogic ausgeführt wurde und in welchem Dokument sie ausgeführt wurde. Für das folgende Beispiel wurde eine iLogic mit dem Dateinamen <code>00_DebugAndTesting.vb</code> erstellt:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="n">Logger</span><span class="p">.</span><span class="n">Info</span><span class="p">(</span><span class="n">iLogicVb</span><span class="p">.</span><span class="n">RuleName</span> <span class="o">&amp;</span> <span class="s">&#34;| &#34;</span> <span class="o">&amp;</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">FileName</span><span class="p">(</span><span class="k">True</span><span class="p">)</span> <span class="o">&amp;</span> <span class="s">&#34; | iLOGIC TRIGGERED&#34;</span><span class="p">)</span></span></span></code></pre></div></div>
<p><strong>Das Ergebnis:</strong>


  

<figure class="centered"><img src="/posts/ilogic-logger/log-example.png"
    alt="Beispiel Log Output">
</figure>

</p>

<h2 class="relative group">Links
    <div id="links" class="anchor"></div>
    
</h2>
<ul>
<li><a href="https://knowledge.autodesk.com/support/inventor-products/learn-explore/caas/CloudHelp/cloudhelp/2014/ENU/Inventor/files/GUID-1A217E8E-FE3A-4E84-9926-8E11C81D60D9-htm.html"  target="_blank" rel="noreferrer">Message Box functions in iLogic reference</a></li>
<li><a href="https://inventorfaq.blogspot.com/2018/09/inventor-20191-logging-in-ilogic-ilogic.html"  target="_blank" rel="noreferrer">Inventor 2019.1: Logging in iLogic (iLogic-Protokoll)</a></li>
<li><a href="https://knowledge.autodesk.com/support/inventor/learn-explore/caas/CloudHelp/cloudhelp/2019/ENU/Inventor-iLogic/files/GUID-BE996AA3-DE49-4765-86A7-129DD7B42A4A-htm.html"  target="_blank" rel="noreferrer">To Create Log Statements</a></li>
</ul>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Stücklisten</title>
      <link>https://jbetzen.net/posts/ilogic-bom/</link>
      <pubDate>Wed, 14 Sep 2022 14:02:41 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-bom/</guid>
      <description>Stücklistenstrukturen spielen sowohl in Bauteilen, als auch Baugruppen eine elementare Rolle. Baugruppen haben als übergeordnete Bauteilsammler zusätzlich noch Stücklistenansichten, die essentiell für nachfolgende ERP-Systeme sind. Dieser Post behandelt, wie Stücklistenstrukturen und Stücklistenansichten mittels der API definiert, aktiviert oder deaktiviert werden können.</description>
      <content:encoded><![CDATA[ <p>Im vorherigen Post <a href="/posts/ilogic-uom/">iLogic: Units of Measurement</a> wurde bereits auf die Dokumenteneinstellungen zu Maßeinheiten innerhalb von Dokumenten eingegangen. In diesem Post geht es um die Stücklisteneinstellungen, die ebenfalls Teil der Dokumenteneinstellungen sind.</p>

<h2 class="relative group">Bauteile und Baugruppen
    <div id="bauteile-und-baugruppen" class="anchor"></div>
    
</h2>
<p>Sowohl in Bauteilen, als auch Baugruppen, kann ein <a href="https://knowledge.autodesk.com/support/inventor/learn-explore/caas/CloudHelp/cloudhelp/2021/ENU/Inventor-Help/files/GUID-A0A95805-CBF6-4524-8314-4AC8B53C19CF-htm.html"  target="_blank" rel="noreferrer">Stücklistenstruktur</a> vorgegeben werden, die Einfluss darauf hat wie diese Bauteile in übergeordneten Baugruppen auf Stücklistenebene aufgelöst werden. Baugruppen selber können in dieser Einstellung ihre eigene Stücklistenauflösung definieren, die so <em>nach Oben</em> durchgereicht wird.</p>


  

<figure class="centered"><img src="/posts/ilogic-bom/bom-doc-settings.gif">
</figure>



<h3 class="relative group">Aktuelle Stücklistenstruktur auslesen
    <div id="aktuelle-stücklistenstruktur-auslesen" class="anchor"></div>
    
</h3>
<p>In der API steht die aktuell zugewiesene Stücklistenstruktur unter <code>ComponentDefinition.BOMStructure</code> zur Verfügung:</p>


  

<figure class="centered"><img src="/posts/ilogic-bom/compdef-bom-structure.png">
</figure>


<p>Umn diese auszulesen muss zuerst verstanden werden, wie die API und im speziellen der sogenannte <a href="https://help.autodesk.com/view/INVNTOR/2022/ENU/?guid=BOMStructureEnum"  target="_blank" rel="noreferrer"><code>BOMStructureEnum</code></a> funktioniert. Er liefert standardmäßig keinen sprechenden Namen zurück, wie bspw. <em>Phantom</em> order <em>Purchased</em>, sondern eine repräsentative 5-stellige Ziffernfolge:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Name GUI</th>
					<th>BOMStructureEnum</th>
					<th>Value</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Normal</td>
					<td>kNormalBOMStructure</td>
					<td>51970</td>
			</tr>
			<tr>
					<td>Phantom</td>
					<td>kPhantomBOMStructure</td>
					<td>51971</td>
			</tr>
			<tr>
					<td>Reference</td>
					<td>kReferenceBOMStructure</td>
					<td>51972</td>
			</tr>
			<tr>
					<td>Purchased</td>
					<td>kPurchasedBOMStructure</td>
					<td>51973</td>
			</tr>
			<tr>
					<td>Inseparable</td>
					<td>kInseparableBOMStructure</td>
					<td>51974</td>
			</tr>
			<tr>
					<td>-</td>
					<td>kDefaultBOMStructure</td>
					<td>51969</td>
			</tr>
			<tr>
					<td>-</td>
					<td>kVariesBOMStructure</td>
					<td>51975</td>
			</tr>
	</tbody>
</table>
</div>
<p>Diese Ziffernfolge kann in einer weiteren Variablen und der Methode <code>ToString</code> in ihren sprechenden Namen, bspw. <code>kNormalBOMStructure</code> umgewandelt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">currentBOMStructure</span> <span class="ow">As</span> <span class="n">BOMStructureEnum</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOMStructure</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">currentBOMStructureAsString</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">currentBOMStructure</span><span class="p">.</span><span class="n">ToString</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;BOM Structure Value is: &#34;</span> <span class="o">&amp;</span> <span class="n">currentBOMStructure</span> _
</span></span><span class="line"><span class="cl">        <span class="o">&amp;</span> <span class="n">vbLf</span> <span class="o">&amp;</span> _
</span></span><span class="line"><span class="cl">        <span class="s">&#34;BOM Structure String is: &#34;</span> <span class="o">&amp;</span> <span class="n">currentBOMStructureAsString</span><span class="p">,</span> _
</span></span><span class="line"><span class="cl">        <span class="n">MessageBoxButtons</span><span class="p">.</span><span class="n">OK</span><span class="p">,</span> _
</span></span><span class="line"><span class="cl">        <span class="s">&#34;Current BOM Structure&#34;</span><span class="p">)</span></span></span></code></pre></div></div>


  

<figure class="centered"><img src="/posts/ilogic-bom/msgbox-current-bom-structure.png">
</figure>


<p><strong>Tipp:</strong> Lange Code-Befehle (<em>Spaghetti Code</em>), wie bspw. der <code>MsgBox()</code>-AnweisungAufruf, können mit einem <em>Underscore</em> (<code>_</code>) in eine neue Zeile umgebrochen werden und so zur Lesbarkeit beitragen. Weiterführendes zum Thema <em>Messageboxes</em> ist im Post <a href="/posts/ilogic-user-interaction/">iLogic: User Interaktion</a> der Serie zu finden.</p>

<h3 class="relative group">Stücklistenstruktur im Dokument ändern
    <div id="stücklistenstruktur-im-dokument-ändern" class="anchor"></div>
    
</h3>
<p>Auch ein manipulieren und überschreiben der aktuellen Stücklistenstruktur ist mit dem <em>BOMStructureEnum</em> leicht möglich. Möchte man die Stückliste bspw. auf <em>Purchased</em> setzen, kann dies so erfolgen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOMStructure</span> <span class="o">=</span> <span class="n">BOMStructureEnum</span><span class="p">.</span><span class="n">kPurchasedBOMStructure</span></span></span></code></pre></div></div>

<h2 class="relative group">Stücklistenansichten in Baugruppen
    <div id="stücklistenansichten-in-baugruppen" class="anchor"></div>
    
</h2>
<p>Neben den Dokumenteneinstellungen zur Stückliste haben Baugruppen noch eine weitere Stücklistenfunktion: Stücklistenansichten. Es gibt drei an der Zahl:</p>
<dl>
<dt><strong>Model Data:</strong></dt>
<dd>Ist immer aktiv und kann nicht beeinflusst werden.</dd>
<dt><strong>Structured:</strong></dt>
<dd>Die Strukturstückliste, die sämtliche Stücklisteneinstellungen der Unterkomponenten aus ihren den Dokumenteneigenschaften widerspiegelt. Sie ist besonders wichtig für nachfolgende Systeme, wie bspw. <a href="https://www.autodesk.de/products/fusion-360-manage-with-upchain/overview?term=1-YEAR&amp;tab=subscription"  target="_blank" rel="noreferrer">Fusion 360 Manage</a>. Ist sie nicht aktiv, werden <em>keine</em> Stücklistenstrukturen ins PLM übertragen.</dd>
<dt><strong>Parts Only:</strong></dt>
<dd>Die reine Bauteilstückliste. Im Kern ist sie gleichzusetzen mit der Strukturstückliste, jedoch listet sie ausschließlich die stücklistenrelevanten Bauteile und das ohne Baugruppenebenen.</dd>
</dl>


  

<figure class="centered"><img src="/posts/ilogic-bom/bom-assembly.png">
</figure>



<h3 class="relative group">Stücklistenansichten aktivieren
    <div id="stücklistenansichten-aktivieren" class="anchor"></div>
    
</h3>
<p>Die API stellt Informationen zu den Stücklistenansichten unter <code>ComponentDefinitions.BOM</code> bereit. Darin befinden sich auch zwei Endpunkte vom Typ <code>Boolean</code> mit den Namen <code>PartsOnlyViewEnabled</code> und <code>StructuredViewEnabled</code>, die Auskunft darüber geben, ob diese aktiviert oder deaktiviert sind:</p>


  

<figure class="centered"><img src="/posts/ilogic-bom/bom-views-api.png">
</figure>


<p>Um nun die Stücklistenansichten zu aktivieren, muss lediglich der Wert <code>True</code> an diesen Endpunkten gesetzt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOM</span><span class="p">.</span><span class="n">PartsOnlyViewEnabled</span> <span class="o">=</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl"><span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">BOM</span><span class="p">.</span><span class="n">StructuredViewEnabled</span> <span class="o">=</span> <span class="k">True</span></span></span></code></pre></div></div>
<p>Zu beachten ist, dass eine Baugruppe in der Detailgenauigkeit <code>Master</code>, bzw. im Model State <code>Primary</code> geladen sein muss, um die Stückliste(n) zu aktivieren.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Units of Measurement</title>
      <link>https://jbetzen.net/posts/ilogic-uom/</link>
      <pubDate>Fri, 09 Sep 2022 23:29:58 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-uom/</guid>
      <description>Ungeachtet der in Dokumenten festgelegten Maßeinheiten, rechnet Inventor intern mit einem vordefinierten Satz an Basiseinheiten, die Default Database Units genannt werden. Wie man diese auslesen und konvertieren kann, wird in diesem Post erläutert.</description>
      <content:encoded><![CDATA[ <p>Jedes Dokument hat in Autodesk Inventor in seinen Dokumenteneinstellungen ein benutzerdefiniertes Set an Maßeinheiten (<em>Units of Measure</em>, kurz <em>UOM</em>), sowie Angaben zu deren Präzision hinterlegt. Werden bspw. <em>Inch</em> oder <em>Millimeter</em> für Längenangaben genutzt, werden der <em>Radiant</em> oder das <em>Gradmaß</em> verwendet oder Gewichtsangaben in <em>Gramm</em> oder <em>Kilogramm</em> angegeben. Diese Angaben dienen aber nur dem Nutzer, der die grafische Oberfläche von Inventor verwendet. Nutzt man bspw. die API um eine Länge von einem Bauteil zu berechnen, rechnet Inventor immer mit der internen Maßeinheit <em>Zentimeter</em>. Dies gilt es zu berücksichtigen, wenn man diese Werte ausliest und ggf. weiterverarbeitet. Die internet Bezeichnung für den Satz an Maßeinheiten der API lautet <em>DatabaseUnits</em>.</p>

<h2 class="relative group">Internal DatabaseUnits
    <div id="internal-databaseunits" class="anchor"></div>
    
</h2>
<p>Inventor nutzt zur internen Berechnung die folgenden Maßeinheiten. Sie werden <em>Internal Database Units (IDU)</em> genannt:</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Messtyp</th>
					<th>IDU</th>
					<th></th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Masse</td>
					<td>kg</td>
					<td>Kilogramm</td>
			</tr>
			<tr>
					<td>Länge / Distanz</td>
					<td>cm</td>
					<td>Zentimeter</td>
			</tr>
			<tr>
					<td>Zeit</td>
					<td>s</td>
					<td>Sekunden</td>
			</tr>
			<tr>
					<td>Temperatur</td>
					<td>K</td>
					<td>Kelvin</td>
			</tr>
			<tr>
					<td>Winkel</td>
					<td>rad</td>
					<td>Radiant</td>
			</tr>
			<tr>
					<td>Kraft</td>
					<td>N</td>
					<td>Newton</td>
			</tr>
			<tr>
					<td>Moment / Drehmoment</td>
					<td>Ncm</td>
					<td>Newton-Zentimeter</td>
			</tr>
			<tr>
					<td>Druck / Spannung</td>
					<td>N/cm²</td>
					<td>Newton pro Quadratzentimeter</td>
			</tr>
			<tr>
					<td>Energie</td>
					<td>J</td>
					<td>Joule</td>
			</tr>
			<tr>
					<td>Leistung</td>
					<td>W</td>
					<td>Watt</td>
			</tr>
			<tr>
					<td>Dichte</td>
					<td>g/cm³</td>
					<td>Gramm pro Kubikzentimeter</td>
			</tr>
			<tr>
					<td>Volumen</td>
					<td>cm³</td>
					<td>Kubikzentimeter</td>
			</tr>
			<tr>
					<td>Fläche</td>
					<td>cm²</td>
					<td>Quadratzentimeter</td>
			</tr>
			<tr>
					<td>Geschwindigkeit</td>
					<td>cm/s</td>
					<td>Zentimeter pro Sekunde</td>
			</tr>
			<tr>
					<td>Beschleunigung</td>
					<td>cm/s²</td>
					<td>Zentimeter pro Quadratsekunde</td>
			</tr>
	</tbody>
</table>
</div>
<p>Problematisch im Konstruktionswesen sind an dieser Stelle die Längenangaben in <em>Zentimeter</em>, da der <em>Millimeter</em> für Konstruktionsdaten als Goldstandard gilt, sowie das Winkelmaß als <em>Radiant</em>, das für den menschlichen Verstand nicht so gut greifbar ist, wie das Winkelmaß.</p>

<h2 class="relative group">Maßeinheiten und die API
    <div id="maßeinheiten-und-die-api" class="anchor"></div>
    
</h2>
<p>Die API stellt für das Arbeiten mit Maßeinheiten zwei wichtige Werkzeuge bereit:</p>
<ol>
<li>
<p>Das Objekt <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=GUID-UnitsOfMeasure"  target="_blank" rel="noreferrer"><strong>UnitsOfMeasure:</strong></a></p>
<p>Dieses Objekt hat die zugehöriger Methode zur Konvertierung von Einheiten und gleichzeitig die in den Dokumenteneinstellungen gesetzten Einheiten zum Auslesen und Manipulieren verfügbar.</p>
</li>
<li>
<p>Den Enum <a href="https://help.autodesk.com/view/INVNTOR/2024/ENU/?guid=UnitsTypeEnum"  target="_blank" rel="noreferrer"><strong>UnitTypeEnum:</strong></a></p>
<p>Mit diesem Enum kann bestimmt werden, um was für eine Einheitenangabe es sich handelt, bspw. um eine generelle Längenangabe, aber auch präziser um eine Längenangabe mit der Einheit <em>Millimeter</em>.</p>
</li>
</ol>

<h2 class="relative group">Beispiel zur Veranschaulichung
    <div id="beispiel-zur-veranschaulichung" class="anchor"></div>
    
</h2>
<p>Als praktisches Beispiel dient ein Zylinder mit einem Durchmesser <code>Ø25mm</code> und einer extrudierten Länge von <code>80mm</code>:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-uom/cylinder-dimensions-ui.png"
          alt=""
        />
  
  
  </figure>
<p>Das Zylinderbauteil hat in den Dokumenteneigenschaften die Maßeinheit <code>mm</code> für Längenangaben gesetzt:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-uom/doc-units-settings.png"
          alt=""
        />
  
  
  </figure>
<p>Eine Extrusion ist ein sogenanntes <em>Feature</em>. Features sind in der API unter dem Objekt <code>ComponentDefinition.Features</code> zu finden. Dort gibt es den Endpunkt <code>ExtrudeFeatures</code>, in dem alle Dimensionsparameter zu finden sind, die den Beispielzylinder beschreiben:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-uom/compdef-feat.png"
          alt=""
        />
  
  
  </figure>
<p>Unterhalb der <code>ExtrudeFeatures</code> gibt es den Abschnitt <code>Parameters</code>, der eine Liste mit allen geometriebeschreibenden Parametern vorhält. Der Durchmesser des Zylinder ist in dieser Liste <code>Item 1</code> und die ausgetragene Länge <code>Item 3</code>.</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-uom/cylinder-dimensions-api.png"
          alt=""
        />
  
  
  </figure>
<p>Als <code>Value</code> erkennt man auf dem Screenshot, dass die Werte <code>2,5</code> und <code>8</code> angegeben werden, obwohl <code>25mm</code> und <code>80mm</code> definiert wurden. <strong>Dies muss immer berücksichtigt werden, wenn ein solcher Wert ausgelesen und bspw. in einer Variable gespeichert und weiterverwendet wird.</strong></p>

<h2 class="relative group">Konvertierung von Maßeinheiten
    <div id="konvertierung-von-maßeinheiten" class="anchor"></div>
    
</h2>
<p>Als Beispiel für eine Maßeinheitenkonvertierung wird der Durchmesser des Zylinders gewählt. Dieser hat, wie bereits angemerkt, die Nummer <code>Item 1</code> in der Parameterliste der <em>ExtrudeFeatures</em>. Um den internen Wert <code>cm</code> nun in <code>mm</code> zu konvertieren wird zum einen  der <code>UnitsTypeEnum</code> benötigt und das <code>UnitsOfMeasure</code>-Objekt des Dokuments, dass die Methode <a href="https://help.autodesk.com/view/INVNTOR/2022/ENU/?guid=UnitsOfMeasure_ConvertUnits"  target="_blank" rel="noreferrer"><code>ConvertUnits()</code></a> bereitstellt.</p>
<p>Die Methode <code>ConvertUnits()</code> benötigt 3 Parameter:</p>
<ol>
<li>Einen Eingabewert, der konvertiert werden soll.</li>
<li>Ein Ausgangsmaßeinheit, von dem aus konvertiert werden soll. In diesem Fall ist es die interne <em>DatabaseUnit</em> für Längenangaben.</li>
<li>Ein Maßeinheit, in die konvertiert werden soll, also <code>mm</code>.</li>
</ol>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">UOM</span> <span class="ow">As</span> <span class="n">UnitsOfMeasure</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Auslesen des Zylinderdurchmessers
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">DiameterCylinder</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ComponentDefinition</span><span class="p">.</span><span class="n">Features</span><span class="p">.</span><span class="n">ExtrudeFeatures</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">1</span><span class="p">).</span><span class="n">Parameters</span><span class="p">.</span><span class="n">Item</span><span class="p">(</span><span class="n">1</span><span class="p">).</span><span class="n">Value</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c">&#39; Konvertierung in Millimeter
</span></span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">DiameterCylinderMillimeters</span> <span class="ow">As</span> <span class="kt">Double</span> <span class="o">=</span> <span class="n">UOM</span><span class="p">.</span><span class="n">ConvertUnits</span><span class="p">(</span><span class="n">DiameterCylinder</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDatabaseLengthUnits</span><span class="p">,</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Der Durchmesser beträgt intern: &#34;</span> <span class="o">&amp;</span> <span class="n">DiameterCylinder</span> <span class="o">&amp;</span> <span class="n">vbLf</span> <span class="o">&amp;</span> <span class="s">&#34;Der Durchmesser beträgt konvertiert: &#34;</span> <span class="o">&amp;</span> <span class="n">DiameterCylinderMillimeters</span><span class="p">,</span> <span class="n">MessageBoxButtons</span><span class="p">.</span><span class="n">OK</span><span class="p">,</span> <span class="s">&#34;Konvertierung&#34;</span><span class="p">)</span></span></span></code></pre></div></div>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-uom/msgbox-convert.PNG"
          alt=""
        />
  
  
  </figure>
<p><strong>Tipp:</strong> In einem späterem Post <a href="/posts/ilogic-user-interaction/">iLogic: User Interaktion</a> wird ausführlich auf die Verwendung von <em>MessageBoxes</em> eingegangen.</p>

<h2 class="relative group">Praxisbeispiel: Importierte CAD-Daten
    <div id="praxisbeispiel-importierte-cad-daten" class="anchor"></div>
    
</h2>
<p>Vor kurzem gab es in meinem Unternehmen folgende Situation:</p>
<ul>
<li>Ein externer Zulieferer importierte eine größere native Inventor Baugruppe.</li>
<li>Sämtliche Bauteile hatten in den Dokumenteneigenschaften einen abweichenden Satz an Maßeinheiten, konkret wurde <em>Meter</em>, statt <em>Millimeter</em> als Längeneinheit definiert.</li>
</ul>

<h3 class="relative group">Korrekturoption 1: Dokumentenebene
    <div id="korrekturoption-1-dokumentenebene" class="anchor"></div>
    
</h3>
<p>Diese Subroutine kann einfach als Trigger vor dem Speichern gesetzt werden und kontrolliert, ob die gewünschten Einheiten und Präzisionswerte vorhanden sind. Ist dies nicht der Fall werden sie korrigiert. Sie prüft und korrigiert nur in Bauteilen und Baugruppen, da Zeichnungen auf die Werte der dargestellten Dokumente zugreifen.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kPartDocumentObject</span> <span class="ow">Or</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">CheckAndSetUnits</span><span class="p">(</span><span class="n">oDoc</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">CheckAndSetUnits</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthDisplayPrecision</span> <span class="o">=</span> <span class="n">3</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDegreeAngleUnits</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleDisplayPrecision</span> <span class="o">=</span> <span class="n">2</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">MassUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kKilogramMassUnits</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">TimeUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kSecondTimeUnits</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Subroutine beenden, da Einheiten korrekt sind
</span></span></span><span class="line"><span class="cl">        <span class="k">Exit</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">    <span class="nf">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthDisplayPrecision</span> <span class="o">=</span> <span class="n">3</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDegreeAngleUnits</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleDisplayPrecision</span> <span class="o">=</span> <span class="n">2</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">MassUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kKilogramMassUnits</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">TimeUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kSecondTimeUnits</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>

<h3 class="relative group">Korrekturoption 2: Alle Unterkomponenten
    <div id="korrekturoption-2-alle-unterkomponenten" class="anchor"></div>
    
</h3>
<p>Alternativ zu einer <em>Trigger</em>-basierten Korrektur, kann auch die oberste Baugruppe geöffnet und eine iLogic manuell ausgeführt werden, die über die gesamten Unterkomponenten der Bauteile iteriert und jedes Teil dabei prüft und ggf. korrigiert. Dafür muss in der API das Objekt <code>ReferencedDocuments</code> verwendet werden. <em>ReferencedDocuments</em> beinhaltet Verweise auf sämtliche Dokumente, die in einer Baugruppe verbaut sind und auch auf den Basiseinheitensatz jedes verbauten Dokuments:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-uom/referenced-docs.png"
          alt="Screenshot API Referenced Documents"
        />
  
  
  </figure>
<p>Dies ist zugleich eine gute Möglichkeit eine nützliche Funktionalität kennenzulernen: Eine <code>For Each</code>-Schleife.</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDocRefs</span> <span class="ow">As</span> <span class="n">DocumentsEnumerator</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">ReferencedDocuments</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">For</span> <span class="k">Each</span> <span class="n">oDocRef</span> <span class="ow">In</span> <span class="n">oDocRefs</span>
</span></span><span class="line"><span class="cl">        <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kPartDocumentObject</span> <span class="ow">Or</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">            <span class="n">CheckAndSetUnits</span><span class="p">(</span><span class="n">oDocRef</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">    <span class="k">Next</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">CheckAndSetUnits</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthDisplayPrecision</span> <span class="o">=</span> <span class="n">3</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDegreeAngleUnits</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleDisplayPrecision</span> <span class="o">=</span> <span class="n">2</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">MassUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kKilogramMassUnits</span> _
</span></span><span class="line"><span class="cl">        <span class="ow">And</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">TimeUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kSecondTimeUnits</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">        <span class="c">&#39; Subroutine beenden, da Einheiten korrekt sind
</span></span></span><span class="line"><span class="cl">        <span class="k">Exit</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">    <span class="nf">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kMillimeterLengthUnits</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">LengthDisplayPrecision</span> <span class="o">=</span> <span class="n">3</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kDegreeAngleUnits</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">AngleDisplayPrecision</span> <span class="o">=</span> <span class="n">2</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">MassUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kKilogramMassUnits</span>
</span></span><span class="line"><span class="cl">        <span class="n">oDoc</span><span class="p">.</span><span class="n">UnitsOfMeasure</span><span class="p">.</span><span class="n">TimeUnits</span> <span class="o">=</span> <span class="n">UnitsTypeEnum</span><span class="p">.</span><span class="n">kSecondTimeUnits</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Dokumententypen</title>
      <link>https://jbetzen.net/posts/ilogic-documenttypes/</link>
      <pubDate>Thu, 08 Sep 2022 12:44:33 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-documenttypes/</guid>
      <description>Dokument ist nicht gleich Dokument. Eine Baugruppe ist keine Schweißbaugruppe. Ein Bauteil ist nicht zwangsweise ein Blechbauteil. Dieser Post handelt darüber, wie man Dokumententypen eindeutig identifiziert und adressiert.</description>
      <content:encoded><![CDATA[ <p>Im vorherigen Post <a href="/posts/ilogic-struktur/">iLogic: Struktureller Aufbau</a> konnte bereits Bekanntschaft mit zwei unterschiedlichen Dokumententypen gemacht werden: <code>kAssemblyDocumentObject</code> und <code>kDrawingDocumentObject</code>. Doch woher kommen diese Bezeichnungen und wie viele gibt es von ihnen? Dokumentiert sind diese Objekte auf der Autodesk Webseite zur <a href="https://help.autodesk.com/view/INVNTOR/2022/ENU/?guid=DocumentTypeEnum"  target="_blank" rel="noreferrer">Inventor API</a>.</p>

<h2 class="relative group">Documenttypes
    <div id="documenttypes" class="anchor"></div>
    
</h2>
<p>Zur Auswahl und Abfrage stehen folgende <code>DocumentTypes</code>. Relevant für die tägliche Arbeit als Konstrukteur sind allerdings nur die ersten drei, nämlich Bauteil, Baugruppe und technische Zeichnung.</p>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Name</th>
					<th>Value</th>
					<th>Beschreibung</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>kPartDocumentObject</td>
					<td>12290</td>
					<td>Part Document</td>
			</tr>
			<tr>
					<td>kAssemblyDocumentObject</td>
					<td>12291</td>
					<td>Assembly Document</td>
			</tr>
			<tr>
					<td>kDrawingDocumentObject</td>
					<td>12292</td>
					<td>Drawing Document</td>
			</tr>
			<tr>
					<td>kDesignElementDocumentObject</td>
					<td>12294</td>
					<td>Design Element Document</td>
			</tr>
			<tr>
					<td>kForeignModelDocumentObject</td>
					<td>12295</td>
					<td>Foreign Model Document</td>
			</tr>
			<tr>
					<td>kNestingDocument</td>
					<td>12298</td>
					<td>Nesting Document</td>
			</tr>
			<tr>
					<td>kNoDocument</td>
					<td>12297</td>
					<td>No Document</td>
			</tr>
			<tr>
					<td>kPresentationDocumentObject</td>
					<td>12293</td>
					<td>Presentation Document</td>
			</tr>
			<tr>
					<td>kSATFileDocumentObject</td>
					<td>12296</td>
					<td>SAT File Document</td>
			</tr>
			<tr>
					<td>kUnknownDocumentObject</td>
					<td>12289</td>
					<td>Unknown Document</td>
			</tr>
	</tbody>
</table>
</div>
<p>Dem geschulten Auge stellen sich sofort zwei Fragen:</p>
<ol>
<li>Wie unterscheide ich ein Standardbauteil von einem Blechbauteil?</li>
<li>Wie unterscheide ich eine Standardbaugruppe von einer Schweißbaugruppe?</li>
</ol>
<p>Um diese Fragen zu beantworten, stellt die Inventor API ein Property namens <a href="https://help.autodesk.com/view/INVNTOR/2022/ENU/?guid=Document_SubType"  target="_blank" rel="noreferrer"><code>DocumentSubType</code></a> zur Verfügung.</p>

<h2 class="relative group">DocumentSubTypes
    <div id="documentsubtypes" class="anchor"></div>
    
</h2>
<p>Sämtliche zur Verfügung stehenden <em>DocumentSubTypes</em> sind auf der <a href="https://knowledge.autodesk.com/search-result/caas/simplecontent/content/documentsubtype-list-common-name-inventors-name-cslid-inv-pro-2021-dev-tools.html"  target="_blank" rel="noreferrer">Autodesk Webseite</a> gelistet. <em>DocumentSubTypes</em> werden mit Hilfe von <a href="https://de.wikipedia.org/wiki/Globally_Unique_Identifier"  target="_blank" rel="noreferrer">GUIDs</a> angegeben. Das steht für <em>Global Unique Identitfier</em>. Diese GUID ist eine Zeichenfolge vom Typ <code>String</code>, die stellvertretend für einen Dokumententyp steht.</p>

<h3 class="relative group">Parts
    <div id="parts" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Common Name</th>
					<th>GUID</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Normal Part</td>
					<td>&ldquo;4D29B490-49B2-11D0-93C3-7E0706000000&rdquo;</td>
			</tr>
			<tr>
					<td>SheetMetal Part</td>
					<td>&ldquo;9C464203-9BAE-11D3-8BAD-0060B0CE6BB4&rdquo;</td>
			</tr>
			<tr>
					<td>Gereric Proxy</td>
					<td>&ldquo;92055419-B3FA-11D3-A479-00C04F6B9531&rdquo;</td>
			</tr>
			<tr>
					<td>Compatibility Proxy</td>
					<td>&ldquo;9C464204-9BAE-11D3-8BAD-0060B0CE6BB4&rdquo;</td>
			</tr>
			<tr>
					<td>Catalog Proxy</td>
					<td>&ldquo;9C88D3AF-C3EB-11D3-B79E-0060B0F159EF&rdquo;</td>
			</tr>
			<tr>
					<td>Molded Part</td>
					<td>&ldquo;4D8D80D4-F5B0-4460-8CEA-4CD222684469&rdquo;</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Assemblies
    <div id="assemblies" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Common Name</th>
					<th>GUID</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Normal Assembly</td>
					<td>&ldquo;E60F81E1-49B3-11D0-93C3-7E0706000000&rdquo;</td>
			</tr>
			<tr>
					<td>Welded Assembly</td>
					<td>&ldquo;28EC8354-9024-440F-A8A2-0E0E55D635B0&rdquo;</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Drawing
    <div id="drawing" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Common Name</th>
					<th>GUID</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Drawing Document</td>
					<td>&ldquo;BBF9FDF1-52DC-11D0-8C04-0800090BE8EC&rdquo;</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Design Element
    <div id="design-element" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Common Name</th>
					<th>GUID</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Design Element</td>
					<td>&ldquo;62FBB030-24C7-11D3-B78D-0060B0F159EF&rdquo;</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Presentations
    <div id="presentations" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Common Name</th>
					<th>GUID</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Normal Presentation</td>
					<td>&ldquo;76283A80-50DD-11D3-A7E3-00C04F79D7BC&rdquo;</td>
			</tr>
			<tr>
					<td>Composite Presentation</td>
					<td>&ldquo;A2B4C17D-F0D2-4C0F-9799-DD5F71DFB291&rdquo;</td>
			</tr>
	</tbody>
</table>
</div>

<h3 class="relative group">Design View Document
    <div id="design-view-document" class="anchor"></div>
    
</h3>
<div style="display:table; margin:auto">
<table>
	<thead>
			<tr>
					<th>Common Name</th>
					<th>GUID</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Design View Document</td>
					<td>&ldquo;81B95C5D-8E31-4F65-9790-CCF6ECABD141&rdquo;</td>
			</tr>
	</tbody>
</table>
</div>

<h2 class="relative group">Codebeispiele
    <div id="codebeispiele" class="anchor"></div>
    
</h2>
<p>Im folgenden ein paar Beispiele, die sowohl den <em>DocumentType</em> abfragen, als auch die GUID nutzen.</p>

<h3 class="relative group">Abfragen des DocumentTypes
    <div id="abfragen-des-documenttypes" class="anchor"></div>
    
</h3>
<p>Wer generell ermitteln möchte, ob es sich bei einem Dokument bspw. um ein Bauteil handelt, kann dies, wie im vorangegangenen Post <a href="/posts/ilogic-struktur/">iLogic: Struktureller Aufbau</a> beschrieben, folgendermaßen erreichen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kPartDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist ein Bauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Else</span>
</span></span><span class="line"><span class="cl">    <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist kein Bauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>
<p>Alternativ kann auch explizit der <em>DocumentTypeEnum</em> bei der Abfrage verwendet werden. Das Ergebnis ist das selbe:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">DocumentTypeEnum</span><span class="p">.</span><span class="n">kPartDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist ein Bauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Else</span>
</span></span><span class="line"><span class="cl">    <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist kein Bauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>
<p><strong>Faustformel:</strong> Möchte man lediglich <em>grob</em> Ermitteln, ob es sich bei einem Dokument bspw. um ein Bauteil, eine Baugruppe oder eine Zeichnung handelt, reicht eine Abfrage des <em>DocumentType</em>.</p>

<h3 class="relative group">Abfragen des DocumentSubTypes
    <div id="abfragen-des-documentsubtypes" class="anchor"></div>
    
</h3>
<p>Möchte man eine spezifischere Abfrage tätigen, die nicht nur prüft ob es sich bei einem Dokument bspw. um ein Bauteil, sondern explizit um ein Blechbauteil handelt, muss der <em>DocumentSubType</em> in Verbindung mit der GUID genutzt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">as</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oSubType</span> <span class="ow">as</span> <span class="kt">String</span> <span class="o">=</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentSubType</span><span class="p">.</span><span class="n">DocumentSubTypeID</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oSubType</span> <span class="o">=</span> <span class="s">&#34;{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}&#34;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="n">MessageBox</span> <span class="p">(</span><span class="s">&#34;Das Bauteil ist ein Blechbauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Else</span>
</span></span><span class="line"><span class="cl">    <span class="n">MessageBox</span> <span class="p">(</span><span class="s">&#34;Das Bauteil ist kein Blechbauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">if</span></span></span></code></pre></div></div>

<h2 class="relative group">Weitergedacht
    <div id="weitergedacht" class="anchor"></div>
    
</h2>
<p>Im vorherigen Post <a href="/posts/ilogic-struktur/">iLogic: Struktureller Aufbau</a> wurden Funktionen und Routinen vorgestellt. Wer häufig eine Unterscheidung zwischen Standard-Bauteilen und Blechbauteilen oder zwischen Standard-Baugruppen und Schweißbaugruppen benötigt, kann eine solche Abfrage auch in einer Funktion abbilden und wiederverwenden. Diese kann dann wiederum mit der Abfrage des <em>DocumentType</em> kombiniert werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kPartDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">If</span> <span class="n">IsSheetMetal</span><span class="p">()</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">            <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das Bauteil ist ein Blechbauteil&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">Else</span>
</span></span><span class="line"><span class="cl">            <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das Bauteil ist zwar ein Bauteil, aber kein Blechbauteil.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsSheetMetal</span><span class="p">()</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span><span class="p">.</span><span class="n">DocumentSubType</span><span class="p">.</span><span class="n">DocumentSubTypeID</span> <span class="o">=</span> <span class="s">&#34;{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}&#34;</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">if</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span></span></span></code></pre></div></div>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Struktureller Aufbau</title>
      <link>https://jbetzen.net/posts/ilogic-struktur/</link>
      <pubDate>Wed, 07 Sep 2022 11:21:41 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-struktur/</guid>
      <description>In diesem Post geht es um den strukturellen Aufbau einer iLogic. iLogics müssen nicht zwangsweise sequenziell als Skript von oben nach unten laufen sondern bieten bspw. die Möglichkeit der Verwendung von Routinen, Subroutinen und Funktionen.</description>
      <content:encoded><![CDATA[ <p>Im vorherigen Post <a href="/posts/ilogic-editor/">iLogic: Der Editor</a> wurde der grundsätzliche Aufbau des Editors erläutert. Nun gilt es den ersten Code zu schreiben. iLogic Code kann prinzipiell ohne eine explizite Hauptroutine <code>Sub Main()</code> laufen. Aller Code wird dann einfach im Editor <em>Line by Line</em> ausgeführt. Während dies bei einfachen Programmen kein Problem darstellt, kann dies bei komplexer aufgebauten iLogics zur Unübersichtlichkeit und Problemen beim Lesen des Codes führen.</p>

<h2 class="relative group">iLogic ohne Main- und Subroutines
    <div id="ilogic-ohne-main--und-subroutines" class="anchor"></div>
    
</h2>
<p>Ein einfaches Beispiel für eine iLogic ohne Unterroutinen könnte so aussehen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">    <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist eine Baugruppe.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">Else</span>
</span></span><span class="line"><span class="cl">    <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist keine Baugruppe.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">If</span></span></span></code></pre></div></div>
<p><strong>Der Code im Detail:</strong></p>
<ol>
<li>Zuerst wird ein Objekt <code>oDoc</code> deklariert und direkt in der gleichen Zeile wird diesem das Dokument zugewiesen, in dem der Code ausgeführt werden soll.</li>
<li>Es folgt eine If-Bedingung, die prüft ob es sich bei dem geöffneten Dokument um eine Baugruppe handelt. Ist dies der Fall, wird eine Messagebox auf dem Bildschirm erscheinen und den Text <em>Das geöffnete Dokument ist eine Baugruppe.</em> ausgeben.</li>
<li>Handelt es sich bei dem geöffneten Dokument um keine Baugruppe, erscheint ebenfalls eine Messagebox, die den Text <em>&ldquo;Das geöffnete Dokument ist keine Baugruppe.&rdquo;</em> ausgibt.</li>
</ol>

<h2 class="relative group">Funktionen und Subroutinen
    <div id="funktionen-und-subroutinen" class="anchor"></div>
    
</h2>
<p>Wie bereits zuvor erwähnt, können Funktionen und Unterroutinen die Lesbarkeit des Codes stark erhöhen. Dies ist besonders hilfreich, wenn man eine iLogic studiert, die nicht aus eigener Feder stammt. Funktionen und Routinen sollten daher immer kurze und prägnante Benennungen erhalten, die eindeutig aufzeigen welchen Zweck sie erfüllen.</p>
<p>Unterscheiden tun sich Funktionen von Subroutinen in einem Punkt: Sie liefern einen Wert zurück und brauchen auch korrekterweise direkt einen Datentyp bei der Deklaration, der beschreibt <em>was</em> da zurückgeliefert wird, bspw. ob es sich um einen <code>String</code>, einen Ganzzahlwert <code>int</code> oder einen <em>bool&rsquo;schen</em> Wert <code>true</code> oder <code>false</code> handelt.</p>

<h3 class="relative group">Funktionen
    <div id="funktionen" class="anchor"></div>
    
</h3>
<p>Übertragen auf das erste Beispiel einer iLogic, kann die Prüfung ob es sich beim geöffneten Dokument um eine Baugruppe handelt, auch einfach durch eine Funktion übernommen werden, die für diesen Fall den Wert <code>true</code> zurückliefert. Dazu muss der eigentliche Programmcode und der Code der Funktion voneinander getrennt werden:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">IsDocumentAssembly</span><span class="p">()</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist eine Baugruppe.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist keine Baugruppe.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsDocumentAssembly</span><span class="p">()</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span></span></span></code></pre></div></div>
<p><strong>Der Code im Detail:</strong></p>
<ol>
<li>Der eigentliche Programmcode läuft nun in einer Hauptroutine <code>Main()</code></li>
<li>Die Prüfung, ob es sich um eine Baugruppe handelt ist in eine eigene Funktion ausgelagert. Die Funktion ist vom Typ <code>Private</code>, steht damit nur in der iLogic selber zur Verfügung und liefert einen <em>bool&rsquo;schen Wert</em> zurück.</li>
<li>Das zu prüfende Dokument <code>oDoc</code> wird direkt in der Funktion zugewiesen.</li>
</ol>
<p>Speziell <strong>Punkt 3</strong> sollte genauer betrachtet werden: Angenommen es gäbe noch eine weitere Funktion, die zusätzlich prüft ob es sich bei dem geöffneten Dokument um eine Zeichnung handelt, müsste man bei gleicher Programmierung zweimal ein Objekt <code>oDoc</code> deklarieren und abfragen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsDocumentDrawing</span><span class="p">()</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kDrawingDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span></span></span></code></pre></div></div>
<p>Diese Redundanz ist ineffizient und sollte vermieden werden. Die Lösung dazu sind Funktionsparameter. Derzeit arbeiten die beiden Funktionen <code>IsDocumentAssembly()</code> und <code>IsDocumentDrawing()</code> ohne einen einzigen Parameter, der an sie übergeben wird. Die Klammern <code>()</code> sind leer. Innerhalb dieser Klammern kann also Vorgegeben werden was für einen Parameter oder Datentyp an die Funktion übergeben wird:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">IsDocumentAssembly</span><span class="p">(</span><span class="n">oDoc</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist eine Baugruppe.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span> <span class="k">If</span> <span class="n">IsDocumentDrawing</span><span class="p">(</span><span class="n">oDoc</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist eine Zeichnung.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist weder eine Baugruppe, noch eine Zeichnung.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsDocumentAssembly</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsDocumentDrawing</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kDrawingDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span></span></span></code></pre></div></div>
<p><strong>Der Code im Detail:</strong></p>
<ol>
<li>Das Objekt <code>oDoc</code>, das stellvertretend für das geöffnete Dokument steht, wir in der Hauptroutine <code>Main()</code> einmalig definiert und an die beiden Funktionen als Parameter übergeben.</li>
<li>Die If-Bedingung wurde um einen weiteren Prüfentscheid <code>Else If</code> erweitert der zusätzlich prüft, ob das geöffnete Dokument eine Zeichnung ist.</li>
<li>Die Funktionen liefern einen <em>bool&rsquo;schen</em> Wert zurück, der in der Hauptroutine für Entscheidungen genutzt werden kann.</li>
</ol>

<h3 class="relative group">Subroutines
    <div id="subroutines" class="anchor"></div>
    
</h3>
<p>Wenn kein expliziter Rückgabewert gefordert ist, kann anstelle eine Funktion auch eine Subroutine genutzt werden. Sie sollten wie kleine Unterprogramme betrachtet werden, die spezifische Tasks ausführen, bspw. eine Stücklistenstruktur setzen, einen Anzeigenamen anpassen oder Bauteile unterdrücken.</p>
<p><strong>Ein fiktiver Fall für eine Subroutine:</strong></p>
<p>Basierend auf dem bisherigen Code soll für den Fall, dass das aktive Dokument eine Baugruppe ist, der Anzeigename im Modellbrowser mit der Bezeichnung <code>Klappspaten</code> überschrieben werden. Die API von Inventor stellt diese Information bereit, man muss nur die richtige Methodik finden an diesen Wert zu kommen. Zur Hilfe bei der Suche kommt wieder das VBA-Makro aus dem ersten Teil dieser Serie <a href="/posts/ilogic-basics/">iLogic: Erste Schritte mit der Inventor API</a> zum Einsatz.</p>
<p>Der Anzeigename ist Teil des Objekts <code>oDoc</code> und kann unter dem API-Endpunkt <code>oDoc.DisplayName</code> geschrieben werden. Des Weiteren kann der Typ entnommen werden, nämlich <code>String</code> - also eine Textfolge -, ebenso wie der aktuelle Wert (<em>Value</em>) des Anzeigenamens, nämlich <code>&quot;Assembly.iam&quot;</code>.</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-struktur/displayname.png"
          alt="Displayname in Inventor"
        />
  
  
  </figure>
<p>Die Subroutine, um den Anzeigenamen zu überschreiben, könnte so aussehen:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">SetDisplayName</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">newName</span> <span class="ow">As</span> <span class="kt">String</span> <span class="o">=</span> <span class="s">&#34;Klappspaten&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="n">oDoc</span><span class="p">.</span><span class="n">DisplayName</span> <span class="o">=</span> <span class="n">newName</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Der gesamte Code, inkl. der neuen Subroutine:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">Main</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span> <span class="o">=</span> <span class="n">ThisDoc</span><span class="p">.</span><span class="n">Document</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">IsDocumentAssembly</span><span class="p">(</span><span class="n">oDoc</span><span class="p">)</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="n">SetDisplayName</span><span class="p">(</span><span class="n">oDoc</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist eine Baugruppe.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span> <span class="k">If</span> <span class="n">IsDocumentDrawing</span><span class="p">(</span><span class="n">oDoc</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist eine Zeichnung.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="n">MsgBox</span><span class="p">(</span><span class="s">&#34;Das geöffnete Dokument ist weder eine Baugruppe, noch eine Zeichnung.&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsDocumentAssembly</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kAssemblyDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Function</span> <span class="nf">IsDocumentDrawing</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span> <span class="ow">As</span> <span class="kt">Boolean</span>
</span></span><span class="line"><span class="cl">    <span class="k">If</span> <span class="n">oDoc</span><span class="p">.</span><span class="n">DocumentType</span> <span class="o">=</span> <span class="n">kDrawingDocumentObject</span> <span class="k">Then</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">True</span>
</span></span><span class="line"><span class="cl">    <span class="k">Else</span>
</span></span><span class="line"><span class="cl">        <span class="k">Return</span> <span class="k">False</span>
</span></span><span class="line"><span class="cl">    <span class="k">End</span> <span class="k">If</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Function</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">SetDisplayName</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">oDoc</span><span class="p">.</span><span class="n">DisplayName</span> <span class="o">=</span> <span class="s">&#34;Klappspaten&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Und so sieht das Ergebnis nach dem Ausführen der iLogic im Modellbaum in Inventor aus:</p>


  

<figure class="centered"><img src="/posts/ilogic-struktur/displayname-klappspaten.png"
    alt="Beispiel Displayname">
</figure>


<p>Wenn man den Anzeigenamen wieder auf den Default-Wert setzen möchte, kann man dies erreichen indem man ihn einfach erneut mit einem leeren String überschreibt:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Private</span> <span class="k">Sub</span> <span class="nf">ResetDisplayName</span><span class="p">(</span><span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">oDoc</span><span class="p">.</span><span class="n">DisplayName</span> <span class="o">=</span> <span class="s">&#34;&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p>Im Serienteil <a href="/posts/ilogic-displayname/">iLogic: Displayname anpassen</a> gibt es weitere Beispiele zur Manipulation des Displaynamens.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Der Editor</title>
      <link>https://jbetzen.net/posts/ilogic-editor/</link>
      <pubDate>Fri, 02 Sep 2022 18:29:16 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-editor/</guid>
      <description>Inventor liefert einen eingebauten iLogic Editor mit. Dieser Post zeigt wie man ihn aufruft, wie seine grafische Oberfläche aufgebaut ist und welche Vor- und Nachteile er gegenüber gängigen Text-Editoren hat.</description>
      <content:encoded><![CDATA[ <p>Im ersten Teil dieser Serie <a href="/posts/ilogic-basics/">iLogic: Erste Schritte mit der Inventor API</a> wurde gezeigt, wie man ein eigenes Verzeichnis mit Schreibrechten einbinden und den <strong>iLogic Browser</strong> aufrufen kann. In diesem Verzeichnis kann nun eine Datei abgelegt werden, bspw. <code>test.vb</code>. Mit einem Rechtsklick auf diese Datei bietet das Kontextmenü den Eintrag <em>Edit</em> an. Wird dieser ausgewählt öffnet sich der iLogic Editor.</p>

<h2 class="relative group">Dateiendung
    <div id="dateiendung" class="anchor"></div>
    
</h2>
<p>Inventor akzeptiert für iLogics folgende Dateiendungen:</p>
<table>
	<thead>
			<tr>
					<th>Dateiendung</th>
					<th>Anmerkungen</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>.txt</code></td>
					<td>Sollte nicht gewählt werden, da allgemeine Textdateien alles beinhalten könnten, was sich in Text abbilden lässt. Es wird jedoch mit Code gearbeitet und es muss nicht zwangsweise im iLogic Editor gearbeitet werden. Ich nutzte bspw. lieber <a href="https://code.visualstudio.com/"  target="_blank" rel="noreferrer">Visual Studio Code</a>. Dieser Editor ermöglicht auch automatisches Syntax Highlighting. Das kann jedoch nicht funktionieren, wenn aus der Dateiendung nicht hervorgeht, dass es sich um Basic-Code handelt.</td>
			</tr>
			<tr>
					<td><code>.ilogicvb</code></td>
					<td>Eine Autodesk-Kreation, die alle Nachteile von <code>.txt</code> mit sich und, gleichzeitig gegenüber <code>.vb</code>, <strong>keinen</strong> Vorteil bietet. Syntax Highlighting ist auch mit dieser Dateiendung (standardmäßig) in externen Code-Editoren nicht möglich.</td>
			</tr>
			<tr>
					<td><code>.vb</code></td>
					<td>Meine präferierte Dateiendung, die automatisches Syntax Highlighting in externen Code-Editoren ermöglicht. Die Dateiendung <code>.vb</code> verweist klar und eindeutig darauf hin, dass in der Datei Basic-Code verwendet wird.</td>
			</tr>
	</tbody>
</table>
<p>Für alle folgenden Beispiele werde ich die Dateiendung <code>.vb</code> verwenden.</p>

<h2 class="relative group">Der iLogic Editor
    <div id="der-ilogic-editor" class="anchor"></div>
    
</h2>
<p>Ruft man den iLogic Editor auf, wird man von folgender Oberfläche begrüßt:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-editor/ilogic-editor.png"
          alt="iLogic Editor"
        />
  
  
  </figure>

<h3 class="relative group">Aufbau der Grafischen Oberfläche
    <div id="aufbau-der-grafischen-oberfläche" class="anchor"></div>
    
</h3>
<p>Das aktiv geladene Part, in diesem Beispiel <code>Part_Meter.ipt</code> wird mittig im Editor angezeigt. Alle Features des Bauteils werden gelistet, bspw. <code>Extrusion1</code>. Klickt man auf dieses Feature erscheinen alle Parameter, bspw. wie viele Millimeter die Extrusion ausgetragen wurde, in der Parameterübersicht.</p>
<p>Im unterem Teil des Editors wird der Code geschrieben. In der Headerleiste befinden sich diverse Dropdown-Menüs, die vordefinierte Code-Blöcke, wie <code>If-Else</code>-Schleifen oder <code>Select Case</code>-Bedingungen bereitstellen. Was diese Funktionen im einzelnen machen, wird in dieser Serie nachfolgend anhand anschaulicher Beispiele erläutert.</p>
<p>Im Linken Teil des Editors stehen allgemeingültige API-Endpunkte zur Verfügung, die nicht zwangsweise etwas mit dem geöffneten Dokument zu tun haben. Es sind bspw. auch Funktionen für <em>iParts</em> oder <em>Sheet Metal Parts</em> verfügbar, auch wenn es sich bei dem Beispielbauteil nicht um solche Bauteile handelt.</p>

<h3 class="relative group">Auto Completion
    <div id="auto-completion" class="anchor"></div>
    
</h3>
<p>Eine sinnvolle Funktion des eingebauten iLogic Editors ist das Autocomplete Feature. Während getippt wird macht der Editor Vorschläge zu API-Endpunkten oder bereits vergebenen Variablen. Wenn ein solcher Eintrag in der Auswahlliste gewünscht ist, kann er mit einem Tippen auf die <kbd>TAB</kbd> Taste übernommen werden. Wichtig ist bei der Kontextauswahl nicht die Taste <kbd>ENTER</kbd> zur Bestätigung zu nutzen, da der Editor sonst nicht den Vorschlag übernimmt und stattdessen direkt in die nächste Zeile spring.</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-editor/ilogic-editor-autocompletion.png"
          alt="iLogic Editor Autocompletion"
        />
  
  
  </figure>

<h3 class="relative group">Nachteile des iLogic Editors
    <div id="nachteile-des-ilogic-editors" class="anchor"></div>
    
</h3>
<p>VBA-Editoren arbeiten naturgemäß mit Tabstopps und nicht mit Leerzeichen um Code einzurücken (<em>Indentation</em>). Das führt zu wunderlichen Situationen, wenn der Code dann kopiert und in irgendwelchen Foren gepostet wird. Kopiert man dann diesen Code aus Foren zurück in den lokalen Editor sieht das in der Regel aus wie <em>Kraut und Rüben</em>. Auch obliegen Tabstopps in ihrer Einrückungsdarstellund der Interpretation des jeweiligen Editors, mit dem sie angezeigt werden. In dieser <a href="https://alexkondov.com/indentation-warfare-tabs-vs-spaces/"  target="_blank" rel="noreferrer">endlosen Debatte</a> gehöre ich dem <strong>Team Spaces</strong> an und möchte daher auch keine Tabstopps in meinem Code vorfinden.</p>
<p>Ich handhabe es so, dass ich den eingebauten iLogic Editor zur Programmierung verwende und schließend den Code noch einmal in Visual Studio Code aufrufe und formatiere. vscode hat eine Funktion namens <code>Convert Indentation to Spaces</code>, die ich anschließend immer über alle iLogics laufen lasse, die mit dem eingebauter iLogic Editor erstellt wurden. Die Funktion kann in vscode mit der Tastenkombination <kbd>STRG</kbd>+<kbd>SHIFT</kbd>+<kbd>P</kbd> aufgerufen werden. In das sich öffnende Kommandofeld muss anschließend nur der Name der Funktion <code>Convert Indentation to Spaces</code> eingetippt und mit <kbd>ENTER</kbd> bestätigt werden.</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-editor/vscode-convert-indentation.png"
          alt="vscode convert Indentation"
        />
  
  
  </figure>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>iLogic: Erste Schritte mit der Inventor API</title>
      <link>https://jbetzen.net/posts/ilogic-basics/</link>
      <pubDate>Thu, 01 Sep 2022 17:00:22 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/ilogic-basics/</guid>
      <description>Autodesk Inventor bietet mittels iLogic ein mächtiges Werkzeug wiederkehrende Aufgaben zu automatisieren. Da der Einstieg in den Umgang mit iLogic und der Inventor API für viele Konstrukteure eine Hürde darstellt, werden in diesem Post die ersten Schritte erläutert.</description>
      <content:encoded><![CDATA[ <p>Viele Konstrukteure verkennen bis heute den Sachverhalt, dass sie oftmals repetitiven Aufgaben gegenüber stehen die Zeit fressen und sich leicht automatisieren lassen. Sie verschwenden damit nicht nur ihre wertvolle Zeit, Arbeitskraft und Motivation, auch verkennen Sie dass im 21 Jahrhundert die Schnittstelle zwischen klassischer mechanischer Konstruktion und Programmierung mehr und mehr verschmelzen.</p>
<p>Diesem Post wird eine Serie zum Thema iLogics und der Inventor API folgen, die praxisnahe Beispiele aus dem Konstruktionsalltag und deren Automatisierung beinhaltet.</p>

<h2 class="relative group">iLogic - Was ist das eigentlich?
    <div id="ilogic---was-ist-das-eigentlich" class="anchor"></div>
    
</h2>
<p>Autodesk bezeichnet iLogic folgendermaßen:</p>
<blockquote><p><a href="https://help.autodesk.com/view/INVNTOR/2026/ENU/?guid=GUID-AB9EE660-299E-408F-BBE1-AFE44C723F59"  target="_blank" rel="noreferrer">iLogic</a> ermöglicht eine regelgesteuerte Konstruktion und bietet eine einfache Möglichkeit zum Erfassen und Wiederverwenden Ihrer Arbeit. Verwenden Sie iLogic zur Standardisierung und Automatisierung von Konstruktionsprozessen und zur Konfiguration Ihrer virtuellen Produkte.</p>
<p>In iLogic werden Regeln als Objekte direkt in Bauteil-, Baugruppen- und Zeichnungsdokumente integriert. Mithilfe der Regeln werden die Parameter und Attributwerte für Ihren Entwurf festgelegt. Über diese Werte definieren Sie das Verhalten der Attribute, Elemente und Komponenten eines Modells. Die Informationen werden wie geometrische Konstruktionselemente direkt in den Dokumenten gespeichert.</p>
</blockquote><p>iLogics können direkt aus Inventor heraus in einem bereitgestellten Editor erstellt und editiert werden. Als Programmiersprache kann VBA und <a href="https://de.wikipedia.org/wiki/Visual_Basic_.NET"  target="_blank" rel="noreferrer">VB.net</a> verwendet werden. Letztere ist in jedem Fall zu bevorzugen, da deutlich bessere Werkzeuge, bspw. zum Error-Handling zu Verfügung stehen. VBA-Erfahrung sammeln Konstrukteure in der Regel bereits dadurch, dass sie im Studium auf dem Strafplaneten Excel den Dienstgrad <em>Tabellenknecht</em> erwerben müssen. Wer also bereits Excel-Macros schreiben oder ein Grundverständnis der Thematik besitzt, wird mit iLogic zügig zurechtkommen.</p>
<p>Neben den Standardfunktionalitäten von Basic bringt iLogic zusätzlich nützliche <em>Shortcuts</em> mit, die das Arbeiten mit Bauteilen und Zeichnungen vereinfachen.</p>

<h3 class="relative group">iLogic Administration
    <div id="ilogic-administration" class="anchor"></div>
    
</h3>
<p>iLogics werden im Idealfall im Zusammenspiel mit Autodesk Vault administriert und zentral durch einen kompetenten Administrator verwaltet und den Nutzern zur Verfügung gestellt. So können sie mittels Berechtigungskonzepten gegen manipulation gesichert werden. Gleichzeitig ist so garantiert, dass der User stets den aktuellen Code in Verwendung hat.</p>
<p>Dieses Konzept bringt für kreative Anwender auch Nachteile mit sich. Die ausgerollten iLogics und das übergeordnete Verzeichnis sind schreibgeschützt. Ein schnelles Testen und Ausprobieren ist somit nicht möglich. Unmöglich ist es aber nicht. Man kann einfach einen weiteren Pfad auf dem Nutzerrechner erstellen, die iLogics dort ablegen und dieses Verzeichnis zusätzlich zum Standardpfad hinzuladen. Zur Einbindung eines iLogic-Verzeichnisses muss im Inventor der Menüpunkt <kbd>Tools &gt; Options &gt; iLogic Configuration</kbd> geklickt werden:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-basics/ilogic-external-dir-menu.png"
          alt="Externer Pfad in dem iLogics gespeichert sind"
        />
  
  
  </figure>
<p>Anschließend öffnet sich folgendes Fenster, in dem ein weiteres Verzeichnis hinzugefügt werden kann:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-basics/ilogic-external-dir.png"
          alt="Advanced iLogic Configuration Window"
        />
  
  
  </figure>

  



<div
  
    class="flex px-4 py-3 rounded-md shadow bg-primary-100 dark:bg-primary-900"
  
  >
  <span
    
      class="text-primary-400 pe-3 flex items-center"
    
    >
    <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
</span>
  </span>

  <span
    
      class="dark:text-neutral-300"
    
    >Inventor benötigt für iLogics stets eindeutige Dateinamen. Wenn im lokalen iLogic-Verzeichnis und im Standardverzeichnis eine iLogic mit gleichem Dateinamen liegt, führt dies zu Problemen.</span>
</div>


<h3 class="relative group">iLogic Browser
    <div id="ilogic-browser" class="anchor"></div>
    
</h3>
<p>Inventor bietet - neben dem Model Browser - die Möglichkeit den iLogic Browser einzublenden. Dazu muss auf das <strong>+</strong> Symbol neben dem Modellbrowser geklickt und der Eintrag <em>iLogic Browser</em> selektiert werden. Anschließend werden alle iLogics gelistet, auch die aus dem zuvor vom Nutzer manuell hinzugefügten Verzeichnis:</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-basics/ilogic-browser.gif"
          alt=""
        />
  
  
  </figure>

<h2 class="relative group">Die Inventor API
    <div id="die-inventor-api" class="anchor"></div>
    
</h2>
<p>API steht für <em>Application Programming Interface</em>. Über diese API können alle Tasks, die sonst ein Konstrukteur mit Hilfe der grafischen Oberfläche ausführt, programmatisch erledigt werden. Autodesk stellt eine Übersicht aller Objekte zur Verfügung, die über die API genutzt werden können. Es gilt in erster Linie nicht zu erschrecken, da diese Übersicht selbst auf A0 ausgedruckt immer noch sehr unübersichtlich ist. Die API von Inventor unterliegt konstantem Wandel und wird mit jedem Major Release erweitert.</p>

<figure><a href="https://damassets.autodesk.net/content/dam/autodesk/www/pdfs/Inventor2022ObjectModel.pdf" target="_blank" class="inline-block">
        <img
          class="my-0 rounded-md nozoom"
          src="/posts/ilogic-basics/api-object-model.png"
          alt="Ausschnitt der Lautsprecher"
        />
  </a>
  
  </figure>
<p>Auf der <a href="https://help.autodesk.com/view/INVNTOR/2022/ENU/?guid=UserManualIndex"  target="_blank" rel="noreferrer">Autodesk Webseite</a> sind diverse Erläuterungen und Leitfäden zur API einsehbar.</p>

<h3 class="relative group">Objekte
    <div id="objekte" class="anchor"></div>
    
</h3>
<p>Betrachtet man das verlinkte PDF des <em>Inventor Object Model</em> genauer, erkennt man dass es unzählige Objekte gibt, auf die zugegriffen werden kann, bspw:</p>
<ul>
<li><strong>Dokumententyp:</strong> Bauteil, Baugruppe oder Zeichnung.</li>
<li><strong>Units of Measurement:</strong> Welche Einheiten werden im Bauteil verwendet, z.B. Inch oder Zentimeter.</li>
<li><strong>Materialien:</strong> Welches Material ist dem Bauteil zugewiesen.</li>
<li><strong>Application:</strong> Welche Version von Inventor in Verwendung ist.</li>
<li>&hellip;</li>
</ul>

<h3 class="relative group">Enums
    <div id="enums" class="anchor"></div>
    
</h3>
<p>Neben Objekten können sogenannte <strong>Enums</strong> genutzt werden. Enums bieten hilfreiche Methoden, um mit Objekten und ihren Werten zu interagieren. In diesem Teil der Serie sollen sie erst einmal keine Rolle spielen. In dem späteren Post <a href="/posts/ilogic-uom/">iLogic: Units of Measurement</a> werden sie anhand eines Beispiels mit Maßeinheiten (<em>Units of Measure</em>) erläutert.</p>

<h2 class="relative group">Debugging der Inventor API
    <div id="debugging-der-inventor-api" class="anchor"></div>
    
</h2>

  



<div
  
    class="flex px-4 py-3 rounded-md shadow bg-primary-100 dark:bg-primary-900"
  
  >
  <span
    
      class="text-primary-400 pe-3 flex items-center"
    
    >
    <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
</span>
  </span>

  <span
    
      class="dark:text-neutral-300"
    
    ><p>Beginnend mit Inventor 2021, liefert Autodesk mit dem Inventor-Installer kein VBA-Modul für Inventor mehr aus. Das Modul kann und muss für die folgenden Schritte manuell für die entsprechende Inventor-Version installiert werden.</p>
<p>Siehe: <a href="https://www.autodesk.com/support/technical/article/caas/tsarticles/ts/580m5V9igpBgk3WNek5Ydf.html"  target="_blank" rel="noreferrer">Download the Microsoft VBA module for Inventor</a></p>
</span>
</div>

<p>Der VBA-Editor kann mit der Tastenkombination <kbd>ALT</kbd> + <kbd>F11</kbd> aufgerufen werden. In diesem Editor werden, neben dem aktuell geöffneten Dokument, das Standard Anwendungsprojekt gelistet. Dieses kann (und wird auch sicherlich) sogenannte VBA-Module enthalten. Jedes Modul hat einen Anwendungszweck und Code der diesen repräsentiert. Möchte man nun einen Blick in die Inventor API werfen gibt es 2 Möglichkeiten:</p>
<ol>
<li><strong>Der nette Admin:</strong> Der Admin ist euch wohlgesonnen und integriert den anschließend folgenden VBA-Code direkt in einem Standard-Modul. Somit steht es global zur Verfügung und kann unabhängig des geöffneten Dokuments ausgeführt werden.</li>
<li><strong>Der uneinsichtige Admin:</strong> Der Admin sieht nicht ein, dem User eine Spielwiese zum Optimieren seiner Arbeitsabläufe zu bieten und legt kein globales Modul an. In diesem Fall kann man ein Alibi-Dokument erstellen und den folgenden Code dort im <em>DocumentProject</em> unter <code>ThisDocument</code> einfügen. Dazu einen Doppelklick auf <code>ThisDocument</code> ausführen.</li>
</ol>
<p><strong>Der benötigte Code:</strong></p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-vb" data-lang="vb"><span class="line"><span class="cl"><span class="k">Sub</span> <span class="nf">HappyDebug</span><span class="p">()</span>
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oApp</span> <span class="ow">As</span> <span class="n">Application</span>
</span></span><span class="line"><span class="cl">    <span class="k">Set</span> <span class="n">oApp</span> <span class="o">=</span> <span class="n">ThisApplication</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">Dim</span> <span class="n">oDoc</span> <span class="ow">As</span> <span class="n">Document</span>
</span></span><span class="line"><span class="cl">    <span class="k">Set</span> <span class="n">oDoc</span> <span class="o">=</span> <span class="n">ThisApplication</span><span class="p">.</span><span class="n">ActiveDocument</span>
</span></span><span class="line"><span class="cl"><span class="k">End</span> <span class="k">Sub</span></span></span></code></pre></div></div>
<p><strong>Dieser Code macht folgendes:</strong></p>
<ol>
<li>Er deklaritert ein Objekt <code>oApp</code> vom Typ <code>Application</code> und weist diesem Objekt die Inventor Anwendung zu.</li>
<li>Er deklariert ein Objekt <code>oDoc</code> vom Typ <code>Document</code> und weist das aktiv offene Dokument im Inventor zu.</li>
</ol>
<p>Der Ausdruck <code>Dim</code> steht für <em>Dimension</em>, also den Platz den dieses Objekt im Speicher belegen wird. Dieser Code ermöglicht es also zum einen die Anwendung Inventor, wie auch das aktiv geöffnete Dokument zu bespielen.</p>
<p><strong>Nun müssen drei finale Schritte erfolgen:</strong></p>
<ol>
<li>Es muss jeweils ein Rechtsklick die Einträge <code>oApp</code> und <code>oDoc</code> ausgeführt und im Kontextmenü der Eintrag <code>Add Watch</code> gewählt werden. Damit wird es, während des Ausführens des VBA-Codes, ermöglicht live in diese zwei Objekt zu schauen.</li>
<li>Es muss ein Stopppunkt in Zeile 4 gesetzt werden. Dazu muss in der linken grauen Leiste vor dem Eintrag <code>End Sub</code> mit der linken Maustaste geklickt werden. Mit dem Setzen des Stopppunkts wird erreicht, dass der Code nur bis zu dieser Zeile ausgeführt wird und somit vor der Terminierung in das Objekt <code>oDoc</code> geschaut werden kann.</li>
<li>Nun muss lediglich noch der Code durch einen klick auf das Play Icon (<em>run</em>) ausgeführt werden.</li>
</ol>
<p>Hat alles funktioniert erscheint nun unterhalb des Codefensters ein Menüfenster mit der Bezeichnung <em>Watches</em>, in dem die Objekte <code>oApp</code> und <code>oDoc</code> auftauchen und ausgeklappt werden können. Dieses Fenster ist ggf. nicht sofort sichtbar. Oftmals ist lediglich der Codebereich sichtbar und man muss den Objektbrowser erst weiter nach unten ziehen, da er soweit unten am Bildschirmrand platziert ist, dass man seinen Inhalt nicht sehen kann.</p>

<figure>
        <img
          class="my-0 rounded-md centered"
          src="/posts/ilogic-basics/happydebug.gif"
          alt="Animation zum Debuggin mittels VBA Editor"
        />
  
  
  </figure>
<p>Diese Methode eignet sich hervorragend um das aktive Dokument oder die Anwendung zu inspizieren. Es werden anschaulich Endpunkte, Werte und Datentyp aufgelistet, die anschließend in einer iLogic verwendet werden können. Somit ist die Basis für eine gut geschriebene iLogic gesetzt.</p>
 ]]></content:encoded>
    </item>
    
    <item>
      <title>Inventor: Top-Down-Konstruktion</title>
      <link>https://jbetzen.net/posts/inventor-top-down-design/</link>
      <pubDate>Thu, 01 Sep 2022 01:41:00 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/inventor-top-down-design/</guid>
      <description>Das Thema Konstruieren mit Master Skizzen, auch &lt;strong&gt;Top-Down-Methode&lt;/strong&gt; genannt, ist erfahrungsgemäß nicht sonderlich gut im Weltnetz dokumentiert. Umso schöner ist es, dass Felix Rodermund sich auf seinem Youtube-Kanal die Zeit genommen hat um diesem Thema eine ganze Playlist zu widmen.</description>
      <content:encoded><![CDATA[ <p>Das Thema Konstruieren mit Master Skizzen, auch <strong>Top-Down-Methode</strong> genannt, ist erfahrungsgemäß nicht sonderlich gut im Weltnetz dokumentiert. Umso schöner ist es, dass <a href="https://r-kon.de/unternehmen_gruender.php"  target="_blank" rel="noreferrer">Felix Rodermund</a> sich auf seinem Youtube-Kanal <a href="https://www.youtube.com/channel/UCxexZqzlgc1E-YuETYdFiUw"  target="_blank" rel="noreferrer">R-Kon - 3D-CAD und Maschinenbau</a> die Zeit genommen hat um eine ganze Playlist diesem Thema zu widmen. Er zeigt anschaulich über mehrere Videos hinweg, welche Sonderfälle und methodischen Schritte im Gegensatz zur klassischen <em>Bottom-Up-Methode</em> eingehalten werden müssen.</p>

<h2 class="relative group">Bottom-Up vs Top-Down
    <div id="bottom-up-vs-top-down" class="anchor"></div>
    
</h2>
<p>Die beiden Bezeichnungen beschreiben die Konstruktionsweise in Baugruppen. Die klassische <strong>Bottom-Up-Methode</strong> beginnt mit der Konstruktion der Einzelteile, die am Ende zu einer Baugruppe zusammengeführt werden. Sämtliche Bemaßungen finden in den Einzelteilen statt - demnach erfolgen auch konstruktive Anpassungen direkt in den jeweiligen Bauteilen und oftmals direkt in mehreren Bauteilen. Erfahrungsgemäß ist diese Methode nach wie vor im Arbeitsalltag des Konstrukteurs vorherrschend.</p>
<p>Die <strong>Top-Down-Methode</strong> stellt diese Konzept auf den Kopf. Wie der Name bereits erahnen lässt werden Baugruppen in ihrer logischen und definierten Struktur nicht in den Einzelteilen bestimmt, sondern <em>von Oben herab</em>. Dies geschieht unter Hilfenahme einer einzigen steuernden Skizze, der Master-Skizze oder auch <em>Master Sketch</em> genannt. In dieser Skizze werden sämtlichen Maße der Einzelteile und ihrer Zusammenhänge in der übergeordneten Baugruppe definiert. Teile dieser Skizzen können dann wiederum in Bauteile <em>projiziert</em> werden. Autodesk Inventor hat für das Arbeiten mit steuernden Skizzen eine eigene Funktion namens <strong>Ableitung</strong> (<a href="https://help.autodesk.com/view/INVNTOR/2023/ENU/?guid=GUID-04363641-CCF9-4B2C-A3C4-AF676D6F7B1A"  target="_blank" rel="noreferrer">derived components</a>), die ausgiebig in der Videoreihe erläutert wird.<br>
Der Vorteil der Top-Down-Methode liegt auf der Hand: Ändert man bspw. den Durchmesser eines Stiftes, der durch drei Bauteile geführt wird, müssen bei der klassischen <em>Bottom-Up-Methode</em> auch alle drei Bauteile in ihren Maßen angepasst werden. Bei der <em>Top-Down-Methode</em> ändert man lediglich ein Maß in der Master-Skizze, das dann in beide Teile automatisch nachgezogen wird.</p>

<h2 class="relative group">Youtube Playlist
    <div id="youtube-playlist" class="anchor"></div>
    
</h2>


  

<figure class="nozoom"><a href="https://www.youtube.com/playlist?list=PLZnehly9NcJg6FHfbGESUXabst67oPS-G" class="inline-block"><img src="https://img.youtube.com/vi/ObaCM5vhklA/maxresdefault.jpg"></a>
</figure>


 ]]></content:encoded>
    </item>
    
    <item>
      <title>Die berufliche Auszeit und die deutsche Bürokratie</title>
      <link>https://jbetzen.net/posts/life-001-berufliche-auszeit/</link>
      <pubDate>Sat, 24 Nov 2018 23:42:13 +0200</pubDate>
      
      <guid>https://jbetzen.net/posts/life-001-berufliche-auszeit/</guid>
      <description>Dieser Post beschreibt, wie man eine berufliche Auszeit ohne Kündigung verschaffen kann, sofern der Arbeitgeber mitspielt. Damit verbunden ist ein inhärenter Kampf gegen die deutsche Bürokratie.</description>
      <content:encoded><![CDATA[ <div class="lead text-neutral-500 dark:text-neutral-400 !mb-9 text-xl">
  <em>Wir können die Schwerkraft überwinden, aber der Papierkram erdrückt uns.</em>
</div>

<p>Wer wie ich in einem Leiharbeitsverhältnis beschäftigt ist und ständig wechselnde Einsatzorte hat, kennt sicherlich das Gefühl der stetigen Unplanbarkeit des Lebens. Arbeitseinsätze, die nur für 1-3 Monate angesetzt sind, zerrten bisweilen stark an meinem Gemüt und haben mich dazu angestiftet darüber nachzudenken, wie man den zeitlichen Übergang zwischen einem alten und neuen Einsatzort (neudeutsch IC: Intercontract Zeit) in Zukunft sinnvoller nutzen könnte, ohne dass für den Arbeitgeber und einen selbst Nachteile entstehen. Ich habe mich dazu entschlossen zwei Monate an das andere Ende der Welt zu Reisen und Asien als Backpacker zu erkunden. Das klingt nun leicht daher gesagt, denn so einfach ist das in einem bürokratischen Land wie Deutschland nicht, schließlich muss alles wasserdicht schriftlich abgesichert sein, damit eine erfolgreiche Wiederaufnahme des Jobs ohne neu verhandelten Vertrag, eine fortlaufende Krankenversicherung und eine lückenlose Renteneinzahlungen gewährleistet sind.</p>
<p>Im Folgenden möchte ich erläutern, was alles berücksichtigt, geplant und erledigt werden muss, bevor die berufliche Auszeit angetreten werden kann. Möge es anderen eine Hilfe sein dem beruflichen Alltag zu entfliehen, um Zeit für sich selbst zu finden und zu nutzen!</p>

<h2 class="relative group">Arbeitgeber informieren
    <div id="arbeitgeber-informieren" class="anchor"></div>
    
</h2>
<p>Der Arbeitgeber sollte frühestmöglich über die Pläne einer Auszeit informiert werden. Dass dies in unserer schnelllebigen Welt der Leiharbeit nicht immer möglich ist liegt auf der Hand. Bei mir gab es Momente, da wusste ich 3 Tage vor Monatsabschluss nicht, ob ich am nächsten Monat noch am aktuellen Einsatzort eingesetzt werde oder nicht. Auch gab es den Moment, an dem ich nicht wusste, ob ich vor Antritt der Weihnachtsferien anschließend noch meine Arbeitsplatz wiedersehen würde. Wichtig ist, dass der Arbeitgeber genügend Planungszeitraum hat und ein festes Datum der Rückkehr genannt bekommt, um schnellstmöglich eine Anschlussverwendung arrangieren zu können.</p>
<p>Einem modernen Arbeitgeber sollten berufliche Auszeiten nicht fremd sein, so hat sich beispielsweise das <em>Sabbatical</em> auch außerhalb des Beamtentums in den Arbeitsalltag vieler Beschäftigten geschlichen. Erfahrungsgemäß sind nur wenige Arbeitnehmer über diese Möglichkeit der Auszeit informiert. Sabbaticals sind in der Regel aber mit vielen Auflagen verbunden. Oftmals wird gefordert eine hohe Anzahl Überstunden aufzubauen und diese mit dem kompletten Jahresurlaub zu kombinieren. Als Gegenleistung erhält man dann eine fortlaufende Rentenzahlung und behält den Krankenversichertenstatus. Dies kam für mich jedoch nicht in Frage, da ironischerweise an meinem derzeitigen Einsatzort keine Überstunden aufgebaut werden dürfen und mir mein Jahresurlaub heilig ist. Sollte ein Unternehmen einen Betriebsrat haben, ist es sinnvoll sich mit diesem in Verbindung zu setzen und einmal pauschal nachzufragen, was aus dessen Sicht zu beachten ist. Es ist zudem sinnvoll den Betriebsrat früh in die Reiseplanung einzuweihen, damit man eine unbeteiligte Partei an Bord hat, falls der Arbeitgeber auf dumme Ideen bei der Rückkehr kommt.</p>
<p>Ich habe mich mit meinem Arbeitgeber mittels eines Zusatzvertrages, einer sogenannten Ruhezeitvereinbarung, geeinigt, der ihn von der Zahlung von Rentenbeiträgen und Sozialabgaben freispricht und im Gegenzug garantiert, dass der bestehende Arbeitsvertrag nach Rückkehr wieder in Kraft tritt. Ich wiederum muss mich selber Krankenversichern und für die fortlaufenden Rentenzahlungen aufkommen. Kurzum: Finanziell muss aus der eigenen Tasche ein nicht zu vernachlässigender Betrag beigesteuert werden. Ob sich ein Arbeitgeber zu einer solchen Vereinbarung hinreißen lässt, kann pauschal sicherlich nicht beantwortet werden. Oftmals sind Kündigungsprozesse deutlich besser in Unternehmen automatisiert, als Sonderverträge. Da das Gewinnstreben von Unternehmen pervertierte Züge angenommen hat, könnten Arbeitgeber auch die Chance sehen eine Kündigung auszusprechen, um anschließend bei Rückkehr einen Neuvertrag mit schlechteren Bedingungen auszuhandeln. Daher ist Vorsicht geboten, dass kein persönlicher Nachteil entsteht.</p>
<p>Die Konditionen des Zusatzvertrages werden vom Arbeitgeber bestimmt. Die wichtigsten Punkte lauten:</p>
<ul>
<li>Die Ruhe des bestehenden unbefristeten Vertrags für den verhandelten Zeitraum der Auszeit und dessen uneingeschränkter Fortführung nach der Rückkehr</li>
<li>Der Arbeitgeber ist in diesem Zeitraum nicht verpflichtet die sogenannten Hauptleistungspflichten zu erbringen. Das umfasst: Gehaltszahlungen, Urlaubsansprüche, Urlaubsgeld, Bonuszahlungen, etc.</li>
<li>Ich als Arbeitnehmer bin selber verpflichtet meinen sozialversicherungspflichtigen Belangen nachzugehen</li>
</ul>
<p>Somit ist aus Sicht des Arbeitgebers und des Arbeitnehmers rechtlich alles geklärt.</p>

<h2 class="relative group">Krankenkasse informieren
    <div id="krankenkasse-informieren" class="anchor"></div>
    
</h2>
<p>Nachdem sich der Arbeitgeber von der Zahlung von Sozialleistungen freigesprochen hat, ist der nächste Gang der zur Krankenkasse. Hier gilt es sich in Eigenleistung für die berufliche Auszeit zu versichern, sofern man in einem Land verweilt in dem der Versicherungsschutz der Krankenkasse gilt. Meine Krankenversicherung bietet zwar ein kostenloses Servicetelefon und auch ein Online-Postfach für digitalen Schriftverkehr, der Erfahrung gemäß lohnt es sich aber einen Termin vor Ort zu vereinbaren und die Angelegenheit und Fragen auf kurzem Weg zu klären. Der zu entrichtende Betrag hängt maßgeblich davon ab, wann der Arbeitgeber die Zahlungen der Sozialleistungen beendet. In meinem Fall war dies zum Monatsende. Meine Reise begann jedoch erst 5 Tage später. Da in Deutschland eine gesetzliche Versicherungspflicht besteht, musste also auf Basis von einkommensabhängigen Tagessätzen ein Versicherungsverhältnis für 5 Tage ausgehandelt werden. Das sind ca. 60€ Eigenleistung, die auf einen zukommen. In manchen Fällen kommen die Krankenkassen ihren Kunden auch entgegen und übernehmen eine gewisse Überbrückungszeit aus eigener Tasche. Aus Erfahrung lässt sich sagen, an dieser Stelle ein bisschen hartnäckiger nachzufragen. In meinem Fall hat sich die Krankenkasse entschlossen diese Zahlungen zu übernehmen. Als Nachweise des Auslandsaufenthalts müssen der Krankenkasse die Flugtickets vorgelegt werden. Selbiges gilt analog für die Rückkehr! In diesem Fall ist die Krankenkasse dazu verpflichtet ihre Versicherten wieder aufzunehmen. Gibt es auch hier eine Diskrepanz zwischen dem Datum der Rückkehr und dem Beginn der erneuten Zahlung der Sozialleistungen durch den Arbeitgeber, muss man selber wieder zum Geldbeutel greifen.</p>

<h2 class="relative group">Private Auslandskrankenversicherung
    <div id="private-auslandskrankenversicherung" class="anchor"></div>
    
</h2>
<p>Wichtig ist zudem das Reiseziel. Der Leistungsumfang meiner Krankenkasse beinhalten keine Leistungen in Asien. In der Regel haben Krankenkassen Vereinbarungen mit Nachbarländern - für Asien gilt das jedoch nicht. Man ist also tunlichst angeraten eine private Auslandskrankenversicherung abzuschließen. Diese bieten für eine festgelegte Anzahl an Tagen im Jahr Schutz bei Aufenthalt im Ausland. Ich habe dafür eine <a href="https://www.huk.de/gesundheit-vorsorge-vermoegen/krankenversicherung/auslandskrankenversicherung.html"  target="_blank" rel="noreferrer">Auslandskrankenversicherung bei der HUK</a> abgeschlossen, die an 56 Reisetagen pro Jahr haftet. Kostenpunkt: läppische 9€ pro Jahr. Wer hier nicht zugreift, dem ist nicht zu helfen.</p>

<h2 class="relative group">Rentenversicherung informieren
    <div id="rentenversicherung-informieren" class="anchor"></div>
    
</h2>
<p>Da sich der Arbeitgeber ebenfalls von den Einzahlungen in die Rentenkasse freigesprochen hat, sollte man an dieser Stelle selber zur Tat schreiten. Grundsätzlich stellt es einem die Deutsche Rentenversicherung frei, <a href="https://www.deutsche-rentenversicherung.de/Allgemein/de/Navigation/2_Rente_Reha/01_Rente/01_allgemeines/02_freiwillige_versicherung/00_freiwillige_versicherung_node.html"  target="_blank" rel="noreferrer">wie viel man aus Eigenleistung einzahlen möchte</a>. Vorgegeben sind lediglich ein festgelegter Mindestbeitrag von 83,70€ und ein Höchstbetrag von 1209,00€ (Stand: 08/2018). Ich habe mich entschlossen lediglich den Mindestbeitrag einzuzahlen, damit keine Lücke in den Einzahlungen besteht. Hierfür muss das <a href="https://www.deutsche-rentenversicherung.de/SharedDocs/Formulare/DE/_pdf/V0060.html"  target="_blank" rel="noreferrer">Formular V0060: Antrag auf Beitragszahlung für eine freiwillige Versicherung</a> ausgefüllt und eingereicht werden. Hier muss auch der Zeitraum eingetragen werden ab wann freiwillig eingezahlt wird. Sinnloserweise gibt es kein Feld, um die Dauer der Zahlungen anzugeben. Ein Anruf bei der Rentenversicherung löste das Dilemma, indem darauf hingewiesen wurde den Zeitraum händisch daneben zu schreiben und dem Antrag eine schriftliche Erläuterung beizulegen. Die Deutsche Rentenversicherung hat in vielen Städten Anlaufstellen, wo der Antrag eingereicht und die Situation noch einmal näher erläutert und besprochen werden kann.</p>
<p>Zusätzlich macht es Sinn, der Deutschen Rentenversicherung für diesen Zeitraum eine Einzugsermächtigung für das Konto zu erteilen, um sicherzustellen dass alle Zahlen zeitgerecht abgebucht werden. Hierfür wird das <a href="https://www.deutsche-rentenversicherung.de/SharedDocs/Formulare/DE/_pdf/V0005.html"  target="_blank" rel="noreferrer">Formular V0005: SEPA-Basis-Lastschriftmandat für wiederkehrende Lastschriften</a> benötigt.</p>
<p>Somit ist die Papierhölle erfolgreich durchlaufen. Travel Safe!</p>
 ]]></content:encoded>
    </item>
    
  </channel>
</rss>
