Entwickler Tutorial (Legacy)
Datenaustausch mit Process Tokens

Datenaustausch mit Prozess Tokens

In diesem Kapitel wird erklärt, wie Flow Nodes ihre Daten über Prozess Tokens an nachfolgende Flow Nodes weiterreichen.

Was ist ein Prozess Token?

Hat eine Flow Node ihre Ausführung beendet, muss Sie das Ergebnis dieser Ausführung festhalten, um es an nachfolgende Flow Nodes weiterreichen zu können. Für einen User Task kann das beispielsweise der Inhalt eines ausgefüllten Formulars sein. Für einen Service Task die von einem externen Dienst empfangenen Daten.

Dies wird über so genannte Prozess Tokens ermöglicht, die jede Flow Node automatisch generiert und mit ihren Ergebnissen individuell beschreibt.

Der Inhalt eines Prozess Tokens muss stets im JSON Format vorliegen.

Arten von Prozess Tokens

Innerhalb des ProcessCubes werden Prozess Tokens auf Zwei Arten dargestellt:

  • Start Token: Beschreibt den eingehenden Token, den eine Flow Node von ihrem Vorgänger übergeben bekommen hat
  • End Token: Beschreibt den von einer Flow Node ausgehenden Token

Beispielprozess Stammdatenerfassung

Nachfolgend wird mit einem einfachen Beispielprozess illustriert, wie der Datenaustausch über Prozess Tokens funktioniert.

Modellierung

Gegeben sei ein Prozess zur Erfassung von Stammdaten.

Die Daten werden über einen User Task in einem einfachen Formular erfasst. Ein nachfolgender Service Task schickt diese an eine externe Benutzerverwaltung, die außerhalb des Prozesses liegt.

Der Start Token des Service Tasks entspricht dabei dem End Token des User Tasks.

Ausführung

Der Prozess kann über das Studio ausgeführt werden.

User Task

Nach Abschluss des User Tasks, generiert dieser folgendes End Token um die an ihm getätigten Eingaben festzuhalten:


Service Task

Dieser Token wird anschließend an den Service Task weitergereicht, welcher diesen dann als Start Token verwendet.


Daten formatieren

Besonders bei der Kommunikation mit externen Diensten kann es schnell passieren, dass Daten in einem Format übermittelt werden müssen, das nicht menschenlesbar ist. Umgekehrt kann es auch vorkommen, dass die von einer externen Schnittstelle empfangenen Daten in einem nur schwer lesbaren Format vorliegen, oder mit mehr Informationen angereichert sind, als der Prozess tatsächlich benötigt.

Um diesen Umstand zu überbrücken, können an jeder Flow Nodes Skripte definiert werden, um diese Daten in ein passendes, bzw. lesbares Format zu bringen.

Diese Skripte bezeichnet man als Pre Script und Post Script.

Pre Script

Ein Pre Script wird verwendet, um die an einer Flow Node eingehenden Daten in ein neues Format zu konvertieren.

Das kann nützlich sein, wenn man Daten aus einem Drittsystem empfangen hat - z.B. über einen Service Task - und diese Daten nur an einer bestimmten Stelle aufbereiten möchte, um Sie sprechend zu veranschaulichen. In diesem Fall würde sich nur der Start Token der mit dem Pre Script ausgestatten Flow Node ändern. Die Daten aus dem Drittsystem würden weiterhin im Originalformat vorliegen.

💡

Das Pre Script läuft bevor die Flow Node ihre Arbeit beginnt und überschreibt somit dessen Start Token.

Post Script

Ein Post Script wird verwendet, um die von einer Flow Node ausgehenden Daten in ein neues Format zu konvertieren. Das kann vor allem dann nützlich sein, wenn man Daten aus einem Drittsystem erhalten hat und diese für den gesamten restlichen Prozess in ein bestimmtes Format bringen möchte.

💡

Das Post Script läuft nachdem die Flow Node ihre Arbeit beendet hat und überschreibt somit dessen End Token.

Erweitertes Beispiel Stammdatenerfassung

Modellierung

Nachfolgend wird obiges Beispiel so modifiziert, dass der Service Task ein Pre-Script und ein Post-Script erhält.

Pre-Script:


Dieses soll die Eingaben des User Tasks in ein Format bringen, das von dem externen Dienst interpretiert werden kann.

Post-Script:


Dieses erzeugt ein neues End Token, in welchem lediglich die erfolgreiche Ausführung des Tasks festgehalten wird.

Ausführung

Führt man den Prozess nun erneut aus, werden für den Service Task folgende Tokens erzeugt:


Man erkennt hier sehr deutlich, wie Start Token und End Token durch die definierten Skripte modifiziert wurden.

Runtime Expressions

Die Daten aus einem Prozess Token können mit so genannten Runtime Expressions zur Konfiguration von Elementen verwendet werden.

Möchte man den Inhalt des aktuellen Tokens auslesen, der von der vorhergehenden Flow Node empfangen wurde, kann die Expression token.current verwendet werden.

Eine detaillierte Anleitung zur Verwendung von Runtime Expressions findet sich im Advanced Kurs.

Nächste Schritte

Im nächsten Kapitel wird erklärt, wie die in einem Prozess verwendeten Daten über Data Objects persistiert und für alle Elemente im Prozess verfügbar gemacht werden können.

Downloads

Beispielprozess