Utilice el nodo SCAInput con el nodo SCAReply para procesar mensajes de WebSphere Process Server.
Si utiliza componentes de servicio en WebSphere Process Server, puede utilizar este nodo para iniciar un servicio proporcionado por WebSphere Message Broker. El flujo actúa como un punto final SCA para que lo utilice el componente de servicio a través de un enlace de importación.
El nodo SCAInput se representa en la bandeja SCA de la paleta de nodos de flujos de mensajes, y se representa en el WebSphere Message Broker Toolkit con 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 acceder a la operación a la que se está llamando en una solicitud de entrada en la siguiente ubicación, en el entorno local:
LocalEnvironment.SCA.Input.Operation
Puede acceder a la información de cabecera SOAP que está presente en una solicitud de entrada desde la siguiente ubicación, en el entorno local:
LocalEnvironment.SCA.Input.Binding.WebServices.SOAP.Header
También puede acceder a la información de contexto SOAP que está presente en una solicitud de entrada, en el entorno local. El contexto SOAP se almacena en la ubicación siguiente:
LocalEnvironment.SCA.Input.Binding.WebServices.SOAP.Context
Asegúrese de que el conjunto de mensajes contenga una definición SCA de intermediario con una extensión de .insca con la que se debe configurar el nodo SCAInput.
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.
Si especifica la propiedad Definición SCA de intermediario escribiendo un nombre de archivo o seleccionando una definición SCA de intermediario utilizando el recurso Examinar, en un nodo SCAInput que ya tenga configurados terminales dinámicos, los terminales dinámicos existentes se sustituirán. Si especifica un nombre de archivo que no sea válido, los terminales dinámicos existentes anteriormente eliminan y no se añaden terminales.
Si arrastra una definición SCA de intermediario en un nodo SCAInput que ya tiene terminales dinámicos configurados, aparece un recuadro de diálogo que le permite confirmar si desea alterar temporalmente los terminales dinámicos existentes con terminales dinámicos que se podrían generar a partir de la definición SCA de intermediario. Si elige alterar temporalmente los terminales dinámicos existente, las conexiones existentes que están configuradas para estos terminales también se suprimirán. Puede especificar que este recuadro de diálogo no se visualice de nuevo.
Si arrastra una definición SCA de intermediario en un nodo SCAInput que ya tiene un terminal de salida, no se añadirán terminales dinámicos generados a partir de la definición SCA de intermediario y el nodo sigue funcionando con su terminal de salida.
La tabla siguiente describe los terminales del nodo SCAInput.
Terminal | Descripción |
---|---|
Anomalía | El terminal de salida al cual se propaga el mensaje recibido cuando se detecta una anomalía (como por ejemplo una anomalía de validación de mensaje). |
Salida | El terminal de salida al cual se direcciona el mensaje si ha seleccionado Direccionar a un terminal de salida común en la propiedad Direccionamiento de mensajes. |
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. |
* (dinámico) | (Aplicable sólo cuando el Tipo de enlace es Servicios web.) Se genera un terminal dinámico para cada operación que recibe soporte del tipo de puerto y que implementa el enlace importado. La operación de terminal dinámico al que se direcciona el mensaje SCA depende de la operación que se define en el mensaje SCA cuando éste se recibe. |
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).
La tabla siguiente describe las propiedades de descripción del nodo SCAInput.
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. |
La tabla siguiente describe las propiedades básicas del nodo SCAInput.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Definición SCA de intermediario | Sí | No | <Ninguna> | Esta propiedad es de tipo Serie. El nombre de la definición SCA de intermediario que contiene las propiedades de configuración para el nodo SCAInput. |
Direccionamiento de mensajes | Sí | No | Direccionar cada operación a su propio terminal | Esta propiedad determina si se va a utilizar un terminal de salida común, o si cada operación se direcciona a su propio terminal.
|
La tabla siguiente describe las propiedades de enlace del nodo SCAInput; el enlace que se encuentra en la definición SCA de intermediario se define aquí.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Tipo de enlace | Sí | No | Deriva de la definición SCA de intermediario | Esta propiedad es de tipo Serie. El valor deriva del intermediario de definición SCA. |
La tabla siguiente describe las propiedades del servicio web del nodo SCAInput. Estas propiedades sólo son relevantes si Tipo de enlace es servicios web.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de archivo WSDL | Sí | No | <Ninguna> | Esta propiedad es de tipo Serie. Se da un valor a esta propiedad cuando se analiza el archivo de configuración WSDL. |
Espacio de nombres de destino | No | No | Deriva de la definición SCA de intermediario | Esta propiedad es de tipo Serie. Espacio de nombres de destino muestra el espacio de nombres del archivo WSDL seleccionado. |
Tipo de puerto | Sí | No | El valor predeterminado es el tipo de puerto de la definición SCA de intermediario. | Esta propiedad es de tipo Serie. Esta propiedad es de sólo lectura. Condiciones de error:
|
Enlace importado | Sí | No | Deriva de la definición SCA de intermediario. | Esta propiedad es de tipo Serie. El recuadro Enlace importado lista todos los enlaces SOAP asociados con el tipo de puerto seleccionado. Los enlaces se listan en el orden en el que se visualizan en el archivo
WSDL.
De forma predeterminada, se selecciona el primer enlace al cual apunta el puerto en la definición SCA de intermediario. Esta propiedad se actualiza cada vez que cambia el valor Tipo de puerto y se visualiza un mensaje de información que indica que se deben realizar los cambios correspondientes en el sistema WebSphere Process
Server. Condiciones de error:
|
Puerto de servicio | Sí | No | Deriva de la definición SCA de intermediario | Esta propiedad es de tipo Serie. El recuadro Puerto de servicio lista todos los puertos de servicio que apuntan al enlace seleccionado. El puerto de servicio al que se hace referencia en la definición SCA de intermediario se selecciona de forma predeterminada. Esta propiedad se actualiza cada vez que cambia el valor de enlace seleccionado y aparece un mensaje de información que indica que los cambios correspondientes deben realizarse en el sistema WebSphere Process
Server. Condiciones de error:
|
Selector de URL | Sí | Sí | Deriva de la definición SCA de intermediario | Esta propiedad es de tipo Serie. Selector de URL es el selector de la vía de acceso HTTP en el que el nodo acepta mensajes de entrada. |
Utilizar HTTPS | No | Sí | Deriva de la definición SCA de intermediario | Esta propiedad es de tipo Booleano. Su valor es True si la ubicación de HTTP es un HTTPS; de lo contrario, su valor será False. |
Propagar sólo el cuerpo SOAP | No | No | True | Esta propiedad es de tipo Booleano. Marque el recuadro de selección sólo si el cuerpo del mensaje SOAP se debe propagar. |
Utilizar WS-Addressing | No | No | False | Esta propiedad es de tipo Booleano. Marque el recuadro de selección si se debe utilizar WS-Addressing. |
La tabla siguiente describe las propiedades de MQ del nodo SCAInput. Estas propiedades sólo son relevantes si el Tipo de enlace es MQ.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de cola | Sí | Sí | Deriva de la definición SCA de intermediario | Esta propiedad es de tipo Serie. El valor de esta propiedad se puede cambiar directamente en el nodo. Si se cambia la propiedad, aparecerá un mensaje de información que indica que se deben realizar los cambios correspondientes en el sistema WebSphere Process Server. |
En la tabla siguiente se describen las propiedades de Análisis de mensajes de entrada del nodo SCAInput.
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 entrada. El dominio se determina según el tipo de 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. En esta tabla se describen las propiedades de Análisis de mensaje de entrada para el dominio DFDL. Puede encontrar descripciones de las propiedades de Análisis de mensaje de entrada para otros dominios en una tabla anterior de este tema. |
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 entrada. Esta lista se llena con todos los archivos de modelos de mensaje. No puede cambiar esta propiedad si el Tipo de enlace es Servicios web. |
Mensaje | No | No | Se toma automáticamente según la definición SCA de intermediario que se ha elegido en el nodo correspondiente. | El nombre o ubicación de un elemento global que modela un documento de datos entero y está incluido en su archivo de esquema de modelo de mensaje. Esta lista se llena con todos los mensajes disponibles que se han definido en el Modelo de mensaje que ha seleccionado. |
Formato físico | No | No | Nombre del formato físico del mensaje de entrada. 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. |
La tabla siguiente describe las propiedades de Opciones de análisis del nodo SCAInput.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | No | No | A solicitud | Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son A solicitud, Inmediato
y Completo. Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición. |
Creación del árbol utilizando tipos de datos del esquema XML | No | No | Seleccionado | Esta propiedad controla si los elementos de la sintaxis del árbol de mensajes toman los tipos de datos del esquema XML. |
Retener el contenido mixto | No | No | Borrado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra texto mixto en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento. |
Retener los comentarios | No | No | Borrado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra comentarios en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento. |
Retener las instrucciones de proceso | No | No | Borrado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra instrucciones de proceso en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento. |
Elementos opacos | No | No | Espacio en blanco | Esta propiedad se utiliza para especificar una lista de elementos en el mensaje de entrada 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. |
La tabla siguiente describe las propiedades de validación del nodo SCAInput. Para ver más información, consulte el apartado Propiedades de validación.
Propiedad | M | 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. |
Las propiedades de seguridad del nodo se describen en la tabla siguiente. Establezca los valores para estas propiedades con el fin de controlar la extracción de una identidad de un mensaje (cuando un perfil de seguridad se asocia al nodo). Para obtener más información sobre estas propiedades, consulte Identidad, Configuración de la extracción de una identidad o una señal de seguridad, Visión general de la seguridad de flujo de mensajes y Configuración de la seguridad de flujo de mensajes.
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 esta propiedad no se especifica, la identidad se recupera de la cabeceras de transporte Basic-Auth y el tipo se establece en Username. |
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. |
La tabla siguiente describe las propiedades de Instancias del nodo SCAInput.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Agrupación de instancias adicionales | No | Sí | Utilizar agrupación asociada al flujo de mensajes | 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 Utilizar agrupación asociada al nodo. De forma predeterminada, no se otorga ninguna instancia adicional al nodo. |
La tabla siguiente describe las propiedades de reintento del nodo SCAInput.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Mecanismo de reintento | No | No | Anomalía | Esta propiedad especifica cómo se maneja el proceso de reintento cuando se retrotrae una anomalía al nodo SCAInput.
|
Umbral de reintentos | No | Sí | 0 | El número máximo de veces que se lleva a cabo el proceso de reintento para el reintento corto. |
Intervalo de reintento corto | No | Sí | 0 | El intervalo entre reintentos cortos. |
Intervalo de reintento largo | No | Sí | 0 | El intervalo entre reintentos largos. |
La propiedad de Transaccionalidad del nodo SCAInput 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'. |
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. |