JavaScript
Echte JS-broncode, gecompileerd bij het opslaan, voor logica die een declaratief programma niet kan uitdrukken.
Een JavaScript-programma bevat echte broncode in scriptData.value, de nooduitgang voor logica die een declaratieve Get Data, Set Data of Batch niet kan uitdrukken. Het wordt bij het opslaan gecompileerd (save_prog draait dezelfde build als Studio en geeft data.compile terug, { ok: true, dependencies } of { ok: false, error }) en draait met een echte API voor velden, tabellen en events, niet alleen een DOM-element.
Eigenschappen
Het uitvoeringscontract
De broncode is een gewone async body, zonder export en zonder wrapper, uitgevoerd als:
params zijn de al geëvalueerde parameters van de aanroeper. xu is de runtime-API: velden, databaserijen, events, HTTP. await werkt vrij, omdat de wrapper async is. Aanhalingstekens zijn hier geen probleem, anders dan in de waarde van een xu-script-attribuut.
Een tabel lezen en schrijven
dbs_*-methoden nemen de _id van de tabel, nooit de naam. De fields-projectie bij dbs_read is optioneel: [], de standaard, geeft alle velden terug, en een lijst veld-id's geeft alleen die velden.
Data doorgeven: via velden, niet via parameters
call_native_javascript evalueert de {value, fx}-parameterwrappers niet. Een script dat zo wordt aangeroepen, ontvangt de letterlijke objecten {value: "", fx: "@field"} en geen opgeloste waarden. Het betrouwbare patroon: de aanroeper zet de payload eerst in een veld (een update-stap of een xu-bind-invoer), roept het script aan met lege parameters: {}, en het script leest met xu.get_field_value en meldt terug met xu.set_field_value. Aanroepen vanuit een ander script werkt anders: de parameters van xu.call_javascript(prog_id, {...}) komen aan zoals ze zijn meegegeven.
Een JavaScript-programma aanroepen
Uitgewerkt voorbeeld
Declareer de parameters
progFields-items worden de argumentnamen van de wrapperfunctie, in aanroepvolgorde.
Schrijf de body
Een gewone async functiebody, geef met return een waarde terug als call_evaluate_javascript die gaat lezen.
Roep hem aan en lees compile.ok
Controleer na save_prog data.compile.ok. Een mislukte compilatie slaat het document nog steeds op, met een build_error erbij.
Maak een JavaScript-node onder Programma's, schrijf de broncode in de code-editor en voeg parameters toe in het raster Velden. Opslaan compileert automatisch opnieuw, fouten verschijnen in de editor.