Verteilen

Interne ID: agorum.flow.distribute

Sie können mit diesem Knoten einen laufenden Workflow intern aufteilen. Ein Workflow wird normalerweise mit einem Token gestartet. Der distribute-Knoten ermöglicht es, diesen Tokens in mehrere parallele Tokens aufzuteilen. Der collect-Knoten sammelt später die aufgeteilten Tokens und fügt diese wieder zu einem Token zusammen.

Verhaltensweise

Erreicht das System den Knoten im Workflow, liest es das Array aus der Variable, die Sie im Parameter Von Variable angegeben haben. Für jedes Element des Arrays entsteht ein eigenes Token. Jedes dieser Token erhält sein Element in der Variable, die Sie im Parameter In Variable angegeben haben. Alle Token verlassen den Knoten über das Standard-Outlet und nehmen dort denselben Weg.

Für den Wert in Von Variable gelten folgende Regeln:

• Ist der Wert kein Array, entsteht ein einzelnes Token mit diesem Wert.
• Enthält das Array kein Element, beendet das System das Token. Der Workflow läuft an dieser Stelle nicht weiter.
• Ist die Variable nicht gesetzt, bricht der Knoten mit einem Fehler ab. Legen Sie die Variable vorher an, etwa mit dem Knoten set.
• Lassen Sie In Variable leer, übernimmt das System die Eigenschaften jedes Elements als Variablen in das jeweilige Token. Die Elemente müssen dann Objekte sein. Der Knoten collect kann in diesem Fall die Werte nicht einsammeln.

Unterschiede zum Knoten „fork“

• Beim Knoten fork müssen die Outlets statisch und von Beginn an definiert werden.
• Erreicht das System den Knoten, erzeugt es für jedes Outlet ein Token.
• Beim Knoten distribute legen Sie über die Eingangsvariable fest, wie viele Token das System für ein Outlet erstellen soll. Mehrere Token nehmen dann den gleichen Weg.

Anwendungsbeispiel

siehe Workflow „Dokumentfreigabe“

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	ja, beliebig viele
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Von Variable	Definiert, aus welcher Variable das System das Array ausliest. Pro Element entsteht ein Token.	Von Variable
In Variable	Definiert, in welcher Variable jedes Token sein Element erhält. Pflicht, wenn Sie die Token später mit dem Knoten collect einsammeln.	In Variable

Von Variable

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Angabe einer Von Variable:

sys_acw_attachments

In diesem Beispiel liest das System das Array aus der internen Variable sys_acw_attachments.

In Variable

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Angabe einer In Variable:

attachment

In diesem Beispiel erhält jedes Token in der Variable attachment genau ein Element des Arrays aus Von Variable, bei sys_acw_attachments also die UUID genau eines Anhangs. Verwenden Sie für die In Variable einen Namen in der Einzahl, weil sie nur ein Element enthält.