Naar de inhoud springen
Geverifieerd

JavaScript

Echte JS-broncode, gecompileerd bij het opslaan, voor logica die een declaratief programma niet kan uitdrukken.

Een JavaScript-programma bevat echte broncode in scriptData.value, de nooduitgang voor logica die een declaratieve Get Data, Set Data of Batch niet kan uitdrukken. Het wordt bij het opslaan gecompileerd (save_prog draait dezelfde build als Studio en geeft data.compile terug, { ok: true, dependencies } of { ok: false, error }) en draait met een echte API voor velden, tabellen en events, niet alleen een DOM-element.

Eigenschappen

Het uitvoeringscontract

De broncode is een gewone async body, zonder export en zonder wrapper, uitgevoerd als:

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

params zijn de al geëvalueerde parameters van de aanroeper. xu is de runtime-API: velden, databaserijen, events, HTTP. await werkt vrij, omdat de wrapper async is. Aanhalingstekens zijn hier geen probleem, anders dan in de waarde van een xu-script-attribuut.

Een tabel lezen en schrijven

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 nemen de _id van de tabel, nooit de naam. De fields-projectie bij dbs_read is optioneel: [], de standaard, geeft alle velden terug, en een lijst veld-id's geeft alleen die velden.

Data doorgeven: via velden, niet via parameters

call_native_javascript evalueert de {value, fx}-parameterwrappers niet. Een script dat zo wordt aangeroepen, ontvangt de letterlijke objecten {value: "", fx: "@field"} en geen opgeloste waarden. Het betrouwbare patroon: de aanroeper zet de payload eerst in een veld (een update-stap of een xu-bind-invoer), roept het script aan met lege parameters: {}, en het script leest met xu.get_field_value en meldt terug met xu.set_field_value. Aanroepen vanuit een ander script werkt anders: de parameters van xu.call_javascript(prog_id, {...}) komen aan zoals ze zijn meegegeven.

Een JavaScript-programma aanroepen

Uitgewerkt voorbeeld

Declareer de parameters

progFields-items worden de argumentnamen van de wrapperfunctie, in aanroepvolgorde.

Schrijf de body

Een gewone async functiebody, geef met return een waarde terug als call_evaluate_javascript die gaat lezen.

Roep hem aan en lees compile.ok

Controleer na save_prog data.compile.ok. Een mislukte compilatie slaat het document nog steeds op, met een build_error erbij.

Maak een JavaScript-node onder Programma's, schrijf de broncode in de code-editor en voeg parameters toe in het raster Velden. Opslaan compileert automatisch opnieuw, fouten verschijnen in de 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" } }
  ]
}