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 SOAPAsyncRequest

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

Finalidad

El nodo SOAPAsyncRequest puede utilizar transporte HTTP o JMS. Está enlazado como un par con un SOAPAsyncResponse utilizando un identificador exclusivo y opcionalmente WS-Addressing, para correlacionar los mensajes de respuesta con la solicitud original. Los nodos SOAPAsyncRequest y SOAPAsyncResponse no se pueden utilizar con operaciones unidireccionales.

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. Esta funcionalidad asíncrona permite realizar varias solicitudes de salida casi en paralelo, ya que la solicitud de salida no se bloquea en espera de la respuesta. 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.

El nodo SOAPAsyncRequest soporta dos métodos de solicitudes asíncronas cuando se utiliza el transporte HTTP:
  1. Utilización de WS-Addressing para dirigir la respuesta al nodo SOAPAsyncResponse emparejado. 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 servidor de fondo realiza una nueva conexión HTTP para responder al nodo SOAPAsyncResponse. Éste es el comportamiento predeterminado.
  2. Utilización de solicitud-respuesta asíncrona HTTP. Cuando se selecciona la propiedad de SOAPAsyncRequest Utilizar solicitud-respuesta asíncrona HTTP, el nodo SOAPAsyncRequest pasa el socket HTTP al nodo SOAPAsyncResponse emparejado para permitir que el servidor de fondo responda utilizando el mismo socket. Cuando se selecciona esta opción, las cabeceras de WS-Addressing se envían, pero es necesario que el servidor de fondo las comprenda. Las cabeceras WS-Addressing no se marcan como mustUnderstand y la cabecera replyTo se establece en anónima. Por consiguiente, el nodo utiliza el manejo de socket HTTP asíncrono en lugar de WS-Addressing para realizar solicitudes HTTP y recibir una respuesta asíncrona.
Para obtener más información, consulte Elección del comportamiento asíncrono para el nodo SOAPAsyncRequest.
El diagrama muestra la relación entre los nodos SOAPAsyncRequest y SOAPAsyncResponse y se describe en el texto.

El nodo SOAPAsyncRequest es la primera mitad del par de nodos de solicitud y respuesta asíncronos. El nodo SOAPAsyncRequest llama a un servicio web remoto basado en SOAP. La solicitud la envía el nodo SOAPAsyncRequest, pero el nodo SOAPAsyncRequest no recibe la respuesta. La respuesta la recibe un nodo SOAPAsyncResponse que se ejecuta en una hebra diferente. El nodo SOAPAsyncResponse suele encontrarse al principio de un flujo de mensajes diferente; no obstante, debe encontrarse en el mismo grupo de ejecución que el nodo SOAPAsyncRequest.

El nodo SOAPAsyncRequest está basado en WSDL, de una forma parecida al nodo SOAPRequest.

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

La imagen muestra un icono del nodo SOAPAsyncRequest.

Utilización de este nodo en un flujo de mensajes

Un nodo SOAPAsyncRequest está enlazado como un par con un nodo SOAPAsyncResponse utilizando un identificador exclusivo para correlacionar mensajes de solicitud y respuesta.

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 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.

Utilización de WSDL con el nodo SOAPAsyncRequest

Un nodo SOAPAsyncRequest debe estar asociado con un archivo WSDL a menos que funcione en modalidad de pasarela. Para obtener más información sobre la modalidad de pasarela, consulte Modalidad de operación de pasarela para nodos SOAP.

En modalidad WSDL, cuando se selecciona un archivo WSDL para el campo Nombre de archivo WSDL, el WSDL se valida para asegurar que es compatible con WS-I. Si el WSDL utiliza un URI de transporte SOAP/JMS, no es compatible con WS-I, pero, de forma predeterminada, no se muestra ningún error. Para habilitar la validación WS-I estricta y mostrar un aviso cuando se utilice un transporte SOAP/JMS, pulse Ventana > Preferencias > Desarrollo de intermediario > Conjuntos de mensajes > Validación y quite la marca de selección del recuadro WS-I BP 1.1: Permitir SOAP/JMS como URI de transporte.

Tras seleccionar un archivo WSDL válido, el proyecto de conjunto de mensajes al que pertenece el archivo WSDL se añade como proyecto referenciado al proyecto de flujo correspondiente, si la referencia no existe. Si el archivo WSDL no es válido, o se especifica un nombre de archivo incorrecto, aparece un mensaje de error en la vista Propiedades y todas las propiedades WSDL están en blanco.

