Preskočiť na obsah
Overené

JavaScript

Skutočný zdrojový kód JS, kompilovaný pri uložení, pre logiku, ktorú deklaratívny program nevyjadrí.

Program JavaScript drží skutočný zdrojový kód v scriptData.value, únikový východ pre logiku, ktorú deklaratívny Get Data, Set Data alebo Batch nevyjadrí. Kompiluje sa pri uložení (save_prog spustí ten istý build ako Studio a vráti data.compile, { ok: true, dependencies } alebo { ok: false, error }) a beží so skutočným API pre polia, tabuľky a udalosti, nielen s prvkom DOM.

Vlastnosti

Kontrakt vykonávania

Zdroj je obyčajné asynchrónne telo, bez export, bez obalu, spúšťané ako:

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

params sú už vyhodnotené parametre volajúceho. xu je API runtime: polia, riadky databázy, udalosti, HTTP. await funguje bez obmedzení, keďže obal je asynchrónny. Úvodzovky sú tu v poriadku, na rozdiel od hodnoty atribútu xu-script.

Čítanie a zápis tabuľky

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 || `` })));

Metódy dbs_* berú _id tabuľky, nikdy jej názov. Projekcia fields v dbs_read je voliteľná: [], predvolená hodnota, vráti každé pole a zoznam id polí vráti iba tie.

Odovzdávanie dát: polia, nie parametre

call_native_javascript nevyhodnocuje obaly parametrov {value, fx}, skript volaný týmto spôsobom dostane doslovné objekty {value: "", fx: "@field"}, nie vyriešené hodnoty. Spoľahlivý postup: volajúci najprv vloží dáta do poľa (krokom update alebo vstupom xu-bind), zavolá skript s prázdnymi parameters: {} a skript číta cez xu.get_field_value a výsledok hlási cez xu.set_field_value. Volanie z iného skriptu je odlišné, parametre xu.call_javascript(prog_id, {...}) prídu tak, ako boli odovzdané.

Vyvolanie programu JavaScript

Ukážkový príklad

Deklarujte parametre

Záznamy progFields sa stanú názvami argumentov funkcie obalu, v poradí volania.

Napíšte telo

Obyčajné asynchrónne telo funkcie, return vráti hodnotu, ak ju prečíta call_evaluate_javascript.

Zavolajte a prečítajte compile.ok

Po save_prog skontrolujte data.compile.ok, neúspešná kompilácia dokument aj tak uloží s priloženým build_error.

Vytvorte uzol JavaScript v časti Programy, zdroj napíšte v editore kódu a parametre pridajte v mriežke Polia. Uloženie sa prekompiluje automaticky, chyby sa zobrazia v editore.

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