4D v16.3

Servicios Web (Cliente)

Inicio

 
4D v16.3
Servicios Web (Cliente)

Servicios Web (Cliente) 

 

Constante  Tipo Valor Comentario
Web Service compression  Entero largo 1  
Web Service detailed message  Entero largo 1 Mensaje detallado que describe el error. El tipo de mensaje difiere según el tipo de error principal.
- Si el error principal = 9910 (Error Soap): se devuelve la causa del error SOAP (ej.: “el método remoto no existe”).
- Si el error principal = 9911 (Error de analizador xml): se devuelve la ubicación del error en el documento XML.
- Si el error principal = 9912 (Error HTTP):
- Si el error HTTP se ubica en el intervalo [300-400] (problemas relacionados con la ubicación del documento solicitado), se devuelve la nueva ubicación del URL solicitado. 
- Para todo otro código de error HTTP, se devuelve el <body>.
- Si el error principal = 9913 (Error de red): se devuelve la causa del error de red (ej.: “ServerAddress: error DNS”)
- Si el error principal = 9914 (Error interno): se devuelve la causa del error interno
Web Service display auth dialog  Entero largo 4 valor =  0 (no mostrar la caja de diálogo) ó 1 (mostrar caja de diálogo)
Esta opción administra la visualización de la caja de diálogo de actualización durante la ejecución del comando CALL WEB SERVICE. Por defecto, este comando nunca muestra la caja de diálogo; por lo general, para hacerlo debe utilizar el comando AUTHENTICATE WEB SERVICE. Sin embargo, si quiere que aparezca la caja de diálogo de autenticación para que el usuario introduzca sus identificadores, deberá utilizar esta opción: pase 1 en valor para mostrar la caja de diálogo, de lo contrario pase 0. La caja de diálogo sólo aparece si el servicio web necesita autenticación.
Web Service dynamic  Entero largo 0  
Web Service error code  Entero largo 0 Código del error principal (definido por 4D). Este código también es devuelto en la variable sistema Error.
Lista de códigos que pueden ser devueltos:
9910: Error Soap (ver también Web Service Fault Actor)
9911: Error de analizador xml
9912: Error HTTP (ver también Web Service HTTP Error code)
9913: Error red
9914: Error interno.
Web Service fault actor  Entero largo 3 Causa del error (devuelto por el protocolo SOAP, a utilizar en caso de error principal 9910).
- Version Mismatch
- Must Understand (un parámetro definido como obligatorio no puede ser interpretado por el servidor)
- Sender Fault
- Receiver Fault
- Encoding Unknown
Web Service HTTP compression  Entero largo 6 valor = Web Service Compression
Esta opción permite activar un mecanismo interno de compresión de las peticiones SOAP con el fin de acelerar los intercambios entre aplicaciones 4D. Cuando ejecuta la instrucción WEB SERVICE SET OPTION(Web Service HTTP Compression; Web Service Compression) en el cliente 4D del servicio web, los datos de la próxima petición SOAP enviados por el cliente serán comprimidos utilizando un mecanismo estándar HTTP ("gzip" o "deflate" en función del contenido de la petición) antes de su envío al servidor SOAP 4D. El servidor descomprimirá y analizará la petición, luego responderá automáticamente utilizando el mismo mecanismo. Sólo se afecta la petición que sigue la llamada al comando WEB SERVICE SET OPTION. Por lo tanto debe llamar este comando cada vez que quiera utilizar la compresión. Por defecto, 4D no comprime las peticiones HTTP de los servicios web.
Nota: este mecanismo no puede utilizarse para las peticiones enviadas a un servidor SOAP 4D de una versión anterior a la 11.3. Para que pueda optimizar más este funcionamiento, las opciones adicionales configuran el límite y la tasa de compresión de las peticiones. Estas opciones son accesibles vía el comando SET DATABASE PARAMETER.
Web Service HTTP error code  Entero largo 2 Código del error HTTP (a utilizar en caso de error principal 9912).
Web Service HTTP timeout  Entero largo 1 valor = "timeout" de la parte cliente expresado en segundos.
El timeout de la parte clientes es el periodo de espera del cliente servicio web en caso de que no haya respuesta del servidor. Después de este período, el cliente cierra la sesión y se pierde la petición.
Por defecto, este timeout es de 180 segundos. Puede modificarse por razones específicas (estado de la red, especificaciones del servicio web, etc.).
Web Service manual  Entero largo 3  
Web Service manual in  Entero largo 1  
Web Service manual out  Entero largo 2  
Web Service reset auth settings  Entero largo 5 valor = 0 (no borrar la información) ó 1 (borra la información)
Esta opción le permite indicar a 4D memorizar la información de autenticación del usuario (nombre de usuario, contraseña, método, etc.), para reutilizarla posteriormente. Por defecto, esta información se borra después de cada ejecución del comando CALL WEB SERVICE. Pase 0 en valor para guardar la información y 1 para borrarla. Note que cuando pasa 0, la información se conserva durante la sesión pero no se almacena.
Web Service SOAP header  Entero largo 2 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 utilizando el comando CALL WEB SERVICE. Por defecto, las peticiones SOAP no contienen un encabezado específico. Sin embargo, algunos servicios web requieren un encabezado, por ejemplo para la gestión de los parámetros de identificación.
Web Service SOAP version  Entero largo 3 valor = Web Service SOAP_1_1 o Web Service SOAP_1_2
Esta opción permite precisar la versión del protocolo SOAP utilizado en la petición. Pase en valor la constante Web Service SOAP_1_1 para indicar la versión 1.1 y la constante Web Service SOAP_1_2 para indicar la versión 1.2.
Web Service SOAP_1_1  Entero largo 0  
Web Service SOAP_1_2  Entero largo 1  


Ver también 

WEB SERVICE CALL
WEB SERVICE Get info
WEB SERVICE SET OPTION

 
PROPIEDADES 

Producto: 4D
Tema: Lista de temas de constantes

 
HISTORIA 

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v16)
Manual de lenguaje 4D ( 4D v16.1)
Manual de lenguaje 4D ( 4D v16.2)
Manual de lenguaje 4D ( 4D v16.3)