WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo SOAPEnvelope

Utilice el nodo SOAPEnvelope para añadir un sobre SOAP a un mensaje existente. Este nodo se ha diseñado para utilizarse con el nodo SOAPExtract.

Este tema contiene las siguientes secciones:

Finalidad

El comportamiento predeterminado del nodo SOAPEnvelope es asociar el sobre SOAP a una ubicación estándar ($LocalEnvironment/SOAP/Envelope) en el árbol del entorno local. Puede especificar una ubicación explícita utilizando una expresión XPath.

También puede utilizar el nodo en un flujo sin un nodo SOAPExtract correspondiente. El nodo tiene una opción para crear un sobre SOAP predeterminado.

El nodo SOAPEnvelope se encuentra en el cajón Servicios web de la paleta y se representa en el WebSphere Message Broker Toolkit mediante el siguiente icono:

Icono de nodo Filter

Utilización del nodo SOAPEnvelope en un flujo de mensajes

Este nodo se ha diseñado para utilizarse junto con el nodo SOAPExtract; consulte Nodo SOAPExtract.

Configuración del nodo SOAPEnvelope

Cuando haya colocado una instancia del nodo SOAPEnvelope en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se muestran en la vista Propiedades.

Analizadores soportados

Esto está diseñado para trabajar con los mensajes SOAP. Utilice uno de los analizadores siguientes:
  • XMLNSC
  • MRM
  • XMLNS
Otros analizadores XML no están soportados porque no dan soporte a los espacios de nombres. Se genera una excepción si se recibe un mensaje que no utiliza el analizador correcto o que no se ajusta a la estructura básica de un mensaje SOAP.

La validación completa no se lleva a cabo en el mensaje SOAP, que simplemente necesita contener un elemento de cuerpo.

Como el dominio SOAP no está soportado por el nodo SOAPEnvelope, no puede añadir el sobre extraído por el nodo SOAPExtract, desde el dominio SOAP, de nuevo al flujo de mensaje; es decir, un flujo como el siguiente no está soportado:
nodo SOAPInput -> nodo SOAPExtract -> nodo SOAPEnvelope

Ejemplo de mensajes SOAP

Mensaje SOAP de entrada

<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <tns:requestHeader>
            <tns:assessorUrl>header1</tns:assessorUrl>
        </tns:requestHeader>
    </soapenv:Header>
</soapenv:Envelope>

Cuerpo del mensaje SOAP de entrada

<?xml version="1.0"?>
<tns:requestAvailability
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <tns:carDetails>body1</tns:carDetails>
    <tns:claimID>body2</tns:claimID>
    <tns:location>body3</tns:location>
    <tns:reqDate>body4</tns:reqDate>
</tns:requestAvailability>

Mensaje SOAP de salida

<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <tns:requestHeader>
            <tns:assessorUrl>header1</tns:assessorUrl>
        </tns:requestHeader>
    </soapenv:Header>
    <soapenv:Body>
        <tns:requestAvailability>
            <tns:carDetails>body1</tns:carDetails>
            <tns:claimID>body2</tns:claimID>
            <tns:location>body3</tns:location>
            <tns:reqDate>body4</tns:reqDate>
        </tns:requestAvailability>
    </soapenv:Body>
</soapenv:Envelope>

Terminales y propiedades

En la tabla siguiente se describen los terminales del nodo SOAPEnvelope:

Terminal Descripción
Entrada El terminal de entrada que acepta un mensaje SOAP para que lo procese el nodo.
De salida El terminal de salida donde sale el mensaje SOAP que se ha creado a partir del cuerpo del mensaje SOAP y de un sobre SOAP.
De anomalías El terminal de salida al que se dirige un mensaje si se ha detectado una anomalía durante su proceso.

Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).

En la tabla siguiente se describen las propiedades de descripción del nodo SOAPEnvelope.

Propiedad M C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo El nombre del nodo.
Descripción corta No No   Una descripción breve del nodo.
Descripción larga No No   Texto que describe la finalidad del nodo en el flujo de mensajes.

En la tabla siguiente se describen las propiedades básicas del nodo SOAPEnvelope.

Propiedad M C Valor predeterminado Descripción
Crear nuevo sobre No No No seleccionado Esta propiedad controla si el nodo crea un sobre SOAP o si obtiene uno ya existente en el árbol de mensaje. Si selecciona el recuadro, el nodo crea un sobre nuevo. Si borra la marca del recuadro de selección, el nodo copia el sobre a partir del valor especificado en la propiedad Ubicación de sobre existente.
Ubicación de sobre existente No No $LocalEnvironment/SOAP/Envelope Una expresión XPath que representa la ubicación desde la que el nodo copiará el sobre SOAP. Están disponibles los siguientes nombres de correlaciones:
$Root
La raíz del árbol de mensaje.
$Body
El último hijo de la raíz del árbol de mensaje (equivalente a /).
$LocalEnvironment
La raíz del árbol de entorno local.
$Environment
La raíz del árbol de entorno global.
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:51


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac60020_