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 SCAAsyncRequest

Utilice el nodo SCAAsyncRequest con el nodo SCAAsyncResponse para construir un par de flujos de mensajes que invoquen un componente de servicio WebSphere Process Server de forma asíncrona.

Nota: A partir de la Versión 7.5, WebSphere Process Server ha pasado a denominarse IBM® Business Process Manager Advanced. La información de este tema que hace referencia a WebSphere Process Server Versión 7.0 también es aplicable a IBM Business Process Manager Advanced Versión 7.5.

Finalidad

El nodo SCAAsyncRequest envía una solicitud a un proceso de negocio que se ejecuta en WebSphere Process Server, pero el nodo no espera hasta recibir la respuesta asociada. Sin embargo, el nodo SCAAsyncRequest espera un acuse de recibo antes de continuar con el flujo de mensajes. El nodo SCAAsyncResponse, que puede estar en un flujo de mensajes separado, recibe la respuesta a la solicitud del servidor de procesos. Los nodos se utilizan como par y las respuestas se correlacionan respecto a las solicitudes originales.

Diagrama que muestra la relación entre el nodo SCAAsynchronousRequest y el nodo SCAAsynchronousResponse.

El nodo SCAAsyncRequest es la primera mitad de la solicitud asíncrona y el par de nodos de respuesta. El nodo SCAAsyncRequest envía una solicitud a un proceso de negocio que se está ejecutando en WebSphere Process Server. La solicitud la envía el nodo SCAAsyncRequest, pero el nodo SCAAsyncRequest no recibe la respuesta. El nodo SCAAsyncResponse que se ejecuta en una hebra diferente recibe la respuesta. El nodo SCAAsyncResponse suele encontrarse al principio de un flujo de mensajes diferente; no obstante, debe encontrarse en el mismo grupo de ejecución que el nodo SCAAsyncRequest.

Se requiere una definición SCA de intermediario para configurar los nodos SCAAsyncRequest y SCAAsyncResponse. La definición SCA de intermediario contiene datos específicos relacionados con el enlace del servidor de procesos.

El nodo SCAAsyncRequest se encuentra en la bandeja SCA de la paleta y se representa en el WebSphere Message Broker Toolkit mediante el icono siguiente:

Icono del nodo SCAAsyncRequest

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente para ver cómo se debe utilizar el nodo:

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 cambiar la operación que se debe invocar cambiando su valor en la siguiente ubicación en el entorno local:

LocalEnvironment.Destination.SCA.Request.Operation

Para un enlace de Servicios web, puede cambiar el URL al que se envía la solicitud. Cambie su valor en la siguiente ubicación en el entorno local:

LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.WebServiceURL

Para un enlace MQ, puede cambiar el Gestor de colas de solicitudes y la Cola de solicitudes cambiando los valores en las siguientes ubicaciones:

LocalEnvironment.Destination.SCA.Request.Binding.MQ.queueManagerName
LocalEnvironment.Destination.SCA.Request.Binding.MQ.queueName

Puede almacenar los datos de contexto en la siguiente ubicación, en el entorno local. El nodo SCAAysncResponse puede, posteriormente, recuperar estos datos.

LocalEnvironment.Destination.SCA.Request.UserContext
Puede cambiar el alias de clave de autenticación SSL cambiando su valor en la siguiente ubicación en el entorno local:
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.KeyAlias

Configuración del nodo SCAAsyncRequest

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

Hay dos métodos para colocar una instancia del nodo SCAAsyncRequest a 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 editor de flujos de mensajes.

Arrastrar un nodo al lienzo
Si ha arrastrado una instancia del nodo de la paleta al lienzo, utilice uno de los métodos siguientes para empezar a configurarla:
  • Arrastre una definición SCA de intermediario que tenga una extensión .outsca al nodo.
  • Escriba el nombre de archivo en la opción Nombre de archivo SCA en la vista Propiedades del nodo.
  • Desplácese hasta el archivo (la opción Nombre de archivo SCA de la vista Propiedades del nodo.)
