4D Doc Center : WA EXECUTE JAVASCRIPT FUNCTION

4D v14.3

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	cadeia	Nome da função JavaScript a executar
resultado\|*	Variável	* para a função sem resultado ou
		Resultado da função (se esperado)
param	cadeia, Number, Data, Object	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 numérico, data, objeto e cadeia.

Importante: A manipulação de dados de tipo complexo (objetos, datas, etc.) só é possível se a área Web utiliza o Web Kit integrado como motor de renderização.

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:

 C_OBJECT($Result)

 C_LONGINT($ID)

 $ID:=1000

 WA EXECUTE JAVASCRIPT FUNCTION(*,"WA";"getCustomerInfo";$Result;$ID)