Academy
External Task programmieren

External Task Worker anlegen

Erklärung

In der prozessorientierten Softwareentwicklung gibt es häufig Szenarien, in denen bestimmte Aufgaben innerhalb eines Prozesses von einem externen System übernommen und bearbeitet werden sollen. Ein typisches Beispiel ist die Abwicklung einer Bestellung durch ein Warenwirtschaftssystem, wie es in unserem Fallbeispiel der Fall ist. In unserem Prozess wird die Bestellung in einem solchen System verbucht.

Dies ist besonders sinnvoll, wenn vorhandene Infrastruktur weiter genutzt werden soll.

Die Integration solcher Systeme kann auf verschiedene Weise erfolgen. Eine gängige Methode ist die Verwendung von External Service Tasks, oder abkürzend auch External Tasks genannt. Dabei wird Programmcode einer Anwendung ausgeführt, die außerhalb des Prozesses liegt (in diesem Fall unsere LowCode Plattform Node-Red), die dann auf das externe System zugreift. Der Vorteil von External Tasks liegt darin, dass handgeschriebener Code/vorgefertigte Bausteine durch Node-Red mit allen benötigten Funktionalitäten eingesetzt werden kann – ähnlich wie bei einem "Microservice". Die Engine wartet, bis der External Task abgeschlossen ist, bevor der Prozess fortgeführt wird.

Topic

Die Art eines External Tasks wird über ein so genanntes Topic bestimmt. Dieses beschreibt, welche fachliche Aufgabe der External Task innerhalb des Prozesses zu erfüllen hat. Entsprechend wird das Topic auch verwendet um zu bestimmen, wie der zuständige External Task Worker implementiert werden muss, um den External Task korrekt abarbeiten zu können. Ein External Task Worker muss sich auf ein Topic subscriben, um Aufgaben zu erhalten.

Im Prozessmodell muss dies noch konfiguriert werden. Dazu wählt man den passenden Service Task im Prozessmodell aus und wählt im Property Panel rechts unter Type den Typen External Task. Anschließend erscheinen diverse Optionen, um den External Task zu konfigurieren. Nun trägt man im Feld Topic den Wert Bestellung-verbuchen/Bestellungen_verbuchen ein.


Payload

Damit der External Task Worker die Aufgabe bearbeiten kann, benötigt er bestimmte Informationen aus dem laufenden Prozess. In diesem Fall sind das die zu verbuchenden Bestellungen, die in unserem Data Object hinterlegt sind. Diese lassen sich über eine so genannte Payload übermitteln, die am External Task konfiguriert werden kann.

Dazu tragen wir folgenden Ausdruck in das Payload Feld ein:

dataObjects.gebuchteBestellungen

Der Prozess muss jetzt wieder neu deployed werden.

"Bestellung verbuchen"-External Task Worker erstellen

Die Einbindung von External Task Workern ist unkompliziert, da die Nodes externaltask-input (opens in a new tab) und externaltask-output (opens in a new tab) zur Verfügung stehen.

Die externaltask-input Node wird verwendet, um die Aufgabe abzufragen bzw. auf Aufgaben mit dem konfigurierten Topic zu warten. Die externaltask-output Node wird verwendet, um das Ergebnis zurückzugeben.

Alle Nodes zwischen externaltask-input und externaltask-output werden ausgeführt, wenn der External Task Worker aufgerufen wird und produzieren das Ergebnis, das an die Engine zurückgegeben wird.

Die externaltask-output Node leitet alles aus der payload Eigenschaft in der aktuellen Message an die Engine als Ergebnis weiter. Gegebenenfalls muss/sollte eine function Node zum Formatieren der Daten verwendet werden.

In dem Beispiel wird eine delay Node genutzt um ein arbeiten zu simulieren. In der Praxis würde hier die Verbuchung der Bestellung in das Warenwirtschaftssystem über eine entsprechende Node erfolgen. Die debug Node lässt uns das Messageobjekt in der Debugansicht von Node-Red betrachten. Dort sehen wir auch die payload Eigenschaft, die an die Engine zurückgegeben wird. Im aktuellen Beispiel ist dies die gebuchteBestellungen Eigenschaft, die vorher als Payload an den External Task Worker übergeben wird.

Eine Spezifizierung für die jeweilige Instanz auf der Anwendungsseite ist nicht erforderlich, da der Ablauf des External Tasks immer gleich ist. Die Engine stellt eine Aufgabe bereit, die erledigt werden muss, und eine Anwendung übernimmt diese Aufgabe, bearbeitet sie und gibt das Ergebnis zurück. Es ist daher nicht notwendig, eine Konfiguration für spezifische Prozessinstanzen vorzunehmen.

Nach dem Deployment des Flows sollte der External Task Worker nun aufgerufen werden können und die Bestellungen, wie im Video zu sehen verbuchen.

Konfiguration der einzelnen Nodes

externaltask-input

Engine URL: http://engine:80
Topic: Bestellung-verbuchen/Bestellungen_verbuchen

Die restlichen Nodes die im Video zu sehen sind, besitzen die Standardkonfiguration.