Siirry sisältöön
Tarkistettu

JavaScript

Aitoa JS-lähdekoodia, joka käännetään tallennettaessa, logiikkaan, jota deklaratiivinen ohjelma ei voi ilmaista.

JavaScript-ohjelma sisältää aitoa lähdekoodia kentässä scriptData.value. Se on varaportti logiikalle, jota deklaratiivinen Hae dataa, Aseta dataa tai Batch ei voi ilmaista. Se käännetään tallennettaessa (save_prog ajaa saman buildin kuin Studio ja palauttaa data.compilen: { ok: true, dependencies } tai { ok: false, error }), ja se toimii oikealla API:lla kentille, tauluille ja tapahtumille, ei pelkällä DOM-elementillä.

Ominaisuudet

Suoritussopimus

Lähdekoodi on tavallinen async-runko, ei exportia eikä kääreitä, ja se ajetaan näin:

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

params ovat kutsujan jo laskemat parametrit. xu on ajonaikainen API: kentät, tietokantarivit, tapahtumat, HTTP. await toimii vapaasti, koska kääre on async. Lainausmerkit ovat tässä sallittuja, toisin kuin xu-script-attribuutin arvossa.

Taulun lukeminen ja kirjoittaminen

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_*-metodit ottavat taulun _id:n, eivät koskaan sen nimeä. dbs_readin fields-rajaus on valinnainen: [], oletusarvo, palauttaa kaikki kentät, ja kenttätunnisteiden lista palauttaa vain ne.

Datan välittäminen sisään: kentät, ei parametrit

call_native_javascript ei laske {value, fx}-parametrikääreitä, joten tällä tavalla kutsuttu skripti saa kirjaimelliset {value: "", fx: "@field"}-oliot, ei lasketut arvot. Luotettava tapa: kutsuja laittaa sisällön ensin kenttään (update-vaihe tai xu-bind-syöte), kutsuu skriptiä tyhjillä parameters: {}-arvoilla, ja skripti lukee xu.get_field_valuella ja raportoi takaisin xu.set_field_valuella. Toisesta skriptistä kutsuminen on eri asia: xu.call_javascript(prog_id, {...})-parametrit saapuvat sellaisinaan.

JavaScript-ohjelman kutsuminen

Esimerkki

Ilmoita parametrit

progFields-merkinnät muuttuvat kääreen funktion argumenttien nimiksi kutsujärjestyksessä.

Kirjoita runko

Tavallinen async-funktion runko. Käytä returnia, jos call_evaluate_javascript lukee arvon.

Kutsu sitä ja lue compile.ok

save_progin jälkeen tarkista data.compile.ok: epäonnistunut käännös tallentaa dokumentin silti, ja siihen liitetään build_error.

Luo JavaScript-solmu kohtaan Ohjelmat, kirjoita lähdekoodi koodieditorissa ja lisää parametrit Kentät-ruudukkoon. Tallennus kääntää uudelleen automaattisesti, ja virheet näkyvät editorissa.

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