|
|
|
|
|
|
|
|
|
|
|
versión 11.3 (Modificado)
SET WEB SERVICE OPTION (opcion; valor)
| Parámetro | Tipo | Descripción | |
| opcion | Entero largo |  | Código de la opción a definir |
| valor | Ent. larg. | Texto | | Valor de la opción |
Nota preliminar: Este comando está diseñado para los usuarios de servicios Web. Su uso es opcional.
Descripción
El comando SET WEB SERVICE OPTION permite definir diferentes opciones que se utilizarán durante la próxima petición SOAP provocada por el comando CALL WEB SERVICE.
Puede llamar este comando tantas veces como opciones a definir.
En el parámetro opcion, pase el número de la opción a definir y en el parámetro valor, pase el nuevo valor de la opción. Para estos parámetros, puede utilizar una de las siguientes constantes predefinidas del tema "Web Services (Client)":
| Constante (param opcion) | Tipo | Valor |
| Web Service HTTP Timeout | Entero largo | 1 |
| Web Service SOAP Header | Entero largo | 2 |
| Web Service SOAP Version | Entero largo | 3 |
| Constante (param valor) | Tipo | Valor |
| Web Service SOAP_1_1 | Entero largo | 0 |
| Web Service SOAP_1_2 | Entero largo | 1 |
Esta es la descripción de las opciones y de los valores posibles:
• opcion = Web Service HTTP Timeout
valor = "timeout" de la parte cliente expresada en segundos.
El timeout de la parte cliente expresada en segundos es el periodo de espera del cliente Web Service en caso de que el servidor no responda. Después de este periodo, el cliente cierra la sesión y se pierde la petición.
Este timeout es 10 segundos por defecto. Puede modificarse por razones específicas (estado de la red, especificidades del servicio Web, etc.).
• opcion = Web Service SOAP Header
valor = referencia del elemento XML raíz a insertar como encabezado de la petición SOAP.
Esta opción permite insertar un encabezado en la petición SOAP generada por el comando CALL WEB SERVICE. Por defecto, las peticiones SOAP no contienen un encabezado específico. Sin embargo, algunos servicios Web requieren de un encabezado, por ejemplo para la gestión de los parámetros de identificación.
• opcion = Web Service SOAP Version
valor = Web Service SOAP_1_1 or Web Service SOAP_1_2
Esta opción le permite especificar la versión del protocolo SOAP utilizado en la petición. Pase la constante Web Service SOAP_1_1 en valor para indicar la versión 1.1 y la constante Web Service SOAP_1_2 para indicar la versión 1.2.
El orden de llamada de las opciones no es importante. Si la misma opcion está definida varias veces, sólo el valor de la primera llamada se tiene en cuenta.
Ejemplos
1. Inserte un encabezado personalizado en la petición SOAP:
` Creación de una referencia XML
C_STRING(16;vRootRef;vElemRef)
vRootRef:=DOM Create XML Ref("RootElement")
vxPath:="/RootElement/Elem1/Elem2/Elem3"
vElemRef:=DOM Create XML element(vRootRef;vxPath)
`Modificación del encabezado SOAP con la referencia
SET WEB SERVICE OPTION(Web Service SOAP Header;vElemRef)
2. Utilización de la versión 1.2 del protocolo SOAP:
SET WEB SERVICE OPTION(Web Service SOAP Version;Web Service SOAP_1_2)
Ver también
|
|
|
|
|
|
|
|
|
|
|