Änderungen von Dokument Workflow


Von Version 72.1
bearbeitet von nlo
am 28.07.2021, 14:19
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 56.1
bearbeitet von nlo
am 27.07.2021, 16:40
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -35,7 +35,7 @@
35 35  
36 36  == Oberfläche ==
37 37  
38 -Wie in der [[Abbildung>>||anchor="fig_workflow_overview"]] zu sehen, besteht der Workflowdesigner aus den folgenden Komponente: [[Arbeitsbereich>>||anchor="sec_component_main"]], [[Elementauswahl>>||anchor="sec_component_element_selection"]], [[Elementeigenschaften>>||anchor="sec_component_element_properties"]], [[Werkzeug->>||anchor="sec_component_tool_bar"]] & [[Statusleiste>>||anchor="sec_component_status_bar"]], welche im Folgenden kurz vorgestellt werden sollen. Allgemeine Informationen zur Werkzeugleiste sind [[hier>>doc:Formcycle.Designer.WebHome]] zu finden.
38 +Wie in der [[Abbildung>>||anchor="fig_workflow_overview"]] zu sehen, besteht der Workflowdesigner aus den folgenden Komponente: [[Arbeitsbereich>>||anchor="sec_component_main"]], [[Elementauswahl>>||anchor="sec_component_element_selection"]], [[Elementeigenschaften>>||anchor="sec_component_element_properties"]] & [[Statusleiste>>||anchor="sec_component_status_bar"]], welche im Folgenden kurz vorgestellt werden sollen. Über diesen Bereichen befindet sich die [[Werkzeugleiste>>||anchor="sec_component_tool_bar"]] des Workflowdesigners (Allgemeine Informationen zur Werkzeugleiste sind [[hier>>doc:Formcycle.Designer.WebHome]] zu finden).
39 39  
40 40  {{id name="sec_component_main"/}}
41 41  
... ... @@ -43,51 +43,21 @@
43 43  
44 44  Der Arbeitsbereich stellt den [[Workflowgraphen>>||anchor="sec_graph"]] dar. Jederzeit können dem Workflowgraphen neue [[Ereignisse>>||anchor="sec_compontents_events"]] hinzugefügt werden. Es gibt zwei Möglichkeiten dem Workflowgraphen ein neues Ereignis hinzuzufügen:
45 45  
46 -* Ein Ereignis wird aus der [[Elementauswahl>>||anchor="sec_component_element_selection"]] am linken Rand per Drag & Drop in den Arbeitsbereich auf das Plus-Sysmbol {{ficon name="plus-circle-outline"/}} am Anfang des Workflowgraphen gezogen.
47 -* Es wird auf Plus-Symbol {{ficon name="plus-circle-outline"/}} am Anfang des Workflowgraphen geklickt. Daraufhin öffnet sich ein Kontextmenü über welches das Ereignis ausgewählt werden kann.
48 -
46 +* Ein Ereignis wird aus der [[Elementauswahl>>||anchor="sec_component_element_selection"]] am linken Rand per Drag & Drop in den Arbeitsbereich auf das Plus-Sysmbol [[image:workflow_plus.png]] am Anfang des Workflowgraphen gezogen.
47 +* Es wird auf Plus-Symbol [[image:workflow_plus.png]] am Anfang des Workflowgraphen geklickt. Daraufhin öffnet sich ein Kontextmenü über welches das Ereignis ausgewählt werden kann.
49 49  In beiden Fällen entsteht eine neue Verarbeitungskette mit dem gewählten Ereignis.
50 50  
51 -Verarbeitungsketten können überall da neue [[Workflowelemente>>||anchor="sec_compontents"]] hinzugefügt werden, wo sich ein sog. Droppunkt {{ficon name="circle-outline"/}} befindet. Dies ist auf zwei verschiedene Arten möglich:
50 +Verarbeitungsketten können überall da neue [[Workflowelemente>>||anchor="sec_compontents"]] hinzugefügt werden, wo sich ein sog. Droppunkt [[image:workflow_drop_point.png]] befindet. Dies ist auf zwei verschiedene Arten möglich:
52 52  
53 -* Ein Workflowelement wird aus der [[Elementauswahl>>||anchor="sec_component_element_selection"]] am linken Rand per Drag & Drop in den Arbeitsbereich auf den gewünschten Droppunkt {{ficon name="circle-outline"/}} in der Verarbeitungskette gezogen.
54 -* Es wird auf den gewünschten Droppunkt {{ficon name="circle-outline"/}} geklickt. Daraufhin öffnet sich ein Kontextmenü über welches das Workflowelement ausgewählt werden kann.
52 +* Ein Workflowelement wird aus der [[Elementauswahl>>||anchor="sec_component_element_selection"]] am linken Rand per Drag & Drop in den Arbeitsbereich auf den gewünschten Droppunkt [[image:workflow_drop_point.png]] in der Verarbeitungskette gezogen.
53 +* Es wird auf den gewünschten Droppunkt [[image:workflow_drop_point.png]] geklickt. Daraufhin öffnet sich ein Kontextmenü über welches das Workflowelement ausgewählt werden kann.
55 55  
56 -Wenn eine neue Verarbeitungskette durch das Anlgen eines [[Ereignisses>>||anchor="sec_elements_events"]] erstellt wurde, erhält diese Verarbeitungskette standardmäßig den Status-Endpunkt //Eingegangen//. [[Endpunkte>>||anchor="sec_elements_endpoints"]] können aus Verarbeitungsketten entfernt werden. Jede Verarbeitungskette, muss allerdings wenigstens einen Endpunkt besitzen. Ein neuer Endpunkt kann hinzugefügt werden indem dieser aus der [[Elementauswahl>>||anchor="sec_component_element_selection"]] auf einen Droppunkt {{ficon name="circle-outline"/}} innerhalb der Verarbeitungskette oder auf den aktuellen Endpunkt der (Teil-)Verarbeitungskette gezogen wird. Wurde der Endpunkt der gesamten Verarbeitungskette gelöscht, kann auch ein neuer Enpukt definiert werden, in dem auf den Platzhalter für den Endpunkt geklickt wird. Daraufhin öffnet sich ein Kontextmenü über welches ein Endpunkt ausgewählt werden kann.
57 -
58 -==== Elemente des Workflowgraphen ====
59 -
60 -Um die Eigenschaften eines [[Workflowelements>>||anchor="sec_elements"]] des Workflowgraphen anzuzeigen, muss auf das entsprechende Workflowelement geklickt werden. Sämtliche Eigenschaften des Elementes werden daraufhin rechts neben dem Workflowgraphen in den [[Elementeigenschaften>>||anchor="sec_component_element_properties"]] dargestellt und können dort angepasst werden. Workflowelemente können innerhalb und zwischen Verarbeitungsketten verschoben werden.
61 -
62 -Wird der Cursor über eine Workflowelement im Workflowgraphen bewegt erscheinen über diesem folgende zusätzliche Optionen:
63 -
64 -; {{icon name="trash"/}} Löschen
65 -: Löscht das gewählte Workflowelment
66 -
67 -; {{icon name="ban"/}} Deaktivieren
68 -: Deaktiviert das gewählte Workflowelement. Wird ein [[Ereignis>>||anchor="sec_elements_events"]] deaktiviert, dann ist dessen gesamte Verarbeitungskette deaktiviert.
69 -
70 -; {{ficon name="content-copy"/}} Duplizieren
71 -: Dupliziert das gewählte Workflowelement. Die Kopie wird unterhalb des Originals in den Workflowgraphen eingefügt. [[Ereignisse>>||anchor="sec_elements_events"]] könnne nicht dupliziert werden.
72 -
73 -; {{icon name="info-circle"/}} Kurzinfo
74 -: Gibt eine Zusammenfassung des Workflowelmentes. Für [[Ereignisse>>||anchor="sec_elements_events"]] beinhaltet dies die Angabe der durch das Ereignis bereitgestellten Werte. für das Ereignis //Double-Opt-In// bestätigt wird bspw. bereitgestellt in welcher Verarbeitungskette der Double-Opt-In initialisiert wurde. Für [[Aktionen>>||anchor="sec_elements_actions"]] werden die Konfigurationsparameter und deren Werte sowie die Rückgabewerte bei Erfolg bzw.Fehler aufgelistet. Die Aktion //Datenbank-Abfrage// gibt bspw. bei Erfolg das Result dieser Abfrage zurück. Mit diesen Rückgabewerten von Ereignissen oder Aktionen kann im weiteren Verlauf des Workflowgraphen also in nachfolgenden Aktione gearbeitet werden.
75 -
76 76  {{id name="sec_component_element_selection"/}}
77 77  
78 78  === Elementauswahl ===
79 79  
80 -Die Elementauswahl kann über das Pfeilsymbol am Rand eingeklappt werden, wodurch mehr Platz für den Arbeitsbereich entsteht. Dem Workflowgraphen können trotzdem neue Elemente mit einem Klick auf die sog. Droppunkte {{ficon name="circle-outline"/}} innerhalb der Verarbeitungsketten hinzugefügt werden (siehe [[Arbeitsbereich>>||anchor="sec_component_main"]]). In der Elementauswahl sind sämtliche Elemente Verfügbar, die im Workflwo verwendet werden können. Um ein Element im Workflowgraphen im [[Arbeitsbereich>>||anchor="sec_component_main"]] zu verwenden, muss es auf einen möglichen Droppunkt ({{ficon name="circle-outline"/}}) im Workflowgraphen im [[Arbeitsbereich>>||anchor="sec_component_main"]] gezogen werden. Abhängig vom Typ des Workflowelementes stehen unterschiedliche mögliche Droppunkte zur Verfügung. Ereginsse können bspw nur am Anfang des Workflowgraphen ({{ficon name="plus-circle-outline"/}}) angehangen werden. Die Workflowelmente sind in unterschiedliche Kategorien aufgeteilt. Wird der Cursor über den oberen rechten Rand der Elementauswahl bewegt, werden die Elementkategorien sichtbar. Die Elemente sind in folgende Kategorien unterteilt:
59 +Die Elementauswahl kann über das Pfeilsymbol am Rand eingeklappt werden, wodurch mehr Platz für den Arbeitsbereich entsteht. Dem Workflowgraphen können trotzdem neue Elemente mit einem Klick auf die sog. Droppunkte [[image:workflow_drop_point.png]] innerhalb der Verarbeitungsketten hinzugefügt werden.
81 81  
82 -* **Buttons**
83 -* **Ereignisse**
84 -* **Aktionen**
85 -* **Steuerung**
86 -* **Status**
87 -
88 -Die Elementauswahl kann mit einem Klick auf die gewählte Kategorie begrenzt werden. Ein nochmaliger Klick sorgt dafür, dass diese Beschränkung wieder aufgehoben wird. Wird die //Strg//-Taste unter Windows bzw. die //Ctrl//-Taste unter MacOS gehalten, können mehrere Kategorien auf einmal ausgewählt werden. Für detailliertere Informationen zu den einzelnen Elementen innerhalb der Kategorien siehe [[Workflowelemente>>||anchor="sec_elements"]].
89 -
90 -
91 91  {{id name="sec_component_element_properties"/}}
92 92  
93 93  === Elementeingenschaften ===
... ... @@ -96,20 +96,10 @@
96 96  
97 97  === Werkzeugleiste ===
98 98  
99 -* Speichern
100 -{{id name="sec_component_tool_bar_validate"/}}
101 -* Validieren
102 -* Ansichtsoptionen
103 -* Mehr...
104 -* Öffnen/Vorschau
105 -
106 106  {{id name="sec_component_status_bar"/}}
107 107  
108 108  === Statusleiste ===
109 109  
110 -* Navigation
111 -* formularinformationen
112 -
113 113  {{id name="sec_elements"/}}
114 114  
115 115  == Workflowelemente ==
... ... @@ -116,36 +116,16 @@
116 116  
117 117  {{id name="sec_elements_events"/}}
118 118  
119 -=== Buttons & Ereignisse ===
79 +=== Ereignisse ===
120 120  
121 -Eregnisse bilden den Beginn von Arbeitsketten und können abhängig vom Typ auf unterschiedliche Art& Weise ausgelöst werden. Eine besondere, weil häufig verwendete, Form von Ereignissen sind [[Buttonereignisse>>||anchor="sec_elements_events_buttons"]]. Diese Ereignisse sind daher
122 -
123 -{{id name="sec_elements_events_buttons"/}}
124 -==== Buttonergnisse ====
125 -
126 -{{id name="sec_elements_events_other"/}}
127 -==== weitere Ereignisse ====
128 -
129 129  {{id name="sec_elements_actions"/}}
130 130  
131 131  === Aktionen ===
132 132  
133 -{{id name="sec_elements_flow_control"/}}
134 -
135 -=== Steuerung ===
136 -
137 137  {{id name="sec_elements_endpoints"/}}
138 138  
139 139  === Endpunkte ===
140 140  
141 -==== Status-Endpunkte ====
142 -==== Aktions-Endpunkte ====
143 -
144 -{{id name="sec_differences_old_workflow"/}}
145 -== Unterschiede zur alten Status- & Aktionsverarbeitung ==
146 -
147 -Sowohl im neuen Workflow als auch in der alten [[Status- & Aktionsverarbeitung>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.WebHome]] gibt es Status. Vorgänge können in beiden Workflows einen Status annehmen. In der alten Status- & Aktionsverarbeitung werden Verarbeitungsketten in den einzelnen Status definiert. Zustandsabhängige Entscheidungen können über Bedingungen an den Aktionen realisiert werden, insbesondere unter Verwendung der Aktion //Statuswechsel//. Verarbeitungsketten werden also über Status ausgelöst. Im neuen Workflow sind Status lediglich Endpunkte. Status beschreiben den Zustand eines Vorgangs und definieren, wer auf disesen Zugriff hat, mehr nicht. Verarbeitungsketten werden über Ereignisse und nicht mehr Status ausgelöst.
148 -
149 149  == Grobe Beschreibung ==
150 150  
151 151  * Grundkonzepte
... ... @@ -160,9 +160,6 @@
160 160  * Aktionen grob Möglichkeiten beschreiben und auf Aktionen verlinken
161 161  * Bedingungen und Fehlerelemente grob beschreiben und auf Aktionen verlinken
162 162  * Endpunkte grob beschreiben und auf Aktionen verlinken
163 -* Funktionsweise der Status kurz erklären, evtl. auf Unterseiten verlinken. Erwähnen, dass Status jetzt auch versioniert sind.
164 -* Kopieren, Deaktivieren, Löschen-Icon an Ereignissen und Aktionen
165 -* Info-Icon (welches an jedem Ereignis / Aktion sich befindet) beschreiben: Enthält Beschreibung, Zusammenfassung der Konfiguration, Rückgabewerte mit Platzhaltern, mögliche auftretende Fehler (=> auf Platzhalter [$%LAST_ERROR%] [%$Aktion.ERROR_CODE%] etc. hinweisen und verlinken) sowie durch Daten, welche bei jedem Fehler zur Verfügung gestellt werden.
166 166  
167 167  Direkt darunter kommen alle Elemente des Workflows
168 168  
... ... @@ -173,11 +173,6 @@
173 173  * Eine Ausführung des Workflows ist fehlerhaft, wenn eine Aktion in einem Fehler endete und dieser Fehler nicht behandelt wurde (Abschlusseite: "Oops". Andernfalls ist die Ausführung des Workflows erfolgreich.
174 174  * Es gibt eine Validierung des gesamten Workflows. Formular wird offline geschaltet, wenn invalider Workflow gespeichert wird.
175 175  * Wird ein Workflow geändert, nicht gespeichert und neu geladen, erscheint ein Dialog, mit dem der alte Stand wiederherstellgt werden kann. Dabei wird nicht gespeichert, sondern erst, wenn der Nutzer auf Speichern klickt.
176 -* Bei einigen Aktionen können Dateien ausgewählt werden, die von anderen Aktionen erzeugt werden. Dabei können alle Aktionen ausgewählt werden, die potentiell vor der Aktion ausgeführt werden können. Z.B. wenn "Aktion A -> Bedingung(ja=Aktion B,nein=Aktion C), Aktion D" konfiguriert ist, dann kann in D Aktion A ausgewählt werden, diese kommt immer von A. Aber auch sowohl B als auch C können ausgewählt werden, weil je nach Ausgang der Bedingung B oder C vor D kommen können. In Aktion C kann aber nicht B ausgewählt werden, weil B nie vor C kommen kann.
177 -** Die gleiche Logik greift auch im Platzhalterdialog bei den zu Verfügung stehenden Aktionsplatzhaltern.
178 -* Referenziert eine Aktion auf Dateien einer vorigen Aktion, geht diese Referenz verloren, wenn die Aktion in eine andere Verarbeitungskette geschoben wird.
179 -* Umbenannt werden kann: Name der Verarbeitungskette und Ja/Nein-Label von Bedingungen durch Klick auf den Namen. Zudem kann durch Klick die Beschreibung geändert werden.
180 -* Bei der Redo/Undo-Funktionalität werden alle Änderungen an der Struktur des Workflows berücksichtigt. Nicht berücksichtigt werden Änderungen rechts im Properties-Panel.
181 181  
182 182  TODO auf Unterseiten:
183 183  
... ... @@ -184,3 +184,4 @@
184 184  * Aktionen des neuen WF sollten immer auch auf die alten verlinken und umgekehrt.
185 185  * Bei den Aktionen sollte immer auch im ersten Satz stehen, in welcher Gruppe sie sind
186 186  * Bei Legacy Aktionen sollte dies gernerell darüber stehen in einem Hinweisfeld. Die Aktionen , welche schon in der Version 6 deprecated waren, sollten dies dann extra im Text erwähnt bekommen.
119 +* Von Andre: Bei einigen Aktionen können Dateien ausgewählt werden, die von anderen Aktionen erzeugt werden. Dabei können alle Aktionen ausgewählt werden, die potentiell vor der Aktion ausgeführt werden können. Z.B. wenn "Aktion A -> Bedingung(ja=Aktion B,nein=Aktion C), Aktion D" konfiguriert ist, dann kann in D Aktion A ausgewählt werden, diese kommt immer von A. Aber auch sowohl B als auch C können ausgewählt werden, weil je nach Ausgang der Bedingung B oder C vor D kommen können. In Aktion C kann aber nicht B ausgewählt werden, weil B nie vor C kommen kann.