Gå til indhold
Bekræftet

JavaScript

Ægte JS-kildekode, kompileret ved gemning, til logik som et deklarativt program ikke kan udtrykke.

Et JavaScript-program rummer ægte kildekode i scriptData.value, nødudgangen til logik, som et deklarativt Get Data, Set Data eller Batch ikke kan udtrykke. Det kompileres ved gemning (save_prog kører det samme build som Studio og returnerer data.compile, { ok: true, dependencies } eller { ok: false, error }), og det kører med et ægte API til felter, tabeller og hændelser, ikke kun et DOM-element.

Egenskaber

Udførelseskontrakten

Kildekoden er en almindelig async-krop, uden export og uden wrapper, og køres sådan:

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

params er den kaldendes parametre, som allerede er evalueret. xu er runtime-API'et: felter, databaserækker, hændelser, HTTP. await kan bruges frit, da wrapperen er async. Anførselstegn er i orden her, i modsætning til i en xu-script-attributværdi.

Læsning og skrivning af en tabel

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_*-metoder tager tabellens _id, aldrig dens navn. fields-projektionen på dbs_read er valgfri: [], standarden, returnerer alle felter, og en liste af felt-id'er returnerer kun dem.

Send data ind: felter, ikke parametre

call_native_javascript evaluerer ikke {value, fx}-parameterwrappere, så et script, der kaldes på den måde, modtager de bogstavelige {value: "", fx: "@field"}-objekter, ikke de løste værdier. Den pålidelige fremgangsmåde: Den, der kalder, lægger data i et felt først (et update-trin eller et xu-bind-input), kalder scriptet med tomme parameters: {}, og scriptet læser med xu.get_field_value og melder tilbage med xu.set_field_value. Hvis du kalder fra et andet script, er det anderledes: parametre i xu.call_javascript(prog_id, {...}) kommer frem, som de blev sendt.

Kald af et JavaScript-program

Eksempel fra praksis

Deklarer parametrene

progFields-poster bliver til wrapper-funktionens argumentnavne, i kaldets rækkefølge.

Skriv kroppen

En almindelig async-funktionskrop. Lad den return'ere en værdi, hvis call_evaluate_javascript skal læse den.

Kald den, og læs compile.ok

Tjek data.compile.ok efter save_prog. En mislykket kompilering gemmer stadig dokumentet med en vedhæftet build_error.

Opret en JavaScript-node under Programmer, skriv kildekoden i kodeeditoren, og tilføj parametre i gitteret Felter. Gem kompilerer automatisk igen, og fejl vises i editoren.

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