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:
O nó RouteToLabel interroga o LocalEnvironment 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 preenche o LocalEnvironment da mensagem com os identificadores de um ou mais nós Label que introduzem a próxima seqüência de processamento para a mensagem. Os destinos são configurados como uma lista de nomes de rótulos na árvore Ambiente Local em um local específico. Este fragmento de ESQL da amostra Airline Reservations demonstra como configurar o conteúdo de LocalEnvironment 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 LocalEnvironment 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 ligue fisicamente o nó RouteToLabel a um nó Label. A conexão é feita pelo intermediário, quando requerida, de acordo com o conteúdo do Ambiente Local.
O nó RouteToLabel está contido no repositório Roteamento da paleta e é representado no ambiente de trabalho pelo seguinte ícone:
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. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em 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 |
---|---|
In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Failure | 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 do 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 | Esta propriedade controla como o nó RouteToLabel
processa os itens no LocalEnvironment que está associado à
mensagem atual. Os valores
válidos são:
|