Werte referenzieren

Die Schreibweise ist überall dieselbe. Unterschiedlich ist der Einstieg — also der erste Wert, mit dem ein Ausdruck beginnt. Er hängt davon ab, an welcher Stelle Sie schreiben.

Einstieg	Steht für	Verfügbar in
fieldValue('<Feld-Id>')	ein Feld des aktuellen Eintrags	Formelspalten, Filter
formValues.get('<Key>')	eine Eingabe auf einer Seite	bedingte Sichtbarkeit
step('<Schritt-Id>')	ein früherer Schritt eines Flows	Flows
today() · now()	heutiges Datum · aktueller Zeitpunkt	überall
true · false	feste Wahrheitswerte	überall
loggedInUser()	die angemeldete Person	überall
owner	Eigentümer des Space	Flows

Der häufigste Fehler steht in dieser Tabelle

Ein Einstieg, den es an dieser Stelle nicht gibt, führt nicht zu einer Fehlermeldung, sondern zu einem leeren Ergebnis. fieldValue('…') in einer Sichtbarkeitsregel bleibt also stumm wirkungslos, und der Block verschwindet dauerhaft. Prüfen Sie zuerst den Einstieg, dann die Funktion.

Felder eines Eintrags: fieldValue

In einer Formelspalte und in Filtern greifen Sie auf die anderen Felder desselben Eintrags zu:

fieldValue('64f2a1c0b53ff00c6bdf1234').multiplyBy(1.19)

Der Wert in den Klammern ist die Id der Spalte, nicht ihr Name.

Nie tippen, immer einfügen

Im Formeleditor listet der Reiter Search alle verwendbaren Felder mit ihrem Namen auf. Ein Klick fügt fieldValue('…') mit der richtigen Id ein und zeigt es als farbigen Baustein mit dem Feldnamen an. Damit sehen Sie im Ausdruck den Namen, gespeichert wird die Id.

Dass die Id gespeichert wird, hat einen Vorteil: eine Formel überlebt das Umbenennen der Spalte. Und einen Nachteil: Wird die Spalte gelöscht, meldet der Editor No field with id … — der Feldname steht dann nicht mehr im Ausdruck.

Welche Felder verwendbar sind: Text, Zahl, Kommazahl, Währung, Datum, Datum und Uhrzeit, Erstellt am, Häkchen, Benutzer, E-Mail und Geolokalisierung. Andere Spaltentypen tauchen im Picker nicht auf.

Formelspalten verweisen nicht auf Formelspalten

Felder vom Typ Formel werden im Picker ausgelassen — sonst könnte eine Formel sich selbst berechnen wollen. Wenn Sie auf einem berechneten Wert aufbauen müssen, wiederholen Sie die Rechnung im neuen Ausdruck.

Eingaben einer Seite: formValues

In der bedingten Sichtbarkeit eines Blocks kommen die Werte aus den Eingabeblöcken derselben Seite:

formValues.get('alter').greaterThan(17)

Der Zugriff erfolgt über den Key des Eingabeblocks — nicht über seine Beschriftung. Alle Keys einer Seite sehen Sie über Keys verwalten. → Eingabeblöcke

Ein falscher Key blendet dauerhaft aus

Heißt der Key age und die Regel fragt formValues.get('alter'), dann ist die Bedingung immer falsch — der Block erscheint nie, ohne jede Meldung. Dasselbe passiert, wenn der Key nachträglich geändert wird.

Legen Sie sprechende Keys fest, bevor Sie Bedingungen darauf bauen.

Ein Sonderfall mit umgekehrtem Ausgang: Ist der Ausdruck nicht nur ins Leere gerichtet, sondern syntaktisch falsch, bleibt der Block sichtbar. Ein Block, der immer erscheint, deutet also auf einen Schreibfehler; ein Block, der nie erscheint, auf einen falschen Key.

Ergebnisse früherer Schritte: step

