WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo Extract

Utilice el nodo Extract para extraer el contenido del mensaje de entrada que desea que procesen los nodos siguientes del flujo de mensajes.

Restricción: Las funciones proporcionadas por este nodo han sido sustituidas por un Nodo Mapping revisado. Si importa un flujo de mensajes que contiene el nodo Extract, puede seguir viendo y desplegando el nodo pero no puede modificarlo.

Este tema contiene las secciones siguientes:

Finalidad

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.

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.

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.

Terminales y propiedades

Cuando haya colocado una instancia del nodo Extract en un flujo de mensajes, podrá configurarlo. Para obtener más información, consulte Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista 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 No Extract Nombre de la rutina de correlación que contiene las sentencias a ejecutar en el árbol de mensajes.

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 Utilizar correlaciones de datos gráficas.

Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:20


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac04710_