JavaScript
Du vrai code JS, compilé à l'enregistrement, pour la logique qu'un programme déclaratif ne peut pas exprimer.
Un programme JavaScript contient du vrai code source dans scriptData.value : la porte de sortie pour la logique qu'un programme déclaratif Obtenir des données, Définir des données ou Lot ne peut pas exprimer. Il se compile à l'enregistrement (save_prog exécute la même compilation que Studio et renvoie data.compile, { ok: true, dependencies } ou { ok: false, error }), et il s'exécute avec une vraie API pour les champs, les tables et les événements, pas seulement un élément DOM.
Propriétés
Le contrat d'exécution
Le source est un simple corps asynchrone, sans export, sans enveloppe, exécuté ainsi :
params sont les paramètres déjà évalués de l'appelant. xu est l'API du runtime : champs, lignes de base de données, événements, HTTP. await fonctionne librement puisque l'enveloppe est asynchrone. Les guillemets sont acceptés ici, contrairement à une valeur d'attribut xu-script.
Lire et écrire une table
Les méthodes dbs_* prennent le _id de la table, jamais son nom. La projection fields de dbs_read est facultative : [], la valeur par défaut, renvoie tous les champs, et une liste d'ids de champs ne renvoie que ceux-là.
Transmettre des données : des champs, pas des paramètres
call_native_javascript n'évalue pas les enveloppes de paramètres {value, fx} : un script appelé ainsi reçoit les objets littéraux {value: "", fx: "@field"}, pas des valeurs résolues. Le schéma fiable : l'appelant place d'abord les données dans un champ (une étape update ou une saisie xu-bind), appelle le script avec parameters: {} vide, et le script lit avec xu.get_field_value et rend compte avec xu.set_field_value. Appeler depuis un autre script est différent : les paramètres de xu.call_javascript(prog_id, {...}) arrivent tels que passés.
Invoquer un programme JavaScript
Exemple concret
Déclarez les paramètres
Les entrées progFields deviennent les noms des arguments de la fonction enveloppe, dans l'ordre d'appel.
Écrivez le corps
Un simple corps de fonction asynchrone, avec return d'une valeur si call_evaluate_javascript doit la lire.
Appelez-le et lisez compile.ok
Après save_prog, vérifiez data.compile.ok : une compilation en échec enregistre quand même le document avec un build_error attaché.
Créez un nœud JavaScript sous Programmes, écrivez le source dans l'éditeur de code, ajoutez des paramètres dans la grille Champs. L'enregistrement recompile automatiquement, les erreurs s'affichent dans l'éditeur.