Trigger-Nodes

Jeder Workflow beginnt mit genau einem Trigger-Node. Der Trigger legt fest, wann und wie der Workflow ausgeführt wird und welche Daten er an nachgelagerte Nodes weitergibt.

Manueller Trigger

Startet den Workflow, wenn ein Benutzer auf die Run-Schaltfläche klickt. Nützlich während der Entwicklung und für Workflows, die auf Anfrage statt automatisch ausgeführt werden sollen.

Keine Konfiguration erforderlich.

Ausgabe	Typ	Beschreibung
triggered	boolean	Immer true
triggeredAt	string	ISO 8601-Zeitstempel, wann der Lauf gestartet wurde

Webhook-Trigger

Startet den Workflow, wenn ein externes System eine HTTP-POST-Anfrage an die Webhook-URL des Workflows sendet. Der Anfrage-Body wird als payload-Ausgabe weitergegeben.

Eingabe	Erforderlich	Beschreibung
Webhook Secret	Nein	Wenn gesetzt, müssen eingehende Anfragen den Header X-Webhook-Secret: <secret> enthalten. Anfragen ohne übereinstimmendes Secret werden abgelehnt.

Ausgabe	Typ	Beschreibung
payload	object	Der geparste JSON-Body der eingehenden POST-Anfrage
triggeredAt	string	ISO 8601-Zeitstempel

Die Webhook-URL wird im Konfigurationspanel des Triggers angezeigt, nachdem Sie den Workflow gespeichert haben. Es gibt separate URLs für Test- und Produktionsumgebungen.

Formular-Trigger

Stellt ein öffentliches Webformular bereit, das strukturierte Eingaben von Benutzern sammelt. Wenn ein Benutzer das Formular abschickt, wird der Workflow mit den übermittelten Daten ausgeführt.

Eingabe	Erforderlich	Beschreibung
Titel	Ja	Der Titel des Formulars, der Benutzern angezeigt wird
Beschreibung	Nein	Untertitel oder Anweisungstext, der unter dem Titel angezeigt wird
Felder	Ja	Liste der Formularfelder: jedes mit Name, Label, Typ (text, textarea, number, select, checkbox, file) und der Angabe, ob es ein Pflichtfeld ist
Zugang	Nein	Zugang auf angemeldete Workspace-Mitglieder beschränken oder für jeden mit dem Link offen lassen

Ausgabe	Typ	Beschreibung
formData	object	Ein Objekt mit den Werten aller übermittelten Formularfelder, nach Feldnamen geordnet
submittedAt	string	ISO 8601-Zeitstempel
submittedBy	string	Benutzer-ID des Einreichers (wenn der Zugang auf Workspace-Mitglieder beschränkt ist)

Die öffentliche Formular-URL wird nach der Bereitstellung in der Trigger-Konfiguration angezeigt.

Geplanter Trigger

Führt den Workflow automatisch nach einem Cron-Zeitplan aus. Der Zeitplan wird mit Standard-Cron-Syntax definiert und in der Zeitzone Europe/Berlin ausgewertet.

Eingabe	Erforderlich	Beschreibung
Cron-Ausdruck	Ja	Standard-5-Feld-Cron-Ausdruck, z. B. 0 9 * * 1-5 für Werktage um 09:00 Berliner Zeit

Ausgabe	Typ	Beschreibung
triggered	boolean	Immer true
triggeredAt	string	ISO 8601-Zeitstempel der tatsächlichen Ausführungszeit
scheduledTime	string	ISO 8601-Zeitstempel der geplanten (beabsichtigten) Ausführungszeit

Häufige Cron-Ausdrücke:

Zeitplan	Ausdruck
Jede Stunde	0 * * * *
Täglich um 08:00	0 8 * * *
Werktags um 09:00	0 9 * * 1-5
Jeden Montag um 06:00	0 6 * * 1
1. des Monats um 00:00	0 0 1 * *

Subworkflow-Trigger

Kennzeichnet diesen Workflow als aufrufbaren Subworkflow. Er kann von einem Subworkflow Call-Node in einem anderen Workflow aufgerufen werden. Der Trigger definiert die Eingabeparameter, die der Aufrufer bereitstellen muss, sowie die zurückgegebenen Ausgaben.

Eingabe	Erforderlich	Beschreibung
Eingabeparameter	Nein	Benannte Eingabefelder definieren (mit Typen und Beschreibungen), die der aufrufende Workflow bereitstellen muss

Ausgaben sind dynamisch und werden vom Aufrufer über die Rückgabezuordnung des Subworkflow-Call-Nodes definiert.