Der Workflow-Ausdruckseditor

Der Workflow-Ausdruckseditor

Der Ausdruckseditor ist ein geführter Dialog, der Platzhalter und Filter für jedes Textfeld in einem Workflow zusammenstellt. Öffnen Sie ihn über das Suffix-Symbol an jedem Feld einer Aktionskonfiguration, Verzweigungsbedingung oder Eingabezuordnung.

Warum Platzhalter verwenden

Platzhalter ziehen dynamische Daten aus dem Auslöser-Datensatz, verwandten Entitäten, früheren Schrittausgaben, Schleifenelementen und Änderungssätzen. Damit verarbeitet ein Workflow jeden passenden Datensatz, ohne Werte fest zu verdrahten.

Platzhalterformen

• {{trigger.field}}: ein direktes Feld am Auslöser-Datensatz (zum Beispiel {{trigger.title}}).
• {{trigger.relation.field}}: ein Feld an einem freigeschalteten verwandten Datensatz (zum Beispiel {{trigger.owner.email}}).
• {{steps.<step_name>.output.<key>}}: die Ausgabe einer zuvor ausgeführten, benannten Aktion.
• {{loop.item}}, {{loop.item.<field>}}, {{loop.index}}: die aktuelle Schleifeniteration innerhalb eines For-Each-Körpers.
• {{change_set.<field>}}, {{change_set.<field>|from}}, {{change_set.<field>|to}}: die alten und neuen Werte eines geänderten Feldes, verfügbar für Feldänderungs-Auslöser.
• {{now}}, {{now -7d}}, {{now +1h}}: die aktuelle UTC-Zeit zur Ausführungszeit, optional mit Offset. Einheiten sind m (Minuten), h (Stunden), d (Tage), w (Wochen) und M (Monate).

Feldauswahl

Der Dialog bietet für jede Platzhalterform eine Auswahl. Die Auslöser-Feldauswahl zeigt jedes Feld der Auslöser-Entität. Die Beziehungsauswahl durchläuft freigeschaltete Beziehungen mit einem Klick, sodass Sie keine Pfadnamen erraten müssen. Die Schrittausgabe-Auswahl listet jeden zuvor benannten Schritt des Workflows auf. Die Auswahl für Schleifenelemente führt das Schema der Quell-Entität in verschachtelte Dialoge ein, wenn Sie sich in einem For-Each-Körper befinden.

Filterkette

Hängen Sie mit | Filter an einen Platzhalter, um die Ausgabe zu transformieren. Filter verketten von links nach rechts:

• upper, lower, title: Großschreibung ändern.
• default:'value': gibt den Standard zurück, wenn die Eingabe leer oder null ist.
• date:'Y-m-d': formatiert ein Datum mit PHP-Datumsformat-Token.
• truncate:100: kürzt die Eingabe auf maximal N Zeichen.
• json: codiert die Eingabe als JSON.
• map:'field': projiziert ein Feld aus jedem Element einer Sammlung.
• take:N: behält die ersten N Elemente einer Sammlung.
• join:', ': verbindet eine Sammlung zu einem String mit dem angegebenen Trennzeichen.

Beispiel

{{trigger.tasks | map:'title' | take:5 | join:', '}} projiziert den Titel der ersten fünf Aufgaben am Auslöser-Datensatz und verbindet sie mit Kommas. {{trigger.due_date | date:'Y-m-d'}} formatiert ein Fälligkeitsdatum als ISO-Datum.

Verzweigungsbedingungen

Innerhalb einer Verzweigung füllt der Ausdruckseditor die linke Seite (das Feld) und den Vergleichsoperator aus und bietet für die rechte Seite eine Platzhalterauswahl. So können Sie Auslöser-Felder, Schrittausgaben und Änderungssätze vergleichen, ohne Rohausdrücke zu tippen.

Validierung

Der Dialog validiert jeden Platzhalter gegen das Schema der gewählten Entität, bevor Sie speichern. Ungültige Pfade werden mit einer klaren Fehlermeldung hervorgehoben, sodass Sie sie direkt korrigieren können.

Tipps

• Benennen Sie Ihre Schritte. Beschreibende Namen (incident_summary, ticket_response) machen nachgelagerte Platzhalter selbsterklärend.
• Nutzen Sie {{now}}-Offsets, um in For-Each-Abfragequellen gleitende Fenster zu bauen, zum Beispiel “created_at größer als {{now -7d}}“.
• Verketten Sie map, take und join, um Sammlungen in einer einzigen lesbaren Zeile zusammenzufassen.
• Verwenden Sie default:'Unassigned', um leere Zeichenfolgen in Benachrichtigungstexten zu vermeiden.