Utilice el nodo Mapping para crear uno o más mensajes nuevos y llenarlos con distintos tipos de información.
Este tema contiene los apartados siguientes:
La primera vez que abra o cree una correlación de mensajes para el nodo, si selecciona Esta correlación se invoca desde un nodo de flujo de mensajes y correlaciona propiedades y cuerpo del mensaje, las cabeceras del mensaje de entrada se copian siempre en el mensaje de salida sin modificarse. Para modificar las cabeceras de mensajes en un nodo Mapping, seleccione Esta correlación se invoca desde un nodo de flujo de mensajes y correlaciona propiedades, cabeceras y cuerpo del mensaje. Cuando selecciona esta propiedad, la correlación que se crea permite correlacionar elementos adicionales, incluidas las cabeceras WebSphere MQ, HTTP y JMS.
Estos componentes del mensaje de salida pueden definirse utilizando correlaciones basadas en elementos del mensaje de entrada y en datos de una base de datos externa. Las correlaciones asociadas a este nodo se crean en el archivo de correlación asociado a este nodo, correlacionando las entradas (mensaje o base de datos) con las salidas. Puede modificar las asignaciones realizadas por estas correlaciones utilizando las funciones y los procedimientos proporcionados o definidos por el usuario; por ejemplo, puede convertir un valor de Serie a mayúsculas cuando lo asigna al campo de salida del mensaje.
Utilice el nodo Mapping para:
El nodo Mapping se encuentra en la bandeja Transformación de la paleta y está representado en WebSphere Message Broker Toolkit mediante 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.
Cuando haya colocado una instancia del nodo Mapping en un flujo de mensajes, podrá configurarlo; consulte Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
Los terminales del nodo Mapping están descritos en la siguiente tabla.
| Terminal | Descripción |
|---|---|
| In (de entrada) | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
| Failure (de anomalías) | El terminal de salida al que se propaga el mensaje de entrada si se detecta una anomalía durante el cálculo. Si ha seleccionado Tratar los avisos como errores, el nodo propagará el mensaje a este terminal si se devuelven mensajes de aviso de base de datos, aunque el proceso se haya completado satisfactoriamente. |
| Out (de salida) | Terminal de salida que propaga el mensaje después de la ejecución de las correlaciones. |
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 Mapping están descritas en la siguiente tabla.
| 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 | Descripción breve del nodo. | |
| Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Las propiedades básicas del nodo Mapping se describen en la siguiente tabla.
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Transacción | Sí | No | Automática | La modalidad de transacción para el nodo. Los
valores son los siguientes:
|
|
| Rutina de correlación | Sí | No | Mapping | Nombre de la rutina de correlación que contiene las
sentencias que se tienen que ejecutar contra la base de datos o el árbol de mensajes.
De forma predeterminada,
el nombre asignado a la rutina de correlación es idéntico al nombre del
archivo de correlación en el que se define la rutina. El nombre predeterminado para
el archivo es el nombre del flujo de mensajes enlazado con el nombre del nodo cuando
lo incluye en el flujo de mensajes (por ejemplo,
MFlow1_Mapping.map para el primer nodo
Mapping en el flujo de mensajes MFlow1). No se puede especificar un valor
que contenga espacios en blanco. Si pulsa Examinar junto a este campo de entrada, se visualiza un diálogo que lista todas las rutinas de correlación disponibles a las que este nodo puede acceder. Seleccione la rutina que desee y pulse Aceptar; el nombre de la rutina se establece en Módulo de correlación. Para trabajar con la rutina de correlación asociada a este nodo, efectúe una doble pulsación en el nodo o pulse el botón derecho del ratón en el nodo y pulse Abrir correlaciones. Si la rutina de correlación no existe, se crea automáticamente con el nombre predeterminado en el archivo predeterminado. Si el archivo ya existe, también puede abrir el archivo <nombre_flujo>_<nombre_nodo>.map en la vista Desarrollo de intermediario. Si crea una rutina de correlación, no puede llamarla desde ninguna otra rutina de correlación, aunque puede llamarla desde una rutina ESQL. Para obtener más información sobre cómo trabajar con archivos de correlación y definir el contenido, consulte Utilización de correlaciones de datos gráficos. |
Las propiedades de validación del nodo Mapping se describen en la siguiente tabla.
Si un mensaje se propaga al terminal de anomalías del nodo, no se valida. Estas propiedades no hacen que se valide el mensaje de entrada. Se espera que, si se necesita dicha validación, el nodo de entrada o un nodo de validación anterior ya habrá realizado la validación. Si desea ver información más detallada sobre la validación de mensajes y las propiedades de validación, consulte Validar mensajes y Propiedades de validación.
| Propiedad | M | C | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Validar | No | Sí | Ninguno | Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar. |
| Acción para anomalía | No | No | Excepción | Esta propiedad controla qué sucede si falla una 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. |