JavaScript
Echter JS-Quelltext, beim Speichern kompiliert, für Logik, die ein deklaratives Programm nicht ausdrücken kann.
Ein JavaScript-Programm hält echten Quellcode in scriptData.value, die Notlösung für Logik, die ein deklaratives Get Data, Set Data oder Batch nicht ausdrücken kann. Es wird beim Speichern kompiliert (save_prog führt denselben Build aus wie Studio und gibt data.compile zurück, { ok: true, dependencies } oder { ok: false, error }), und es läuft mit einer echten API für Felder, Tabellen und Ereignisse, nicht nur mit einem DOM-Element.
Eigenschaften
Der Ausführungsvertrag
Der Quelltext ist ein einfacher async-Körper, ohne export, ohne Wrapper, ausgeführt als:
params sind die bereits ausgewerteten Parameter des Aufrufers. xu ist die Laufzeit-API: Felder, Datenbankzeilen, Ereignisse, HTTP. await funktioniert frei, da der Wrapper async ist. Anführungszeichen sind hier in Ordnung, anders als in einem Attributwert xu-script.
Eine Tabelle lesen und schreiben
dbs_*-Methoden nehmen die _id der Tabelle, nie ihren Namen. Die Projektion fields bei dbs_read ist optional: [], der Standard, liefert alle Felder, eine Liste von Feld-IDs nur diese.
Daten übergeben: Felder, nicht Parameter
call_native_javascript wertet die Wrapper {value, fx} bei Parametern nicht aus, ein so aufgerufenes Skript erhält die wörtlichen Objekte {value: "", fx: "@field"}, nicht aufgelöste Werte. Das verlässliche Muster: Der Aufrufer legt die Nutzdaten zuerst in ein Feld (ein Schritt update oder ein xu-bind-Eingabefeld), ruft das Skript mit leeren parameters: {} auf, und das Skript liest mit xu.get_field_value und meldet mit xu.set_field_value zurück. Der Aufruf aus einem anderen Skript ist anders, bei xu.call_javascript(prog_id, {...}) kommen die Parameter wie übergeben an.
Ein JavaScript-Programm aufrufen
Praxisbeispiel
Die Parameter deklarieren
progFields-Einträge werden zu den Argumentnamen der Wrapper-Funktion, in der Aufrufreihenfolge.
Den Körper schreiben
Ein einfacher async-Funktionskörper, return gibt einen Wert zurück, wenn call_evaluate_javascript ihn liest.
Aufrufen und compile.ok lesen
Prüfe nach save_prog data.compile.ok, eine fehlgeschlagene Kompilierung speichert das Dokument trotzdem, mit angehängtem build_error.
Lege unter Programme einen JavaScript-Knoten an, schreibe den Quelltext im Code-Editor und füge Parameter im Raster Felder hinzu. Das Speichern kompiliert automatisch neu, Fehler erscheinen im Editor.