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 Mapping

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:

Finalidad

Puede llenar los nuevos mensajes con los siguientes tipos de información:
  • Información nueva
  • Información modificada del mensaje de entrada
  • Información obtenida de una base de datos

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:

  • Crear un nuevo mensaje
  • Copiar mensajes entre analizadores
  • Transformar un mensaje de un formato a otro
El nodo Mapping da soporte a una alteración temporal de Entorno local para el script de correlación, lo que le permite seleccionar dinámicamente la correlación que se ejecutará. El nombre de correlación que se especifica en el mensaje de entrada se utiliza en lugar del establecido en el nodo Mapping. Por ejemplo:
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:

Icono de nodo Mapping

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo:

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.

Terminales y propiedades

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

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:00:56


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