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 las secciones 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 tomada de una base de datos
Puede modificar elementos de los datos del cuerpo del mensaje, su entorno asociado y su lista de excepciones.

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:

  • Crear un nuevo mensaje
  • Copiar mensajes entre analizadores
  • Transformar un mensaje de un formato a otro

El nodo Mapping se encuentra en la bandeja Transformación de la paleta y está representado en el entorno de trabajo mediante el siguiente icono:

Icono de nodo Mapping

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente para ver cómo se debe utilizar este nodo:

Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.

Terminales y propiedades

Cuando haya colocado una instancia del nodo Mapping en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo en el diálogo Propiedades, pulse con el botón derecho del ratón sobre el nodo y pulse en Propiedades. (Si efectúa una doble pulsación en el nodo Mapping, se abrirá el recuadro de diálogo Nueva correlación de mensajes.) 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 produce el mensaje a continuación de la ejecución de las correlaciones.

Las tablas siguientes describen las propiedades de 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 O 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 el propósito del nodo en el flujo de mensajes.

Las propiedades básicas del nodo Mapping se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Origen de datos No   El nombre del origen de datos ODBC de la base de datos que contiene las tablas a las que se hace referencia en las correlaciones asociadas a este nodo (identificadas por la propiedad Módulo de correlación). Este nombre identifica la base de datos apropiada del sistema en el que se va a ejecutar el flujo de mensajes. El intermediario se conecta a esta base de datos con la información de ID de usuario y contraseña que ha especificado en el mandato mqsicreatebroker, mqsichangebroker o mqsisetdbparms.

z/OS platform En los sistemas z/OS, el intermediario utiliza el ID de tarea iniciada de intermediario o el ID de usuario y la contraseña que se han especificado en el JCL del mandato mqsisetdbparms, BIPSDBP en el conjunto de datos de personalización <hlq>.SBIPPROC.

Transacción No Automática La modalidad de transacción para el nodo. Los valores son los siguientes:
  • Automática (el valor predeterminado). 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.
  • Confirmar. Para confirmar acciones no confirmadas realizadas en este flujo de mensajes en la base de datos conectada a este nodo, independientemente del éxito o error del flujo de mensajes como un todo, seleccione Confirmar. Los cambios en la base de datos se confirman incluso si el flujo de mensajes no se ejecuta correctamente.
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 mensaje. 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.msgmap 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>.msgmap en la vista Desarrollo de intermediario.

Una rutina de correlación es específica del tipo de nodo al que está asociada; no se puede utilizar una rutina de correlación que ha desarrollado para un nodo Mapping con ningún otro nodo que utilice correlaciones (por ejemplo, un nodo DataInsert). 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 Desarrollo de correlaciones de mensajes.

Modalidad de correlación No Mensaje La modalidad que se utiliza para procesar información que se pasa a través del nodo Mapping. Los valores válidos son:
  • Mensaje (valor predeterminado): el mensaje se genera o se pasa a través a través del nodo Mapping, tal como se ha modificado dentro del nodo.
  • Entorno local: la estructura de árbol Entorno local se genera o pasa a través del nodo Mapping, tal como se ha modificado dentro del nodo.
  • Entorno local y mensaje: la estructura de árbol Entorno local y el mensaje se generan o se pasan a través del nodo Mapping, tal como se ha modificado dentro del nodo.
  • Excepción: la estructura de árbol Lista de excepciones se genera o se pasa a través del nodo Mapping, tal como se ha modificado dentro del nodo.
  • Excepción y mensaje: la estructura de árbol Lista de excepciones y el mensaje se generan o se pasan a través del nodo Mapping, tal como se ha modificado dentro del nodo.
  • Excepción y entorno local: las estructuras de árbol Lista de excepciones y Entorno local se generan o se pasan a través del nodo Mapping, tal como se ha modificado dentro del nodo.
  • Todo: el mensaje, Lista de excepciones y Entorno local se generan o se pasan a través del nodo Mapping, tal como se ha modificado dentro del nodo.

Debe establecer esta propiedad para que refleje correctamente el formato de mensaje de salida que requiere. Si selecciona una opción (o acepta el valor predeterminado) que no incluye un componente particular del mensaje, ese componente no se incluye en ningún mensaje de salida que se cree.

Puede utilizar cualquier combinación de los componentes Mensaje, Entorno local y Excepción para que los genere y modifique el nodo Mapping. Para crear una correlación que propague varios mensajes de destino, establezca esta propiedad en Entorno local y mensaje para asegurar que el nodo se ejecuta correctamente.

En algunas versiones anteriores, LocalEnvironment (entorno local) se denominaba DestinationList (lista de destinos); se conserva con fines de compatibilidad.

El componente Entorno del árbol de mensaje no queda afectado por el valor de modalidad. Su contenido, si lo hay, se pasa desde este nodo.

Tratar los avisos como errores No No seleccionado Para que los mensajes de aviso de base de datos se traten como errores y que el nodo propague el mensaje de salida al terminal de anomalías, seleccione Tratar los avisos como errores. Inicialmente, el recuadro está vacío.

Cuando selecciona el recuadro, el nodo gestiona todos los códigos de retorno positivos de la base de datos como errores y genera excepciones igual que si se tratase de errores negativos o más graves. Si no selecciona el recuadro, el nodo trata los avisos como códigos de retorno normales y no emite excepciones. El aviso más significativo es no encontrado que, en la mayoría de los casos, puede tratarse de forma segura como un código de retorno normal.

Generar excepción en error de base de datos No Seleccionado Para que el intermediario genere una excepción cuando se detecte un error de base de datos, seleccione Generar excepción en error de base de datos. Inicialmente, el recuadro está seleccionado. Si deselecciona el recuadro, deberá manejar el error en el flujo de mensajes para asegurarse de la integridad del intermediario y de la base de datos. El error se omite y si no lo maneja mediante su propio proceso, porque ha decidido no invocar el manejo de errores predeterminado mediante el intermediario. Por ejemplo, podría conectar el terminal de anomalías a una subrutina de proceso de errores.

En la tabla siguiente se describen las Opciones de análisis para el nodo Mapping.

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son A petición, Inmediato y Completo.

Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición.

La opción Temporización de análisis está establecida, de forma predeterminada en A petición, lo que hace que la validación se retrase hasta que se analice mediante el análisis parcial. Si cambia este valor por Inmediato, el análisis parcial se altera temporalmente y se analizan y validan todos los elementos de mensaje, excepto los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento. Si cambia este valor por Completo, el análisis parcial se altera temporalmente y se analiza y valida todo lo contenido en el mensaje; los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento producen una anomalía de validación.

Utilizar analizador compacto XMLNSC para dominio XMLNS No No No seleccionado Si selecciona este recuadro, la cabecera MQFH2 de salida especifica XMLNS en vez del analizador XMLNSC, lo que permite que una aplicación externa permanezca sin cambios. Si los mensajes de salida no contienen cabeceras MQRFH2, esta propiedad no tiene ningún efecto.
Retener contenido mixto No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje 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 comentarios No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje 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 instrucciones de proceso No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje 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.

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 O C Valor predeterminado Descripción
Validar No Ninguna Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguna, 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.
Incluir todas las limitaciones de valor No No Seleccionado Esta propiedad no se puede editar. Si el recuadro está seleccionado (valor predeterminado), en la validación se incluyen todas las limitaciones de valor.
Arreglo No No Ninguna Esta propiedad no se puede editar. Se proporciona un arreglo mínimo. Los valores válidos son Ninguna y Todos.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:42

ac04720_