Daten zwischen Schritten weitergeben

Während ein Workflow läuft, sammelt er Informationen: die Daten, die der Trigger mitgebracht hat, Werte, die frühere Schritte berechnet haben, die IDs der Datensätze, die er erstellt hat, Antworten von Webhooks. All das wird an einer Stelle gesammelt, einem gemeinsamen Namensraum namens __data, und jeder spätere Schritt kann ihn mit Flexie Scripting lesen:

{{ __data.incoming_email.subject }}
{{ __data.__entity_inserted_id }}
{{ __data.my_stored_value }}

Stellen Sie sich __data als Notizblock vor, den jeder Schritt im Lauf lesen kann und in den bestimmte Schritte schreiben. Er ist auf diesen Workflow, für diesen Datensatz beschränkt. Es gibt kein Übergreifen zwischen Datensätzen oder zwischen Workflows, und innerhalb eines Laufs gibt es kein Ablaufen: Alles, was geschrieben wurde, bleibt für alles weiter unten verfügbar.

Eine Regel, die zum Baum zurückführt: Ein Schritt kann sich nur auf Daten verlassen, die über ihm im Baum erzeugt wurden. Wenn Schritt B benötigt, was Schritt A erzeugt hat, muss B ein Nachfahre von A sein, kein Geschwister, das parallel daneben läuft.

Was in __data schreibt

1. Das Trigger- oder Listener-Signal

Wenn ein Workflow von einem Listener gestartet wird, werden die Daten des Signals in __data abgelegt, bevor der erste Schritt läuft. So kann schon die allererste Aktion sie verwenden. Die gängigen Signale und was sie liefern:

Trigger-Signal	So lesen Sie es	Nützliche Felder
Eine E-Mail trifft ein	__data.incoming_email	from_email, from_name, subject, text, html, cc_emails, date_received, Anhänge
Eine SMS oder WhatsApp wird empfangen	__data.incoming_sms	sender_number, to_number, text, date_received
Eine Nachricht wird zugestellt	__data.delivered_sms	text, date_delivered
Eine Aufgabe wird erstellt	__data.last_task	task, due_date, category, owner, created_by
Eine Aufgabe wird aktualisiert	__data.updated_task	(gleiche Form wie eine neue Aufgabe)
Eine Notiz wird hinzugefügt	__data.last_note	note, note_text, category, author
Eine Erwähnung in einer Notiz	__data.mention	note, note_text, author, mentioned_user
Ein Kommentar wird hinzugefügt	__data.last_comment	note, comment, comment_text, author
Eine Seite wird besucht oder ein Link angeklickt	__data.page_visit	url, utm_*, external_referer, date_hit, ip
Eine Web-Anfrage trifft auf einen dynamischen Endpunkt	__data.<body_field> für jedes Body-Feld, plus __data.__headers.* für Header	siehe Dynamische Endpunkte, Daten empfangen

2. Die Aktion „Wert speichern“

Der direkteste Weg, selbst etwas auf den Notizblock zu legen. Sie geben ihr einen Namen und einen Wert (berechnet mit Flexie Scripting), und ab dann ist er als {{ __data.<name> }} verfügbar. Verwenden Sie sie, um etwas einmal zu berechnen und über viele spätere Schritte hinweg wiederzuverwenden.

3. Schritte, die Datensätze erstellen

Wenn ein Schritt einen Datensatz erstellt, wird die ID des neuen Datensatzes in __data.__entity_inserted_id abgelegt (und sein Typ in __data.__entity_type). So referenziert ein späterer Schritt genau den Datensatz, den ein früherer Schritt gerade erstellt hat, zum Beispiel eine Zahlung gegen die Rechnung verbuchen, die dieser Lauf gerade erzeugt hat.

4. Die Webhook-Aktion

Eine Webhook-Aktion speichert die Antwort des anderen Systems unter dem Namen, den Sie wählen (standardmäßig webhook), sodass ein späterer Schritt auf der Antwort verzweigen oder Werte daraus verwenden kann: {{ __data.webhook }}, und den Statuscode als praktischen Begleitwert.

5. Der KI-Schritt

Ein KI-Schritt speichert die Ausgabe des Modells (Standardname __ai_response), sodass spätere Schritte verwenden können, was die KI erzeugt hat, zum Beispiel die von der KI entworfene Antwort senden oder auf dem Urteil der KI verzweigen.

Werte lesen

Greifen Sie mit Punkten auf die Daten zu, genau wie bei Datensatzfeldern:

Hi {{ __data.incoming_email.from_name | default("there") }},

We received your message:
"{{ __data.incoming_email.subject }}"

Kombinieren Sie es mit dem Flexie Scripting-Werkzeugkasten, um es umzuformen oder abzusichern:

{# A received payload may be JSON text, decode then read it #}
{% set order = __data.webhook | json_decode %}
Order {{ order.id }} total: {{ jsonPath(order, "$.totals.grand") | number_format(2) }}

Sichern Sie Werte, die fehlen könnten, immer mit default(...) oder einem {% if %} ab. Ein Signalfeld kann leer sein, und ein Webhook gibt vielleicht nicht zurück, was Sie erwarten.

Ein durchgespieltes Beispiel

Trigger (Listener): Eine E-Mail trifft im Support-Postfach ein. Entscheidung (virtuelle Bedingung): Enthält {{ __data.incoming_email.subject }} das Wort „invoice“?   Ja: Ticket erstellen, Betreff = {{ __data.incoming_email.subject }}, Beschreibung = {{ __data.incoming_email.text }}.   Dann Wert speichern case_ref = die ID des neuen Tickets ({{ __data.__entity_inserted_id }}).   Dann E-Mail senden, die das Ticket {{ __data.case_ref }} bestätigt.

Jeder Schritt verwendet, was die Schritte über ihm erzeugt haben, das ist __data bei der Arbeit.

Workflow-übergreifend teilen (kurz)

__data ist privat für einen Lauf. Wenn Sie wirklich einen Wert brauchen, der einen Lauf überdauert und anderswo gelesen wird, schreibt die Aktion Gemeinsames Gedächtnis setzen in einen kurzlebigen gemeinsamen Speicher, den andere Workflows (und Templates) mit memoryGet("key") lesen können. Verwenden Sie sie sparsam, sie ist für Workflow-übergreifende Signale gedacht, nicht für allgemeine Datenweitergabe.

Nächste Schritte

• Laufzeit, parallele Ausführung & der Baum: warum Daten nur nach unten fließen.
• Dynamische Endpunkte, Daten empfangen: wie eine eingehende Web-Anfrage in __data landet.