Si el nodo se ha creado arrastrando un archivo WSDL desde un conjunto de mensajes al editor de flujos de mensajes, esta propiedad estará preestablecida en el nombre del archivo WSDL. Si el nombre del archivo WSDL no está preestablecido, puede establecer esta propiedad de una de las siguientes maneras:

  • Si tiene WSDL desplegable, puede seleccionar entre los archivos WSDL desplegables pulsando Examinar.
  • Si tiene definiciones WSDL, pero ningún conjunto de mensajes, puede crear un conjunto de mensajes:
    1. Pulse Examinar para abrir la ventana Selección de WSDL.
    2. Pulse Importar/Crear nuevo para abrir el asistente Importar archivo WSDL.
    3. Entre el nombre del conjunto de mensajes y el nombre del proyecto de conjunto de mensajes. Pulse Siguiente.
    4. Seleccione la opción pertinente:
      • Si el archivo WSDL existe en el espacio de trabajo, seleccione Utilizar recursos del espacio de trabajo y seleccione el archivo WSDL.
      • Si el archivo WSDL está en el sistema de archivos, seleccione Utilizar recursos externos. Seleccione el archivo WSDL. Pulse Siguiente.
    5. Seleccione los enlaces WSDL que va a importar. Los avisos o errores se visualizan en el mensaje de cabecera del asistente.
    6. Pulse Finalizar. Resultado: Se crea un nuevo proyecto de conjunto de mensajes y un nuevo conjunto de mensajes, con definiciones de mensajes. Las definiciones WSDL se añaden a la carpeta WSDL desplegable.
    7. Ahora puede seleccionar el archivo WSDL en la ventana Selección de WSDL. Pulse Aceptar.
  • Si tiene un conjunto de mensajes pero ninguna definición de WSDL, debe generar una definición WSDL. Consulte Conjuntos de mensajes: generar una definición WSDL a partir de un conjunto de mensajes.
  • Arrastre un archivo WSDL desde un conjunto de mensajes al nodo.
  • Escriba un nombre de archivo que esté relacionado con el proyecto de conjunto de mensajes en el que el archivo WSDL desplegable existe.
Cuando guarda el archivo de flujo de mensajes, se valida que el Nombre de archivo WSDL exista en el conjunto de mensajes. Si no existe, se genera un error, y no podrá añadir un flujo que contenga este nodo SOAPAsyncRequest al archivo de archivador de intermediario (BAR).

Terminales y propiedades

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

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje de solicitud SOAP para que el nodo lo despache al destino.
Failure (de anomalías) El terminal de salida al que se direcciona un mensaje si se detecta una anomalía cuando el mensaje de solicitud SOAP se despacha al destino (como una anomalía de validación de mensaje).
Out (de salida) El terminal de salida al que se direcciona el mensaje si se ha despachado satisfactoriamente al destino y si este flujo de mensajes requiere un proceso adicional. El mensaje que deja el terminal de salida es el mismo que el mensaje que ha llegado al terminal de entrada.

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 debe entrar un valor cuando no se haya definido ningún valor predeterminado). La columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añada el flujo de mensajes al archivo BAR para desplegarlo).

Algunas propiedades del nodo SOAPAsyncRequest se establecen inicialmente a partir de las propiedades del WSDL importado. Estas propiedades se analizan de forma diferente en función del formato de URI que utilice el elemento address del WSDL. Para obtener información detallada, consulte Formatos de URI de WSDL de JMS.

Las propiedades de descripción del nodo SOAPAsyncRequest se describen en la tabla siguiente.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo 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 la finalidad del nodo en el flujo de mensajes.

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

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Identificador exclusivo No   Esta propiedad es el identificador exclusivo que enlaza un par de nodos SOAPAsyncRequest y SOAPAsyncResponse.

Cuando se utiliza el transporte HTTP, este identificador se utiliza como un fragmento de URL exclusivo para identificar los mensajes de respuesta entrantes para el nodo SOAPAsyncResponse.

Cuando se utiliza el transporte JMS, esta propiedad se utiliza como un identificador exclusivo sólo si la propiedad Obtener respuesta por ID de correlación está seleccionada. Si la propiedad Obtener respuesta por ID de correlación no está seleccionada y se utiliza el transporte JMS, la cola Destino de respuesta actúa en su lugar como el identificador exclusivo y, por lo tanto, debe ser exclusiva para este par de nodos.

asyncResponseCorrelator
Modalidad de operación Invocar un servicio web específico definido por una interfaz WSDL

Esta propiedad le permite especificar la modalidad de operación del nodo, que determina si éste actúa en modalidad WSDL o en modalidad de pasarela. En modalidad WSDL, el nodo realiza operaciones en función del WSDL con el que esté configurado. Sin embargo, la modalidad de pasarela le permite configurar el flujo para que maneje mensajes SOAP genéricos de solicitud/respuesta y unidireccionales, o para que actúe como fachada entre varios clientes de servicios web y varios proveedores de servicios web de fondo.

