Nodo RouteToLabel

Utilice el nodo RouteToLabel junto con uno o más nodos Label para determinar dinámicamente la ruta que toma un mensaje a través del flujo de mensajes, basándose en su contenido.

Este tema contiene las secciones siguientes:

Finalidad

El nodo RouteToLabel interroga el entorno local del mensaje para determinar el identificador del nodo Label al que desea dirigir el mensaje.

En el flujo de mensajes, coloque delante del nodo RouteToLabel un nodo Compute que rellene el entorno local del mensaje con los identificadores de uno o más nodos Label que presenten la siguiente secuencia de proceso del mensaje. Los destinos están definidos como una lista de nombres de etiquetas en el árbol de entorno local en una ubicación específica. Este extracto de ESQL del ejemplo de Reserva de vuelos muestra cómo configurar el contenido del entorno local en un nodo Compute:

IF InputRoot.XMLNSC.PassengerQuery.ReservationNumber<>'' THEN
   SET OutputLocalEnvironment.Destination.RouterList.DestinationData[1].labelname ='SinglePassenger';
ELSE
   SET OutputLocalEnvironment.Destination.RouterList.DestinationData[1].labelname ='AllReservations';
END IF;

Los nombres de etiquetas pueden ser cualquier valor de serie y pueden especificarse explícitamente en el nodo Compute, tomarse o transformarse a partir de cualquier campo del mensaje o recuperarse de una base de datos. Un nombre de etiqueta en el entorno local debe coincidir con la propiedad Nombre de etiqueta de un nodo Label correspondiente.

Cuando se configura el nodo Compute, también se ha de seleccionar un valor para la propiedad Modalidad de cálculo de la lista que incluye el entorno local.

Diseñe el flujo de mensajes de nodo que un nodo RouteToLabel preceda lógicamente a uno o más nodos Label dentro de un flujo de mensajes, pero no conecte físicamente el nodo RouteToLabel a un nodo Label. La conexión la efectúa el intermediario, cuando se requiere, según el contenido del entorno local.

El nodo RouteToLabel se encuentra en la bandeja Direccionamiento de la paleta y está representado en el entorno de trabajo mediante el siguiente icono:

Icono de nodo RouteToLabel

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente para ver cómo se debe utilizar este nodo: Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.

Terminales y propiedades

Cuando haya colocado una instancia del nodo RouteToLabel en un flujo de mensajes, podrá configurarlo; 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, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades. Todas las propiedades obligatorias para las que se debe entrar un valor están marcadas con un asterisco.

Los terminales del nodo RouteToLabel 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 dirige un mensaje si se ha detectado una anomalía durante su proceso.

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); 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 RouteToLabel están descritas en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo: RouteToLabel 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 RouteToLabel se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Modalidad No Direccionar a último Esta propiedad controla el modo en que el nodo RouteToLabel procesa los elementos dentro del Entorno local asociado al mensaje actual. Los valores válidos son:
  • Direccionar a primero: elimina el primer elemento del Entorno local. El mensaje actual se direcciona al nodo Label identificado por el nombre de etiqueta en ese elemento de la lista.
  • Direccionar a último (valor predeterminado): elimina el último elemento del Entorno local. El mensaje actual se direcciona al nodo Label identificado por el nombre de etiqueta en ese elemento de la lista.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:44

ac04820_