Änderungen von Dokument Workflow


Von Version 65.1
bearbeitet von nlo
am 28.07.2021, 12:46
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 77.2
bearbeitet von nlo
am 28.07.2021, 15:11
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -16,7 +16,7 @@
16 16  == Workflowgraph ==
17 17  
18 18  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]]
19 -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.
19 +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.
20 20  
21 21  {{id name="sec_graph_default"/}}
22 22  
... ... @@ -48,12 +48,12 @@
48 48  
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 [[image:workflow_drop_point.png]] befindet. Dies ist auf zwei verschiedene Arten möglich:
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:
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 [[image:workflow_drop_point.png]] in der Verarbeitungskette gezogen.
54 -* 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.
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.
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 [[image:workflow_drop_point.png]] 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.
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 57  
58 58  ==== Elemente des Workflowgraphen ====
59 59  
... ... @@ -77,29 +77,57 @@
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 [[image:workflow_drop_point.png]] innerhalb der Verarbeitungsketten hinzugefügt werden.
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:
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 +
82 82  {{id name="sec_component_element_properties"/}}
83 83  
84 84  === Elementeingenschaften ===
85 85  
95 +Abhängig vom [[Workflowelement>>||anchor="sec_elements"]], welches gerade im [[Arbeitsbereich>>||anchor="sec_component_main"]] ausgewählt ist, ändert sich der Inhalt der //Elementeigenschaften//, welche rechts neben dem Arbeitsbereich dargestellt werden. In den Elementeigenschaften sind sämtliche Parameter eines Elements konfigurierbar. So kann hier bspw. in der Aktion [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail.WebHome]] der Absender, Empfänger, Betreff, Inhalt etc. definiert werden. Wenn die Elementeigenschaften nicht nötig sind, können diese auch über das Pfeil-Symbol am linken Rand der Elementeigenschaften eingeklappt werden.
96 +
86 86  {{id name="sec_component_tool_bar"/}}
87 87  
88 88  === Werkzeugleiste ===
89 89  
90 -* Speichern
101 +; Speichern
102 +: Speichert den Workflowgraphen und somit die Verarbeituungskonfiguration des Formulars. Sollte es Fehler in der Workflowkonfiguration geben (siehe Validieren), kann der Workflow trotzdem gespeichert werden. Das Formular wird in diesem Fall jedoch in den //Wartungsmodus// geschaltet und ist nicht mehr //online// verfügbar, da eine korrekte Verarbeitung von Vorgängen nicht mehr gewährleistet werden kann. Erst wenn alle Fehler in der Workflowkonfiguration behoben wurden, wird das Formular wieder online verfügbar sein.
103 +
91 91  {{id name="sec_component_tool_bar_validate"/}}
92 -* Validieren
93 -* Ansichtsoptionen
94 -* Mehr...
95 -* Öffnen/Vorschau
96 96  
106 +; Validieren
107 +: Überprüft die aktuelle Workflowkonfiguration auf Fehler. Ein Fehler in der Workflowkonfiguration ist bspw. ein nicht ausgefülltes Empfängefeld in der Aktion [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail.WebHome]] oder die Abwesenheit eines Endpunktes in einer Verarbeitungskette.
108 +
109 +; Ansichtsoptionen
110 +: Es stehen verschiedene Ansichtsoptionen zur Verfügung. Der Workflowgraph im [[Arbeitsbereich>>||anchor="sec_component_main"]] kann //vergrößert// oder //verkleinert// sowie wieder //zentriert// werden. Unter dem Menüpunkt //Ansicht// gibt es folgende Ansichtsioptionen:
111 +
112 +* //Hilfslinien anzeigen//: Hilfslinien trennen die einzelnen Verarbeitungsketten visuell.
113 +* //Benutzergruppen anzeigen//: Wenn für bestimmte Ereignisse Benutzergruppenbeschränkungen bestehen, werden diese an der entsprechenden Verarbeitungskette angezeigt.
114 +* //Status anzeigen//: Wenn für bestimmte Ereignisse Statusbeschränkungen bestehen, werden diese an der entsprechenden Verarbeitungskette angezeigt.
115 +* //Verarbeitungsketten ein-/ausblenden//: einzelne oder alle Verarbeitungsketten können ein- bzw. ausgeblendet werden.
116 +
117 +; Mehr...
118 +: 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.
119 +
120 +; Öffnen
121 +: Öffnet das Formular im Live-Modus. Stehen Frontendserver zur Verfügung, kann das Formular auch auf einem der Frontendserver geöffnet werden.
122 +
123 +; Vorschau
124 +: Öffnet das Formular im Vorschaumodus. Hier kann das Formular getestet werden ohne dass Vorgänge erstellt werden.
125 +
97 97  {{id name="sec_component_status_bar"/}}
98 98  
99 99  === Statusleiste ===
100 100  
101 -* Navigation
102 -* formularinformationen
130 +Die Statusleiste befindet sich unterhalb des [[Arbeitsbereichs>>||anchor="sec_component_main"]]. Auf der linken Seite ist der Navigationsbereich, wodurch erkennbar ist, wo sich das selektierte Formularelement im workflowgraphen befindet. Auf der rechten Seite sind Detailinformationen zum Formular und aktuellen Version sichtbar.
103 103  
104 104  {{id name="sec_elements"/}}
105 105  
... ... @@ -107,26 +107,41 @@
107 107  
108 108  {{id name="sec_elements_events"/}}
109 109  
110 -=== Ereignisse ===
138 +=== Buttons & Ereignisse ===
111 111  
140 +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
141 +
142 +{{id name="sec_elements_events_buttons"/}}
143 +
144 +==== Buttonergnisse ====
145 +
146 +{{id name="sec_elements_events_other"/}}
147 +
148 +==== weitere Ereignisse ====
149 +
112 112  {{id name="sec_elements_actions"/}}
113 113  
114 114  === Aktionen ===
115 115  
154 +{{id name="sec_elements_flow_control"/}}
155 +
156 +=== Steuerung ===
157 +
116 116  {{id name="sec_elements_endpoints"/}}
117 117  
118 118  === Endpunkte ===
119 119  
120 -* Status-Endpunkte
121 -* Aktions-Endpunkte
162 +==== Status-Endpunkte ====
122 122  
123 -== Grobe Beschreibung ==
164 +==== Aktions-Endpunkte ====
124 124  
125 -* Grundkonzepte
126 -* alter und neuer Workflow ansprechen
166 +{{id name="sec_differences_old_workflow"/}}
127 127  
128 -Verlinkung auf alten Workflow (Der alte Workflow wird in einer Unterkategorie positioniert und enthält dort alle bisherigen Unterseiten unverändert.)
168 +== Unterschiede zur alten Status- & Aktionsverarbeitung ==
129 129  
170 +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.
171 +
172 +
130 130  == Beschreibung des neuen Workflows ==
131 131  
132 132  * Verarbeitungsketten ... jeweils ein Ereignis auslösend
... ... @@ -142,7 +142,6 @@
142 142  
143 143  Hinweise von Andre:
144 144  
145 -* Jeder Verarbeitungskette muss auf einen Endpunkt enden. Wird z.B. eine Bedingung am Ende einer Verarbeitungskette verwendet, muss sowohl im Ja-Fall als auch Nein-Fall sich ein Endpunkt befinden.
146 146  * Treffen mehrere Ereignisse zu, werden die entsprechenden Verarbeitungsketten der Reihe nach von links nach rechts ausgeführt.
147 147  * 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.
148 148  * Es gibt eine Validierung des gesamten Workflows. Formular wird offline geschaltet, wenn invalider Workflow gespeichert wird.