Nodo Extract

Este tema contiene las secciones siguientes:

Finalidad

Utilice el nodo Extract para extraer el contenido del mensaje de entrada que desea que procesen los nodos siguientes del flujo de mensajes. Utilizando el nodo Extract, puede crear un nuevo mensaje de salida que contenga solamente un subconjunto del contenido del mensaje de entrada. El mensaje de salida sólo contiene los elementos de entrada que especifique para inclusión al configurar el nodo Extract, definiendo sentencias de correlación.

El nodo Extract se representa en el entorno de trabajo con el siguiente icono:

Icono de nodo Extract

Utilización de este nodo en un flujo de mensajes

Este nodo es de gran utilidad cuando se requiere solamente un subconjunto del mensaje después del proceso inicial de todo el mensaje. Por ejemplo, es posible que desee almacenar el mensaje completo a efectos de comprobación (en el nodo Warehouse), pero sólo propagar una pequeña parte del mensaje (quizás, información sobre el pedido) para su proceso adicional.

Recibe pedidos de nuevos clientes y desea recopilar los nombres y direcciones para promociones futuras. Para ello, utilice el nodo Extract para obtener esta información de cada pedido y enviarla como un nuevo mensaje a la oficina central. Estos mensajes se procesan en la oficina central de forma que los detalles de los clientes se puedan procesar en la siguiente campaña de marketing.

Configuración del nodo Extract

Cuando haya transferido una instancia del nodo Extract a un flujo de mensajes, podrá configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione 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 Extract de la manera siguiente:

  1. En Módulo de correlación, identifique la rutina de correlación asociada que debe ejecutarse 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_Extract.mfmap para el primer nodo Extract 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 el nodo Extract 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.

  2. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  3. Pulse Aplicar para efectuar los cambios en el nodo Extract 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 Extract 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 direcciona el mensaje de entrada si se detecta una anomalía durante la extracción.
Out (de salida) El terminal de salida al que se direcciona el mensaje transformado si el mensaje de entrada se procesa satisfactoriamente.

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 Extract se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Módulo de correlación No Extract Nombre de la rutina de correlación que contiene las sentencias que se tienen que ejecutar contra el árbol de mensaje. La rutina es exclusiva de este tipo de nodo.

Las propiedades de descripción del nodo Extract 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
ac04710_