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

RegistryLookup

Use o nó RegistryLookup para recuperar qualquer tipo de entidade mantida no WebSphere Service Registry and Repository (WSRR). As entidades que correspondem aos critérios de procura especificados são armazenadas no ambiente local. A mensagem de entrada não é modificada.

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

Propósito

O nó RegistryLookup recupera qualquer tipo de entidade mantida no WSRR.

Os dados são recuperados de acordo com os critérios de procura definidos pelas propriedades do nó, possivelmente suplementados ou substituídos pelas definições de ambiente local no tempo de execução; consulte Substituições do Ambiente Local para obter mais detalhes.

Os dados recuperados são colocados na árvore de ambiente local, tornando-os disponíveis nos nós subsequentes. A mensagem de entrada recebida pelo nó é propagada ao terminal de saída inalterada.

Processamento do Nó RegistryLookup

O nó RegistryLookup está contido no repositório de Serviços da Web da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó RegistryLookup
Quando o nó RegistryLookup recebe uma mensagem, as etapas seguintes ocorrem em sequência.
  1. O nó RegistryLookup recupera os dados do WSRR usando os critérios de procura especificados.
  2. Se uma ou mais correspondências forem localizadas, o nó RegistryLookup incluirá uma representação dessas entidades na árvore de ambiente local.
    • Se a Política de Correspondência estiver configurada como Um, uma única entidade será retornada pelo WSRR e incluída na árvore de ambiente local. Se o registro contiver mais de uma entidade que corresponda aos critérios de procura especificados, não será possível determinar qual será retornada pelo WSRR. Uma diferente pode ser retornada toda vez que a consulta for emitida.
    • Se a Política de Correspondência for configurada como Todos, todas as entidades correspondentes serão incluídas na árvore de ambiente local. A ordem das entidades é determinada pelo WSRR e pode variar entre as consultas.

    A mensagem de entrada é propagada inalterada para o terminal de Saída. A árvore de ambiente local é propagada ao terminal de Saída, onde ela fica disponível para processamento adicional por nós de transformação. A representação exata de uma entidade na árvore de ambiente local depende da propriedade Política de Profundidade. Consulte Saída do Nó RegistryLookup para obter detalhes da árvore de saída de ambiente local.

    Inclua um nó de cálculo em seu fluxo de mensagens para interpretar e agir nos dados retornados. Por exemplo, se a árvore de ambiente local contiver múltiplos endereços de terminal para uso por nós de pedido subsequentes, o nó Computar deverá selecionar o endereço necessário e configurar quaisquer cabeçalhos de transporte ou configurações do ambiente local necessárias para esses nós de pedido.

  3. Se nenhuma correspondência for localizada, o nó RegistryLookup propaga a mensagem de entrada para o terminal NoMatch.
  4. Se ocorrer um erro de processamento, por exemplo se o servidor WSRR configurado no objeto do serviço configurável DefaultWSRR não puder ser conectado, ou o tempo de conexão se esgotar, o nó RegistryLookup propagará a mensagem de entrada inalterada para o terminal de Falha. A ExceptionList é preenchida com detalhes do erro.

Substituições do Ambiente Local

É possível substituir as propriedades do nó RegistryLookup usando as configurações do ambiente local. Consulte o Definindo Dinamicamente os Critérios de Procura.

Terminais e Propriedades

Quando tiver colocado uma instância do nó RegistryLookup 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.

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

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem é roteada se um erro ocorrer no processamento do nó.
Saída O terminal de saída para o qual a mensagem de entrada não-modificada e o ambiente local atualizado contendo os dados de registro correspondidos são enviados.
NoMatch O terminal para o qual a mensagem de entrada é enviada se nenhuma entidade de correspondência for localizada com base nos critérios de procura especificados.

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ó RegistryLookup são descritas na tabela a seguir.