In einem Flow liefert jeder Schritt ein Ergebnis, auf das die folgenden zugreifen können:

step('66f13d06b53ff00c6bdf2769').output.get('email')

Teil	Bedeutung
step('…')	der Schritt, erkannt an seiner Id
.output	das Ergebnis dieses Schritts
.get('…')	ein einzelnes Feld daraus

Auch hier tippt niemand Ids: Der Reiter Flow im Ausdruckseditor zeigt die Schritte des Flows als Baum, und ein Klick fügt den passenden Ausdruck ein. Der Baum entsteht aus dem letzten Testlauf — ohne Testlauf ist er leer, und der Editor sagt das auch:

Zuerst musst du den Flow testen

→ Flows testen · Daten zwischen Schritten

Verschachtelte Daten mit mehreren get

Webhook-Daten und JSON-Antworten sind oft verschachtelt. Dann hängen Sie get() mehrfach aneinander: step('…').output.get('kunde').get('email'). Jedes get() geht eine Ebene tiefer.

Datum, Person, Space

Diese Einstiege brauchen keinen Bezug zu einem Eintrag oder Schritt:

Ausdruck	Ergebnis
today()	das heutige Datum, ohne Uhrzeit
now()	der aktuelle Zeitpunkt mit Uhrzeit
loggedInUser()	die angemeldete Person, mit .email, .firstName, .lastName, .id
owner	der Eigentümer des Space, mit .email, .firstName, .lastName
true · false	feste Wahrheitswerte

fieldValue('frist').before(today())
loggedInUser().email.isEqualTo(fieldValue('bearbeiter'))

owner bietet die Oberfläche nur in Flows an

Die drei Werte E-Mail Space Eigentümer, Vorname Space Eigentümer und Nachname Space Eigentümer stehen im Ausdruckseditor als Flow-Variablen zur Auswahl. Für Formeln und Sichtbarkeitsregeln bietet die Oberfläche sie nicht an — verlassen Sie sich dort nicht darauf.

Wer ist bei einem Flow angemeldet?

loggedInUser() ist die Person, die die Aktion ausgelöst hat. Läuft ein Flow über einen Webhook oder ein öffentliches Formular, ist das nicht zwangsläufig ein Mitglied des Space. Für Zuordnungen ist ein ausdrücklich gefülltes Feld verlässlicher als der angemeldete Benutzer.

Welcher Typ kommt heraus

In einer Formelspalte wählen Sie unter Ergebnis anzeigen als den Spaltentyp des Ergebnisses. Die Auswahl richtet sich nach dem Typ, den der Ausdruck liefert:

Ausdruck ergibt	wählbare Spaltentypen
Wahrheitswert	Häkchen
Zahl	Zahl, Kommazahl, Währung
Kommazahl	Kommazahl, Währung
Text	Text
Datum	Datum
Datum und Uhrzeit	Datum und Uhrzeit

Warum die Auswahl manchmal auf einen Eintrag zusammenschrumpft

Bleibt nur ein Spaltentyp übrig, setzt ihn der Editor selbst — der Ausdruck lässt keinen anderen zu. Umgekehrt heißt eine plötzlich lange Liste: Der Ausdruck ist noch nicht auswertbar, und der Typ steht noch nicht fest.

Welchen Typ ein Ausdruck gerade liefert, steht im Editor über dem Beispielergebnis — Typ: String, Typ: Number. Er entscheidet auch darüber, welche Funktionen als Nächstes möglich sind. → Funktionsreferenz

Weiter

• Schreibweise — Punkt, Klammern, Anführungszeichen
• Bedingungen bauen — Vergleiche, UND/ODER, Verzweigungen
• Der Ausdruckseditor — Token-Ansicht, Picker, Beispielergebnis
• Funktionsreferenz — alle Funktionen je Typ
• Berechnete Felder · Bedingte Sichtbarkeit · Eingabeblöcke