Sari la conținut
Verificat

JavaScript

Cod JS real, compilat la salvare, pentru logica pe care un program declarativ nu o poate exprima.

Un program JavaScript păstrează cod sursă real în scriptData.value, calea de ieșire pentru logica pe care un Get Data, Set Data sau Batch declarativ nu o poate exprima. Se compilează la salvare (save_prog rulează același build ca Studio și returnează data.compile, { ok: true, dependencies } sau { ok: false, error }) și rulează cu un API real pentru câmpuri, tabele și evenimente, nu doar cu un element DOM.

Proprietăți

Contractul de execuție

Sursa este un corp async simplu, fără export, fără wrapper, rulat astfel:

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

params sunt parametrii apelantului, deja evaluați. xu este API-ul de runtime: câmpuri, rânduri de bază de date, evenimente, HTTP. await funcționează liber, deoarece wrapperul este async. Ghilimelele sunt în regulă aici, spre deosebire de valoarea unui atribut xu-script.

Citirea și scrierea unui 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 || `` })));

Metodele dbs_* primesc _id-ul tabelului, niciodată numele lui. Proiecția fields de la dbs_read este opțională: [], valoarea implicită, returnează toate câmpurile, iar o listă de id-uri de câmp returnează doar acele câmpuri.

Trimiterea datelor: prin câmpuri, nu prin parametri

call_native_javascript nu evaluează wrapperele de parametri {value, fx}: un script apelat astfel primește obiectele literale {value: "", fx: "@field"}, nu valori rezolvate. Modelul de încredere: apelantul pune mai întâi datele într-un câmp (un pas update sau un câmp de intrare cu xu-bind), apelează scriptul cu parameters: {} gol, iar scriptul citește cu xu.get_field_value și raportează înapoi cu xu.set_field_value. Apelul dintr-un alt script este diferit: parametrii xu.call_javascript(prog_id, {...}) ajung așa cum au fost trimiși.

Apelarea unui program JavaScript

Exemplu lucrat

Declară parametrii

Intrările progFields devin numele argumentelor funcției wrapper, în ordinea apelului.

Scrie corpul

Un corp simplu de funcție async; folosește return pentru o valoare dacă o va citi call_evaluate_javascript.

Apelează-l și citește compile.ok

După save_prog, verifică data.compile.ok: o compilare eșuată salvează totuși documentul, cu un build_error atașat.

Creează un nod JavaScript sub Programe, scrie sursa în editorul de cod, adaugă parametri în grila Câmpuri. Salvarea recompilează automat, iar erorile apar în 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" } }
  ]
}