SET WEB SERVICE OPTION

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11.3 (Modificado)


SET WEB SERVICE OPTION (opcion; valor)

ParámetroTipoDescripción
opcionEntero largoCódigo de la opción a definir
valorEnt. larg. | TextoValor 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)TipoValor
Web Service HTTP TimeoutEntero largo1
Web Service SOAP HeaderEntero largo2
Web Service SOAP VersionEntero largo3

Constante (param valor)TipoValor
Web Service SOAP_1_1 Entero largo0
Web Service SOAP_1_2Entero largo1

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

CALL WEB SERVICE.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente