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 SOAPAsyncResponse

Utilice el nodo SOAPAsyncResponse conjuntamente con el nodo SOAPAsyncRequest para construir un par de flujos de mensajes que llamen a un servicio web de forma asíncrona.

Finalidad

El nodo SOAPAsyncRequest envía una solicitud de servicio web, pero el nodo no espera a que se reciba la respuesta de servicio web asociada. Sin embargo, el nodo SOAPAsyncRequest espera el acuse de recibo de HTTP 202 antes de continuar con el flujo de mensajes y el nodo SOAPAsyncRequest se bloquea si no se recibe el acuse de recibo. El nodo SOAPAsyncResponse, que puede estar en un flujo de mensajes separado, recibe la respuesta del servicio web. Los nodos se utilizan como par, y correlacionan las respuestas con las solicitudes originales.

Diagrama que muestra la relación entre el nodo SOAPAsyncRequest y el nodo SOAPAsyncResponse.

El analizador SOAP invoca el analizador XMLNSC para que analice el contenido XML del servicio web SOAP, y valide el cuerpo XML del servicio web SOAP. Las opciones del analizador SOAP se pasan al analizador XMLNSC. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.

El nodo SOAPAsyncResponse 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 del nodo SOAPAsyncResponse

Utilización de este nodo en un flujo de mensajes

La configuración del nodo SOAPAsyncResponse no está basada en WSDL, aunque la lista de 'Cabeceras debe reconocer' configurada en el nodo SOAPAsyncRequest correspondiente es aplicable al nodo SOAPAsyncResponse.

La mayoría de las opciones de configuración para este nodo se establecen en el nodo SOAPAsyncRequest emparejado, incluidas las propiedades Destino de restitución y Umbral de restituciones. No se envía ningún error SOAP cuando se alcanza el umbral de restituciones.

Puede recuperar los datos de contexto que haya almacenado el nodo SOAPAsyncRequest desde la ubicación siguiente, en el entorno local:
LocalEnvironment.SOAP.Response.UserContext

Si alguna de las propiedades de entorno local LocalEnvironment.Destination.SOAP.Response.ReplyIdentifier o LocalEnvironment.Destination.HTTP.RequestIdentifier se han proporcionado al nodo SOAPAsyncRequest emparejado, éstas se pasan al entorno local para el nodo SOAPAsyncResponse.

El siguiente ejemplo muestra cómo utilizar los nodos SOAP asíncronos cuando se llama a un servicio web. El servicio web simula un servicio de pedidos y el cliente muestra cómo se pueden ampliar las interfaces de WebSphere MQ existentes para realizar solicitudes de servicio web.

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

El nodo SOAPAsyncResponse puede recibir una respuesta que tenga una cabecera Content-Encoding de gzip o deflate. Cuando se recibe una respuesta de este tipo, el contenido se descodifica y la cabecera Content-Encoding se elimina.

Terminales y propiedades

Cuando haya colocado una instancia del nodo SOAPAsyncResponse 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. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Los terminales del nodo SOAPAsyncResponse se describen en la siguiente tabla.

Terminal Descripción
Failure (de anomalías) El terminal de salida al que se direcciona un mensaje de respuesta SOAP asíncrono si se detecta una anomalía cuando el mensaje recibido se propaga al flujo de salida como, por ejemplo, en el caso de una anomalía de validación de mensaje.
Out (de salida) El terminal de salida al que se direcciona el mensaje de respuesta SOAP asíncrono si se ha recibido satisfactoriamente y se requiere proceso adicional dentro del flujo de mensajes. Si no se producen errores dentro del nodo, un mensaje de respuesta SOAP de ninguna anomalía recibido de un recurso externo siempre se envía primero al terminal de salida.
Fault (de defectos) El terminal de salida al que se direcciona una respuesta de error SOAP asíncrono si se ha recibido satisfactoriamente y se requiere proceso adicional dentro de este flujo de mensajes.
Catch (de captación) El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta.

Las tablas siguientes describen las propiedades del 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).

Las propiedades de descripción del nodo SOAPAsyncResponse están descritas en la siguiente tabla.

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

Las propiedades básicas del nodo SOAPAsyncResponse se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Identificador exclusivo No   Especifique el fragmento de URL exclusivo que es común al par de nodos SOAPAsyncRequest y SOAPAsyncResponse. asyncRequestCorrelator

La propiedad de Transacciones del nodo SOAPAsyncResponse se describe en la siguiente tabla. Este valor no se aplica cuando el nodo utiliza transporte HTTP.

Propiedad O C Valor predeterminado Descripción
Modalidad de transacción No No

Esta propiedad controla si el mensaje se recibe bajo una transacción JMS. Los valores válidos son y No.

Seleccione No para recibir el mensaje utilizando una sesión JMS no transaccional.

Seleccione para recibir el mensaje utilizando una sesión JMS transaccional. La transacción JMS puede ser local o coordinada XA. Para utilizar una transacción coordinada XA, mediante una sesión JMS XA, también debe seleccionar la propiedad de flujo de mensajes Transacción coordinada en las propiedades del archivo BAR.

Consulte Configuración para transacciones JMS coordinadas.

