JavaScript
Ægte JS-kildekode, kompileret ved gemning, til logik som et deklarativt program ikke kan udtrykke.
Et JavaScript-program rummer ægte kildekode i scriptData.value, nødudgangen til logik, som et deklarativt Get Data, Set Data eller Batch ikke kan udtrykke. Det kompileres ved gemning (save_prog kører det samme build som Studio og returnerer data.compile, { ok: true, dependencies } eller { ok: false, error }), og det kører med et ægte API til felter, tabeller og hændelser, ikke kun et DOM-element.
Egenskaber
Udførelseskontrakten
Kildekoden er en almindelig async-krop, uden export og uden wrapper, og køres sådan:
params er den kaldendes parametre, som allerede er evalueret. xu er runtime-API'et: felter, databaserækker, hændelser, HTTP. await kan bruges frit, da wrapperen er async. Anførselstegn er i orden her, i modsætning til i en xu-script-attributværdi.
Læsning og skrivning af en tabel
dbs_*-metoder tager tabellens _id, aldrig dens navn. fields-projektionen på dbs_read er valgfri: [], standarden, returnerer alle felter, og en liste af felt-id'er returnerer kun dem.
Send data ind: felter, ikke parametre
call_native_javascript evaluerer ikke {value, fx}-parameterwrappere, så et script, der kaldes på den måde, modtager de bogstavelige {value: "", fx: "@field"}-objekter, ikke de løste værdier. Den pålidelige fremgangsmåde: Den, der kalder, lægger data i et felt først (et update-trin eller et xu-bind-input), kalder scriptet med tomme parameters: {}, og scriptet læser med xu.get_field_value og melder tilbage med xu.set_field_value. Hvis du kalder fra et andet script, er det anderledes: parametre i xu.call_javascript(prog_id, {...}) kommer frem, som de blev sendt.
Kald af et JavaScript-program
Eksempel fra praksis
Deklarer parametrene
progFields-poster bliver til wrapper-funktionens argumentnavne, i kaldets rækkefølge.
Skriv kroppen
En almindelig async-funktionskrop. Lad den return'ere en værdi, hvis call_evaluate_javascript skal læse den.
Kald den, og læs compile.ok
Tjek data.compile.ok efter save_prog. En mislykket kompilering gemmer stadig dokumentet med en vedhæftet build_error.
Opret en JavaScript-node under Programmer, skriv kildekoden i kodeeditoren, og tilføj parametre i gitteret Felter. Gem kompilerer automatisk igen, og fejl vises i editoren.