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:
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
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.