Ugrás a tartalomhoz
Ellenőrizve

JavaScript

Valódi JS-forráskód, mentéskor lefordítva, olyan logikához, amelyet egy deklaratív program nem tud kifejezni.

A JavaScript program valódi forráskódot tartalmaz a scriptData.value mezőben, ez a menekülőút olyan logikához, amelyet egy deklaratív Adatok lekérése, Adatok beállítása vagy Batch nem tud kifejezni. Mentéskor lefordul (a save_prog ugyanazt a buildet futtatja, mint a Studio, és visszaadja a data.compile értéket: { ok: true, dependencies } vagy { ok: false, error }), és valódi API-val fut mezőkhöz, táblákhoz és eseményekhez, nem csak egy DOM-elemhez.

Tulajdonságok

A végrehajtási szerződés

A forráskód sima aszinkron törzs, export és burkoló nélkül, és így fut:

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

A params a hívó már kiértékelt paraméterei. Az xu a futásidejű API: mezők, adatbázissorok, események, HTTP. Az await szabadon használható, mert a burkoló aszinkron. Az idézőjelek itt rendben vannak, az xu-script attribútumértékkel ellentétben.

Tábla olvasása és írása

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

A dbs_* metódusok a tábla _id értékét veszik át, soha a nevét. A dbs_read fields vetítése nem kötelező: az [], az alapértelmezés, minden mezőt visszaad, a mezőazonosítók listája pedig csak azokat.

Adatok átadása: mezőkkel, nem paraméterekkel

A call_native_javascript nem értékeli ki a {value, fx} paraméterburkolókat, az így hívott szkript a szó szerinti {value: "", fx: "@field"} objektumokat kapja, nem a feloldott értékeket. A megbízható minta: a hívó először egy mezőbe teszi a tartalmat (egy update lépéssel vagy egy xu-bind bemenettel), üres parameters: {} értékkel hívja a szkriptet, a szkript pedig az xu.get_field_value függvénnyel olvas, és az xu.set_field_value függvénnyel jelent vissza. Másik szkriptből hívni más: az xu.call_javascript(prog_id, {...}) paraméterei úgy érkeznek meg, ahogy át lettek adva.

JavaScript program meghívása

Példa lépésről lépésre

Deklarálja a paramétereket

A progFields bejegyzések a burkolófüggvény argumentumneveivé válnak, hívási sorrendben.

Írja meg a törzset

Sima aszinkron függvénytörzs, return értéket adjon vissza, ha a call_evaluate_javascript olvasni fogja.

Hívja meg, és olvassa a compile.ok értéket

A save_prog után ellenőrizze a data.compile.ok értéket, a sikertelen fordítás is elmenti a dokumentumot, csatolt build_error hibával.

Hozzon létre egy JavaScript csomópontot a Programok alatt, írja meg a forráskódot a kódszerkesztőben, adjon hozzá paramétereket a Mezők rácson. A mentés automatikusan újrafordít, a hibák a szerkesztőben jelennek meg.

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