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 petición de servicio web, pero el nodo no espera a que se reciba la respuesta por parte del servicio web asociado. 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 las respuestas se correlacionan respecto a las peticiones 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 Manipulación de mensajes en el dominio XMLNSC.

El nodo SOAPAsyncResponse se encuentra en el cajón Servicios web de la paleta y se representa en el IBM® Integration 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á orientada por 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 de este nodo están establecidas 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 restitución.

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 pedido y el cliente muestra cómo interfaces existentes de WebSphere MQ pueden ampliarse para realizar solicitudes de servicio web.

Puede ver información sobre los ejemplos sólo cuando utilice el centro de información que está integrado en IBM Integration Toolkit o el centro de información en línea. Puede ejecutar ejemplos sólo cuando utilice el centro de información que está integrado en IBM Integration Toolkit.

El nodo SOAPAsyncResponse puede recibir una respuesta que tenga una cabecera Content-Encoding de gzip o deflate. Cuando se recibe este tipo de respuesta, 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 Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan 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 error) 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 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).

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 Ninguna Una descripción breve del nodo.
Descripción larga No No Ninguna Texto que describe el propósito 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 Sí 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 el transporte HTTP.

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

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

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

Seleccione Sí 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 de transacciones coordinadas JMS.

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 va a añadir la operación SOAP entrante a la lista de destinos route-to-label.
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 No seleccionado 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 no está marcado, porque, de forma predeterminada, se procesa y 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 Sí 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, las instancias adicionales se obtendrán 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 Sí 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 otorga ninguna instancia adicional 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 Sí 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 mensajes 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 los tipos de datos de esquema XML No No Seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos de la sintaxis en el árbol de mensaje con tipos de datos tomados del esquema XML.

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

Retener contenido mixto No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje 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 comentarios No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje 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 instrucciones de proceso No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje 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. Si desea ver información más detallada, consulte Validar mensajes y Propiedades de validación.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar No Sí Contenido y valor Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguna, 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 M C Valor predeterminado Descripción
Sucesos No No Ninguna Los sucesos que se han definido para el nodo se visualizan en esta pestaña. 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 de la propiedad siguiente en 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 | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:48:48


Tema de referenciaTema de referencia | IBM Integration Bus Versión 9.0.0.0 | ac56210_