Arrastre un archivo .outsca al lienzo
  • Si el archivo .outsca contiene un WSDL que sólo tiene definida una única operación, unidireccional, se crea un nodo SCARequest.
  • Si el archivo .outsca contiene un WSDL que sólo tenga operaciones de tipo solicitud-respuesta, seleccione primero la operación, e indique si desea que la solicitud de salida se envíe de forma síncrona o asíncrona. Para una solicitud síncrona, se crea y configura un nodo SCARequest. Para una solicitud asíncrona, se crea y configura un par de nodos SCAAsyncRequest y SCAAsyncResponse.
  • Si el archivo .outsca contiene un WSDL que tenga definida una mezcla de operaciones, unidireccionales y de tipo solicitud-respuesta, y selecciona una operación unidireccional, se crea un nodo SCARequest.

Los valores de muchas de las propiedades del nodo se proporcionan en la definición SCA de intermediario. Las propiedades del nodo se visualizan 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.

  1. Opcional: en el separador Descripción, entre una Descripción corta, una Descripción larga o ambas cosas. En este separador también puede renombrar el nodo.
  2. En el separador Básicas, establezca las propiedades Identificador exclusivo y Definición SCA de intermediario.
    • Identificador exclusivo. Debe especificar la serie exclusiva que es común a su par de nodos SCAAsyncRequest y SCAAsyncResponse. Esta propiedad es obligatoria.
    • En Definición SCA de intermediario, especifique el nombre de la definición SCA de intermediario que contiene las propiedades de configuración para el nodo SCAAsyncRequest. Si ha creado el nodo arrastrando una definición SCA de intermediario de un conjunto de mensajes en el lienzo del editor de flujos de mensajes, esta propiedad estará ya establecida en el nombre de la definición SCA de intermediario. Si ha creado el nodo seleccionándolo de la paleta, puede establecer esta propiedad de una de las siguientes maneras:
      • Si dispone de una definición SCA de intermediario, puede seleccionarla de las definiciones SCA de intermediario pulsando Examinar.
      • Escriba un nombre de archivo que sea relativo al proyecto de conjunto de mensajes en el que existe una definición SCA de intermediario.
      • Si dispone de definiciones SCA de intermediario pero no dispone de un conjunto de mensajes, puede crear un conjunto de mensajes:
        1. Pulse Examinar para abrir el panel Selección de definición SCA de intermediario.
        2. Pulse Importar/Crear nuevo para abrir el asistente Importar definición SCA de intermediario.
        3. Entre el nombre del conjunto de mensajes y el nombre del proyecto de conjunto de mensajes, a continuación, pulse Siguiente.
        4. Elija la opción relevante:
          • Si ya existe la definición SCA de intermediario en el espacio de trabajo, pulse Utilizar recursos del espacio de trabajo y seleccione la definición SCA de intermediario.
          • Si la definición SCA de intermediario está en el sistema de archivos, pulse Utilizar recursos externos, seleccione la definición SCA de intermediario y pulse Siguiente.
        5. Seleccione la definición SCA de intermediario que va a importar.
        6. Pulse Finalizar. Se crea un nuevo proyecto de conjunto de mensajes y un conjunto de mensajes con definiciones de mensajes. La definición SCA de intermediario se añade a la carpeta Definiciones SCA de intermediario.
        7. Seleccione la definición SCA de intermediario de la ventana Selección de definición SCA de intermediario y, a continuación, pulse Aceptar.
      • Si tiene un conjunto de mensajes pero ninguna definición SCA de intermediario, genere una definición SCA de intermediario siguiendo las instrucciones de Conjuntos de mensajes: generar una definición SCA de intermediario a partir de un conjunto de mensajes.
      • Arrastre una definición SCA de intermediario de un conjunto de mensajes al nodo.
  3. En el separador Enlace, especifique propiedades relacionadas con el enlace WebSphere Process Server. Algunas de las propiedades de este separador derivan de la definición SCA de intermediario.
    • El valor de la propiedad Tipo de enlace deriva de la información de enlace en la definición SCA de intermediario. Es de sólo lectura. Los valores posibles son:
      • Servicio web. Las solicitudes de WebSphere Process Server se envían como mensajes SOAP a través del transporte HTTP. Consulte la tabla de propiedades WSDL de Terminales y propiedades para ver los detalles de las propiedades de enlace que suministra la definición SCA de intermediario, o que debe establecer el usuario.
      • MQ. Las solicitudes de WebSphere Process Server llegan como mensajes WebSphere MQ. Consulte la tabla Propiedades de MQ y la tabla Transaccionalidad de Terminales y propiedades si desea obtener los detalles de las propiedades de enlace que suministra la definición SCA de intermediario, o que debe establecer el usuario.

