4D Doc Center : WEB SERVICE SET PARAMETER

4D v14.3

WEB SERVICE SET PARAMETER


WEB SERVICE SET PARAMETER ( nome ; valor {; tipoSoap} )

Parâmetro	Tipo	Descrição
nome	cadeia	Nome do parâmetro a incluir na petição SOAP
valor	Variável	Variável 4D que contém o valor do parâmetro
tipoSoap	cadeia	Tipo SOAP do parâmetro

Descrição

O comando WEB SERVICE SET PARAMETER permite a definição de um parâmetro utilizado por uma petição SOAP cliente. Chame este comando por cada parâmetro na petição (o número de vezes que for chamado o comando depende do número de parâmetros).

Passe em nome o nome do parâmetro tal como aparece na petição SOAP.

Em valor, passe a variável 4D que contém o valor do parâmetro. No caso dos métodos proxy, esta variável é geralmente $1, $2, $3, etc., correspondente a um parâmetro 4D passado ao método proxy durante sua chamada. Entretanto, é possível utilizar variáveis intermediárias.

Nota: cada variável ou array 4D utilizado deve ser declarada previamente utilizando os comandos dos temas Compilador ou Arrays.

Como padrão, 4D determina automaticamente o tipo SOAP mais apropriado para o parâmetro nome de acordo ao conteúdo de valor. A indicação do tipo está incluída na petição.

Entretanto, poderia “forçar” a definição do tipo SOAP de um parâmetro. Neste caso, pode passar o parâmetro opcional tipoSOAP utilizando uma das seguintes cadeias de caracteres (tipos de dados primários):

tipoSOAP	Descrição
string	String
int	Inteiro longo
booleam	Booleano
float	Real 32 bits
decimal	Real com decimal
double	Real 64 bits
duratiom	Duração em anos, meses, dias, horas, minutos, segundos, por exemplo:
	P1Y2M3DT10H30M
datetime	Data e hora em formato ISO8601, por exemplo 2003-05-31T13:20:00
time	Hora, por exemplo 13:20:00
date	Data, por exemplo 2003-05-31
gyearmonth	Ano e mês (calendário gregoriano), por exemplo 2003-05
gyear	Ano (calendário gregoriano), por exemplo 2003
gmonthday	Mês e dia (calendário gregoriano), por exemplo --05-31
gday	Dia (calendário gregoriano), por exemplo ---31
gmonth	Mês (calendário gregoriano), por exemplo --10--
hexbinary	Valor expresso em hexadecimal
base64binary	BLOB
anyuri	Uniform Resource Identifier (URI), por exemplo
	http://www.empresa.com/page
qname	Nome XML qualificado (espaço de nome e parte local)
notation	Atributo notação

Nota: para maior informação sobre tipos de dados XML, consulte a URL http://www.w3.org/TR/xmlschema-2/

Exemplo

Este exemplo define dois parâmetros:

 C_TEXT($1)

 C_TEXT($2)

 WEB SERVICE SET PARAMETER("cidade";$1)

 WEB SERVICE SET PARAMETER("país";$2)