Nodo Mapping

Este tema contiene las secciones siguientes:

Finalidad

Utilice el nodo Mapping para crear uno o más mensajes nuevos y colocar en ellos información nueva, información modificada del mensaje de entrada o 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 especifica la opción 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.

Si desea modificar las cabeceras de mensajes en un nodo Mapping, debe seleccionar la opción Esta correlación se invoca desde un nodo de flujo de mensajes y correlaciona propiedades, cabeceras y cuerpo del mensaje. Al hacer esto, la correlación que se crea permite correlacionar elementos adicionales, incluidas las cabeceras 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. Opcionalmente, 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 de caracteres a mayúsculas cuando lo asigna al campo del mensaje de salida.

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 representa en el entorno de trabajo con el siguiente icono:

Icono de nodo Mapping

Utilización de este nodo en un flujo de mensajes

Examine el ejemplo siguiente para ver cómo se puede utilizar este nodo:

Configuración del nodo Mapping

Una vez ha puesto una instancia del nodo Mapping en un flujo de mensajes, puede configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Aparecen las propiedades básicas del nodo.

Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.

Configure el nodo Mapping de la manera siguiente:

  1. En Origen de datos, especifique el nombre por el que se conoce la base de datos correspondiente en el sistema en el que va a ejecutarse este 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.

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

  2. Seleccione el valor Transacción en el menú desplegable. Los valores son los siguientes:
    • Automática (el valor por omisión). El flujo de mensajes, del que forma parte el nodo Mapping, se confirma si la operación es satisfactoria. 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. Si desea 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.
  3. En Rutina de correlación, identifique la rutina de correlación que se debe ejecutar en este nodo. Por omisión, 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 por omisión 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.mfmap 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 al lado de este campo de entrada, aparece un diálogo que lista todas las rutinas de correlación disponibles a las que puede acceder este nodo. 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, pulse el botón derecho del ratón en el nodo y seleccione Abrir correlaciones. Si la rutina de correlación no existe, se crea automáticamente con el nombre por omisión en el archivo por omisión. Si el archivo ya existe, también puede abrir el archivo <nombre_flujo>_<nombre_nodo>.mfmap en la vista Navegador.

    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.

  4. En Modalidad de correlación, especifique la modalidad que desea utilizar para procesar la información que se pasa a través del nodo Mapping. Puede utilizar cualquier combinación de los componentes Mensaje, Entorno local y Excepción para que los genere y modifique el nodo Mapping.

    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 por omisión) que no incluye un componente particular del mensaje, ese componente no se incluye en ningún mensaje de salida que se cree.

    (En releases anteriores a la versión 2.1, el entorno asociado (Entorno local) se denominaba Lista de destinos. Lista de destinos es un término válido y puede utilizarse con fines de compatibilidad.)

    (El establecimiento de la modalidad no afecta al componente Entorno del árbol de mensaje. Su contenido, si lo hay, se pasa desde este nodo.)

    Las opciones están explicadas en la tabla siguiente.

    Modalidad Descripción
    Mensaje (valor por omisión) El mensaje lo genera o lo pasa el nodo Mapping tal como se modifica dentro del nodo.
    Entorno local El nodo Mapping genera y distribuye la estructura en árbol del entorno local tal como se modifica dentro del nodo.
    Entorno local y mensaje El nodo Mapping genera o pasa la estructura en árbol del entorno local y el mensaje tal como lo modifica el nodo.
    Excepción El nodo Mapping genera o pasa la Lista de excepciones tal como la modifica.
    Excepción y mensaje El nodo Mapping genera o pasa la Lista de excepciones y el mensaje tal como los modifica.
    Excepción y entorno local El nodo Mapping genera o pasa la Lista de excepciones y la estructura en árbol del entorno local tal como las modifica.
    Todo El nodo Mapping genera o pasa el mensaje, la Lista de excepciones y el entorno local tal como los modifica.
  5. Seleccione Básico en el navegador del diálogo de propiedades y seleccione o deseleccione los dos recuadros:
    • Si desea que los mensajes de aviso de base de datos se traten como errores y desea que el nodo propague el mensaje de salida al terminal de anomalías, seleccione el recuadro de selección Tratar los avisos como errores. Inicialmente, el recuadro no está seleccionado.

      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.

    • Si desea que el intermediario genere una excepción cuando se detecte un error de base de datos, seleccione el recuadro de selección Generar excepción en error de base de datos. Inicialmente, el recuadro está seleccionado.

      Si deselecciona el recuadro, deberá gestionarlo en el flujo de mensajes para asegurarse de la integridad del intermediario y de la base de datos: el error se ignora si no lo gestiona a través de su propio proceso, debido a que ha decidido no invocar el manejo de errores por omisión mediante el intermediario. Por ejemplo, podría conectar el terminal de anomalías a una subrutina de proceso de errores.

  6. Seleccione Validación en el navegador del diálogo de propiedades si desea que el analizador MRM valide el cuerpo de los mensajes contra el diccionario generado del conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

    Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.

  7. Seleccione Opciones de mensajes generales en el navegador del diálogo de propiedades. Temporización del análisis se establece por omisión en A petición. Esto hace que la validación se retarde hasta que se analiza mediante el análisis parcial. Si cambia este valor a 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 lo cambia por Completo, el análisis parcial se altera y se analizan y validan todos los elementos del 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.

    Seleccione el recuadro de selección Utilizar analizador compacto MQRFH2C para dominio MQRFH2 si desea que se utilice el analizador compacto MQRFH2C en lugar del analizador MQRFH2 para las cabeceras MQRFH2.

  8. Seleccione las opciones de XMLNSCparser en el navegador de diálogo de propiedades y seleccione el recuadro de selección Utilizar analizador compacto XMLNSC para dominio XMLNS si desea utilizar el analizador XMLNSC para los mensajes en el dominio XMLNS.

    Otras propiedades controlan si se utiliza el analizador XMLNSC para el texto mixto, los comentarios y las instrucciones de proceso en el mensaje de entrada.

  9. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  10. Pulse Aplicar para efectuar los cambios en el nodo Mapping sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y eliminar todos los cambios que ha efectuado en las propiedades.

