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.
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 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:
Un nodo SOAPAsyncRequest está enlazado como un par con un nodo SOAPAsyncResponse utilizando un identificador exclusivo para correlacionar mensajes de solicitud y respuesta.
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.
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 WS-I BP 1.1: Permitir SOAP/JMS como URI de transporte. y quite la marca de selección del recuadro
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:
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 | Sí | 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 | Sí | Sí | 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.
|
|
Nombre de archivo WSDL | Sí | 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 WS-I BP 1.1: Permitir SOAP/JMS como URI de transporte. y quite la marca de selección del recuadro Ú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 | Sí | 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:
Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela. |
|
Enlace importado | Sí | 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:
Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela. |
||
Operación de enlace | Sí | 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 | Sí | 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:
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 | Sí | 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:
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 | Sí | 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 | Sí | 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 | Sí | TLS | Esta propiedad es de tipo Enumerado. Protocolo SSL
que hay que utilizar al realizar una solicitud HTTPS. Los valores válidos son:
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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | "" (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 | Sí | Sí | 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 | Sí | Sí | 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 | Sí | 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 | Sí | Sí | 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 | Sí | Sí | 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:
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 | Sí | Sí | 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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | Persistente | Esta propiedad controla la modalidad de
persistencia que utiliza un proveedor JMS para un mensaje. Los valores válidos son:
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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | No | Automática | Esta propiedad controla si el mensaje se genera bajo una transacción JMS. Los valores válidos son Sí, No y Automática. Seleccione No para generar el mensaje utilizando una sesión JMS no transaccional. Seleccione Sí 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. |
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 | Sí | No | Esta propiedad controla si MTOM se ha habilitado para el analizador. Los valores válidos son Sí, 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:
|
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. |
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.
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
)
)
)
)
)
WrittenDestination = (
SOAP = (
Request = (
WSA = (
To = 'URI'
ReplyTo = 'http://server:7800/reply'
MessageID = 'id'
Action = 'doAllTheStuff'
)
Transport = (
JMS = (
Destination = 'jms:jndi:B2BQUEUEIN'
)
)
)
)
)