Invocar un servicio web específico definido por una interfaz WSDL
Configure el nodo con un WSDL desplegable estableciendo la propiedad Nombre de archivo WSDL o arrastrando un WSDL al nodo. Esta es la opción predeterminada.
Invocar un servicio web genérico
Configure el nodo para que actúe en modalidad de pasarela sin que sea necesario ningún WSDL. Consulte Modalidad de operación de pasarela para nodos SOAP para obtener una explicación más completa de la modalidad de pasarela.
 
Nombre de archivo WSDL No Ninguna

Esta propiedad indica la ubicación del archivo WSDL que desea utilizar para configurar el nodo. Especifique la vía de acceso completa al archivo WSDL o pulse Examinar para localizar el archivo WSDL en el espacio de trabajo.

Cuando seleccione un archivo WSDL para la propiedad Nombre de archivo WSDL, el WSDL se valida para garantizar que es compatible con WS-I. Si el WSDL tiene un enlace que utiliza SOAP/JMS que no cumple la normativa WS-I, de forma predeterminada, no aparecerá ningún error. Para habilitar la validación WS-I estricta y mostrar un aviso cuando se utilice un transporte SOAP/JMS, pulse Ventana > Preferencias > Desarrollo de intermediario > Conjuntos de mensajes > Validación y quite la marca de selección del recuadro WS-I BP 1.1: Permitir SOAP/JMS como URI de transporte.

Únicamente puede utilizar archivos WSDL desplegables para configurar los nodos SOAP. Tras seleccionar un archivo WSDL válido, el proyecto de conjunto de mensajes al que pertenece el archivo WSDL se añade como proyecto referenciado a la aplicación o biblioteca correspondiente, si la referencia no existe.

Si el archivo WSDL no es válido, o se especifica un nombre de archivo incorrecto, aparece un mensaje de error en la vista Propiedades y todas las propiedades WSDL están en blanco.

Si el nodo se ha creado arrastrando un archivo WSDL desde un conjunto de mensajes al editor de flujos de mensajes, esta propiedad estará establecida previamente con el nombre del archivo WSDL.

Esta propiedad toma un valor de serie.

En una condición de error se producen las situaciones siguientes:

Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela.

 
Tipo de puerto No De forma predeterminada, se selecciona el primer Tipo de puerto encontrado en el archivo WSDL que tenga asociado un enlace HTTP o JMS.

Esta propiedad es de tipo Serie. Este campo lista todos los tipos de puertos definidos por el archivo WSDL especificado. De forma predeterminada, se selecciona el primer tipo de puerto encontrado en el archivo WSDL que tenga un enlace HTTP o JMS asociado.

Cuando guarda el archivo de flujo de mensajes, se valida que el Tipo de puerto seleccionado sea válido dentro del contenido del archivo WSDL seleccionado. Si no es válido, se genera un error, y no podrá añadir un flujo que contenga este nodo SOAPAsyncRequest al archivo de archivador de intermediario (BAR).

Condiciones de error:
  • El Tipo de puerto seleccionado no contiene como mínimo una operación.

Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela.

 
Enlace importado No   Esta propiedad es de tipo Serie. El recuadro Enlace importado lista todos los enlaces SOAP asociados con el tipo de puerto seleccionado. Sólo se soporta el transporte HTTP o JMS. Los enlaces se listan en el orden en el que se visualizan en el archivo WSDL. De forma predeterminada, se selecciona el primer enlace que implementa la operación y tiene un puerto de servicio asociado. Esta propiedad se actualiza cada vez que cambia el valor Tipo de puerto.
Condiciones de error:
  • No hay ningún enlace SOAP (con transporte HTTP o JMS) en el archivo WSDL que esté asociado con el Tipo de puerto.
  • El enlace seleccionado no tiene operaciones.

Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela.

 
Operación de enlace No   Esta propiedad es de tipo Serie.

El recuadro Operación de enlace contiene todas las operaciones definidas por el enlace seleccionado. La primera operación en la lista se selecciona de forma predeterminada. Esta propiedad se actualiza cada vez que el valor de enlace seleccionado cambia.

Cuando guarda el archivo de flujo de mensajes, se valida que la Operación de enlace seleccionada sea válida dentro del contenido del archivo WSDL seleccionado. Si no es válido, se genera un error, y no podrá añadir un flujo que contenga este nodo SOAPAsyncRequest al archivo de archivador de intermediario (BAR).

Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela.

 
Puerto de servicio No   Esta propiedad es de tipo Serie. El recuadro Puerto de servicio lista todos los puertos de servicio que apuntan al enlace seleccionado. El primer puerto de servicio para el enlace se selecciona de forma predeterminada. Esta propiedad se actualiza cada vez que el valor de enlace seleccionado cambia.

