Přeskočit na obsah
Ověřeno

JavaScript

Skutečný zdrojový kód JS, kompilovaný při uložení, pro logiku, kterou deklarativní program nevyjádří.

Program JavaScript obsahuje skutečný zdrojový kód v scriptData.value, což je nouzový východ pro logiku, kterou deklarativní Get Data, Set Data nebo Batch nevyjádří. Kompiluje se při uložení (save_prog spustí stejné sestavení jako Studio a vrátí data.compile, tedy { ok: true, dependencies } nebo { ok: false, error }) a běží se skutečným API pro pole, tabulky a události, nejen s prvkem DOM.

Vlastnosti

Prováděcí smlouva

Zdroj je prosté asynchronní tělo, bez export, bez obalu, spouštěné takto:

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

params jsou již vyhodnocené parametry volajícího. xu je API běhového prostředí: pole, řádky databáze, události, HTTP. await funguje bez omezení, protože obal je asynchronní. Uvozovky zde nevadí, na rozdíl od hodnoty atributu xu-script.

Čtení a zápis tabulky

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

Metody dbs_* berou _id tabulky, nikdy její název. Projekce fields u dbs_read je volitelná: [], výchozí hodnota, vrátí všechna pole a seznam id polí vrátí jen tato pole.

Předávání dat dovnitř: pole, ne parametry

call_native_javascript nevyhodnocuje obaly parametrů {value, fx}, skript zavolaný tímto způsobem dostane doslovné objekty {value: "", fx: "@field"}, ne vyhodnocené hodnoty. Spolehlivý postup: volající nejprve vloží data do pole (krokem update nebo vstupem xu-bind), zavolá skript s prázdnými parameters: {} a skript čte pomocí xu.get_field_value a hlásí zpět pomocí xu.set_field_value. Volání z jiného skriptu je jiné, parametry xu.call_javascript(prog_id, {...}) dorazí tak, jak byly předány.

Vyvolání programu JavaScript

Praktický příklad

Deklarujte parametry

Položky progFields se stanou názvy argumentů funkce obalu, v pořadí volání.

Napište tělo

Prosté asynchronní tělo funkce, pomocí return vraťte hodnotu, pokud ji bude číst call_evaluate_javascript.

Zavolejte ho a přečtěte compile.ok

Po save_prog zkontrolujte data.compile.ok: neúspěšná kompilace dokument stále uloží, s připojenou chybou build_error.

Vytvořte uzel JavaScript v sekci Programy, zdroj napište v editoru kódu a parametry přidejte v mřížce Pole. Uložení překompiluje automaticky, chyby se zobrazí v editoru.

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