Was ist ApptiveScript
ApptiveScript ist die Ausdruckssprache von ApptiveGrid. Ein Ausdruck ist eine einzelne Rechnung, Verknüpfung oder Bedingung — er nimmt Werte, macht etwas daraus und liefert ein Ergebnis.
Sie haben ApptiveScript sehr wahrscheinlich schon benutzt, ohne es zu bemerken.
Jeder Filter ist bereits ein Ausdruck
Wenn Sie in einer Ansicht filtern — Status ist gleich Offen — schreibt ApptiveGrid im Hintergrund genau das:
fieldValue('<Status>').isEqualTo('Offen')Die Bedingungen aus dem Filterdialog sind Funktionen der Sprache:
| Bedingung in der Oberfläche | Funktion |
|---|---|
| ist gleich · ist nicht gleich | isEqualTo · isNotEqualTo |
| enthält | contains |
| ist größer als · ist kleiner als | greaterThan · smallerThan |
| ist leer · ist nicht leer | isEmpty · isNotEmpty |
| enthält eines · keines · alle von | includesAnyOf · includesNoneOf · includesAllOf |
| ist vor · ist nach | before · after |
| UND · ODER | logicalAnd · logicalOr |
Dasselbe gilt für die relativen Datumswerte: heute ist today(), gestern ist today().subtractDays(1).
Der Dialog schreibt mit
Wer einen Ausdruck von Hand schreiben will, baut ihn am schnellsten zuerst über den Dialog zusammen und sieht sich dann an, was dabei herauskommt. Die einfache Auswahl und der Ausdruck sind zwei Ansichten auf dieselbe Sache.
Wo Sie selbst Ausdrücke schreiben können
An sieben Stellen bietet ApptiveGrid ein Feld für einen eigenen Ausdruck an:
| Stelle | Wozu | Ergebnis muss sein |
|---|---|---|
| Formel-Spalte in einem Grid | Werte innerhalb eines Eintrags verrechnen | der gewählte Ergebnistyp |
| Bedingte Sichtbarkeit eines Blocks, Bereich Erweitert | Blöcke abhängig von Eingaben zeigen | ein Wahrheitswert |
| Flow-Übergang, Erweiterte Logik | einen Zweig nur unter Bedingungen fortsetzen | ein Wahrheitswert |
| Textfelder in Flow-Schritten | Werte in Betreff, Text, URL einsetzen | Text |
| Filter, wenn die Auswahl nicht ausreicht | mehrere Bedingungen kombinieren | ein Wahrheitswert |
| Relative Datumswerte in Filtern | „vor 7 Tagen" statt eines festen Datums | ein Datum |
| Einstellungsfelder vom Typ Ausdruck in einzelnen Flow-Schritten | Wert berechnen statt eintragen | je Schritt |
Die Schreibweise ist überall dieselbe. Unterschiedlich ist nur, womit ein Ausdruck anfangen darf — das hängt davon ab, welche Werte an dieser Stelle überhaupt zur Verfügung stehen. → Werte referenzieren
Was ApptiveScript nicht ist
Keine Programmiersprache
Es gibt keine Variablen, Schleifen, eigenen Funktionen und keine Zwischenschritte. Ein Ausdruck ist eine Zeile, die einen Wert ergibt. Wenn Sie mehrere Schritte brauchen, ist ein Flow das richtige Werkzeug — oder mehrere Formelspalten, die aufeinander aufbauen.
Nicht der JavaScript-Schritt
Der Flow-Schritt JavaScript ist etwas anderes: dort läuft echtes JavaScript mit mehreren Zeilen, Variablen und Rückgabewert. ApptiveScript ist die kleine Sprache für einzelne Ausdrücke in Feldern. → Aktionen
Kein Zugriffsschutz
Eine Sichtbarkeitsregel entscheidet, was angezeigt wird — sie schützt keine Daten. Wer ausgeblendete Inhalte wirklich verbergen muss, braucht Zugriffsbeschränkungen.
Wenn etwas nicht stimmt
Das Wichtigste zuerst: ein fehlerhafter Ausdruck macht in der Regel keinen Lärm. Er liefert nichts, und was dann passiert, ist je nach Stelle unterschiedlich:
| Stelle | Verhalten bei einem Ausdruck, der nicht aufgeht |
|---|---|
| Filter | Der Eintrag gilt als nicht zutreffend und verschwindet aus der Ansicht |
| Bedingte Sichtbarkeit | Bei einem Fehler bleibt der Block sichtbar, bei einem leeren Ergebnis wird er ausgeblendet |
| Textfeld im Flow | Es wird nichts eingesetzt — der Text bleibt an dieser Stelle leer |
| Formel | Die Spalte bleibt leer |
Daraus folgt die wichtigste Fehlersuche-Regel: Ein Feld, das unerwartet leer bleibt oder ein Block, der immer verschwindet, ist der typische Hinweis auf einen Tippfehler im Ausdruck — nicht auf ein Rechteproblem.
Ein Name, den es nicht gibt, ist dabei kein Fehler, sondern einfach leer. formValues.get('alter') liefert nichts, wenn der Key in Wahrheit age heißt. Deshalb: Ids und Keys nie tippen, sondern einfügen. → Werte referenzieren
Weiter
- Schreibweise — Punkt, Klammern, Anführungszeichen
- Werte referenzieren — womit ein Ausdruck anfängt
- Bedingungen bauen — Vergleiche, UND/ODER, Verzweigungen
- Der Ausdruckseditor — Token-Ansicht, Picker, Beispielergebnis
- Funktionsreferenz — alle Funktionen je Typ
- Berechnete Felder · Bedingte Sichtbarkeit · Daten zwischen Schritten