Cuando guarda el archivo de flujo de mensajes, se valida que el Puerto de servicio seleccionado sea válido dentro del contenido del archivo WSDL seleccionado. Si no es válido, se genera un error, y no podrá añadir un flujo que contenga este nodo SOAPAsyncRequest al archivo de archivador de intermediario (BAR).

Condiciones de error:
  • Ningún puerto apunta al enlace seleccionado.

Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela.

 
Espacio de nombres de destino No No   Esta propiedad es de tipo Serie. Espacio de nombres de destino muestra el espacio de nombres del archivo WSDL seleccionado.

Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela.

 
Transporte No No HTTP Esta propiedad se establece automáticamente cuando se selecciona la propiedad Enlace importado. El valor de esta propiedad muestra el transporte utilizado por el enlace WSDL seleccionado; por ejemplo, HTTP o JMS.

Si decide cambiar el transporte de JMS a HTTP, aparece un recuadro de diálogo, que le permite restablecer las propiedades específicas de JMS. Debe restablecer las propiedades JMS para desplegar el flujo de mensajes en una versión del entorno de ejecución anterior al fixpack V7.0.0.1.

 

Las propiedades de transporte HTTP del nodo SOAPAsyncRequest se describen en la siguiente tabla. Estos valores se utilizan solamente cuando el nodo utiliza el transporte HTTP.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
URL de servicio web No   Esta propiedad es de tipo Serie. Esta propiedad se deriva automáticamente del elemento <soap:address> del Puerto de servicio seleccionado. Siempre que se actualiza el puerto seleccionado, se actualiza el URL de servicio web como corresponde. No obstante, si altera temporalmente el valor, el valor persiste y el URL ya no se actualiza desde el puerto de servicio.
Si elige alterar temporalmente esta propiedad, debe especificarla en el formato http://<nombre_host>[:<puerto>]/[<vía_acceso>] donde:
  • http://<nombre_host> debe especificarse.
  • <puerto> toma por omisión el valor 80. Si especifica un valor, debe incluir los dos puntos (:) antes del número de puerto.
  • <vía_acceso> toma por omisión el valor de una barra inclinada (/). Si especifica un valor, debe incluir la barra inclinada (/) antes de la vía de acceso.

Para obtener más información acerca de cómo alterar temporalmente esta propiedad, consulte Cambio del URL predeterminado para un nodo SOAPRequest o una solicitud de nodo SOAPAsyncRequest.

webServiceURL
Tiempo de espera de solicitud (en segundos) No 120 Esta propiedad es de tipo Entero. Esta propiedad tiene el valor del tiempo de espera hasta que el servidor remoto responde con un acuse de recibo de que se ha recibido el mensaje.

Si selecciona la propiedad Utilizar socket asíncrono, el valor de Tiempo de espera de solicitud hace referencia en su lugar al valor del tiempo de espera para que el servidor remoto envíe una respuesta al nodo SOAPAsyncResponse.

Tiempo, en segundos, que un nodo espera la respuesta del servicio web. El rango válido es de 1 a (231)-1. No se puede entrar un valor que represente una espera ilimitada.

requestTimeout
Ubicación de proxy HTTP(S) No   Esta propiedad es de tipo Serie. La ubicación del servidor proxy al que se envían solicitudes. Este valor debe tener el formato nombre_host:puerto. httpProxyLocation
Protocolo SSL (si se utiliza SSL) No TLS Esta propiedad es de tipo Enumerado. Protocolo SSL que hay que utilizar al realizar una solicitud HTTPS. Los valores válidos son:
SSL
Esta opción intenta establecer conexión utilizando primero el protocolo SSLv3, pero el reconocimiento puede recurrir al protocolo SSLv2 cuando el proveedor JSSE subyacente soporte el protocolo SSLv2.
SSLv3
Esta opción intenta conectar sólo con el protocolo SSLv3. El reconocimiento no puede recurrir a SSLv2.
TLS
El valor predeterminado. Esta opción intenta establecer conexión sólo con el protocolo TLS. El reconocimiento no puede recurrir a SSLv3 o SSLv2.

Ambos extremos de una conexión SSL deben utilizar el mismo protocolo. El protocolo debe ser uno que el servidor remoto pueda aceptar.

