JavaScript
Riktig JS-källkod, kompilerad vid sparande, för logik som ett deklarativt program inte kan uttrycka.
Ett JavaScript-program innehåller riktig källkod i scriptData.value, nödutgången för logik som ett deklarativt Get Data, Set Data eller Batch inte kan uttrycka. Det kompileras vid sparande (save_prog kör samma bygge som Studio och returnerar data.compile, { ok: true, dependencies } eller { ok: false, error }), och det körs med ett riktigt API för fält, tabeller och händelser, inte bara ett DOM-element.
Egenskaper
Körningskontraktet
Källkoden är en vanlig async-kropp, utan export och utan omslag, och körs som:
params är anroparens redan utvärderade parametrar. xu är runtime-API:t: fält, databasrader, händelser, HTTP. await fungerar fritt eftersom omslaget är async. Citattecken går bra här, till skillnad från i ett xu-script-attributvärde.
Läsa och skriva en tabell
dbs_*-metoderna tar tabellens _id, aldrig dess namn. fields-projektionen på dbs_read är valfri: [], standardvärdet, returnerar alla fält, och en lista med fält-id:n returnerar bara dem.
Skicka in data: fält, inte parametrar
call_native_javascript utvärderar inte parameteromslagen {value, fx}. Ett skript som anropas så får de bokstavliga objekten {value: "", fx: "@field"}, inte upplösta värden. Det pålitliga mönstret: anroparen lägger först innehållet i ett fält (ett update-steg eller en xu-bind-inmatning), anropar skriptet med tomma parameters: {}, och skriptet läser med xu.get_field_value och rapporterar tillbaka med xu.set_field_value. Att anropa från ett annat skript är annorlunda: parametrarna i xu.call_javascript(prog_id, {...}) kommer fram som de skickades.
Anropa ett JavaScript-program
Exempel steg för steg
Deklarera parametrarna
Poster i progFields blir omslagsfunktionens argumentnamn, i anropsordning.
Skriv kroppen
En vanlig async-funktionskropp, return ett värde om call_evaluate_javascript ska läsa det.
Anropa den och läs compile.ok
Efter save_prog, kontrollera data.compile.ok: en misslyckad kompilering sparar ändå dokumentet, med ett build_error bifogat.
Skapa en JavaScript-nod under Program, skriv källkod i kodeditorn och lägg till parametrar i rutnätet Fält. Sparande kompilerar om automatiskt och fel visas i editorn.