Para obtener información sobre cómo configurar el nodo SCAAsyncRequest para utilizar SSL, consulte Configuración de una infraestructura clave pública y revise la información que está relacionada con el nodo SOAPAsyncRequest.

Terminales y propiedades

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

Terminal Descripción
Entrada El terminal de entrada que acepta un mensaje.
Anomalía El terminal de salida al cual se envía el mensaje si se detecta una anomalía en el nodo.
Salida El terminal de salida al cual se envía el mensaje después de que el nodo haya enviado satisfactoriamente el mensaje al recurso SCA.

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

En la tabla siguiente se describen las propiedades de descripción del nodo SCAAsyncRequest.

Propiedad M C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo El nombre del nodo.
Descripción corta No No Ninguna Descripción breve del nodo.
Descripción larga No No Ninguna Texto que describe el propósito del nodo en el flujo de mensajes.

En la tabla siguiente se describen las propiedades básicas del nodo SCAAsyncRequest.

Propiedad M C Valor predeterminado Descripción
Identificador exclusivo No se ha establecido La propiedad especifica un identificador exclusivo que es común a su par de nodos SCAAsyncRequest y SCAAsyncResponse.
Definición SCA de intermediario No se ha establecido La propiedad especifica el nombre de la definición SCA de intermediario que contiene las propiedades de configuración para el nodo SCAAsyncRequest. Puede pulsar Examinar para ver una lista de todas las definiciones SCA de intermediario relevantes en el espacio de trabajo actual.

La propiedad de Enlace del nodo SCAAsyncRequest se describe en la siguiente tabla.

Propiedad M C Valor predeterminado Descripción
Tipo de enlace No A partir de una exportación SCA Esta propiedad es de sólo lectura. La suministra el kit de herramientas cuando se analiza el archivo de configuración de exportación SCA. La propiedad describe el tipo de enlace que se ha encontrado en la definición SCA de intermediario. Si el enlace es Servicios web, sólo se muestran las propiedades de WSDL. Si el enlace es MQ, sólo se muestran las propiedades de MQ.

Las propiedades de WSDL se describen en la tabla siguiente. Estas propiedades se muestran sólo si el tipo de enlace es Servicios web.

Nota: Los valores para las propiedades deben suministrarse en el nodo. No se marca como obligatorio en el nodo porque es posible que la definición SCA de intermediario no contenga todos los valores de propiedad, lo que provoca que se muestren los errores del nodo. Debe proporcionar valores para aquellas propiedades que no se hayan configurado mediante el archivo de definición SCA de intermediario.
Propiedad M C Valor predeterminado Descripción
Nombre de archivo WSDL No No se ha establecido El nombre de archivo WSDL se toma del archivo WSDL al cual hace referencia la definición SCA de intermediario.
Espacio de nombres de destino No No A partir de la definición SCA de intermediario Esta propiedad es de tipo Serie. La suministra el kit de herramientas cuando se analiza el archivo de configuración de WSDL al cual hace referencia la definición SCA de intermediario.
Tipo de puerto No El valor predeterminado, el Tipo de puerto al cual se hace referencia en la definición SCA de intermediario. Esta propiedad es de tipo Serie. Esta propiedad es de sólo lectura.
Condiciones de error:
  • El Tipo de puerto seleccionado no contiene como mínimo una operación.
Enlace importado No A partir de la definición SCA de intermediario Esta propiedad es de tipo Serie. La suministra el kit de herramientas cuando se analiza el lenguaje de descripción de servicios web (WSDL) al cual hace referencia la definición SCA de intermediario.
Condiciones de error:
  • No hay enlaces SOAP (con transporte HTTP) en el archivo WSDL asociados al Tipo de puerto.
  • El enlace seleccionado no tiene ninguna operación.
Operación No A partir de la definición SCA de intermediario Esta propiedad es de tipo Serie.