sslProtocol
Cifrados SSL permitidos (si se utiliza SSL) No Vacío Esta propiedad es de tipo Serie. Lista separada por comas de cifrados que hay que utilizar al realizar una solicitud SSL. Este valor le permite especificar un solo cifrado (por ejemplo SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA) o una lista de cifrados que son los únicos utilizados por la conexión. Esta lista de cifrados debe incluir uno o varios que el servidor remoto acepte. El valor predeterminado es una Serie vacía, que permite al nodo utilizar cualquiera o todos los cifrados disponibles durante el reconocimiento de conexión SSL. Este método permite el ámbito más amplio para establecer una conexión SSL satisfactoria. allowedSSLCiphers
Usar compresión No No Ninguna Esta propiedad controla si el contenido de la solicitud HTTP está comprimido. Los valores válidos son ninguno, gzip, zlib (deflate) y deflate. Si la solicitud está comprimida, la cabecera Content-Encoding se establece para indicar que el contenido está comprimido.

zlib (deflate) representa la RFC 1950 y la RFC 1951 combinadas.

deflate representa únicamente la RFC 1951.

requestCompressionType
Aceptar respuestas comprimidas por omisión No No seleccionado Esta propiedad indica si la solicitud acepta respuestas comprimidas. Si esta opción está seleccionada, la solicitud puede recibir respuestas con una cabecera Content-Encoding de gzip o deflate. Si se recibe una respuesta de este tipo, el contenido se descodifica y la cabecera Content-Encoding se elimina.

Si la cabecera de solicitud no contiene una cabecera Accept-Encoding, al seleccionar esta opción se establece la cabecera Accept-Encoding en "gzip, deflate".

acceptCompressedResponses
Habilitar comprobación de nombre de host de certificado SSL No No Esta propiedad especifica si el nombre de host del servidor que está recibiendo la solicitud debe coincidir con el nombre de host en el certificado SSL. hostnameChecking
Utilizar solicitud-respuesta asíncrona HTTP No No No seleccionado El establecimiento de esta propiedad especifica que el nodo SOAPAsyncRequest pasa el socket HTTP al nodo SOAPAsyncResponse emparejado para permitir que el servidor de fondo responda utilizando el mismo socket.

Esta propiedad configura el nodo para utilizar el manejo de solicitud-respuesta HTTP asíncrona en lugar de WS-Addressing asíncrono. Cuando se selecciona Utilizar solicitud-respuesta asíncrona HTTP, las cabeceras WS-Addressing no se marcan como mustUnderstand y la cabecera replyTo se establece en anónima.

Seleccione esta opción si el servidor de fondo no puede realizar solicitudes de salida en una conexión nueva.

Para obtener más información, consulte Elección del comportamiento asíncrono para el nodo SOAPAsyncRequest.

 
Alias de clave de autenticación de cliente SSL No "" (serie vacía) Esta propiedad especifica un alias de autenticación SSL para el del lado del cliente de una conexión SOAPAsyncRequest. Tomar el valor predeterminado, significa elegir automáticamente la primera clave adecuada. keyAlias

Las propiedades de transporte JMS del nodo SOAPAsyncRequest se describen en la siguiente tabla. Estos valores se utilizan solamente cuando el nodo utiliza el transporte JMS.

Propiedad M C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Destino Ninguna El destino al que el nodo envía los mensajes de salida. Si el nodo SOAPAsyncRequest debe utilizarse para enviar mensajes de punto a punto, especifique el nombre de cola de destino para el nombre de cola JMS que se indica en el archivo de enlaces.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándar) o IBM® (propietario). El Destino se establece en el valor de destinationName encontrado en el WSDL si se encuentra un URL de estilo W3C, o destination si se encuentra un URI de estilo IBM.

jmsDestination
Destino de respuesta Ninguna El nombre del destino JMS al que la aplicación receptora debe enviar un mensaje de respuesta. Para que se devuelva un mensaje de respuesta a este destino JMS, el nombre de destino JMS debe ser conocido en el dominio del proveedor JMS utilizado por el cliente receptor.

Si la propiedad Obtener respuesta por ID de correlación no está seleccionada, esta cola identifica de forma exclusiva los mensajes destinados al nodo SOAPAsyncResponse emparejado. Si la propiedad Obtener respuesta por ID de correlación está seleccionada, entonces esta cola puede ser compartida entre varios nodos.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándares) o IBM (propietario). El Destino de respuesta se establece en el valor de replyToName encontrado en el WSDL si se encuentra un URI de estilo W3C, o en la primera de las propiedades replyToName, replyTo, replyToDestination o replyDestination si se encuentra un URI de estilo IBM. Si alguna de estas otras propiedades está presente, se visualizan como un par nombre-valor en la tabla Parámetros de usuario.

jmsReplyToDestination
Nombre del proveedor JMS No WebSphere MQ Seleccione un nombre de proveedor JMS en la lista o especifique el nombre que desee. El nombre debe coincidir con el nombre del servicio configurable definido para el intermediario al que despliega el flujo de mensajes.

