User Tasks programmieren
Erklärung
Im letzten Kapitel haben wir gelernt, wie man Prozesse starten kann. In diesem Kapitel beschäftigen wir uns nun mit User Tasks. Diese wurden bereits im Abschnitt zur Modellierung erläutert und verwendet. Wir haben also bereits modellierte Form Fields in den Prozessen integriert und im Studio ausgeführt. Jetzt wollen wir diese Form Fields auch in unserer Anwendung darstellen.
Bestellung erfassen Seite anlegen
Um loszulegen, erstellen wir eine neue Seite die Material-Bestellung erfassen heißt.
Es handelt sich um eine Seite, auf der die User Task "Bestellung erfassen" für den Prozess "Material-Bestellung" dargestellt wird.
Dafür wird eine gleichnamige Group angelegt, in der das Formular angezeigt wird.
Die Visibility(Sichtbarkeit) der angelegten Seite und Gruppe wird auf hidden gesetzt, damit diese nicht in der
Seitenleiste angezeigt wird. Es ist nur gewollt, dass die Seite über den Buttonklick zum Prozess starten aufgerufen
wird.
Zur Page navigieren
Was wir nun machen wollen, ist das gezielte Navigieren zu der Seite, die wir gerade erstellt haben. Dazu verbinden wir eine Function Node von Node-Red mit dem Ausgang der vorherigen Start Process Node (opens in a new tab).
In der Function Node wird die Payload des ankommenden msg Objekt überschrieben und um die page Eigenschaft erweitert, zu der wir navigieren wollen.
Zusätzlich wird die processInstanceId aus der Response der Start Process Node (opens in a new tab) entnommen und als Query in die Payload gehangen.
Die Query Eigenschaft enthält auch die Flow Node ID des User Tasks, die wir später benötigen, um den User Task abzufragen und darzustellen.
msg.payload = {
page: 'Material-Bestellung erfassen',
query: {
processInstanceId: msg.payload.processInstanceId,
flowNodeId: 'Bestellung_erfassen',
},
};
return msg;Das Message Objekt ist ein JSON Objekt, das Informationen über den Flow und die Nachricht enthält, die durch den Flow fließt. Es ist ähnlich wie der Token in der Engine/Prozessmodell, der Informationen über den Prozess enthält. Für mehr Informationen über das Message Objekt, siehe die Node-Red Dokumentation (opens in a new tab).
Die Function Node wird noch mit der ui-control Node verbunden, um die Navigation zu triggern.
Die ui-control Node wertet die vorher gesetzte page Eigenschaft aus und leitet den Nutzer auf die angegeben Seite weiter.
Wenn der Flow nun ausgeführt wird, wird der Nutzer zur neuen Seite navigiert:
Da die Seite noch leer ist, fügen wir nun die DynamicForm Komponente hinzu, die die Form Fields rendert.
DynamicForm
Um die Form Fields aus dem modellierten User Task zu rendern, verwenden wir die DynamicForm Komponente.
Im Wesentlichen dient diese Komponente dazu, schnell und effizient Formulare zu entwickeln.
Eine genauere Beschreibung befindet sich in der Dokumentation (opens in a new tab).
Zur Vorbereitung muss allerdings noch die User Task Instanz abgefragt werden, wenn die Material Bestellung erfassen Seite angezeigt wird.
Dafür wird
- die
ui-page-navigationNode (opens in a new tab) erstellt und mit - der
usertask-inputNode (opens in a new tab) verbunden, die die User Task Instanz anhand der Query Eigenschaft des Message Objekts abfragt, und - die
ui-dynamic-forman die vorherige Node angeschlossen, um die Form Fields zu rendern, - die
usertask-outputNode (opens in a new tab) wird mit derui-dynamic-formNode verbunden, um den User Task an der Engine abzuschließen.
Konfiguration der einzelnen Nodes
ui-page-navigation
UI: My-Dashboard
Event: $pageview
page: Material-Bestellung erfassenusertask-input
Engine URL: http://engine:80
Query: msg.payload.query
Result: Send First Taskui-dynamic-form
Group: Material-Bestellung erfassen
Actions: Submitusertask-output
Engine URL: http://engine:80
Result: msg.payload.formDataNachdem der Flow neu deployt wurde und ein Prozess gestartet wird, wird die Seite mit der Dynamic Form gerendert:
Das Abschließen des User Tasks findet mit den angegebenen Daten statt und der Prozess setzt sich fort.
Zurück zur Startseite navigieren
Nachdem der User Task abgeschlossen wurde, soll der Nutzer zur Startseite (Bestellung Starten) zurückgeleitet werden.
Dafür wird eine weitere Function Node erstellt, die die page Eigenschaft des Message.Payload Objekts auf die Bestellung starten Seite setzt.
msg.payload = {
page: 'Bestellung starten',
};
return msg;Die Function Node wird mit der ui-control Node verbunden, die die Navigation triggert.
Nachdem der Flow neu deployt wurde und ein Prozess gestartet wird, wird der Nutzer nach Abschluss des User Tasks zur Startseite zurückgeleitet.