Este tema contiene las secciones siguientes:
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:
El nodo Mapping se representa en el entorno de trabajo con el siguiente icono:
Examine el ejemplo siguiente para ver cómo se puede utilizar este nodo:
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:
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.
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.
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. |
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 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.
Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.
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.
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.
Pulse Cancelar para cerrar el diálogo y eliminar todos los cambios que ha efectuado en las 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 | Sí | 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 | Sí | No | Automática | La modalidad de transacción para el nodo. Los valores válidos son Automática o Confirmar. |
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 mensaje. La rutina es exclusiva de este tipo de nodo. |
Modalidad de correlación | Sí | No | Mensaje | Seleccione una de las opciones siguientes:
|
Tratar los avisos como errores | Sí | 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 | Sí | 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 | Sí | Sí | 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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | No seleccionado | No | ![]() ![]() |
Modalidad de retención de contenido mixto | Sí | 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 | Sí | 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 | Sí | 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. |