Zum Inhalt springen
Geprüft

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:

js
async function (params, xu, SESSION_ID, SESSION_OBJ, jobNoP, $container, func, glb, APP_OBJ, evt) {
  /* your source */
}

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

js
const raw = await xu.get_field_value(`rows_json_v`);
const rows = typeof raw === `string` ? JSON.parse(raw || `[]`) : raw || [];
for (const row of rows) {
  await xu.dbs_create(`392_tbl_…`, { CNT_Name: row.name || `` });
}
// dbs_read resolves to an ARRAY of { id, value } rows, the row id on .id, fields under .value.
const all = await xu.dbs_read(`392_tbl_…`, {}, [], null, 999);
await xu.set_field_value(`saved_rows_v`, all.map((r) => ({ row_id: r.id, name: r.value?.CNT_Name || `` })));

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.

xml
<meta lang="json5">
{
  id: "normalize_student_name",
  menuTitle: "Normalize Student Name"
}
</meta>

<params lang="json5">
{
  in: { raw_name_in: "string" },
  out: { normalized_name_out: "string" }
}
</params>

<code>
return (@raw_name_in || "")
  .trim()
  .split(/\s+/)
  .filter(Boolean)
  .map(part => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
  .join(" ");
</code>
json
{
  "properties": { "menuType": "javascript", "menuName": "Slugify Name", "fileExtension": "js" },
  "scriptData": { "value": "return name.toLowerCase().replace(/[^a-z0-9]+/g, '-');", "dependencies": [] },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "name", "type": "virtual" }, "props": { "fieldType": "string" } }
  ]
}