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:
Puede modificar elementos de los datos del cuerpo del mensaje, el árbol de entorno local y la carpeta de propiedades.
El nodo Mapping pasa a través del árbol ExceptionList del mensaje de entrada sin modificar.
Cuando se crea una correlación de mensajes para el nodo, la correlación puede contener mensajes y tablas de base de datos como entradas y salidas. También se pueden correlacionar propiedades, y opcionalmente cabeceras (cabeceras WebSphere MQ, HTTP y JMS) y el Entorno local.
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:
SET OutputLocalEnvironment.Mapping.MappingRoutine =
'{http://www.ibm.com/mimapper}:mapper_po';
El nodo Mapping se encuentra en la bandeja Transformación de la paleta y está representado en el 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 muestran 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. El valor predeterminado es Automático. El flujo de mensajes, del cual forma parte el nodo Mapping, se confirma si es satisfactorio; es decir, se realizan las acciones que se han definido en las correlaciones y el mensaje continúa a través del flujo de mensajes. Si el flujo de mensajes da error, la acción se restituye. Si elige Automática, la posibilidad de confirmar o restituir la acción del nodo Mapping en la base de datos depende del éxito o el error de todo el flujo de mensajes. |
|
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 que se asigna a la rutina de correlación es: {esquema_intermediario_predeterminado}:nombre_archivo_correlación_predeterminado_sin_ninguna_extensión Donde esquema_intermediario_predeterminado es el esquema de intermediario en el que está ubicado el archivo de flujo de mensajes, y donde nombre_archivo_correlación_predeterminado_sin_ninguna_extensión es el nombre del flujo de mensajes, concatenado con el nombre del nodo de correlación. Por ejemplo, {su.esquema.intermediario}:nombreFlujo1_nombreNodo1. Tenga en cuenta que no puede especificar un valor que incluya espacios.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 la propiedad Rutina de correlación. Esta propiedad se puede alterar temporalmente de forma dinámica estableciendo una ruta de correlación en el entorno local. Consulte el apartado Seleccionar dinámicamente una correlación de datos gráfica. Para trabajar con la rutina de correlación que está 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 correlación. Si la rutina de correlación no existe, se abre el asistente Nueva correlación de mensajes, con algunos valores predeterminados especificados. Si la rutina de correlación ya existe, se abre en el editor de correlaciones gráficas. También puede abrir la rutina de correlación en la Vista Desarrollo de intermediario, y efectuar una doble pulsación en la misma para abrir la rutina en el editor de correlaciones gráficas. 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 Utilizar correlaciones de datos gráficas. |
Puede configurar las propiedades de Validación en un nodo Mapping para los mensajes de salida. Se actúa sobre estas propiedades cuando se serializa el mensaje, es decir, cuando el árbol lógico que representa el mensaje se formatea en el formato de corriente de bits física.
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.
Las propiedades de Validación del nodo Mapping se describen en la tabla siguiente:
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. |
Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.