Nodo RouteToLabel

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo RouteToLabel junto con uno o más nodos Label para determinar de forma dinámica la ruta que un mensaje sigue por el flujo de mensajes, en función de su contenido. El nodo RouteToLabel investiga en el entorno local del mensaje para determinar el identificador del nodo Label al que direccionar el mensaje.

Debe preceder el nodo RouteToLabel del flujo de mensajes con un nodo Compute que rellena el entorno local del mensaje con los identificadores de uno o más nodos Label que introducen la secuencia siguiente del proceso del mensaje. Los destinos se configuran como una lista de nombres de etiqueta en el árbol del entorno local en una ubicación específica. Este extracto de ESQL del ejemplo Airline (que se enlaza a continuación) proporciona un ejemplo de cómo configurar el contenido del entorno local en un nodo Compute:

IF InputRoot.XML.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 etiqueta pueden ser cualquier valor de serie de caracteres y pueden especificarse de forma explícita en el nodo Compute, extraídos o modificados por una transformación CAST de cualquier campo en el mensaje, o recuperados de una base de datos. Un nombre de etiqueta del entorno local debe coincidir con la propiedad Nombre de etiqueta del correspondiente nodo Label.

Al configurar el nodo Compute, también debe seleccionar un valor para la propiedad Modalidad de cálculo en la lista desplegable que incluye Entorno local.

Diseñe el flujo de mensajes de modo que un nodo RouteToLabel preceda de forma lógica a uno o más nodos Label dentro de un flujo de mensajes, pero que no esté unido físicamente con cables al nodo RouteToLabel con un nodo Label. La conexión la lleva a cabo el intermediario, cuando es necesario, de acuerdo con el contenido del entorno local.

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

Icono de nodo RouteToLabel

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente para ver cómo puede utilizar este nodo:

Configuración del nodo RouteToLabel

Después de transferir una instancia del nodo RouteToLabel a un flujo de mensajes, puede configurarla. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse 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 RouteToLabel como se describe a continuación:

  1. Establezca la Modalidad. Esto define cómo el nodo RouteToLabel elimina destinos del entorno local asociado con el mensaje. Puede establecer uno de los dos valores siguientes:
    • Direccionar a primero (first) elimina el primer el primer elemento del entorno local. El mensaje actual se direcciona al nodo Label identificado por labelName en el elemento de lista.
    • Direccionar a último (last) (el valor por omisión) elimina el último elemento del entorno local. El mensaje actual se direcciona al nodo Label identificado por labelName en el elemento de lista.
  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 RouteToLabel 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 RouteToLabel 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 si se detecta una anomalía durante el proceso.

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

Propiedad O C Valor por omisión Descripción
Modalidad No Direccionar a último (last) Cómo el nodo RouteToLabel procesa los elementos dentro del entorno local asociado con el mensaje actual

Las propiedades de descripción del nodo RouteToLabel 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
Árbol LocalEnvironment

Tareas relacionadas
Cómo decidir los nodos que utilizar
Creación de listas de destinos
Manejo de errores en flujos de mensajes
Utilización de nodos para la toma de decisiones

Referencia relacionada
Nodo Compute
Nodo FlowOrder
Nodo Label
Función CAST