Entwickler Tutorial (Legacy)
Datenpersistierung mit Data Objects

Datenpersistierung mit Data Objects

Dieses Kapitel erklärt, wie die von Flow Nodes generierten Daten persistiert und für den gesamten Prozessverlauf bereitgestellt werden können.

Was ist ein Data Object?

Ein Data Object ist ein Datenspeicher, in welchem Daten zu einer Prozessinstanz permanent gespeichert werden können.

Jede Flow Node eines Prozesses hat die Möglichkeit Daten aus beliebig vielen Data Objects auszulesen und auch in diese zu schreiben.


Ein Data Object hinzufügen

Um ein Data Object einem Prozess hinzuzufügen, kann links in der Toolbar das Data Object ausgewählt und per Drag and Drop an den gewünschten Ort im Prozess abgelegt werden.


In ein Data Object schreiben

Daten werden in ein Data Object geschrieben, indem ein Pfeil darauf gerichtet wird. Dies wird eine Assoziation genannt.


Wird die Assoziation ausgewählt, enthält das Property Panel ein Feld Data Source. Das Feld kann genutzt werden, um dem Data Object die namensgebenden Daten zu überreichen.


Wird das Feld leer gelassen, wird das gesamte aktuelle Token in das Data Object gespeichert.

Sollen nur Teile des Tokens gespeichert werden, können diese aus dem Token ausgewählt werden.

{
    foo: token.current.foo
}

Daten können auch manuell dem Data Object übergeben werden.

{
    ...token.current,
    "foo": "bar"
}

Aus einem Data Object lesen

Sollen die Daten aus einem Data Object gelesen werden, wird die Notation dataObjects.dataObjectId genutzt. Beispielsweise kann an einem Task ein Pre-Script ausgeführt werden, um das aktuelle Token mit den notwendigen Daten zu ergänzen:


Eine Assoziation wird hier nicht benötigt, allerdings wird sie genutzt, um den Datenfluss transparent zu machen. Dabei zeigt der Pfeil in die andere Richtung des Datenflusses (vom Data Object ausgehend, in den Task hinein).


Initial Value

Das Initial Value ist ein seeding Wert, der einmalig beim Start des Prozesses in das Data Object gegeben wird. Falls das Data Object mit einer Assoziation verbunden ist, wird das Initial Value stets überschrieben, selbst wenn die Assoziation keinen Wert übergibt.

Der Wert im Initial Value muss immer ein JSON-Objekt sein. Wenn ein Data Object ein Initial Value hat, erscheint oben links ein kleines Symbol als Indikator am Data Object.


Nächste Schritte

Im nächsten Kapitel wird ein komplexer Service Task erstellt und verwendet, um Daten mittels HTTP zu erhalten oder zu verarbeiten.

Downloads

Prozesse