Der Ausdruckseditor
Ausdrücke schreiben Sie nicht in ein leeres Textfeld, sondern in einen Editor, der mitdenkt: Er zeigt Feldnamen statt Ids, führt die passenden Funktionen und rechnet das Ergebnis probeweise aus.
Wo er auftaucht
| Stelle | So kommen Sie hin |
|---|---|
| Formel-Spalte | In den Feldeinstellungen unter Formel |
| Textfeld eines Flow-Schritts | Auf einen bereits eingefügten Wert klicken — der Dialog Einen Ausdruck bearbeiten öffnet sich für diesen Baustein |
| Flow-Übergang | Im Dialog Nur fortfahren, wenn … unter Erweiterte Logik |
Bausteine oder Text
Ein Ausdruck lässt sich in zwei Ansichten bearbeiten. Umgeschaltet wird über das Menü neben der Beschriftung:
| Menüpunkt | Was Sie sehen |
|---|---|
| Formel mit Text einblenden | Den Ausdruck als reinen Text — zum Kopieren, Einfügen und für größere Umbauten |
| Formel als Token einblenden | Den Ausdruck als farbige Bausteine — Felder mit ihrem Namen, Funktionen, Werte |
Die Token-Ansicht ist die lesbarere: Statt fieldValue('64f2a1c0…') steht dort der Feldname in Blau. Gespeichert wird in beiden Fällen dasselbe.
Text-Ansicht für Ausdrücke von woanders
Einen Ausdruck aus dieser Dokumentation oder aus einem anderen Grid fügen Sie am einfachsten in der Text-Ansicht ein. Anschließend zurück auf Token schalten — gelingt die Umwandlung, war der Ausdruck lesbar.
Werte und Funktionen einfügen
Unter dem Eingabefeld liegt der Picker mit mehreren Reitern:
| Reiter | Inhalt |
|---|---|
| Search | Die Felder des Grids, die Rechenzeichen und die Funktionen des aktuellen Typs |
| Flow | Die Ergebnisse der Schritte dieses Flows und die Flow-Variablen |
| Date · Numbers · String · Boolean · Collection | Alle Funktionen des jeweiligen Typs, unabhängig vom Ausdruck |
Ein Klick fügt den Eintrag an der Einfügemarke ein. In den Textfeldern eines Flow-Schritts können Sie Werte außerdem aus dem Picker an die gewünschte Stelle ziehen.
Der Reiter Search ändert sich, während Sie schreiben
Er zeigt die Funktionen des Typs, den der Ausdruck gerade liefert. Nach fieldValue('titel') stehen dort Text-Funktionen, nach .isEmpty() die eines Wahrheitswerts. Wer eine Funktion sucht, die dort nicht auftaucht, hat meist den falschen Typ vor sich — nicht die falsche Schreibweise.
Die Rechenzeichen + - * / erscheinen nur, wenn der Ausdruck eine Zahl liefert.
Der Flow-Reiter braucht einen Testlauf
Die Schrittergebnisse stammen aus dem letzten Testlauf. Ohne ihn bleibt der Reiter leer und der Editor sagt es auch: Zuerst musst du den Flow testen. → Flows testen
Beispielergebnis und Typ
Unter dem Eingabefeld steht Beispielergebnis — der Ausdruck, ausgerechnet mit echten Daten: in einer Formelspalte mit einem Eintrag des Grids, in einem Flow mit den Werten des Testlaufs. Darüber steht der ermittelte Typ, etwa Typ: String.
Der Typ ist die wichtigere der beiden Angaben. Er entscheidet, welche Funktionen als Nächstes möglich sind, und in einer Formelspalte auch, welche Ergebnistypen unter Ergebnis anzeigen als zur Auswahl stehen.
Ein leeres Beispielergebnis ist kein Beweis
Das Beispielergebnis wird im Browser berechnet, die produktive Auswertung läuft auf dem Server. Beides ist nicht deckungsgleich: Vor allem bei Datumsrechnungen und einigen Umwandlungen bleibt die Vorschau leer, obwohl derselbe Ausdruck im Betrieb rechnet — die relativen Datumsfilter der Oberfläche sind genau solche Ausdrücke.
Verlassen Sie sich deshalb auf die Typanzeige und prüfen Sie das Ergebnis an einem echten Eintrag beziehungsweise in einem Testlauf.
Übernehmen und Fehler
Der Ausdruck wird übernommen, wenn Sie das Feld verlassen oder Enter drücken. Ist er nicht lesbar, erscheint die Meldung unter dem Feld — und der eingegebene Text bleibt als Text stehen, statt in Bausteine umgewandelt zu werden.
Bausteine statt Text sind also die Bestätigung, dass der Ausdruck gelesen werden konnte. Bleibt Ihre Eingabe unverändert stehen, stimmt etwas nicht.
Die Meldungen sind englisch und nennen interne Typnamen; welche es gibt und was sie bedeuten, steht unter Schreibweise.
Grid-Felder im HTML-Block und im JavaScript-Schritt
Der HTML-Block und der Flow-Schritt JavaScript haben keinen Ausdruckseditor, sondern einen Code-Editor. Auch dort lassen sich Grid-Felder einfügen:
Drücken Sie Strg + Leertaste um Grid-Felder einzufügen
Die Vorschlagsliste zeigt die Feldnamen und fügt {{fieldValue('<Feld-Id>')}} ein — mit geschweiften Klammern, weil in diesen Editoren Text und Ausdruck gemischt werden. Dieselbe Liste erscheint, sobald Sie field tippen.
Weiter
- Bedingungen bauen — Vergleiche, UND/ODER, Verzweigungen
- Werte referenzieren — womit ein Ausdruck anfängt
- Funktionsreferenz — alle Funktionen je Typ
- Berechnete Felder · Daten zwischen Schritten