WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

RouteToLabel

Utilize o nó RouteToLabel juntamente com um ou mais nós Label para determinar dinamicamente a rota a ser seguida por uma mensagem pelo fluxo de mensagens, com base em seu conteúdo.

Este tópico contém as seguintes seções:

Finalidade

O nó RouteToLabel interroga o ambiente local da mensagem para determinar o identificador do nó Label para o qual rotear a mensagem.

Você deve preceder o nó RouteToLabel no fluxo de mensagens com um nó Compute que preencha o ambiente local da mensagem com os identificadores de um ou mais nós Label que introduzam à próxima sequência para a mensagem. Os destinos são configurados como uma lista de nomes de rótulos na árvore do ambiente local em um local específico. Esse extrato do ESQL da amostra Airline Reservations demonstra como configurar o conteúdo do ambiente local em um nó 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;

Os nomes de rótulos podem ser qualquer valor de cadeia e podem ser especificados explicitamente no nó Compute, obtido ou convertido de qualquer campo na mensagem ou recuperado de um banco de dados. Um nome de rótulo no ambiente local deve corresponder à propriedade Nome do Rótulo de um nó Label correspondente.

Quando configurar o nó Compute, você também deve selecionar um valor para a propriedade Modo de Cálculo da lista que inclui LocalEnvironment.

Projete seu fluxo de mensagens para que um nóRouteToLabel preceda logicamente um ou mais nós Label em um fluxo de mensagens, mas não conecte fisicamente o nó RouteToLabel com um nóLabel. A conexão é feita pelo broker, quando necessário, de acordo com o conteúdo do ambiente local.

O nó RouteToLabel está contido no repositório Roteamento da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

 Ícone do Nó RouteToLabel

Utilizando este nó em um fluxo de mensagens

Examine a amostra a seguir para ver como utilizar esse nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Terminais e Propriedades

Quando tiver colocado uma instância do nó RouteToLabel em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais você deve inserir um valor são marcadas com um asterisco.

Os terminais do nó RouteToLabel são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem será roteada se for detectado um defeito durante o processamento.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó RouteToLabel são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome de nó Não Não O tipo de nó: RouteToLabel O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó RouteToLabel são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Modo Sim Não Rotear para o Último Essa propriedade controla como o nó RouteToLabel processa os itens no ambiente local que está associado com a mensagem atual. Os valores válidos são:
  • Rotear para o Primeiro: remove o primeiro item do ambiente local. A mensagem atual é roteada para o nó Label identificado por labelName nesse item da lista.
  • Rotear para o Último (o padrão): remove o último item do ambiente local. A mensagem atual é roteada para o nó Label identificado por labelName nesse item da lista.
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:19


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04820_