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.
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:
Puede utilizar el nodo en cualquier flujo de mensajes que necesite llamar a una aplicación que se ejecute en WebSphere Process Server.
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
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.
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.
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.
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. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Definición SCA de intermediario | Sí | 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. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Tipo de enlace | Sí | No | ninguno | El tipo de enlace que se ha encontrado en la Exportación SCA. |
Tiempo de espera de solicitud | No | Sí | 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. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de archivo WSDL | Sí | 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 | Sí | 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:
Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela. |
Enlace importado | Sí | 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:
Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela. |
Operación | Sí | 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 | Sí | 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:
Las propiedades WSDL están inhabilitadas cuando el nodo está configurado para actuar en modalidad de pasarela. |
Espacio de nombres de destino | Sí | 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 | Sí | Sí | 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:
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 | Sí | "" (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. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Operación | Sí | 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 | Sí | Sí | ninguno | La cola que recibe un mensaje de solicitud de WebSphere Message Broker. |
Nombre del gestor de colas | Sí | Sí | ninguno | El gestor de colas que recibe una solicitud de WebSphere Message Broker. |
Nombre de cola de respuestas | Sí | Sí | ninguno | La cola que recibe un mensaje de respuesta de WebSphere Process Server. |
Nombre de gestor de cola de respuestas | No | Sí | ninguno | El gestor de colas que recibe una respuesta de WebSphere Process Server. |
Correlación de mensaje de respuesta | Sí | 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. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Validar | No | 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 | 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. |
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. |