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:
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 en 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 WebSphere Message Broker Toolkit mediante el siguiente icono:
Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.
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. 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 del 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 | Sí | No | Direccionar a último | Esta propiedad controla el modo en que el nodo
RouteToLabel procesa los elementos en el
Entorno local asociado al mensaje actual. Los valores válidos son:
|
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. |