Cuando se selecciona un nombre de proveedor de la lista, la propiedad Fábrica de contexto inicial se actualiza automáticamente con la clase Java™ pertinente. Si entra un nombre de proveedor JMS que no esté en la lista, también deberá entrar un valor en Fábrica de contexto inicial.

 
Fábrica de contexto inicial com.sun.jndi.fscontext. RefFSContextFactory Punto de partida para un espacio de nombres JNDI.

Una aplicación JMS utiliza el contexto inicial para obtener y buscar la fábrica de conexiones y los objetos de cola o tema para el proveedor JMS. Si selecciona un nombre de proveedor JMS de la lista en Nombre de proveedor JMS, la propiedad Fábrica de contexto inicial se actualiza automáticamente con la clase Java pertinente. Si entra un nombre de proveedor JMS que no esté en la lista, también deberá entrar un valor en Fábrica de contexto inicial. El valor predeterminado es com.sun.jndi.fscontext.RefFSContextFactory, que define la Fábrica de contexto inicial para el proveedor JMS de WebSphere MQ.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándar) o IBM (propietario). La Fábrica de contexto inicial se establece en el valor de jndiInitialContextFactory encontrado en el WSDL si se encuentra un URI de estilo W3C, o initialContextFactory si se encuentra un URI de estilo IBM.

initialContextFactory
Ubicación de enlaces URL de JNDI   Vía de acceso de sistema o ubicación LDAP para el archivo de enlaces. El archivo de enlaces contiene definiciones para los objetos JNDI administrados utilizados por el nodo SOAPAsyncRequest.

Esta propiedad está inhabilitada cuando la Fábrica de contexto inicial es com.ibm.mq.jms.Nojndi.

Cuando especifique un valor para Ubicación de enlaces URL de JNDI, asegúrese de que cumple las instrucciones siguientes:
  • Construya el archivo de enlaces antes de desplegar un flujo de mensajes que contenga un nodo SOAPAsyncRequest.
  • No incluya en este campo el nombre del archivo de enlaces.
  • Si ha especificado una ubicación LDAP que necesite autenticación, configure por separado el principal (id de usuario) LDAP y los credenciales (contraseña) LDAP. Estos valores se configuran a nivel de intermediario. Para obtener información sobre la configuración de estos valores, consulte el Mandato mqsicreatebroker y el Mandato mqsichangebroker.
  • El valor de serie debe incluir un prefijo de URL soportado que tenga un manejador de URL que esté disponible en la vía de acceso de clases.

Para obtener más información sobre cómo construir el archivo de enlaces de objetos JNDI administrados, consulte la documentación del proveedor JMS.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándar) o IBM (propietario). La Ubicación de enlaces URL de JNDI se establece en el valor de jndiURL encontrado en el WSDL si se encuentra un URL de estilo W3C, o jndiProviderURL si se encuentra un URI de estilo IBM.

locationJndiBindings
Nombre de fábrica de conexiones   El nombre de la fábrica de conexiones que utiliza el nodo SOAPAsyncRequest para crear una conexión con el proveedor JMS. Esta propiedad se configura inicialmente desde el WSDL importado. Este nombre debe existir en el archivo de enlaces. El Nombre de fábrica de conexiones debe ser una fábrica de conexiones de cola (QueueConnectionFactory) de JMS.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándares) o IBM (propietario). El Nombre de fábrica de conexiones se establece en el valor de jndiConnectionFactoryName encontrado en el WSDL si se encuentra un URI de estilo W3C, o connectionFactory si se encuentra un URI de estilo IBM.

connectionFactoryName
Parámetros de usuario No No   Esta tabla describe las propiedades de usuario que se enviarán en la propiedad requestURI del mensaje de solicitud saliente. Las propiedades son pares nombre-valor que existen en el WSDL y no los utilizan otras propiedades del nodo SOAPAsyncRequest.  
Parámetros de JNDI No No   Tabla que correlaciona parámetros de contexto JNDI con su tipo.

Estas propiedades toman sus valores iniciales de cualquier propiedad WSDL de estilo W3C que comience por jndi-. El WSDL de estilo IBM no da soporte a parámetros JNDI, pero puede establecer estas propiedades en el nodo.

 
Obtener respuesta por ID de correlación No No seleccionado Si está propiedad está seleccionada, el nodo SOAPAsyncRequest envía el mensaje de solicitud con el ID de correlación especificado en la propiedad Identificador exclusivo, y el nodo SOAPAsyncResponse sólo recibe los mensajes de respuesta que coinciden con ese ID de correlación. Esto permite que una sola cola de Destino de respuesta se comparta entre varios pares de nodos SOAPAsyncRequest y SOAPAsyncResponse, si esta propiedad está seleccionada para todos esos nodos.

