Utilice el nodo Extract para extraer el contenido del mensaje de entrada que desea que procesen los nodos siguientes del flujo de mensajes.
Este tema contiene las secciones siguientes:
Utilizando el nodo Extract se puede crear un nuevo mensaje de entrada que contenga únicamente 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 está contenido en la bandeja Base de datos de la paleta y se representa en el entorno de trabajo con el siguiente icono:
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.
Por ejemplo, recibe pedidos de nuevos clientes y desea recopilar los nombres y direcciones para promociones futuras. 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.
Cuando haya colocado una instancia del nodo Extract en un flujo de mensajes, podrá configurarlo. Para ver más información, 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 Extract, se abre 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 Extract 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 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 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) y 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 Extract están descritas en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | Extract | 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 Extract se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Módulo de correlación | Sí | No | Extract | Nombre de la rutina de correlación que contiene las
sentencias a ejecutar en el árbol de mensaje. 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 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_Extract.msgmap para el primer nodo Extract en el flujo de mensajes MFlow1). No se puede especificar un valor que contenga espacios en blanco. Para trabajar con la rutina de correlación asociada a este nodo, 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 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. 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. |