WA EXECUTE JAVASCRIPT FUNCTION
WA EXECUTE JAVASCRIPT FUNCTION ( {* ;} objeto ; funcaoJS ; resultado|* {; param}{; param2 ; ... ; paramN} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | 🡒 | Se especificado, objeto é um nome de objeto (string); se omitido, objeto é uma variável |
| objeto | Objeto de formulário | 🡒 | Nome objeto (se * for especificado) ou Variável (se * é omitido) |
| funcaoJS | String | 🡒 | Nome da função JavaScript a executar |
| resultado|* | Variável | 🡒 | * para a função sem resultado ou |
| 🡘 | Resultado da função (se esperado) | ||
| param | String, Número, Data, Objeto, Collection | 🡒 | Parâmetros a passar a função |
Descrição
O comando WA EXECUTE JAVASCRIPT FUNCTION executa, na área Web designada pelos parâmetros * e objeto, a função JavaScript funcaoJS retorna opcionalmente seu resultado no parâmetro resultado.
Se a função não retorna um resultado, passe * no parâmetro resultado.
Pode passar em param uma ou várias cadeias que contenham os parâmetros da função.
O comando suporta vários tipos de parâmetros, tanto para entrada (param) como para saída (resultado). Pode passar e recuperar dados de tipo string, numérico, data, objeto e coleção. Se o tipo parâmetro não for definido, o tipo texto é usado como padrão
Aviso: Não é recomendado usar este comando para chamar diretamente uma função JavaScript que exibe um diálogo (alert(), print()...) porque o usuário não pode interagir com a área Web enquanto o código 4D roda. Se precisar implementar uma interface desse tipo, chame um código como setTimeout(function(){alert();}, 50)) para finalizar a execução do código 4D e permitir interação de usuário.
Exemplo 1
Chamada de uma função JavaScript con 3 parâmetros:
$JavaScriptFunction:="FuncaoAExecutar"
$Param1:="10"
$Param2:="true"
$Param3:="1,000.2" //note "," como separador de milhares e "." como separador decimal
WA EXECUTE JAVASCRIPT FUNCTION(MinhaWArea;$FuncaoAExecutar;$Result;$Param1;$Param2;$Param3)
Exemplo 2
A função JavaScript "getCustomerInfo" recebe um número ID como parâmetro e devolve um objeto:
var $Result : Object
var $ID : Integer
$ID:=1000
WA EXECUTE JAVASCRIPT FUNCTION(*,"WA";"getCustomerInfo";$Result;$ID)