Nodo Extract

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo Extract para extraer el contenido del mensaje de entrada que desea que procesen nodos posteriores en el flujo de mensajes. Con el nodo Extract, puede crear un nuevo mensaje de salida que contiene sólo un subconjunto del contenido del mensaje de entrada. El mensaje de salida sólo contiene los elementos del mensaje de entrada cuya inclusión se especifica al configurar el nodo Extract, al definir las sentencias de correlación.

El nodo Extract se representa en el área de trabajo por el icono siguiente:

Icono de nodo Extract

Utilización de este nodo en un flujo de mensajes

Este nodo puede ser útil si sólo requiere un subconjunto del mensaje después del proceso inicial de todo el mensaje. Por ejemplo, es posible que desee almacenar todo el mensaje para fines de auditoría (en el nodo Warehouse), pero sólo propagar una pequeña parte del mensaje (por ejemplo, información de pedidos) para procesarlo más adelante.

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

Configuración del nodo Extract

Después de transferir una instancia del nodo Extract a un flujo de mensajes, puede configurarla. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione Propiedades. Se visualizan las propiedades básicas de nodo.

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

Configure el nodo Extract como se describe a continuación:

  1. En Módulo de correlación, identifique la rutina de correlación asociada que se va a ejecutar en este nodo. Por omisión, el nombre asignado a la rutina de correlación es idéntico al nombre del archivo de correlaciones en el que se define. El nombre por omisión del archivo es el nombre del flujo de mensajes concatenado con el nombre del nodo cuando se incluye en el flujo de mensajes (por ejemplo, MFlow1_Extract.mfmap para el primer nodo Extract en el flujo de mensajes MFlow1). No puede especificar un valor que incluye espacios.

    Si pulsa Examinar junto a este campo de entrada, aparece un diálogo que muestra todas las rutinas de correlación disponibles a las que este nodo puede acceder. Seleccione la rutina que desea y pulse Aceptar. El nombre de rutina se establece enMódulo de correlación.

    Para trabajar con la rutina de correlación asociada con 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 de Navegador.

    Una rutina de correlación es específica al tipo de nodo al que está asociada; no puede utilizar una rutina de correlación desarrollada para un nodo Extract en ningún otro nodo que utilice correlaciones (por ejemplo, un nodo DataInsert). Si ha creado una rutina de correlación, no puede llamarla desde ninguna otra rutina, aunque sí puede llamarla desde una rutina de ESQL.

  2. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción breve, una descripción larga o ambas.
  3. Pulse Aplicar para realizar 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 descartar todos los cambios realizados en las propiedades.

Terminales y propiedades

Los terminales de nodo Extract se describen en la tabla siguiente.

Terminal Descripción
Terminal de entrada Terminal de entrada que acepta un mensaje para que el nodo lo procese.
Terminal de anomalías Terminal de salida al que se direcciona el mensaje de entrada si se detecta una anomalía durante la extracción.
Terminal de salida Terminal de salida al que se direcciona el mensaje transformado si se procesa correctamente el mensaje de entrada.

En las siguientes tablas se 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 se debe entrar un valor cuando no se ha definido ningún valor por omisión), la columna con la cabecera C indica si la propiedad es configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para difundirlo).

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 van a ejecutar contra el árbol de mensajes. La rutina es exclusiva a 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   Breve descripción del nodo.
Descripción larga No No   Texto que describe la utilidad del nodo en el flujo de mensajes.

Conceptos relacionados
Flujos de mensajes
Flujos de mensajes, correlaciones y ESQL

Tareas relacionadas
Cómo decidir los nodos que utilizar
Configuración de flujos de mensajes coordinados
Manejo de errores en flujos de mensajes
Desarrollo de correlaciones

Referencia relacionada
Nodo Database
Nodo DataInsert
Nodo Mapping