WEB SERVICE GET RESULT
WEB SERVICE GET RESULT* ( valorRetornado {; nomeRetornado {; *}} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| valorRetornado | Variable | ← | Valor retornado pelo Web Service |
| nomeRetornado | Text | → | Nome do parâmetro a ser retornado |
| * | Operator | → | Liberar memória |
Descrição
comando WEB SERVICE GET RESULT permite recuperar um valor enviado pelo serviço web como resultado do processo realizado.
Nota: este comando deve ser utilizado apenas depois do comando WEB SERVICE CALL.
O parâmetro valorRetornado recebe o valor reenviado pelo serviço web. Passe neste parâmetro uma variável 4D. Esta variável é geralmente $result, que corresponde ao valor retornado pelo método proxy. Entretanto, é possível utilizar variáveis intermediárias (deve utilizar as variáveis de processo apenas).
Nota: cada variável 4D ou array utilizado deve ser declarado previamente utilizando os comandos dos temas “Compilador e Arrays”
O parâmetro opcional nomeRetornado é utilizado para especificar o nome do parâmetro a recuperar. Entretanto, como a maioria dos serviços web devolvem apenas um valor, geralmente este parâmetro não é necessário.
O parâmetro opcional *, indica ao programa que libere a memória dedicada ao processamento da petição. Deve passar este parâmetro depois de recuperar o último valor enviado pelo serviço web.
Exemplo
Imagine um serviço web que devolve a hora atual em qualquer cidade do mundo. Os parâmetros recebidos pelo serviço web são o nome da cidade e o código do país. O serviço web devolve a hora correspondente. O método proxy de chamada pode ser da seguinte forma:
#DECLARE($param1 : Text ; $param2 : Text) -> $result : Time
SET WEB SERVICE PARAMETER("cidade";$param1)
SET WEB SERVICE PARAMETER("codigo_pais";$param2)
CALL WEB SERVICE("http://www.cidadesdomundo.com/WS";"WSHoras#Hora_cidade";"Hora_cidade";
"http://www.cidadesdomundo.com/namespace/default")
If(OK=1)
GET WEB SERVICE RESULT($result;"devolve";*)
End if
Ver também
WEB SERVICE CALL
WEB SERVICE SET PARAMETER
Propriedades
| Número do comando | 779 |
| Thread-seguro | ✓ |