La propiedad Avanzadas del nodo SOAPAsyncResponse se describe en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Establecer lista de destinos No No Seleccionado Esta propiedad indica si se debe añadir la operación SOAP entrante a la lista de destinos de direccionamiento a etiqueta.
Prefijo de etiqueta No No   Utilice esta propiedad para añadir un prefijo al nombre de la operación SOAP en la lista de destinos. Debe añadir un Prefijo de etiqueta si desea utilizar varios nodos SOAPAsyncResponse en el mismo flujo de mensajes sin causar un conflicto en sus correspondientes nodos Label. De forma predeterminada, el prefijo es una serie vacía de forma que el nombre de operación y el nombre de etiqueta son idénticos. Esta propiedad no está disponible si la propiedad Establecer lista de destinos no está seleccionada.
Colocar las cabeceras WS-Addressing en el Entorno local No No Deseleccionado Esta propiedad especifica si el nodo pone las cabeceras WS-Addressing del mensaje de respuesta en el árbol del entorno local. Las cabeceras WS-Addressing no son accesibles para el flujo si este recuadro está deseleccionado porque, de forma predeterminada, se procesan y se eliminan todas las cabeceras.

Las propiedades de instancias del nodo SOAPAsyncResponse se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Agrupación de instancias adicionales No Utilizar agrupación asociada al flujo de mensajes La agrupación de la que se obtienen instancias adicionales.
  • Si selecciona Utilizar agrupación asociada al flujo de mensajes, se obtienen instancias adicionales del valor del flujo de mensajes.
  • Si selecciona Utilizar agrupación asociada al nodo, las instancias adicionales se asignarán desde las instancias adicionales del nodo basándose en el número especificado en la propiedad Instancias adicionales.
componentLevel
Instancias adicionales No 0 El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales se establece en Utilizar agrupación asociada al nodo. De forma predeterminada, no se proporcionan instancias adicionales al nodo. additionalInstances

En la tabla siguiente se describen las propiedades de Análisis de mensajes de respuesta del nodo SOAPAsyncResponse. El nodo SOAPAsyncResponse establece estas propiedades automáticamente; no las puede establecer el usuario.

Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No SOAP Dominio que se utiliza para analizar el mensaje de respuesta. De forma predeterminada, el mensaje que se propaga desde el nodo SOAPAsyncResponse está en el dominio de SOAP. No puede especificar un dominio distinto. Para obtener más información, consulte Analizador y dominio SOAP.

Las propiedades de Análisis de mensaje de respuesta se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en la modalidad de pasarela.

Conjunto de mensajes No Se establece automáticamente en la propiedad Nombre de archivo WSDL que proporciona el nodo SOAPAsyncRequest. Nombre del conjunto de mensajes en el que se define el mensaje de respuesta. Conjunto de mensajes se establece automáticamente en el conjunto de mensajes que contiene el archivo WSDL que está configurado en el nodo SOAPAsyncRequest correspondiente.

Si establece esta propiedad y, a continuación, actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes.

Las propiedades de Análisis de mensaje de respuesta se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en la modalidad de pasarela.

Tipo de mensaje No No   Nombre del mensaje de respuesta. El nodo detecta automáticamente el tipo de mensaje. Esta propiedad no se puede establecer.
Formato del mensaje No No   Nombre del formato físico del mensaje de respuesta. Esta propiedad no se puede establecer.

Las propiedades Opciones de análisis del nodo SOAPAsyncResponse se describen en la siguiente tabla. Las propiedades se pasan al analizador XMLNSC.

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No No A petición Esta propiedad controla cuándo se analiza un mensaje de respuesta. Los valores válidos son A petición, Inmediato y Completo.

De forma predeterminada, la temporización de análisis se establece en A petición, lo que hace que se retrase el análisis del mensaje de entrada. Para obtener una descripción completa de esta propiedad, consulte Análisis a petición.

Crear árbol utilizando tipos de datos de esquema XML No No Seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos de sintaxis en el árbol de mensajes con tipos de datos obtenidos del esquema XML.

Esta propiedad se ignora cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en la modalidad de pasarela.

Retener el contenido mixto No No Deseleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra texto mixto en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento.
Retener los comentarios No No Deseleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra comentarios en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento.
Retener las instrucciones de proceso No No Deseleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra instrucciones de proceso en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento.
Elementos opacos No No Espacio en blanco Esta propiedad se utiliza para especificar una lista de elementos en el mensaje de respuesta que se analizan opacamente por el analizador XMLNSC. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada.

Las propiedades de validación del nodo SOAPAsyncResponse están descritas en la siguiente tabla. De forma predeterminada, la validación está habilitada.

Si un mensaje se propaga al terminal de anomalías del nodo, no se valida. Para obtener más detalles, consulte Validar mensajes y Propiedades de validación.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar No Contenido y valor Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor y Contenido.

Las propiedades de validación se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en modalidad de pasarela.

validateMaster
Acción para anomalía No No Excepción Esta propiedad controla qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Lista de excepciones, Anotaciones de errores locales y Excepción.

Las propiedades de validación se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en modalidad de pasarela.

 
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.

Alteraciones temporales de LocalEnvironment

Puede recuperar información establecida por el nodo SOAPAsyncRequest emparejado desde la propiedad siguiente bajo LocalEnvironment.Destination.SOAP.Response:
Valor Descripción
UserContext
Puede recuperar los datos de contexto que ha almacenado el nodo SOAPAsyncRequest desde la ubicación siguiente en el entorno local:
SET myVar = InputLocalEnvironment.Destination.SOAP.Response.UserContext;
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:49


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