Esta funcionalidad sólo funciona con los proveedores de servicios web que permiten leer el ID de correlación del mensaje de solicitud y utilizarlo como el ID de correlación en el mensaje de respuesta.

 
Destino de restitución No  

El nodo SOAPAsyncResponse envía mensajes de respuesta a este destino cuando los errores impiden que el flujo de mensajes de respuesta procese el mensaje de respuesta. El mensaje se elimina del destino de respuesta.

Las propiedades de restitución las establece el nodo SOAPAsyncRequest, pero sólo las utiliza su nodo SOAPAsyncResponse emparejado.

backoutDestination
Umbral de restituciones No 0

Este valor controla cuándo se pone un mensaje en el destino de restitución. Por ejemplo, si el valor es 3, el proveedor JMS intenta entregar el mensaje al destino de entrada tres veces. Tras el tercer intento de entrega, el mensaje se no se restituye al destino de respuesta y se envía al Destino de restitución.

Las propiedades de restitución las establece el nodo SOAPAsyncRequest, pero sólo las utiliza su nodo SOAPAsyncResponse emparejado.

Consulte Configuración de la propiedad de umbral de restitución.

 

Las propiedades de entrega de mensajes del nodo SOAPAsyncRequest se describen en la siguiente tabla. Este subseparador sólo está habilitado si el enlace seleccionado en el separador Básicas utiliza transporte JMS.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Servicio de destino No No Ninguna Se utiliza en el nodo SOAPAsyncRequest cuando se despachan solicitudes de servicio.

Esta propiedad toma su valor inicial de la propiedad WSDL targetService.

targetService
Modalidad de entrega No Persistente Esta propiedad controla la modalidad de persistencia que utiliza un proveedor JMS para un mensaje. Los valores válidos son:
  • Persistente: el mensaje sobrevive si en el proveedor JMS se produce una anomalía del sistema.
  • No persistente: el mensaje se pierde si en el proveedor JMS se produce una anomalía del sistema.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándar) o IBM (propietario). La Modalidad de entrega se establece en el valor de deliveryMode encontrado en el WSDL si se encuentra un URI de estilo W3C, o en la primera de las propiedades deliveryMode o persistence si se encuentra un URI de estilo IBM. Si ambas propiedades están presentes, la segunda propiedad se muestra como un par nombre-valor en la tabla Parámetros de usuario.

deliveryMode
Prioridad del mensaje No 4

Esta propiedad asigna importancia relativa al mensaje y puede utilizarse para que un servicio web de recepción seleccione mensajes.

Seleccione un valor entre 0 (prioridad más baja) y 9 (prioridad más alta). El valor predeterminado es 4, que indica una prioridad media. Las prioridades del rango 0 - 4 indican una entrega típica. Las prioridades del rango 5 - 9 indican una entrega más rápida.

Esta propiedad toma su valor inicial de una propiedad URI de WSDL, en función de si el formato del URI address de WSDL es de estilo W3C (estándar) o IBM (propietario). La Prioridad se establece en el valor de priority encontrado en el WSDL si se encuentra un URI de estilo W3C, o en la primera de las propiedades priority o Priority si se encuentra un URI de estilo IBM. Si ambas propiedades están presentes, la segunda propiedad se muestra como un par nombre-valor en la tabla Parámetros de usuario.

messagePriority
Caducidad del mensaje (ms) No 0 Esta propiedad controla el tiempo, en milisegundos, durante el cual el proveedor JMS conserva el mensaje JMS de salida. El valor predeterminado, 0, se utiliza para indicar que el mensaje no debe caducar.

Esta propiedad toma su valor inicial de la propiedad WSDL timeToLive.

messageExpiration
Tipo de mensaje No bytes Seleccione un valor en la lista para configurar el tipo de mensaje JMS que produce el nodo SOAPAsyncRequest. Los valores válidos son text y bytes. messageType

Las propiedades de Transacciones del nodo SOAPAsyncRequest se describen en la tabla siguiente. Este valor no se aplica cuando el nodo utiliza transporte HTTP.

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

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

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

Seleccione para generar 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.

Seleccione Automática si desea que la transaccionalidad del mensaje se herede del valor Modalidad de transacción en el nodo de entrada al inicio del flujo.

Consulte Configuración para transacciones JMS coordinadas.

Las propiedades Avanzadas del nodo SOAPAsyncRequest se describen en la tabla siguiente.

Las cabeceras SOAP que forman parte de la lista de Cabeceras debe reconocer se incorporan al flujo en lugar de causar un error SOAP. Añadir cabeceras a la lista de Cabeceras debe reconocer impide que se generen errores SOAP por parte de cabeceras SOAP.

