#Variable

This feature is provided by the commercial plugin «Workflow: Benutzerdefinierte Variable», please purchase to use

#Einführung

Sie können in einem Workflow Variablen deklarieren oder bereits deklarierten Variablen Werte zuweisen. Dies wird typischerweise verwendet, um temporäre Daten innerhalb des Workflows zu speichern.

#Knoten erstellen

Im Konfigurationsbereich des Workflows klicken Sie auf das Plus-Symbol („+“) im Workflow, um einen „Variablen“-Knoten hinzuzufügen:

#Knoten konfigurieren

#Modus

Ein Variablen-Knoten ähnelt Variablen in der Programmierung: Er muss zuerst deklariert werden, bevor er verwendet und ihm ein Wert zugewiesen werden kann. Daher müssen Sie beim Erstellen eines Variablen-Knotens dessen Modus auswählen. Es stehen zwei Modi zur Verfügung:

• Neue Variable deklarieren: Erstellt eine neue Variable.
• Einer bestehenden Variable einen Wert zuweisen: Weist einer Variable, die zuvor im Workflow deklariert wurde, einen Wert zu. Dies entspricht einer Änderung des Variablenwerts.

Wenn der zu erstellende Knoten der erste Variablen-Knoten im Workflow ist, können Sie nur den Deklarationsmodus auswählen, da zu diesem Zeitpunkt noch keine Variablen zur Zuweisung verfügbar sind.

Wenn Sie einer deklarierten Variable einen Wert zuweisen möchten, müssen Sie auch die Zielvariable auswählen, d. h. den Knoten, in dem die Variable deklariert wurde:

#Wert

Der Wert einer Variable kann von beliebigem Typ sein. Es kann sich um eine Konstante handeln, z. B. eine Zeichenkette, eine Zahl, einen Booleschen Wert oder ein Datum, oder um eine andere Variable aus dem Workflow.

Im Deklarationsmodus entspricht das Festlegen des Variablenwerts der Zuweisung eines Initialwerts zur Variable.

Im Zuweisungsmodus entspricht das Festlegen des Variablenwerts der Änderung des Werts der deklarierten Zielvariable auf einen neuen Wert. Bei nachfolgenden Verwendungen wird dieser neue Wert abgerufen.

#Den Wert einer Variable verwenden

In nachfolgenden Knoten nach dem Variablen-Knoten können Sie den Wert der Variable verwenden, indem Sie die deklarierte Variable aus der Gruppe „Knotenvariablen“ auswählen. Zum Beispiel können Sie in einem Abfrage-Knoten den Variablenwert als Abfragebedingung nutzen:

#Beispiel

Ein nützlicheres Szenario für Variablen-Knoten sind Verzweigungen, in denen neue Werte mit vorherigen Werten berechnet oder zusammengeführt werden (ähnlich wie reduce/concat in der Programmierung) und dann nach Beendigung der Verzweigung verwendet werden. Im Folgenden wird ein Beispiel gezeigt, wie Sie eine Empfängerzeichenkette mithilfe einer Schleifenverzweigung und eines Variablen-Knotens zusammenfügen können.

Erstellen Sie zunächst einen Sammlungs-getriggerten Workflow, der ausgelöst wird, wenn „Artikel“-Daten aktualisiert werden, und laden Sie die zugehörigen „Autor“-Beziehungsdaten vorab (um die Empfänger zu erhalten):

Erstellen Sie anschließend einen Variablen-Knoten, um die Empfängerzeichenkette zu speichern:

Erstellen Sie als Nächstes einen Schleifenverzweigungs-Knoten, um die Autoren des Artikels zu durchlaufen und deren Empfängerinformationen in der Empfänger-Variable zusammenzufügen:

Innerhalb der Schleifenverzweigung erstellen Sie zuerst einen Berechnungs-Knoten, um den aktuellen Autor mit der bereits gespeicherten Autorenzeichenkette zu verketten:

Nach dem Berechnungs-Knoten erstellen Sie einen weiteren Variablen-Knoten. Wählen Sie den Zuweisungsmodus, den Empfänger-Variablen-Knoten als Zuweisungsziel und das Ergebnis des Berechnungs-Knotens als Wert aus:

Auf diese Weise speichert die Empfänger-Variable nach Abschluss der Schleifenverzweigung die Empfängerzeichenkette aller Autoren des Artikels. Anschließend können Sie nach der Schleife einen HTTP-Anfrage-Knoten verwenden, um eine E-Mail-Sende-API aufzurufen und den Wert der Empfänger-Variable als Empfängerparameter an die API zu übergeben:

Damit ist eine einfache Massen-E-Mail-Funktion mithilfe einer Schleife und eines Variablen-Knotens implementiert.