|
|
Zeile 1: |
Zeile 1: |
| == Ziel == | | /* Das folgende JavaScript wird für alle Benutzer geladen. */ |
| In diesem Beispiel wird der Workflow ''Gruppen-Feedback'' so angepasst, dass der '''Schwellenwert der Benutzerzahl''' angepasst wird. Dieser Schwellenwert definiert, wann der Workflow vom System abgeschlossen wird.
| | if ( mw.config.get( 'wgCanonicalSpecialPageName' ) === 'Watchlist' ) { |
| | document.body.classList.add( 'mw-rcfilters-ui-initialized' ); |
| | } |
| | if ( mw.config.get( 'wgCanonicalSpecialPageName' ) === 'RecentChanges' ) { |
| | document.body.classList.add( 'mw-rcfilters-ui-initialized' ); |
| | } |
|
| |
|
| == Schritte ==
| | /*BITV tabelle*/ |
|
| |
|
| # '''Ursprüngliches ''BPMN''''' aus Github ins Wiki übertragen.
| | var allTableCells = document.getElementById("bitv").getElementsByTagName("td"); |
| # '''Schwellenwert''' für benötigtes Benutzerfeedbacks festsetzen.
| |
| # '''Systemnachricht''' für Workflow-Titel im Wiki erstellen.
| |
| #'''Workflow-Trigger''' definieren.
| |
| # '''Testen''' des Workflows.
| |
|
| |
|
| == Anleitung ==
| |
|
| |
|
| === BPMN übertragen === | | for( var i = 0; i < allTableCells.length; i++ ) { |
| So übertragen Sie den ursprünglichen BPMN-Prozess ins Wiki:
| |
|
| |
|
| # '''Gehen''' Sie zur [https://github.com/wikimedia/mediawiki-extensions-Workflows/blob/4.1.1/workflow/GroupFeedback.bpmn Github-Seite für den Workflow "Gruppen-Feedback"].
| | var node = allTableCells[i]; |
| # '''Kopieren''' Sie das XML.
| |
| # '''Erstellen''' Sie die Seite ''MediaWiki:GruppenFeedbackTeam.bpmn''
| |
| # '''Kopieren''' Sie das XML in den Quelltext der neuen ''bpmn''-Seite.
| |
| # '''Speichern''' Sie die Seite.[[Datei:Gruppen-Feedback anpassen Github.png|alternativtext=XML kopieren|zentriert|mini|750x750px|XML kopieren]]
| |
| {{Hinweisbox|boxtype=Hinweis|icon=|Note text=Die Links zu den BPMN-Dokumenten für die 4 Standard-Workflows finden Sie bei den einzelnen Workflow-Beschreibungen auf der [[Handbuch:Erweiterung/Workflows|Workflows Hilfeseite]].|bgcolor=}}
| |
|
| |
|
| === Schwellenwert festsetzen ===
| |
| So ändern Sie den Schwellenwert der Benutzeranzahl. Dieser bestimmt den Abschluss des Workflows:
| |
|
| |
|
| # '''Wechseln''' Sie auf der soeben erstellten Seite in den Bearbeitungsmodus.
| | //get the text from the first child node - which should be a text node |
| # '''Definieren''' Sie im Element ''<wf:threshhold>'' den ''Wert'' und die ''Einheit'' für die Berechnung des Workflow-Abschlusses. <span /><span /><br />Wenn der Workflow nach Feedback von 50% der Mitglieder der Gruppe abgeschlossen werden soll, geben Sie an:<syntaxhighlight lang="text">
| |
| <wf:threshold>
| |
| <wf:type>complete</wf:type>
| |
| <wf:value>50</wf:value>
| |
| <wf:unit>percent</wf:unit>
| |
| </wf:threshold>
| |
| </syntaxhighlight>Alternatives Beispiel - Workflow-Abschluss, wenn 4 Mitglieder in der Gruppe ihre Aufgabe erledigt haben:<syntaxhighlight lang="text">
| |
| <wf:threshold>
| |
| <wf:type>complete</wf:type>
| |
| <wf:value>4</wf:value>
| |
| <wf:unit>users</wf:unit>
| |
| </wf:threshold>
| |
| </syntaxhighlight>
| |
| # '''Speichern''' Sie die Seite.
| |
|
| |
|
| === Systemnachricht erstellen === | | var currentText = node.childNodes[0].nodeValue; |
| Falls in der Workflow-Übersicht und anderen Workflow-basierten Inhalten kein lesbarer Titel angezeigt wird, handelt es sich hier um eine Systemnachricht.
| |
|
| |
| [[Datei:Gruppen-Feedback anpassen systemnachricht.png|alternativtext=Systemnachricht anpassen|zentriert|mini|650x650px|Systemnachricht anpassen]]
| |
| Um diese mit einem lesbaren Titel zu ersetzen:
| |
| # '''Erstellen''' Sie die Seite MediaWiki:<hier Systemnachricht einsetzen>. Also z.B. für die im Screenshot gezeigte Nachricht <workflows-wikipage-definition-GroupFeedbackTeam-title>
| |
| # '''Geben''' Sie im Seiteninhalt den gewünschten Titel ein.[[Datei:Gruppen-Feedback anpassen systemnachricht-seite.png|alternativtext=Titel angeben|zentriert|mini|650x650px|Titel angeben]]
| |
| # '''Speichern''' Sie die Systemnachricht. Der Titel wird nun auf der Benutzeroberfläche angezeigt.[[Datei:Gruppen-Feedback anpassen Workflowtitel.png|alternativtext=Anzeige des gewünschten Titels|zentriert|mini|650x650px|Anzeige des gewünschten Titels]]
| |
|
| |
|
| === Workflow-Trigger definieren === | | currentText = currentText.trim(); |
| Damit der Workflow ausgewählt werden kann, muss ein entsprechender Auslöser (Trigger) im Wiki vorhanden sein.
| |
|
| |
|
| So erstellen Sie den Trigger:
| |
|
| |
|
| # '''Klicken''' Sie auf ''Workflow Triggers'' im Menü ''Globale Aktionen''.
| | //check for 'one' and assign this table cell's background color accordingly |
| # '''Klicken''' Sie auf Neuen Auslöser hinzufügen.
| |
| # '''Wählen''' Sie aus dem Auswahlfeld die Option ''Manuell''.[[Datei:Gruppen-Feedback trigger manuell.png|alternativtext=Manuellen Trigger wählen|zentriert|mini|550x550px|Manuellen Trigger wählen]]<span /><span /><br />
| |
| # '''Definieren''' Sie die Einstellungen für den Workflow-Auslöser:
| |
| #* ''Name:'' Name, der im Auswahlmenü für den Workflow angezeigt wird.
| |
| #* ''Beschreibung'': Erklärung der Funktion und Besonderheiten dieses Triggers.
| |
| #* ''Zu startender Workflow'': Workflow, der durch diesen Trigger ausgelöst wird. In unserem Fall ''GroupFeedbackTeam''.
| |
| #* ''Anfangsdaten'' für den Workflow (alle Angaben sind optional): - Gruppe: Es ist sinnvoll, hier eine vordefinierte Gruppe anzugeben. Diese sollte von der Mitgliederanzahl auf den im Workflow gesetzten Schwellenwert abgestimmt sein. - Anweisungen: Diese werden den Benutzern in der zugewiesenen Aufgabe zum besseren Verständnis angezeigt. - Bericht senden: Hier kann eine beliebige E-Mail-Adresse angegeben werden. Der Empfänger wird zum Abschluss des Workflows benachrichtigt. (Der Initiator des Workflows bekommt automatisch eine Benachrichtigung und muss hier nicht gesondert angegeben werden).
| |
| #* ''Bedingungen'' (Conditions): In welchen Namensräumen der Workflow zur Auswahl angezeigt wird. [[Datei:Gruppen-Feedback trigger-einstellungen.png|alternativtext=Trigger-Einstellungen|zentriert|mini|499x499px|Trigger-Einstellungen]]
| |
| # '''Klicken''' Sie ''Speichern.''
| |
|
| |
|
| === Workflow testen === | | if (currentText == "Erfüllt") { |
| Der Workflow steht nun im Wiki zur Verfügung. Lösen Sie einen Test-Workflow aus. Testen Sie, ob folgende Funktionalität vorhanden ist:
| | node.style.backgroundColor = "#c5e8c9"; |
| | } |
| | else if (currentText == "Nicht Erfüllt") { |
| | node.style.backgroundColor = "#e9c4c4"; |
| | } |
|
| |
|
| * Der Workflow steht in den im Workflow-Trigger definierten Namensräumen zur Verfügung (falls es hier Einschränkungen gibt).
| | } |
| * Der Workflow wird ausgelöst.
| |
| * Der Workflow wird in der Workflows-Übersicht angezeigt.
| |
| * Die Gruppenmitglieder erhalten eine Aufgabe.
| |
| * Der Workflow schließt nach der Erreichung des gesetzten Schwellenwerts ab.
| |