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.
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.
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:
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.
É possível substituir as propriedades do nó RegistryLookup usando as configurações do ambiente local. Consulte o Definindo Dinamicamente os Critérios de Procura.
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:
|
|
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. |
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. |