Propriedade M P Padrão Descrição
Nome do Nó Não Não O tipo de nó (RegistryLookup) O nome do nó
Short description Não Não Nenhum Uma descrição breve do nó
Descrição Longa Não Não Nenhum Texto que descreve a finalidade do nó no fluxo de mensagens

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

Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Nome Não Sim Nenhum Insira os valores de cadeia para um ou mais de Nome, Espaço de Nomes e Versão para as entidades ou artefatos que você deseja recuperar do WSRR.

Pelo menos uma das propriedades é necessária. Se você deixar todos os três valores de propriedade em branco, obterá uma mensagem de erro ao tentar salvar.

nome
Espaço de Nomes Não Sim Nenhum espaço de nomes
Versão Não Sim Nenhum serviceVersion
Propriedades do Usuário Não Não Nenhum Permite que uma consulta especifique propriedades definidas pelo usuário. Inclua Propriedades do Usuário clicando em Incluir. Propriedades de Usuário se referem às Propriedades Adicionais que são usadas para catalogar as entidades no WSRR. Insira valores para Nome da Propriedade, que é a correspondência de letras maiúsculas e minúsculas da propriedade adicional no WSRR, Tipo de Propriedade e Valor da Propriedade. O Tipo de Propriedade pode ser:
  • uma Cadeia (o padrão), nesse caso o Valor da Propriedade é uma cadeia de caracteres a ser correspondida com o valor da propriedade adicional presente no WSRR
  • XPATH, ou ESQL, nesse caso o Valor da Propriedade é uma expressão XPath ou ESQL que localiza um campo na árvore de mensagens que contém a cadeia de caracteres a ser correspondida com o valor da propriedade presente no WSRR.
 
Classificação Não Não Nenhum

A propriedade de sistema de classificação de OWL (Web Ontology Language). Cada classificador é um classe em OWL e tem um URI (Uniform Resource Identifier). Utilizar as classificações no registro pode ajudar a tornar os objetos mais fáceis de encontrar e também pode incluir significado nos objetos customizados que são exclusivos a um determinado sistema.

Inclua uma Classificação clicando em Incluir e digitando o URI de OWL qualificado completo para a classificação de OWL. Por exemplo, isto pode definir um estado do ciclo de vida do terminal em serviço específico.

 
Política de Correspondência Sim Não Um O WSRR pode conter múltiplas entidades que correspondem aos critérios de procura especificados pelas propriedades acima. Se Política de Correspondência estiver configurada como Um, no máximo uma entidade de correspondência será retornada. Se Política de Correspondência estiver configurada como Todos, todas as entidades correspondentes serão retornadas. Consulte o Saída do Nó RegistryLookup  

As propriedades Avançadas do nó RegistryLookup são descritas na tabela a seguir.

Propriedade M P Padrão Descrição
Política de Profundidade Sim Não Retornar apenas correspondência (Profundidade = 0)

Especifique a profundidade da consulta de WSRR e o conteúdo dos dados da entidade a serem retornados. As entidades retornadas são armazenadas na árvore de mensagens ServiceRegistry no LocalEnvironment.

Selecione Retornar apenas correspondência (Profundidade = 0) para usar uma profundidade de consulta WSRR igual a 0 e para retornar somente as entidades correspondidas.

Selecione Retornar correspondência mostrando relacionamentos imediatos (Apenas para compatibilidade) para usar uma profundidade de consulta WSRR igual a 1 e para retornar apenas as entidades correspondidas. As entidades retornadas incluem elementos que listam os bsrURIs de entidades filhas relacionadas. Esta opção fornece compatibilidade com versões do WebSphere Message Broker anteriores à Versão 6.1.0.4, usando o formato de saída que foi usado nessas versões anteriores. Esta opção está reprovada, use uma das outras opções.

Selecione Retornar correspondência mais entidades relacionadas imediatas (Profundidade = 1) para usar uma profundidade de consulta WSRR igual a 1 e para retornar as entidades correspondidas e as entidades filhas relacionadas imediatas.

Selecione Retornar correspondência mais todas as entidades relacionadas (Profundidade = -1) para usar uma profundidade de consulta WSRR igual a -1 e para retornar as entidades correspondidas e todas as entidades filhas relacionadas.

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:45


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