La propiedad Operaciones lista las operaciones que están definidas por el tipo de puerto. La primera operación bidireccional de la lista está seleccionada de forma predeterminada.

Solamente se da soporte a las aplicaciones bidireccionales.
Puerto de servicio No A partir de la definición SCA de intermediario Esta propiedad es de tipo Serie. La suministra el kit de herramientas cuando se analiza el archivo de configuración WSDL.
Condiciones de error:
  • Ningún puerto apunta al enlace seleccionado.
URL de servicio web A partir de la definición SCA de intermediario 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>[:<port>]/[<vía_acceso>] donde:
  • http://<nombre_host> debe especificarse.
  • <puerto> toma de forma predeterminada 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 /. Si especifica un valor, debe incluir la barra inclinada / antes de la vía de acceso.
Alias de clave de autenticación de cliente SSL No "" (serie vacía) La propiedad keyAlias especifica un alias de clave de autenticación SSL para el lado del cliente de una conexión SCAAsyncRequest. Tomar el valor predeterminado, significa elegir automáticamente la primera clave adecuada.

Las propiedades de MQ se describen en la tabla siguiente. Estas propiedades se muestran sólo si el tipo de enlace es MQ.

Nota: Los valores para las propiedades deben suministrarse en el nodo. No se marca como obligatorio en el nodo porque es posible que la definición SCA de intermediario no contenga todos los valores de propiedad, lo que provoca que se muestren los errores del nodo. Debe proporcionar valores para aquellas propiedades que no se hayan configurado mediante el archivo de definición SCA de intermediario.
Propiedad M C Valor predeterminado Descripción
Operación No A partir de la definición SCA de intermediario Las operaciones disponibles que se encuentran en la interfaz de la definición SCA de intermediario. Solamente se da soporte a las aplicaciones bidireccionales.
Nombre de cola A partir de la definición SCA de intermediario El nombre de la cola que recibe un mensaje de solicitud de WebSphere Message Broker. Se toma de la definición SCA de intermediario, pero se puede actualizar directamente en el nodo.

Puede ser una cola remota; consulte "¿Cómo funciona la transferencia de colas distribuidas?" en la sección Intercomunicación del centro de información de WebSphere MQ.

Nombre del gestor de colas A partir de la definición SCA de intermediario El nombre del gestor de colas que recibe un mensaje de WebSphere Message Broker. Se toma de la definición SCA de intermediario, pero se puede actualizar directamente en el nodo.

Si se utiliza una cola remota, deje esta propiedad en blanco para permitir que WebSphere MQ resuelva el nombre del gestor de colas.

Nombre de cola de respuestas A partir de la definición SCA de intermediario El nombre de la cola que recibe un mensaje de respuesta de WebSphere Process Server. Se toma de la definición SCA de intermediario, pero se puede actualizar directamente en el nodo.
Nombre de gestor de cola de respuestas No A partir de la definición SCA de intermediario El nombre del gestor de colas que recibe una respuesta de WebSphere Process Server. Se toma de la definición SCA de intermediario, pero se puede actualizar directamente en el nodo.

Este gestor de colas debe ser local para el intermediario.

Correlación de mensaje de respuesta No A partir de la definición SCA de intermediario Esta propiedad indica cómo WebSphere Process Server proporciona información de ID de correlación en el mensaje de respuesta. Esta información de correlación la utiliza WebSphere Message Broker para determinar qué mensaje es una respuesta a una determinada solicitud y la proporciona el kit de herramientas cuando se analiza el archivo de exportación SCA.

Seleccione A partir del ID de mensaje si se espera que WebSphere Process Server copie el campo MQMD MSGID de la solicitud en el campo MQMD CORRELID de la respuesta.

Seleccione A partir de ID de mensaje si se espera que WebSphere Process Server copie el campo MQMD CORRELID de la solicitud en el campo MQMD CORRELID de la respuesta.

La propiedad de Transaccionalidad del nodo SCAAsyncRequest se describe en la siguiente tabla.

Propiedad M C Valor predeterminado Descripción
Modalidad de transacción No No Para MQ, 'yes' Esta propiedad puede ser 'automatic', 'no' o 'yes'. La propiedad se habilita solamente cuando el Tipo de enlace es MQ.
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.

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:59:01


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