zuordnung

Zweck

Das Zuweisung-Element wird verwendet, um Variablen innerhalb deines Flows zu erstellen oder zu ändern. Es ermöglicht dir, einen Datenwert mit einem bestimmten Namen (einem Schlüssel) und einem Wert zu definieren, auf den später andere Elemente in der Automatisierung zugreifen können. Dies ist grundlegend für das Speichern von Informationen, das Festlegen von Konfigurationswerten oder die Vorbereitung von Daten für nachfolgende Schritte.

Bildschirmfoto 2025-11-06 um 13.34.59.png

Anwendungsfälle:

• Speichern eines statischen Wertes, wie einer API-Endpunkt-URL oder einer Benutzer-ID, zur Verwendung an mehreren Stellen.

• Erstellen einer benutzerdefinierten Nachricht oder eines Status basierend auf vorherigen Flow-Daten.

• Festlegen eines Standard- oder Fallback-Wertes für eine Variable, die möglicherweise nicht immer von einem Auslöser bereitgestellt wird.

Kurz: Das Zuweisungselement legt einzelne Schlüssel-Wert-Paare im Flow-Speicher an oder ersetzt bestehende.

Praktische Anwendungshinweise

• Überschreiben von Variablen: Wenn eine Variable mit demselben Schlüssel bereits im Speicher des Flows vorhanden ist, wird deren Wert von diesem Element ersetzt. Daten werden nicht zusammengeführt oder angehängt.

• Dynamische Werte: Das value-Feld kann Referenzen auf Variablen aus vorherigen Schritten enthalten. Du kannst den Wert beispielsweise auf Willkommen, {{trigger.kundenname}}! setzen, um eine dynamische Begrüßung zu erstellen.

• Datentypen: Achte auf den Datentyp, den du zuweist. Wenn du ein JSON-Objekt oder -Array zuweisen möchtest, stelle sicher, dass der value gültiges JSON ist. Andernfalls wird er als einfacher Text-String behandelt.

Beispiele:

Beispiel: dynamischer Text

value: "Willkommen, {{trigger.kundenname}}!"

Beispiel: JSON-Objekt

value: {"stadt": "Berlin", "plz": "10115"}

Konfigurationsoptionen

• Variablen

  • Beschreibung: Eine Liste, in der du eine oder mehrere Variablen definieren kannst. Jeder Eintrag in der Liste besteht aus einem key (dem Namen der Variable) und einem value (den Daten, die sie enthalten soll).

  • Eingabeformat:

    • key: Ein Text-String, der zum Namen der Ausgabevariable wird. Er sollte keine Leerzeichen oder Sonderzeichen enthalten.

    • value: Der Inhalt für die Variable. Dies kann ein einfacher Text, eine Zahl oder eine komplexere Struktur im JSON-Format sein (wie {"stadt": "Berlin"} oder ["rot", "grün"]).

  • Beispielwert:

    • key: status

    • value: pruefung_ausstehend

Eingabe-/Ausgabe-Erwartungen

• Eingabe: Das Element wird direkt in der Benutzeroberfläche durch Hinzufügen von Einträgen zur Variablen-Liste konfiguriert. Es verarbeitet in der Regel keine Ausgabevariablen aus vorherigen Schritten.

• Ausgabe: Dieses Element erzeugt keine einzelne, gebündelte result-Variable. Stattdessen wird für jeden von dir in der Konfiguration erstellten Eintrag eine neue, separate Ausgabevariable generiert. Der Name der Variable ist der von dir angegebene key, und sie enthält den entsprechenden value.

Beispiel Nutzung in nachfolgenden Elementen:

Zugriff auf gesetzte Variable

{{Assignment.benutzerId}}

Wenn du beispielsweise eine Variable mit dem Schlüssel benutzerId und dem Wert 12345 konfigurierst, kannst du in nachfolgenden Elementen auf die Variable {{Assignment.benutzerId}} zugreifen.

Wichtig: Das Element ersetzt existierende Variablen mit identischem Schlüssel — es führt keine Verschmelzung von Werten durch.