Utilice el nodo SCAAsyncResponse con el nodo SCAAsyncRequest para construir un par de flujos de mensajes que inicien un componente de forma asíncrona.
El nodo permite que el intermediario reciba la respuesta a una solicitud asíncrona anterior, realizada desde un nodo SCAAsyncRequest.
El nodo se encuentra en la bandeja SCA de la paleta y está representado en WebSphere Message Broker Toolkit por el siguiente icono:
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.
Puede recuperar los datos de contexto que haya almacenado el nodo SCAAsyncRequest, de la ubicación siguiente, en el entorno local:
LocalEnvironment.SCA.Response.UserContext
Puede acceder a la cabecera SOAP y la información de contexto en una entrada de respuesta en el entorno local, en las ubicaciones siguientes:
LocalEnvironment.SCA.Response.Binding.WebServices.SOAP.Header
LocalEnvironment.SCA.Response.Binding.WebServices.SOAP.Context
Asegúrese de que el conjunto de mensajes contenga una definición SCA de intermediario con una extensión de .outsca con la que se va a configurar el nodo.
Hay dos métodos para colocar una instancia del nodo en un flujo de mensajes: puede arrastrar una instancia del nodo desde la paleta de nodos, o puede arrastrar una definición SCA de intermediario con una extensión de .outsca desde un conjunto de mensajes, al lienzo del flujo de mensajes del editor. Si arrastra una definición SCA de intermediario con una extensión de .outsca al lienzo, se crea un par de nodos SCAAsyncRequest y SCAAsyncResponse.
Si ha arrastrado una instancia del nodo desde la paleta al lienzo, deberá empezar a configurarla arrastrando una definición SCA de intermediario con una extensión de .outsca al nodo. Los valores de muchas de las propiedades del nodo se proporcionan en la definición SCA de intermediario. Si ha arrastrado una definición SCA de intermediario al lienzo y ha creado un par de nodos SCAAsyncRequest y SCAAsyncResponse, muchos de los valores para las propiedades de nodo ya se han suministrado desde la definición SCA de intermediario.
Las propiedades del nodo se muestran en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (propiedades que no tienen un valor predeterminado definido) están marcadas con un asterisco.
El recuadro de selección Propagar sólo el cuerpo SOAP (propiedad del dominio XMLNSC) sólo se muestra cuando el Tipo de enlace es Servicios web. No se muestra cuando el Tipo de enlace es MQ; no hay propiedades de enlace específicas de MQ.
Los terminales del nodo se describen en la tabla siguiente.
Terminal | Descripción |
---|---|
Anomalía | El terminal de salida al que se direcciona el mensaje si se detecta una anomalía al transferir el mensaje a la cola de salida. |
Salida | El terminal de salida al que se direcciona el mensaje si se ha propagado satisfactoriamente y se requiere proceso adicional dentro del flujo de mensajes. |
Error | El terminal de salida al que se direcciona un mensaje de error SOAP si el Tipo de enlace es Servicios web. El terminal de error no lo utiliza ningún otro tipo de Tipo de enlace. |
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. |
Cuando haya colocado una instancia del nodo en un flujo de mensajes, podrá configurarlo. Consulte 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 (propiedades que no tienen un valor predeterminado definido) están marcadas con un asterisco.
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 se describen en la tabla siguiente.
Propiedad | M | 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 | 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 se describen en la tabla siguiente:
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Identificador exclusivo | Sí | No | No se ha establecido | Especifique el identificador exclusivo que es común a su par de nodos. |
Definición SCA de intermediario | Sí | Sí | No se ha establecido | La propiedad especifica el nombre de la definición SCA de intermediario que contiene las propiedades de configuración del nodo. Puede pulsar Examinar para ver una lista de todas las definiciones SCA de intermediario relevantes en el espacio de trabajo actual. |
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Tipo de enlace | Sí | No | No se ha establecido | El tipo de enlace que se ha encontrado en la importación SCA. |
extractSOAPBody | No | No | Borrado | Esta opción está disponible si el enlace es Servicios web. Si se marca el recuadro de selección, sólo se propaga el cuerpo SOAP. Si se desmarca, se propaga el mensaje SOAP completo. |
Las propiedades Análisis de mensaje de respuesta del nodo se describen en la tabla siguiente. El nodo establece estas propiedades automáticamente; la tabla describe cuándo se pueden cambiar.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Dominio de mensajes | No | No | Se establece automáticamente según el enlace definido en el nodo correspondiente. | Dominio que se utiliza para analizar el mensaje de respuesta. Se determina según el Tipo de enlace. Puede cambiar esta propiedad si el Tipo de enlace es MQ. La propiedad es de sólo lectura cuando el Tipo de enlace es Servicios web. |
Modelo de mensaje | No | No | Se toma automáticamente según la definición SCA de intermediario que se ha elegido en el nodo correspondiente. | Nombre o ubicación del modelo de mensaje en el que se define el mensaje de respuesta. El Modelo de mensaje se establece automáticamente en el modelo de mensaje que contiene el archivo SCA que está configurado en el nodo correspondiente. Esta propiedad es de sólo lectura. |
Mensaje | No | No | Se toma automáticamente según la definición SCA de intermediario que se ha elegido en el nodo correspondiente. | El nodo detecta automáticamente el mensaje. Puede cambiar esta propiedad si el Tipo de enlace es MQ y el dominio de mensajes es MRM. No puede cambiar esta propiedad si el Tipo de enlace es Servicios web. |
Formato físico | No | No | Nombre del formato físico del mensaje de respuesta. Puede cambiar esta propiedad si el Tipo de enlace es MQ y el dominio de mensaje es MRM. No puede cambiar esta propiedad si el Tipo de enlace es Servicios web. |
Las propiedades Opciones de análisis del nodo se describen en la tabla siguiente.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | Sí | 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 mensaje con tipos de datos tomados del esquema XML. |
Retener el contenido mixto | Sí | No | Borrado | Esta propiedad controla si el analizador 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 se ha desmarcado el recuadro de selección, se ignora el texto mixto y no se crean elementos. |
Retener los comentarios | Sí | No | Borrado | Esta propiedad controla si el analizador 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 se ha desmarcado el recuadro de selección, se ignoran los comentarios y no se crean elementos. |
Retener las instrucciones de proceso | Sí | No | Borrado | Esta propiedad controla si el analizador 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 se ha desmarcado el recuadro de selección, se ignoran las instrucciones de proceso y no se crean elementos. |
Elementos opacos | No | No | No se ha establecido | Esta propiedad se utiliza para especificar una lista de elementos en el mensaje de respuesta que se analizan opacamente. 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 se describen en la tabla siguiente.
Si falla la validación, el mensaje se propaga al terminal de anomalía, si está conectado. Para obtener más detalles, consulte Validar mensajes y Propiedades de validación.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Validar | Sí | Sí | Contenido y valor | Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguna, Contenido y valor y Contenido. |
Acción para anomalía | Sí | Sí | 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. |
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Tipo de señal de identidad | No | No | Ninguna | Esta propiedad especifica el tipo de señal de identidad existente en el mensaje de entrada. Los valores válidos son: Valor predeterminado del transporte, Nombre de usuario, Nombre de usuario + Contraseña, Aserción SAML, y Certificado X.509. Si no se especifica esta propiedad, la identidad se recupera de la cabecera de transporte Basic-Auth y el tipo se establece en Nombre de usuario + Contraseña. |
Ubicación de señal de identidad | No | No | Ninguna | Esta propiedad indica en qué parte del mensaje se puede encontrar la identidad. La ubicación se especifica como referencia de campo ESQL, una expresión XPath o un literal de serie. Si utiliza un literal de serie, debe estar encerrado entre comillas simples y no debe contener un punto (.). Si esta propiedad no se especifica, la identidad se recupera de la cabecera de transporte MQMD.UserIdentifier. |
Ubicación de contraseña de identidad | No | No | Ninguna | Esta propiedad indica en qué parte del mensaje se puede encontrar la contraseña. La ubicación se especifica como referencia de campo ESQL, una expresión XPath o un literal de serie. Si utiliza un literal de serie, debe estar encerrado entre comillas simples y no debe contener un punto (.). Si no se especifica, la contraseña no se establece. Esta propiedad se puede establecer solamente si se ha establecido Tipo de señal de identidad en Nombre de usuario + Contraseña. |
Ubicación de emisor de identidad | No | No | Ninguna | Esta propiedad especifica una expresión de serie o vía de acceso que describe el emisor de la identidad. La ubicación se especifica como referencia de campo ESQL, una expresión XPath o un literal de serie. Si utiliza un literal de serie, debe estar encerrado entre comillas simples y no debe contener un punto (.). El valor especifica el Emisor que se ha pasado a un proveedor de STS WS-Trust v1.3. Si esta propiedad no se especifica, se utilizará el valor MQMD.PutApplName. Si deja en blanco el campo Ubicación de emisor de identidad y MQMD.PutApplName también está en blanco, se utilizará la serie MQ. |
Tratar las excepciones de seguridad como excepciones normales | No | No | False | Esta propiedad especifica si van a tratarse las excepciones de seguridad (como por ejemplo "Acceso denegado") como excepciones normales y a propagarse por el termina de anomalías (si está conectado). De forma predeterminada, esta propiedad está desactivada con lo que se asegura la restitución del mensaje incluso si el terminal de anomalías está conectado. |
Las propiedades de Instancias del nodo se describen en la tabla siguiente.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Agrupación de instancias adicionales | No | Sí | Flujo | La agrupación de la que se obtienen instancias adicionales.
|
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 Nodo. De forma predeterminada, no se otorga ninguna instancia adicional al nodo. |
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. |