Der Workflow-Ausdruckseditor

Der Ausdruckseditor lässt einen Workflow dynamische Daten in jedes Textfeld einfügen, mithilfe von Platzhaltern in doppelten geschweiften Klammern und optionalen Filtern, die das Ergebnis formen. Platzhalter funktionieren in Aktionskonfigurationen, Feldzuordnungen, Verzweigungs- und Auslöserbedingungen sowie Eingabezuordnungen von Unter-Workflows. Der geführte Editor hilft Ihnen, sie ohne Auswendiglernen der Syntax zusammenzustellen, und Sie können sie jederzeit direkt eingeben.

Platzhalterformen

  • Auslöserfeld: {{trigger.field}} liest ein Feld des Auslöserdatensatzes.
  • Verwandtes Feld: {{trigger.relation.field}} folgt einer erlaubten Beziehung zu einem Wert auf einem verwandten Datensatz.
  • Feld eines benutzerdefinierten Objekts: {{trigger.data.<field_id>}} liest ein Feld eines benutzerdefinierten Objekteintrags anhand seiner Feld-ID.
  • Schrittausgabe: {{steps.<step_name>.output.<key>}} verwendet die Ausgabe einer früheren benannten Aktion erneut.
  • Schleifenelement: {{loop.item}}, {{loop.item.<field>}} und {{loop.index}} referenzieren das aktuelle Element innerhalb eines For-each.
  • Änderungssatz: {{change_set.<field>}} enthält ein geändertes Feld, und {{change_set.<field>|from}} sowie {{change_set.<field>|to}} geben den vorherigen und den neuen Wert bei einem Feldänderungs-Auslöser an.
  • Aktuelle Zeit: {{now}} ist die Ausführungszeit, und eine relative Form wie {{now -7d}} verschiebt sie um eine Anzahl von Minuten, Stunden, Tagen, Wochen oder Monaten.

Filterketten

Hängen Sie einen Filter mit einem senkrechten Strich an einen Platzhalter an und verketten Sie mehrere Filter von links nach rechts. Die unterstützten Filter sind:

  • upper, lower, title: ändern die Groß- und Kleinschreibung des Textes.
  • default: default:'value' liefert einen Ersatzwert, wenn die Eingabe leer ist.
  • date: date:'Y-m-d' formatiert ein Datum mit standardmäßigen Datumstoken.
  • truncate: truncate:100 kürzt Text auf eine maximale Länge.
  • json: kodiert den Wert als JSON.
  • map: map:'field' projiziert ein Feld aus jedem Element einer Sammlung.
  • take: take:5 behält die ersten Elemente einer Sammlung.
  • join: join:', ' verbindet eine Sammlung mit einem Trennzeichen zu einer Zeichenkette.

Ein Beispiel für Verkettung

Filter lassen sich natürlich kombinieren. Zum Beispiel kürzt {{trigger.title | truncate:60 | upper}} einen Titel und schreibt ihn groß, während {{steps.list_items.output.items | map:'title' | join:', '}} eine Sammlung von Elementen in eine durch Kommas getrennte Liste von Titeln verwandelt. Da Ketten von links nach rechts gelesen werden, spielt die Reihenfolge eine Rolle, also formen Sie die Daten, bevor Sie sie formatieren.

Wo Platzhalter gelten

Verwenden Sie Platzhalter überall dort, wo ein Workflow einen Textwert akzeptiert: Betreff und Text einer E-Mail, die Feldzuordnungen einer Erstellen- oder Aktualisieren-Aktion, die Bedingungen einer Verzweigung, die verglichenen Werte in einer Auslöserbedingung und die Eingabezuordnungen, die an einen Unter-Workflow übergeben werden. Um die Aktionen zu sehen, die diese Werte verbrauchen, lesen Sie Workflow-Aktionen, und um die Daten zu wählen, mit denen ein Workflow beginnt, siehe Workflow-Auslöser. Für den weiteren Zusammenhang lesen Sie den Überblick zur Workflow-Automatisierung.

Möchten Sie dynamische Workflows mit Ihren eigenen Daten ausprobieren? Starten Sie Ihre kostenlose 14-tägige Testversion.

War dieser Artikel hilfreich?