Hoppa till innehållet
Verifierad

JavaScript

Riktig JS-källkod, kompilerad vid sparande, för logik som ett deklarativt program inte kan uttrycka.

Ett JavaScript-program innehåller riktig källkod i scriptData.value, nödutgången för logik som ett deklarativt Get Data, Set Data eller Batch inte kan uttrycka. Det kompileras vid sparande (save_prog kör samma bygge som Studio och returnerar data.compile, { ok: true, dependencies } eller { ok: false, error }), och det körs med ett riktigt API för fält, tabeller och händelser, inte bara ett DOM-element.

Egenskaper

Körningskontraktet

Källkoden är en vanlig async-kropp, utan export och utan omslag, och körs som:

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

params är anroparens redan utvärderade parametrar. xu är runtime-API:t: fält, databasrader, händelser, HTTP. await fungerar fritt eftersom omslaget är async. Citattecken går bra här, till skillnad från i ett xu-script-attributvärde.

Läsa och skriva en tabell

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_*-metoderna tar tabellens _id, aldrig dess namn. fields-projektionen på dbs_read är valfri: [], standardvärdet, returnerar alla fält, och en lista med fält-id:n returnerar bara dem.

Skicka in data: fält, inte parametrar

call_native_javascript utvärderar inte parameteromslagen {value, fx}. Ett skript som anropas så får de bokstavliga objekten {value: "", fx: "@field"}, inte upplösta värden. Det pålitliga mönstret: anroparen lägger först innehållet i ett fält (ett update-steg eller en xu-bind-inmatning), anropar skriptet med tomma parameters: {}, och skriptet läser med xu.get_field_value och rapporterar tillbaka med xu.set_field_value. Att anropa från ett annat skript är annorlunda: parametrarna i xu.call_javascript(prog_id, {...}) kommer fram som de skickades.

Anropa ett JavaScript-program

Exempel steg för steg

Deklarera parametrarna

Poster i progFields blir omslagsfunktionens argumentnamn, i anropsordning.

Skriv kroppen

En vanlig async-funktionskropp, return ett värde om call_evaluate_javascript ska läsa det.

Anropa den och läs compile.ok

Efter save_prog, kontrollera data.compile.ok: en misslyckad kompilering sparar ändå dokumentet, med ett build_error bifogat.

Skapa en JavaScript-nod under Program, skriv källkod i kodeditorn och lägg till parametrar i rutnätet Fält. Sparande kompilerar om automatiskt och fel visas i editorn.

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" } }
  ]
}