versión 2003
SET WEB SERVICE PARAMETER (nombre; valor{; tipoSOAP})
Parámetro | Tipo | Descripción | |
nombre | Cadena | Nombre del parámetro a incluir en la petición SOAP | |
valor | Variable | Variable 4D que contiene el valor del parámetro | |
tipoSOAP | Cadena | Tipo SOAP del parámetro |
Descripción
El comando SET WEB SERVICE PARAMETER permite la definición de un parámetro utilizado por una petición SOAP cliente. Llame este comando por cada parámetro en la petición (el número de veces que se llame el comando depende del número de parámetros).
Pase en nombre el nombre del parámetro tal como aparece en la petición SOAP.
En valor, pase la variable 4D que contiene el valor del parámetro. En el caso de los métodos proxy, esta variable es generalmente $1, $2, $3, etc., correspondiente a un parámetro 4D pasado al método proxy durante su llamada. Sin embargo, es posible utilizar variables intermediarias.
Nota: Cada variable o array 4D utilizado debe ser declarado previamente utilizando los comandos de los temas "Compilador" y "Arrays".
Por defecto, 4D determina automáticamente el tipo SOAP más apropiado para el parámetro nombre de acuerdo al contenido de valor. La indicación del tipo está incluida en la petición.
Sin embargo, podría "forzar" la definición del tipo SOAP de un parámetro. En este caso, puede pasar el parámetro opcional tipoSOAP utilizando una de las siguientes cadenas de caracteres (tipos de datos primarios):
tipoSOAP | Descripción |
string | Cadena |
int | Entero largo |
boolean | Booleano |
float | Real 32 bits |
decimal | Real con décimal |
double | Real 64 bits |
duration | Duración en años, meses, días, horas, minutos, segundos, por ejemplo: |
P1Y2M3DT10H30M | |
datetime | Fecha y hora en formato ISO8601, por ejemplo 2003-05-31T13:20:00 |
time | Hora, por ejemplo 13:20:00 |
date | Fecha, por ejemplo 2003-05-31 |
gyearmonth | Año y mes (calendario gregoriano), por ejemplo 2003-05 |
gyear | Año (calendario gregoriano), por ejemplo 2003 |
gmonthday | Mes y día (calendario gregoriano), por ejemplo --05-31 |
gday | Día (calendario gregoriano), por ejemplo ---31 |
gmonth | Mes (calendario gregoriano), por ejemplo --10-- |
hexbinary | Valor expresado en hexadecimal |
base64binary | BLOB |
anyuri | Uniform Resource Identifier (URI), por ejemplo |
http://www.empresa.com/page | |
qname | Nombre XML calificado (espacio de nombre y parte local) |
notation | Atributo notación |
Nota: Para mayor información sobre tipos de datos XML, consulte el URL http://www.w3.org/TR/xmlschema-2/
Ejemplo
Este ejemplo define dos parámetros:
C_TEXT($1) C_TEXT($2) SET WEB SERVICE PARAMETER("ciudad";$1) SET WEB SERVICE PARAMETER("país";$2)
Ver también
CALL WEB SERVICE, GET WEB SERVICE RESULT.