JavaScript
Código JS real, compilado ao guardar, para lógica que um programa declarativo não consegue exprimir.
Um programa JavaScript contém código-fonte real em scriptData.value, a saída de emergência para lógica que um Obter Dados, Definir Dados ou Lote declarativo não consegue exprimir. Compila ao guardar (save_prog executa a mesma compilação que o Studio e devolve data.compile, { ok: true, dependencies } ou { ok: false, error }), e corre com uma API real para campos, tabelas e eventos, não apenas um elemento DOM.
Propriedades
O contrato de execução
O código-fonte é um corpo assíncrono simples, sem export, sem wrapper, executado como:
params são os parâmetros de quem chama, já avaliados. xu é a API do runtime: campos, linhas da base de dados, eventos, HTTP. await funciona livremente, uma vez que o wrapper é assíncrono. As aspas não têm problema aqui, ao contrário de um valor de atributo xu-script.
Ler e escrever numa tabela
Os métodos dbs_* recebem o _id da tabela, nunca o seu nome. A projeção fields em dbs_read é opcional: [], o valor predefinido, devolve todos os campos, e uma lista de ids de campos devolve só esses.
Passar dados: campos, não parâmetros
call_native_javascript não avalia os wrappers de parâmetros {value, fx}, um script chamado dessa forma recebe os objetos literais {value: "", fx: "@field"}, não valores resolvidos. O padrão fiável: quem chama coloca primeiro a carga num campo (um passo update ou um campo de entrada xu-bind), chama o script com parameters: {} vazio, e o script lê com xu.get_field_value e comunica de volta com xu.set_field_value. Chamar a partir de outro script é diferente, os parâmetros de xu.call_javascript(prog_id, {...}) chegam tal como foram passados.
Invocar um programa JavaScript
Exemplo prático
Declare os parâmetros
As entradas de progFields tornam-se os nomes dos argumentos da função wrapper, pela ordem da chamada.
Escreva o corpo
Um corpo de função assíncrona simples, faça return de um valor se call_evaluate_javascript o for ler.
Chame-o e leia compile.ok
Depois de save_prog, verifique data.compile.ok, uma compilação falhada ainda guarda o documento com um build_error anexado.
Crie um nó JavaScript em Programas, escreva o código no editor de código e adicione parâmetros na grelha de Campos. Guardar recompila automaticamente, os erros aparecem no editor.