Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- primus:workflow [2022/08/05 12:39] – gelöscht - Externe Bearbeitung (Unknown date) 127.0.0.1
+++ primus:workflow [2023/06/16 07:24] (aktuell) – +oldvercall_cond, Neuerungen im Update vom 15.06.2023 mgras
@@ Zeile 1: / Zeile 1: @@
+====== Workflow ======
+Mit **Workflow** werden im [[Abschnitte|Abschnitt]] [[Public]], verschiedene Optionen für die Versionierung von Dokumenten definiert.
+===== Attribute =====
+Über folgende Attribute kann festgelegt werden was bei Versionsänderungen passieren soll. Die Attribute können alle in einem einzigen ''Workflow''-[[Glossar#Tag]], oder aber auch auf mehrere verteilt werden, was die Übersichtlichkeit erhöht.
+^ Attribut^ Wert^ Funktion^
+| [[Workflow#newvercall]]| ''<FUNKTION>''| Interne oder externe Primusfunktion die bei der Versionierung aufgerufen werden soll um die neue Version zu bearbeiten|
+| [[Workflow#newvercall_cond]]| ''<BEDINGUNG>''| Bedingung unter der eine neue Version zulässig ist {{tag>Klärungsbedarf}}|
+| [[Workflow#newversioncond]]| ''<BEDINGUNG>''| Bedingung unter der eine neue Version zulässig ist {{tag>Klärungsbedarf}}|
+| [[Workflow#oldvercall]]| ''<FUNKTION>''| Interne oder externe Primusfunktion die bei der Versionierung aufgerufen werden soll um die bestehende (alte) Version zu bearbeiten|
+| [[Workflow#oldvercall_cond]]| ''<BEDINGUNG>''| Bedingung unter der ''oldvercall'' ausgeführt wird|
+| [[Workflow#oldverstatus]]| ''<STATUS>''| Nummer des Status den die bestehende Version im Falle einer Versionierung bekommen soll|
+| [[Workflow#revision_firstnewver]]| ''<WERT>''| Wert den die erste Revision eines Dokuments erhält|
+| [[Workflow#revision_newdoc]]| ''<WERT>''| Numerischer oder alphanumerischer Wert, den ein neu angelegtes Dokument bekommt|
+| [[Workflow#revision_split]]| ''<WERT>''| Zeichen oder Zeichenfolge mit der die Revision vom Dateinamen getrennt ist|
+| [[Workflow#synchronize_ref]]| ''<PARAMETER>''| Definiert welcher Referenzen mit versioniert werden|
+==== newvercall ====
+Mit dem Attribut **newvercall** wird definiert welche Funktion aufgerufen werden soll, um die neue Version des Dokuments zu bearbeiten, z.B. um den Status in der Datei zusetzen.
+Für [[:solid_edge]] kann Beispielsweise die Funktion [[seSetSolidEdgeFileStatusByPath]] des [[Addin]]s [[SEInterface]] genutzt werden.
+<code xml><Workflow> newvercall="SEInterface.seSetSolidEdgeFileStatusByPath %FILEPATH%|0" /></code>
+==== oldvercall ====
+Mit dem Attribut **oldvercall** wird definiert welche Funktion aufgerufen werden soll, um die bestehende (alte) Version des Dokuments zu bearbeiten, z.B. um den Status in der Datei zusetzen.
+=== seSetSolidEdgeFileStatusByPath ===
+Für Solid Edge kann Beispielsweise die Funktion [[seSetSolidEdgeFileStatusByPath]] des [[Addin]]s [[SEInterface]] genutzt werden. Dabei wird der Status der Solid Edge Datei direkt gesetzt.
+<code xml><Workflow> newvercall="SEInterface.seSetSolidEdgeFileStatusByPath %FILEPATH%|0" /></code>
+=== StatusChangeByFilePath ===
+Das oldverstatus wird nicht mehr direkt gesetzt. Es wird nur die Methode StatusChangeByFilePath aufgerufen, die einen echten Statusübergang mit PreCalls und PostCalls ausführt. Dazu muss aber im Gegensatz zu ''seSetSolidEdgeFileStatusByPath'' eine entsprechende Workflowdefinition  in [[StatusWorkflow_Settings]] existieren.
+<code xml><Workflow oldverstatus="" oldvercall="StatusChangeByFilePath %FILEPATH%|StatusWorkflow_Settings|004" /></code>
+=== prmExecuteNamedCalls ===
+Es ist auch möglich einen [[NamedCalls|NamedCall]] zu definieren und hier aufzurufen. Der Unterschied zu einer Workflowdefinition ist, dass z.B. keine PreCalls überprüft werden.
+<code xml><Workflow oldverstatus="" oldvercall="prmExecuteNamedCalls %FILEPATH%|OldVerCall" /></code>
+==== oldvercall_cond ====
+Die Angabe des Attributs ''oldvercall_cond'' ist optional. Diese Bedingung definiert ob ''oldvercall'' für das Dokument ausgeführt wird.
+=== Wichtig ===
+Wenn dieses Attribut definiert ist, wird nicht der Statusworkflow der unter [[StatusWorkflow_Settings]] definiert ist aufgerufen. Es kann nur entweder der Workflowstatus oder direkt die hier definierte [[:funktion]] aufgerufen werden.
+==== synchronize_ref ====
+Das Tag **synchronize_ref** hat folgende Parameter, welche in der angegebenen Reihenfolge, getrennt durch ''|'', angegeben werden müssen.
+^ Parameter^ Wert^ Funktion^
+^ 1| ''ref1''| Revisioniert alle Dokumente in denen dieses Dokument als erste Indexreferenz eingetragen ist|
+^:::| ''refwithname''| Revisioniert nur die Dokumente die auf dieses Dokument referenzieren und den gleichen Namen haben|
+^ 2| ''<DATEITYP>''| Definiert welchen Dateityp die referenzierenden Dokumente haben müssen, z.B. nur ''.dft''|
+<code xml><Workflow synchronize_ref="refwithname|.dft" /></code>
+{{tag>Workflow}}