Terminales y propiedades

Los terminales del nodo Mapping se describen 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 del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), 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 básicas del nodo Mapping se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Origen de datos No   El nombre del origen de datos ODBC de la base de datos en la que residen las tablas a las que se hace referencia en las correlaciones asociadas a este nodo (identificadas por la propiedad Módulo de correlación).
Transacción No Automática La modalidad de transacción para el nodo. Los valores válidos son Automática o Confirmar.
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. La rutina es exclusiva de este tipo de nodo.
Modalidad de correlación No Mensaje Seleccione una de las opciones siguientes:
  • Mensaje
  • Entorno local
  • Entorno local y mensaje
  • Excepción
  • Excepción y mensaje
  • Excepción y entorno local
  • Todo
Si desea construir una correlación que propague varios mensajes de destino, establezca esta propiedad en Entorno local y Mensaje para asegurar que el nodo se ejecute correctamente.
Tratar los avisos como errores No No seleccionado Tratar los avisos SQL de base de datos como errores. Si selecciona el recuadro, se realizará esta acción.
Generar excepción en error de la base de datos No Seleccionado Los errores de la base de datos hacen que el intermediario genere una excepción. Si selecciona el recuadro, se realizará esta acción.

En la tabla siguiente se describen las propiedades de validación del nodo Mapping.

Propiedad O C Valor por omisión Descripción
Validar Ninguno Determina si se realiza la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar.
Acción para anomalía No Excepción Determina qué sucede si se produce un error de validación. Sólo puede establecer esta propiedad si Validar se establece 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 Seleccionado Esta propiedad no se puede editar. La acción por omisión, indicada por el recuadro seleccionado, es que en la validación se incluyen todas las limitaciones de valor.
Arreglo No Ninguno Esta propiedad no se puede editar. Se proporciona un arreglo mínimo. Los valores válidos son Ninguno y Todos.

Las propiedades de las Opciones de mensajes generales para el nodo Mapping se describen en la tabla siguiente:

Propiedad O C Valor por omisión Descripción
Temporización del análisis 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.

Consulte Análisis a petición para obtener una descripción completa de esta propiedad.

Utilizar analizador compacto MQRFH2C para dominio MQRFH2 No No Falso Esta propiedad controla si se utiliza el Analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2.

En la tabla siguiente se describen las opciones de analizador XMLNSC para el nodo Mapping.

Propiedad O C Valor por omisión Descripción
Utilizar analizador compacto XMLNSC para dominio XMLNS No seleccionado No Inicio del cambioEstablecer esta propiedad hace que la cabecera MQRFH2 del mensaje de salida especifique el analizador XMLNS en lugar del 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.Fin del cambio
Modalidad de retención de contenido mixto No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra texto mixto en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para el texto mixto. Si se selecciona Ninguno, significa que el texto mixto se ignora y no se crea ningún elemento.
Modalidad de retención de comentarios No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra comentarios en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para los comentarios. Si se selecciona Ninguno, significa que se ignoran los comentarios y no se crean elementos.
Modalidad de retención de instrucciones de proceso No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra instrucciones de proceso en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para las instrucciones de proceso. Si se selecciona Ninguno, significa que se ignoran las instrucciones de proceso y no se crean elementos.

Las propiedades de descripción del nodo Mapping se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
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.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ac04720_