Añade un encabezado a la siguiente función SOAP de un servicio web a ejecutar.
La cabecera añadida puede contener parámetros adicionales que afectan a la solicitud SOAP. En la mayoría de los casos, la información añadida a las cabeceras no representa directamente los parámetros de la función Webservice, sino meta información como, por ejemplo, la información de autenticación.
Observación: La función SOAP se ejecutará mediante una llamada a
SOAPRun o
SOAPRunXML.
// Add a header to the next SOAP procedure run
// This header is used to check the security level used by the SOAP server
// If the maximum security level is not used,
// the next SOAP procedure will not be run
SOAPAddHeader("Security", "MaxSecurity", "Security-Level", True)
Sintaxis
Personalizar el encabezado del Servicio Web Ocultar los detalles
SOAPAddHeader(<Webservice name> , <Element to add into header>)
<Webservice name>: Webservice
Nombre del servicio web a utilizar. El nombre del servicio web se muestra en el panel "Explorador de proyectos", en la carpeta "Servicios web.
<Element to add into header>: Tipo simple o complejo
Variable del mismo tipo que el encabezado a insertar en la llamada al método Webservice. Los diferentes tipos se han recuperado al importar el archivo WSDL. Este elemento se añade al encabezado cuando se llama a una función SOAP del Webservice.
Añadir un encabezado para un servicio web específico Ocultar los detalles
SOAPAddHeader(<Webservice name> , <Parameter name> , <Parameter value> , <Parameter namespace>)
<Webservice name>: Webservice
Nombre del servicio web a utilizar. El nombre del servicio web se muestra en el panel "Explorador de proyectos", en la carpeta "Servicios web".
<Parameter name>: Cadena de caracteres
Nombre del parámetro adicional. Este parámetro adicional se utiliza para comprobar una información específica del servidor SOAP.
Este parámetro se proporciona en la documentación del servidor SOAP y sus funciones.
<Parameter value>: Cualquier tipo
Valor del parámetro adicional. Los valores posibles se proporcionan en la documentación del servidor SOAP y sus funciones.
<Parameter namespace>: Cadena de caracteres
Namespace del parámetro. Este parámetro se proporciona en la documentación del servidor SOAP y sus funciones.
Nueva funcionalidad versión 27Observaciones
Ejecución de la Procedure (sintaxis 4, mantenida por compatibilidad con el pasado)
Tienes la capacidad de ejecutar (o no) el próximo SOAP Procedure añadiendo un encabezado. Para ello, el parámetro <Ejecución de procedimiento> debe inicializarse en True.
Si el parámetro <Ejecución de procedimiento> se inicializa en True:
- La función SOAPRun (o SOAPRunXML) devuelve True si se estableció la relación con el servidor SOAP, o False en caso contrario.
- Si se estableció la conexión con el servidor SOAP y si éste cumple las condiciones solicitadas por el encabezado, se ejecuta el Procedure.
- Si se ha ejecutado el Procedure, vuelve el SOAPGetResult:
- el resultado del Procedure si el Procedure se ejecutaba con éxito,
- una cadena vacía ("") si la Procedure fallaba.
- Si el Procedure falló o si no se ejecutó, JABÓNError regresa:
- el código de error "MustUnderstand" si el servidor SOAP no cumple las condiciones requeridas por el encabezado,
- un error en los otros casos.
Clasificación Lógica de negocio / UI: Lógica de negocio