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 SCARequest

Utilice el nodo SCARequest para enviar una solicitud a WebSphere Process Server. El nodo es un nodo de solicitud y respuesta síncronas y se bloquea tras enviar la solicitud hasta que se recibe la respuesta. El nodo también puede enviar solicitudes unidireccionales.

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 SCARequest envía solicitudes bidireccionales (solicitud-respuesta) síncronas de salida, y operaciones unidireccionales (sólo solicitud), a un proceso de negocio en WebSphere Process Server.

Se requiere un archivo de definición SCA del intermediario de salida (.outsca) para configurar el nodo SCARequest. La definición SCA de intermediario contiene datos específicos relacionados con el enlace que utiliza el componente de Exportación SCA.

El nodo SCARequest se encuentra en el cajón SCA de la paleta y está representado en el WebSphere Message Broker Toolkit mediante el siguiente icono:

Icono del nodo SCARequest

Utilización de este nodo en un flujo de mensajes

Puede utilizar el nodo en cualquier flujo de mensajes que necesite llamar a una aplicación que se ejecute en WebSphere Process Server.

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

Puede cambiar el tiempo de espera cambiando su valor en la siguiente ubicación en el entorno local:

LocalEnvironment.Destination.SCA.Request.Timeout

Puede cambiar el tiempo de espera cambiando su valor en la siguiente ubicación en el entorno local:

LocalEnvironment.Destination.SCA.Request.Timeout

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

Configuración del nodo SCARequest

Asegúrese de que el conjunto de mensajes contenga una definición SCA de intermediario con una extensión .outsca, con la que configurar el nodo SCARequest.

Hay dos maneras de colocar una instancia del nodo SCARequest en un flujo de mensajes: puede arrastrar una instancia del nodo de la paleta del nodo, o bien puede arrastrar una definición SCA de intermediario que tenga una extensión de .outsca de un conjunto de mensajes, en el 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.

Si la solicitud contiene una operación bidireccional, el nodo se bloquea hasta que se recibe un mensaje de respuesta, o durante el período de tiempo definido por la propiedad de tiempo de espera excedido (valor predeterminado, 120 segundos). Si se sobrepasa el periodo de tiempo de espera excedido, el mensaje recibido en el terminal de entrada del nodo SCARequest se propaga al terminal de anomalías.

Los dominios SOAP, XMLNSC, XMLNS, MRM, MIME, JSON, DFDL y BLOB están disponibles para analizar la respuesta.
  • Si el Tipo de enlace es Servicio web, el dominio de mensajes es SOAP.
  • Si el Tipo de enlace es MQ, el dominio predeterminado es BLOB, si alguna de las operaciones tiene enlaces de datos no XML. Si todas las operaciones tienen un enlace de datos XML, el dominio predeterminado es XMLNSC. El enlace de datos se identifica como XML si la Exportación SCA utiliza com.ibm.websphere.sca.mq.data.impl.mqdatabindingimplxml o com.ibm.wbiserver.datahandler.xml.XMLDataHandler.

Si la solicitud contiene una operación unidireccional, el nodo envía el mensaje de solicitud y luego direcciona el mensaje de entrada a través del terminal de salida. En este caso, las propiedades del separador Análisis de mensaje de respuesta no están disponibles.

Los valores de muchas de las propiedades del nodo los proporciona 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.

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

Terminales y propiedades

Los terminales del nodo SCARequest están descritos en la siguiente tabla.

