collect

Interne ID: agorum.flow.collect

Sie können mit diesem Knoten die aufgeteilten Tokens aus einem distribute-Knoten sammeln lassen. Die Tokens werden durch den collect-Knoten wieder zu einem Token zusammengefasst. Mit diesem Token arbeitet das System danach im Workflow weiter.

Verhaltensweise

Erreicht das System den Knoten im Workflow, wertet das System die Parameter Offene Tokens und Abgeschlossene Tokens aus. Anschließend führt das System die Tokens wieder zu einem Token zusammen und der Workflow wird fortgesetzt.

Ist kein offenes oder abgeschlossenes Token in den Parametern gesetzt, wartet der Workflow, bis alle nebenläufigen Tokens eingegangen sind.

Der Knoten collect setzt einen vorherigen Knoten distribute voraus, bei dem der Parameter In Variable gesetzt ist. Fehlt der Knoten distribute oder die In Variable, bricht der Workflow mit einem Fehler ab.

Wenn der Workflow fortgesetzt wird, schreibt das System das Ergebnis in die Variable, die im Knoten distribute unter Von Variable angegeben war. Sie enthält danach ein Array mit folgenden Eigenschaften:

• Das Array hat so viele Einträge, wie distribute Token erzeugt hat, in der Reihenfolge der ursprünglichen Elemente.
• Jeder Eintrag enthält den Wert, den das Token zuletzt in der In Variable des Knotens distribute hatte.
• Für Token, die den Knoten collect nicht mehr erreicht haben, weil das System sie beendet hat, ist der Eintrag null.
• Die In Variable entfernt das System aus dem fortgesetzten Token.

Anwendungsbeispiel

siehe Workflow „Dokumentfreigabe“

Ein weiteres Beispiel: Der Knoten distribute hat Von Variable orders und In Variable order. In jedem Zweig setzt ein Skript-Knoten token.variables.order = { id: 1, ok: true }. Nach dem Knoten collect enthält token.variables.orders ein Array mit diesen Objekten.

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.	ja, beliebig viele

Parameter

Parameter	Beschreibung	Beispiel
Offene Tokens	Definiert, wie viele Tokens noch nebenläufig im Workflow vorhanden sein müssen, damit der Workflow an dieser Stelle beim nächsten eingehenden Token fortgeführt wird.	Offene Tokens
Abgeschlossene Tokens	Definiert, wie viele Tokens bereits in dem Knoten eingegangen sein müssen, damit der Workflow an dieser Stelle beim nächsten eingehenden Token fortgeführt wird.	Abgeschlossene Tokens

Zahlenwerte der Parameter

Für die Parameter Offene Tokens und Abgeschlossene Tokens gelten folgende Regeln:

• Beide Parameter müssen Zahlen sein. Andernfalls wirft der Knoten einen Fehler.
• Ein leerer Wert und der Wert 0 gelten als nicht gesetzt.
• Der Workflow läuft weiter, sobald eine der folgenden Bedingungen zutrifft: Es ist kein Token mehr offen. Es sind höchstens so viele Token offen, wie Sie unter Offene Tokens angegeben haben. Es sind mindestens so viele Token eingegangen, wie Sie unter Abgeschlossene Tokens angegeben haben.

Offene Tokens

Angabe offener Tokens im Editor:

1

In diesem Beispiel darf maximal 1 Token eines distribute-Knotens offen sein, damit der Workflow fortgeführt wird.

In diesem Beispiel erhält ein Benutzer, etwa Projektmanager, die Möglichkeit, eine Aufgabe über die Bedienoberfläche (UI-Knoten) zu erstellen. Die Aufgabe kann er Benutzern zuweisen. Klickt der Projektmanager im UI auf Erstellen, wird die Aufgabe erstellt und den Benutzern zugewiesen. Maximal einer der Benutzer darf die Aufgabe noch offen haben, damit der collect-Knoten erreicht wird und das System den Workflow fortsetzt.

Das System würde die restlichen offenen Tokens beenden, sofern vorhanden, sobald der Knoten collect den Prozess weiterführt.

Abgeschlossene Tokens

Angabe abgeschlossener Tokens im Editor:

1

In diesem Beispiel muss mindestens 1 Token eines distribute-Knotens abgeschlossen sein, damit der Workflow fortgeführt wird.

In diesem Beispiel erhält ein Benutzer, etwa Projektmanager, die Möglichkeit, eine Aufgabe über die Bedienoberfläche (UI-Knoten) zu erstellen. Die Aufgabe kann er Benutzern zuweisen. Klickt der Projektmanager im UI auf Erstellen, wird die Aufgabe erstellt und den Benutzern zugewiesen. Mindestens einer der Benutzer muss die Aufgabe abschließen, damit der collect-Knoten erreicht wird und das System den Workflow fortsetzt. 

Das System würde die restlichen offenen Tokens beenden, sofern vorhanden, sobald der Knoten collect den Prozess weiterführt.