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