Nombre Tipo Descripción
In (de entrada) Datos de entrada El nodo se dirige mediante un mensaje que llega al terminal.
Out (de salida) Datos de salida Cuando se ha enviado un mensaje a un recurso externo, se envía al terminal de salida sin que se le haya efectuado cambio alguno, excepto la adición del estado de información.
Failure (de anomalías) Datos de salida Una anomalía producida en el nodo, se envía al terminal de anomalías.
Fault (de defectos) Datos de salida Una anomalía SOAP procedente del sistema externo, se envía a este terminal. Este terminal sólo se utiliza cuando el Tipo de enlace es Servicios web.

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

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 Ninguno Una descripción breve del nodo.
Descripción larga No No Ninguno Texto que describe la finalidad del nodo en el flujo de mensajes.
En la tabla siguiente se describen las propiedades básicas del nodo SCARequest.
Propiedad O C Valor predeterminado Descripción
Definición SCA de intermediario No ninguno El nombre de la definición SCA de intermediario que contiene las propiedades de configuración para el nodo SCA Request. Pulse el botón de examen para ver una lista de todas las definiciones SCA de intermediario relevantes en el espacio de trabajo actual.
En la tabla siguiente se describen las propiedades de enlace del nodo SCARequest.
Propiedad O C Valor predeterminado Descripción
Tipo de enlace No ninguno El tipo de enlace que se ha encontrado en la Exportación SCA.
Tiempo de espera de solicitud No 120 El tiempo, en segundos, que transcurre antes de que agote el tiempo que la solicitud espera a una respuesta de WebSphere Process Server. Si se sobrepasa el periodo de tiempo de espera excedido, el mensaje recibido en el terminal de entrada del nodo SCARequest se propaga al terminal de anomalías. Esta propiedad está inhabilitada si la definición SCA de intermediario (de entrada) sólo contiene operaciones unidireccionales.
Las propiedades de los servicios web se describen en la tabla siguiente. Estas propiedades se muestran sólo si el tipo de enlace es Servicios web.
Propiedad O C Valor predeterminado Descripción
Nombre de archivo WSDL No <ninguno> Esta propiedad es de tipo Serie. Cuando seleccione un archivo WSDL para el campo Nombre de archivo WSDL, el WSDL se valida para garantizar que es compatible con WS-I. Sólo se puede utilizar WSDL desplegable para configurar los nodos SCA. 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.
Tipo de puerto No De WSDL Esta propiedad es de tipo Serie. El campo lista todos los tipos de puertos definidos en el archivo WSDL seleccionado en la propiedad Nombre de archivo WSDL.
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 De WSDL Esta propiedad es de tipo Serie.

Esta propiedad se actualiza siempre que cambia el valor Tipo de puerto. Estos campos listan los enlaces SOAP importados con transporte HTTP o JMS asociado al Tipo de puerto seleccionado. Cuando selecciona un enlace, se habilita el separador de propiedades del transporte asociado; de lo contrario, estará inhabilitado.

Los enlaces se listan en el mismo orden en el que aparecen en el archivo WSDL. El enlace seleccionado es el único que tiene ambos puertos y operaciones. Si no existe un enlace de este tipo, se selecciona enlazar con puertos. Si ningún enlace tiene puertos, se selecciona el primer enlace en la lista.

Condiciones de error:
  • No se asocia ningún enlace SOAP (con transporte HTTP o JMS) en el archivo WSDL con el Tipo de puerto.
  • El enlace seleccionado no tiene ninguna operación.

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

Operación No De WSDL 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 cambia el valor de enlace

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

Puerto de servicio No De WSDL Esta propiedad es de tipo Serie. Este campo se actualiza siempre que se actualiza el enlace seleccionado. Este campo lista todos los puertos WSDL 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.
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 De WSDL Espacio de nombres de destino se implementa como un campo de sólo lectura.

Esta propiedad oculta es de tipo Serie. Se actualiza con el Nombre de espacio de destino del archivo WSDL cuando está configurado el Nombre de archivo WSDL.

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

URL de servicio web ninguno El URL de la dirección SOAP seleccionada. 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> tiene un valor predeterminado de /. Si especifica un valor, debe incluir el carácter / delante 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.

Propagar sólo el cuerpo SOAP, propiedad del dominio XMLNSC No No falso Si selecciona, sólo se propaga el cuerpo SOAP, de lo contrario, se propaga todo el mensaje SOAP.
Utilizar WS-Addressing No No falso Seleccione el recuadro de selección si desea utilizar WS-Addressing.
Alias de clave de autenticación de cliente SSL No "" (serie vacía) La propiedad especifica un alias de autenticación SSL para el lado del cliente de una conexión SCA. 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.
Propiedad O C Valor predeterminado Descripción
Operación No De WSDL La operación seleccionada del enlace seleccionado en el archivo WSDL. El WSDL no se visualiza; el WSDL se encuentra en el archivo de definición SCA de intermediario.
Nombre de cola ninguno La cola que recibe un mensaje de solicitud de WebSphere Message Broker.
Nombre del gestor de colas ninguno El gestor de colas que recibe una solicitud de WebSphere Message Broker.
Nombre de cola de respuestas ninguno La cola que recibe un mensaje de respuesta de WebSphere Process Server.
Nombre de gestor de cola de respuestas No ninguno El gestor de colas que recibe una respuesta de WebSphere Process Server.
Correlación de mensaje de respuesta No FromMsgId Esta propiedad indica cómo WebSphere Message Broker debe completar la información de ID de correlación en el mensaje de respuesta.

En la tabla siguiente se describen las propiedades de Análisis de mensajes de respuesta del nodo SCARequest. El nodo establece estas propiedades automáticamente; la tabla describe cuándo se pueden cambiar. .

Propiedad O 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. El dominio 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 mensaje 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 de validación se describen en la tabla siguiente. Para obtener más información, consulte Propiedades de validación.
Propiedad O C Valor predeterminado Descripción
Validar No 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 No No Excepción Esta propiedad controla qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones.
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 17:01:00


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