Änderungen von Dokument Workflow


Von Version 77.5
bearbeitet von nlo
am 28.07.2021, 15:17
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 83.3
bearbeitet von nlo
am 28.07.2021, 16:07
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -11,6 +11,8 @@
11 11  
12 12  Der Workflowdesigner ermöglicht es, die Verarbeitung von Formularen auf eine intuitive und visuelle Weise per Drag & Drop zu erstellen. Die Verarbeitung von Formularen wird als ein ereignisbasiertes Flussdiagramm dargestellt. Dieses Flussdiagramm wird im Folgenden als der [[**Workflowgraph**>>||anchor="sec_graph"]] bezeichnet. Innerhalb des //Workflowgraphen// werden einzelne Verarbeitungsketten angelegt, welche durch Ereignisse ausgelöst werden. Ereignisse sind etwa der Klick auf einen Absendebutton, das Bestätigen eines Double-Opt-In-Vorgangs oder das Überschreitung eines definierten Zeitpunktes. Abzweigungen innerhalb des Graphen stellen Entscheidungen oder Bedingungen dar. Durch diese Bedingungen können unterschiedliche Aktionen ausgeführt werden, abhängig vom Status eines Vorgangs und/oder den erfassten Formulardaten.
13 13  
14 +Mit dem Workflowdesigner wird der Workflow einer gewählte Version des Formulars bearbeitet. Wird keine Formularversion explizit gewählt, so wird die aktive Formularversion bearbeitet.
15 +
14 14  {{id name="sec_graph"/}}
15 15  
16 16  == Workflowgraph ==
... ... @@ -48,7 +48,7 @@
48 48  * 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.
49 49  * 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.
50 50  
51 -In beiden Fällen entsteht eine neue Verarbeitungskette mit dem gewählten Ereignis. Verarbeitungsketten können mit einem Klick auf deren Namen umbenannt werden.
53 +In beiden Fällen entsteht eine neue Verarbeitungskette mit dem gewählten Ereignis. Verarbeitungsketten können mit einem Klick auf deren Namen umbenannt werden. Unterhalb des Namens kann diesen auch eine Beschreibung hinzugefügt werden.
52 52  
53 53  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:
54 54  
... ... @@ -56,6 +56,7 @@
56 56  * 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.
57 57  
58 58  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.
61 +Die Ja/Nein-Label von Bedingungen können umbenannt werden, indem man auf diese klickt.
59 59  
60 60  ==== Elemente des Workflowgraphen ====
61 61  
... ... @@ -116,6 +116,9 @@
116 116  * //Status anzeigen//: Wenn für bestimmte Ereignisse Statusbeschränkungen bestehen, werden diese an der entsprechenden Verarbeitungskette angezeigt.
117 117  * //Verarbeitungsketten ein-/ausblenden//: einzelne oder alle Verarbeitungsketten können ein- bzw. ausgeblendet werden.
118 118  
122 +; Rückgängig/Wiederholen
123 +: Veränderungen an der Struktur des Workflows können rückgängig gemacht oder wiederholt werden. Änderungen an den [[Elementeigenschaften>>||anchor="sec_component_element_properties"]] werden nicht berücksichtigt.
124 +
119 119  ; Mehr...
120 120  : Unter dem Menüpunkt //Mehr...// sind weitere Inhalte zu finden, die [[an dieser Stelle>>doc:Formcycle.Designer.WebHome||anchor="sec_tools_more"]] näher beschrieben werden.
121 121  
... ... @@ -139,63 +139,66 @@
139 139  
140 140  === Buttons & Ereignisse ===
141 141  
142 -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
148 +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 haben daher ihre eigen Kategorie in der [[Elementauswahl>>||anchor="sec_component_element_selection"]].
143 143  
144 144  {{id name="sec_elements_events_buttons"/}}
145 145  
146 146  ==== Buttonergnisse ====
147 147  
154 +Für jeden [[Button>>doc:Formcycle.Designer.Form.FormElements.Button.WebHome]] im Formular, der zum //Absenden// oder //Speichern// verwendet wird, gibt es ein entsprechendes Ereignis in der [[Elementauswahl>>||anchor="sec_component_element_selection"]]. Diese Buttonereignisse können dann ganz einfach in den Workflowgraphen gezogen werden. Somit kann für jeden Button eine eigene Verarbeitungskette definiert werden. Weitere Informationen zu Buttonereignissen sind [[hier>>doc:Formcycle.Designer.Workflow.Events.SubmitButton.WebHome]] und [[hier>>doc:Formcycle.Designer.Workflow.Events.SubmitButtonAdvanced.WebHome]] zu finden.
155 +
148 148  {{id name="sec_elements_events_other"/}}
149 149  
150 150  ==== weitere Ereignisse ====
151 151  
152 -{{id name="sec_elements_actions"/}}
160 +Neben den Buttonereignissen gibt es noch folgende Ereignisse:
153 153  
154 -=== Aktionen ===
162 +; [[Benutzerdefinierte Ereignisse>>doc:Formcycle.Designer.Workflow.Events.Custom.WebHome]]
163 +: Ein benutzerdefiniertes Ereignis tritt nicht automatisch ein, sondern muss durch einen Benutzer manuell ausgelöst werden.
155 155  
156 -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.
165 +; [[Datum und Uhrzeit>>doc:Formcycle.Designer.Workflow.Events.DateAndTime.WebHome]]
166 +: Dieses Ereignis tritt ein, sobald ein benutzerdefinierter fester oder berechneter Zeitpunkt eintritt.
157 157  
158 -* Die gleiche Logik greift auch im Platzhalterdialog bei den zu Verfügung stehenden Aktionsplatzhaltern.
168 +; [[Double-Opt-In bestätigen>>doc:Formcycle.Designer.Workflow.Events.DoubleOptInConfirmed.WebHome]]
169 +: Sobald ein Nutzer auf einen vorher generierten Double-Opt-In Link klickt und damit den Double-Opt-In Prozess bestätigt, tritt dieses Ereignis ein.
159 159  
160 -{{id name="sec_elements_flow_control"/}}
171 +; [[Einladung fehlgeschlagen>>doc:Formcycle.Designer.Workflow.Events.InvitationFailed.WebHome]]
172 +: Tritt ein, wenn beim Versenden einer Einladungsmail ein Fehler auftritt.
161 161  
162 -=== Steuerung ===
174 +; [[Einladung versendet>>doc:Formcycle.Designer.Workflow.Events.InvitationSent.WebHome]]
175 +: Tritt ein, wenn eine Einladungsmail zu einem Formular versandt wurde.
163 163  
164 -{{id name="sec_elements_endpoints"/}}
177 +; [[Nach Statuswechsel>>doc:Formcycle.Designer.Workflow.Events.AfterStateChange.WebHome]]
178 +: Dieses Ereignis tritt einmalig ein, nachdem der Vorgang nach einem Statuswechsel für eine gewisse Zeit in einem bestimmten Status verweilt hat.
165 165  
166 -=== Endpunkte ===
180 +; [[Workflow-Fehler>>doc:Formcycle.Designer.Workflow.Events.WorkflowError.WebHome]]
181 +: Dieses Ereignis tritt ein, sobald im Workflow an irgendeiner Stelle ein unbehandelter Fehler auftritt.
167 167  
168 -==== Status-Endpunkte ====
183 +{{id name="sec_elements_actions"/}}
169 169  
170 -==== Aktions-Endpunkte ====
185 +=== Aktionen ===
171 171  
172 -{{id name="sec_differences_old_workflow"/}}
187 +Eine Liste sämtlicher Workflowaktionen ist [[hier>>doc:Formcycle.Designer.Workflow.Actions.WebHome]] zu finden.
173 173  
174 -== Unterschiede zur alten Status- & Aktionsverarbeitung ==
189 +{{id name="sec_elements_flow_control"/}}
175 175  
176 -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.
191 +=== Steuerung ===
177 177  
193 +Eine Liste sämtlicher Steuerungselemente ist [[hier>>doc:Formcycle.Designer.Workflow.FlowControl.WebHome]] zu finden.
178 178  
179 -== Beschreibung des neuen Workflows ==
195 +{{id name="sec_elements_endpoints"/}}
180 180  
181 -* Verarbeitungsketten ... jeweils ein Ereignis auslösend
182 -* Ereignisse grob beschreiben und auf Unterseite verlinken
183 -* Aktionen grob Möglichkeiten beschreiben und auf Aktionen verlinken
184 -* Bedingungen und Fehlerelemente grob beschreiben und auf Aktionen verlinken
185 -* Endpunkte grob beschreiben und auf Aktionen verlinken
186 -* Funktionsweise der Status kurz erklären, evtl. auf Unterseiten verlinken. Erwähnen, dass Status jetzt auch versioniert sind.
187 -* Kopieren, Deaktivieren, Löschen-Icon an Ereignissen und Aktionen
188 -* 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.
197 +=== Status ===
189 189  
190 -Direkt darunter kommen alle Elemente des Workflows
199 +Weitere Information zu Status sind [[hier>>doc:Formcycle.Designer.Workflow.States.WebHome]] zu finden.
191 191  
192 -Hinweise von Andre:
201 +{{id name="sec_differences_old_workflow"/}}
193 193  
194 -* 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.
195 -* Referenziert eine Aktion auf Dateien einer vorigen Aktion, geht diese Referenz verloren, wenn die Aktion in eine andere Verarbeitungskette geschoben wird.
196 -* 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.
197 -* 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.
203 +== Unterschiede zur alten Status- & Aktionsverarbeitung ==
198 198  
205 +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. Zudem sind die Status des neuen Workflows mit der Formularversion versioniert, d.h. jede Formularversion kann unterschiedliche Status besitzen. Der Status //Eingegangen// ist der Standardstatus und kann weder gelöscht noch umbenant werden.
206 +
207 +
199 199  TODO auf Unterseiten:
200 200  
201 201  * Aktionen des neuen WF sollten immer auch auf die alten verlinken und umgekehrt.