No es necesario añadir cabeceras debe reconocer para WS-Addressing y WS-Security, porque ya se reconocen si configura Extensiones WS.

La lista de Cabeceras debe reconocer que está configurada en este nodo se aplica al nodo SOAPAsyncResponse correspondiente cuando el nodo SOAPAsyncResponse recibe la respuesta del servidor remoto.

Propiedad O C Valor predeterminado Descripción
Cabeceras de respuesta SOAP definidas en WSDL No No   La tabla Cabeceras de respuesta SOAP definidas por WSDL es de sólo lectura y se llena basándose en las cabeceras SOAP definidas en la parte de salida de las operaciones seleccionadas. De forma predeterminada, los recuadros de selección, en la segunda columna de la tabla, están desmarcados para todas las entradas de la tabla Cabeceras de respuesta SOAP definidas en WSDL. Debe seleccionar el recuadro de selección relevante para añadir la cabecera a la lista de Cabeceras debe reconocer.

Cuando el nodo se configura para actuar en modalidad de pasarela, sin que sea necesario ningún WSDL, se borra el contenido de esta tabla. Los valores originales de estos campos se restauran si la modalidad de operación del nodo se cambia a la modalidad WSDL.

Cabeceras de respuesta SOAP definidas por el usuario No No   Puede añadir cabeceras personalizadas (cabeceras que no están definidas en el archivo WSDL) en la tabla Cabeceras SOAP definidas por el usuario. Utilice Añadir, Editar y Suprimir para esta tabla. Debe seleccionar el recuadro de selección pertinente, en la segunda columna de la tabla, para asegurar que la cabecera personalizada que acaba de añadir se añada a la lista de Cabeceras debe reconocer.

Las propiedades de Extensiones WS del nodo SOAPAsyncRequest se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción  
Utilizar WS-Addressing No No Seleccionado Esta propiedad no se puede editar. Esta propiedad indica que WS-Addressing siempre está activado en el nodo SOAPAsyncRequest.

Para obtener información más detallada acerca de WS-Addressing con el nodo SOAPAsyncRequest, consulte WS-Addressing con los nodos SOAPAsyncRequest y SOAPAsyncResponse.

 
Permitir MTOM No No Esta propiedad controla si MTOM se ha habilitado para el analizador. Los valores válidos son , No y Heredar.

Para obtener más información sobre la utilización de SOAP MTOM con los nodos SOAPReply, SOAPRequest y SOAPAsyncRequest; consulte Utilización de SOAP MTOM con los nodos SOAPReply, SOAPRequest y SOAPAsyncRequest. Para obtener más información sobre MTOM, consulte SOAP MTOM.

El soporte MTOM se inhabilita cuando el nodo se configura para actuar en modalidad de pasarela.

allowMTOM
WS-Security No No   Esta tabla presenta dos columnas:
  • Alias
  • Expresión XPath
Puede añadir expresiones XPath con un valor Alias asociado a la tabla WS-Security. El Alias se resuelve en un Conjunto de políticas que crea el administrador. El Conjunto de políticas resuelve el Alias para cifrar o firmar la parte del mensaje a la que se refiere Expresión XPath. En esta tabla, puede Añadir, Editar y Suprimir.
 
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 alterar dinámicamente los valores establecidos en el entorno local del mismo modo que se establecen valores en otros elementos de un mensaje. Si desea obtener una lista completa de los valores que puede alterar temporalmente en el entorno local, consulte Alteraciones temporales del entorno local.

Cómo trabajar con datos WrittenDestination

Una vez realizada la solicitud, la carpeta WrittenDestination del entorno local se actualiza con WS-Addressing, los detalles de compresión (si se utilizan) y los detalles del transporte. Una WrittenDestination para un nodo SOAPAsyncRequest tiene el formato siguiente, con WS-Addressing y Compression presentes sólo si se utilizan:
WrittenDestination = (
   SOAP  = (
      Request = (
         WSA = (
            To = 'URI'
            ReplyTo = 'http://server:7800/reply'
            MessageID = 'id'
            Action = 'doAllTheStuff'
         )
         Transport = (
            HTTP  = (
               WebServiceURL = 'http://server:8080/service'
               Compression   = (
                  OriginalSize   = 775
                  CompressedSize = 411
            )
         )
      )
   )
)
En el ejemplo siguiente se utiliza el transporte JMS:
WrittenDestination = (
   SOAP  = (
      Request = (
         WSA = (
            To = 'URI'
            ReplyTo = 'http://server:7800/reply'
            MessageID = 'id'
            Action = 'doAllTheStuff'
         )
         Transport = (
            JMS = (
               Destination = 'jms:jndi:B2BQUEUEIN'
            )
         )
      )
   )
)
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 | ac56200_