JavaScript
Vero codice JS, compilato al salvataggio, per la logica che un programma dichiarativo non riesce a esprimere.
Un programma JavaScript contiene vero codice sorgente in scriptData.value, la via di fuga per la logica che un Leggi dati, Imposta dati o Batch dichiarativo non riesce a esprimere. Viene compilato al salvataggio (save_prog esegue la stessa build di Studio e restituisce data.compile, { ok: true, dependencies } oppure { ok: false, error }) e viene eseguito con una vera API per campi, tabelle ed eventi, non solo per un elemento DOM.
Proprietà
Il contratto di esecuzione
Il sorgente è un semplice corpo asincrono, senza export né wrapper, eseguito come:
params sono i parametri del chiamante già valutati. xu è l'API di runtime: campi, righe del database, eventi, HTTP. await funziona liberamente perché il wrapper è asincrono. Qui le virgolette vanno bene, a differenza del valore di un attributo xu-script.
Leggere e scrivere una tabella
I metodi dbs_* accettano il _id della tabella, mai il suo nome. La proiezione fields di dbs_read è facoltativa: [], il valore predefinito, restituisce tutti i campi, e un elenco di id di campo restituisce solo quelli.
Passare i dati: campi, non parametri
call_native_javascript non valuta i wrapper di parametri {value, fx}: uno script chiamato in questo modo riceve gli oggetti letterali {value: "", fx: "@field"}, non i valori risolti. Lo schema affidabile: il chiamante mette prima il payload in un campo (un passo update o un input xu-bind), chiama lo script con parameters: {} vuoto e lo script legge con xu.get_field_value e restituisce il risultato con xu.set_field_value. Chiamare da un altro script è diverso: i parametri di xu.call_javascript(prog_id, {...}) arrivano come passati.
Richiamare un programma JavaScript
Esempio pratico
Dichiara i parametri
Le voci di progFields diventano i nomi degli argomenti della funzione wrapper, nell'ordine di chiamata.
Scrivi il corpo
Un semplice corpo di funzione asincrona, usa return per restituire un valore se call_evaluate_javascript lo leggerà.
Chiamalo e leggi compile.ok
Dopo save_prog, controlla data.compile.ok: una compilazione fallita salva comunque il documento con un build_error allegato.
Crea un nodo JavaScript sotto Programmi, scrivi il sorgente nell'editor di codice, aggiungi i parametri nella griglia Campi. Il salvataggio ricompila automaticamente, gli errori compaiono nell'editor.