| ... |
... |
@@ -18,7 +18,7 @@ |
| 18 |
18 |
== Workflowgraph == |
| 19 |
19 |
|
| 20 |
20 |
Der //Workflowgraph// stellt das Herzstück des Workflowdesigners dar, mit welchem die Verarbeitung eines Formulars grafisch repräsentiert wird und bearbeitet werden kann. Der Beginn einer jeden Verarbeitung ist mit dem {{formcycle/}}-Symbol markiert. [[image:workflow_start.png]] |
| 21 |
|
-Der Workflow ist von oben nach unten zu lesen und besteht aus einzelnen //Verarbeitungsketten//. Jede Verarbeitungskette beginnt mit einem [[Ereignis>>||anchor="sec_elements_events"]], welches diese auslöst. Bspw. kann der Klick auf einen bestimmten Button im Formular eine Verarbeitungskette starten, in welcher eine [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail.WebHome]] an den Antragsteller gesendet wird. Wie man an diesem Beispiel sieht, werden innerhalb von Verarbeitungsketten [[Aktionen>>||anchor="sec_elements_actions"]] ausgeführt. Diese Verarbeitungsketten können komplexer werden und sich bspw. abhänging von den Formulareingaben aufsplitten. Diese Abzweigungen werden über [[Bedingungen>>doc:Formcycle.Designer.Workflow.FlowControl.Condition.WebHome]] realisiert. So wird bspw. nur eine E-Mail versendet, wenn der Antragsteller auch eine E-Mail angegeben hat. Wenn dies nicht der Fall ist, wird bspw. ein PDF des Formulars erstellt und dieses dem Antragsteller zurückgegeben. Wie man sieht führen Bedingungen dazu, dass sich eine Verarbeitungskette in zwei //Teilverarbeitungsketten// aufteilt. Jede Verarbeitungskette muss in einem [[Endpunkt>>||anchor="sec_elements_endpoints"]] enden. In der Regel ist ein solcher Endpunkt ein [[Status>>doc:Formcycle.Designer.Workflow.States.WebHome]] in dem sich der Vorgang nach Aursführung der Verarbeitung befinden soll. Im Fall von Bedingungen werden die dadurch entstandenen Teilverarbeitungsketten nach Ausführung der geünschten Aktionen wieder zusammen geführt (siehe [[Abbildung>>||anchor="fig_workflow_example_submit"]]). Jede Teilverarbeitungskette kann allerdings auch einen eigenen Endpunkt definieren. Das hier vorgestellte Beispiel ist in der [[Abbildung>>||anchor="fig_workflow_example_submit"]] als Verarbeitungskette im Arbeitsbereich des Workflowdesigner dargestellt. Treffen mehrere Ereignisse zu, werden die entsprechenden Verarbeitungsketten der Reihe nach von links nach rechts ausgeführt. |
|
21 |
+Der Workflow ist von oben nach unten zu lesen und besteht aus einzelnen //Verarbeitungsketten//. Jede Verarbeitungskette beginnt mit einem [[Ereignis>>||anchor="sec_elements_events"]], welches diese auslöst. Beispielsweise kann der Klick auf einen bestimmten Button im Formular eine Verarbeitungskette starten, in welcher eine [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail.WebHome]] an den Antragsteller gesendet wird. Wie man an diesem Beispiel sieht, werden innerhalb von Verarbeitungsketten [[Aktionen>>||anchor="sec_elements_actions"]] ausgeführt. Diese Verarbeitungsketten können komplexer werden und sich zum Beispiel abhänging von den Formulareingaben aufsplitten. Diese Abzweigungen werden über [[Bedingungen>>doc:Formcycle.Designer.Workflow.FlowControl.Condition.WebHome]] realisiert. So kann beispielsweise der Workflow so konfiguriert werden, dass eine E-Mail nur dann versendet wird, wenn der Antragsteller auch eine E-Mail angegeben hat. Wenn dies nicht der Fall ist, kann zum Beispiel ein PDF des Formulars erstellt und dieses dem Antragsteller zurückgegeben. Wie man sieht führen Bedingungen dazu, dass sich eine Verarbeitungskette in zwei //Teilverarbeitungsketten// aufteilt. Jede Verarbeitungskette muss in einem [[Endpunkt>>||anchor="sec_elements_endpoints"]] enden. In der Regel ist ein solcher Endpunkt ein [[Status>>doc:Formcycle.Designer.Workflow.States.WebHome]], in dem sich der Vorgang nach Ausführung der Verarbeitung befinden soll. Im Fall von Bedingungen werden die dadurch entstandenen Teilverarbeitungsketten nach Ausführung der geünschten Aktionen wieder zusammen geführt (siehe [[Abbildung>>||anchor="fig_workflow_example_submit"]]). Jede Teilverarbeitungskette kann allerdings auch einen eigenen Endpunkt definieren. Das hier vorgestellte Beispiel ist in der [[Abbildung>>||anchor="fig_workflow_example_submit"]] als Verarbeitungskette im Arbeitsbereich des Workflowdesigner dargestellt. Treffen mehrere Ereignisse zu, werden die entsprechenden Verarbeitungsketten der Reihe nach von links nach rechts ausgeführt. |
| 22 |
22 |
|
| 23 |
23 |
{{id name="sec_graph_default"/}} |
| 24 |
24 |
|
| ... |
... |
@@ -58,6 +58,7 @@ |
| 58 |
58 |
* 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. |
| 59 |
59 |
|
| 60 |
60 |
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. |
| 61 |
61 |
|
| 62 |
62 |
==== Elemente des Workflowgraphen ==== |
| 63 |
63 |
|
| ... |
... |
@@ -150,7 +150,7 @@ |
| 150 |
150 |
|
| 151 |
151 |
==== Buttonergnisse ==== |
| 152 |
152 |
|
| 153 |
|
-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]] zu finden. |
|
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. |
| 154 |
154 |
|
| 155 |
155 |
{{id name="sec_elements_events_other"/}} |
| 156 |
156 |
|
| ... |
... |
@@ -161,54 +161,51 @@ |
| 161 |
161 |
; [[Benutzerdefinierte Ereignisse>>doc:Formcycle.Designer.Workflow.Events.Custom.WebHome]] |
| 162 |
162 |
: Ein benutzerdefiniertes Ereignis tritt nicht automatisch ein, sondern muss durch einen Benutzer manuell ausgelöst werden. |
| 163 |
163 |
|
| 164 |
|
-; [[Datum und Uhrzeit>>doc:Formcycle.Designer.Workflow.Events.Custom.WebHome]] |
|
165 |
+; [[Datum und Uhrzeit>>doc:Formcycle.Designer.Workflow.Events.DateAndTime.WebHome]] |
| 165 |
165 |
: Dieses Ereignis tritt ein, sobald ein benutzerdefinierter fester oder berechneter Zeitpunkt eintritt. |
| 166 |
166 |
|
| 167 |
|
-{{id name="sec_elements_actions"/}} |
|
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. |
| 168 |
168 |
|
| 169 |
|
-=== Aktionen === |
|
171 |
+; [[Einladung fehlgeschlagen>>doc:Formcycle.Designer.Workflow.Events.InvitationFailed.WebHome]] |
|
172 |
+: Tritt ein, wenn beim Versenden einer Einladungsmail ein Fehler auftritt. |
| 170 |
170 |
|
| 171 |
|
-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. |
|
174 |
+; [[Einladung versendet>>doc:Formcycle.Designer.Workflow.Events.InvitationSent.WebHome]] |
|
175 |
+: Tritt ein, wenn eine Einladungsmail zu einem Formular versandt wurde. |
| 172 |
172 |
|
| 173 |
|
-* Die gleiche Logik greift auch im Platzhalterdialog bei den zu Verfügung stehenden Aktionsplatzhaltern. |
|
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. |
| 174 |
174 |
|
| 175 |
|
-Referenziert eine Aktion auf Dateien einer vorigen Aktion, geht diese Referenz verloren, wenn die Aktion in eine andere Verarbeitungskette geschoben wird. |
|
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. |
| 176 |
176 |
|
|
183 |
+{{id name="sec_elements_actions"/}} |
|
184 |
+ |
|
185 |
+=== Aktionen === |
|
186 |
+ |
|
187 |
+Eine Liste sämtlicher Workflowaktionen ist [[hier>>doc:Formcycle.Designer.Workflow.Actions.WebHome]] zu finden. |
|
188 |
+ |
| 177 |
177 |
{{id name="sec_elements_flow_control"/}} |
| 178 |
178 |
|
| 179 |
179 |
=== Steuerung === |
| 180 |
180 |
|
| 181 |
|
-Ja/Nein-Label von Bedingungen können umbenannt werden. |
|
193 |
+Eine Liste sämtlicher Steuerungselemente ist [[hier>>doc:Formcycle.Designer.Workflow.FlowControl.WebHome]] zu finden. |
| 182 |
182 |
|
| 183 |
183 |
{{id name="sec_elements_endpoints"/}} |
| 184 |
184 |
|
| 185 |
|
-=== Endpunkte === |
|
197 |
+=== Status === |
| 186 |
186 |
|
| 187 |
|
-==== Status-Endpunkte ==== |
|
199 |
+Status beschreiben den Zustand eines Vorgangs und definieren, wer auf disesen Zugriff hat. Weitere Information zu Status sind [[hier>>doc:Formcycle.Designer.Workflow.States.WebHome]] zu finden. |
| 188 |
188 |
|
| 189 |
|
-==== Aktions-Endpunkte ==== |
| 190 |
|
- |
| 191 |
191 |
{{id name="sec_differences_old_workflow"/}} |
| 192 |
192 |
|
| 193 |
|
- |
| 194 |
194 |
== Unterschiede zur alten Status- & Aktionsverarbeitung == |
| 195 |
195 |
|
| 196 |
196 |
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. |
| 197 |
197 |
|
| 198 |
198 |
|
| 199 |
|
-== Beschreibung des neuen Workflows == |
|
208 |
+== TODO auf Unterseiten == |
| 200 |
200 |
|
| 201 |
|
-* Verarbeitungsketten ... jeweils ein Ereignis auslösend |
| 202 |
|
-* Ereignisse grob beschreiben und auf Unterseite verlinken |
| 203 |
|
-* Aktionen grob Möglichkeiten beschreiben und auf Aktionen verlinken |
| 204 |
|
-* Bedingungen und Fehlerelemente grob beschreiben und auf Aktionen verlinken |
| 205 |
|
-* Endpunkte grob beschreiben und auf Aktionen verlinken |
| 206 |
|
- |
| 207 |
|
- |
| 208 |
|
- |
| 209 |
|
- |
| 210 |
|
-TODO auf Unterseiten: |
| 211 |
|
- |
| 212 |
212 |
* Aktionen des neuen WF sollten immer auch auf die alten verlinken und umgekehrt. |
| 213 |
213 |
* Bei den Aktionen sollte immer auch im ersten Satz stehen, in welcher Gruppe sie sind |
| 214 |
214 |
* 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. |
