JavaScript
Cod JS real, compilat la salvare, pentru logica pe care un program declarativ nu o poate exprima.
Un program JavaScript păstrează cod sursă real în scriptData.value, calea de ieșire pentru logica pe care un Get Data, Set Data sau Batch declarativ nu o poate exprima. Se compilează la salvare (save_prog rulează același build ca Studio și returnează data.compile, { ok: true, dependencies } sau { ok: false, error }) și rulează cu un API real pentru câmpuri, tabele și evenimente, nu doar cu un element DOM.
Proprietăți
Contractul de execuție
Sursa este un corp async simplu, fără export, fără wrapper, rulat astfel:
params sunt parametrii apelantului, deja evaluați. xu este API-ul de runtime: câmpuri, rânduri de bază de date, evenimente, HTTP. await funcționează liber, deoarece wrapperul este async. Ghilimelele sunt în regulă aici, spre deosebire de valoarea unui atribut xu-script.
Citirea și scrierea unui tabel
Metodele dbs_* primesc _id-ul tabelului, niciodată numele lui. Proiecția fields de la dbs_read este opțională: [], valoarea implicită, returnează toate câmpurile, iar o listă de id-uri de câmp returnează doar acele câmpuri.
Trimiterea datelor: prin câmpuri, nu prin parametri
call_native_javascript nu evaluează wrapperele de parametri {value, fx}: un script apelat astfel primește obiectele literale {value: "", fx: "@field"}, nu valori rezolvate. Modelul de încredere: apelantul pune mai întâi datele într-un câmp (un pas update sau un câmp de intrare cu xu-bind), apelează scriptul cu parameters: {} gol, iar scriptul citește cu xu.get_field_value și raportează înapoi cu xu.set_field_value. Apelul dintr-un alt script este diferit: parametrii xu.call_javascript(prog_id, {...}) ajung așa cum au fost trimiși.
Apelarea unui program JavaScript
Exemplu lucrat
Declară parametrii
Intrările progFields devin numele argumentelor funcției wrapper, în ordinea apelului.
Scrie corpul
Un corp simplu de funcție async; folosește return pentru o valoare dacă o va citi call_evaluate_javascript.
Apelează-l și citește compile.ok
După save_prog, verifică data.compile.ok: o compilare eșuată salvează totuși documentul, cu un build_error atașat.
Creează un nod JavaScript sub Programe, scrie sursa în editorul de cod, adaugă parametri în grila Câmpuri. Salvarea recompilează automat, iar erorile apar în editor.