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

Promovendo uma Propriedade

É possível promover uma propriedade do nó para o nível do fluxo de mensagens para simplificar a manutenção do fluxo de mensagens e seus nós e para fornecer valores comuns para vários nós do fluxo convergindo propriedades promovidas.

Antes de começar:
A maioria das propriedades do nó do fluxo de mensagens está disponível para promoção, mas não é possível promover as seguintes propriedades:
  • Propriedades que nomeiam módulos de mapeamento
  • Um grupo de propriedades (mas você pode promover uma propriedade individual)
  • Uma propriedade que não pode ser editada (por exemplo, a propriedade Correção do nó MQInput)
  • As propriedades de descrição (Descrição Resumida e Descrição Longa)
  • Propriedades complexas (por exemplo, a propriedade Elementos de Consulta do nó DatabaseRoute ou a propriedade Elementos Opacos do MQInput e de vários outros nós)

Para promover propriedades do nó do fluxo de mensagens para o nível do fluxo de mensagens, conclua as etapas a seguir.

  1. Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
  2. Abra o fluxo de mensagens para o qual deseja promover propriedades.
  3. Clique com o botão direito do mouse no nó apropriado e clique em Promover Propriedade.

    A caixa de diálogo Promover Propriedade (Promote Property) é exibida.

    Diálogo Promover Propriedade

    A área de janela Propriedades de Nó Disponíveis lista todas as propriedades disponíveis de todos os nós no fluxo de mensagens. As propriedades para o nó clicado são expandidas. É possível expandir as propriedades para todos os nós no fluxo de mensagens aberto, independentemente do nó clicado inicialmente.

    A área de janela Propriedades Promovidas exibe o nome do fluxo de mensagens aberto e todas as propriedades promovidas atualmente para o fluxo de mensagens. Se você ainda não tiver promovido nenhuma propriedade, apenas o nome do fluxo de mensagens será exibido como a raiz da árvore de propriedades promovidas, conforme mostrado no exemplo anterior. Se já tiver promovido as propriedades desse nó, elas aparecerão na área de janela Propriedades Promovidas, mas não na área de janela Propriedades de Nó Disponíveis.

  4. Selecione a propriedade ou propriedades que deseja promover para o fluxo de mensagens. Você pode selecionar várias propriedades mantendo pressionada a tecla Ctrl e selecionando as propriedades.
  5. Clique em Promover. A caixa de diálogo Seleção de Destino abre e exibe destinos válidos para a promoção.
  6. Selecione o grupo ou propriedade de destino para as propriedades que deseja promover. É possível agrupar propriedades relacionadas a partir dos mesmos nós ou de nós diferentes no fluxo de mensagens, colocando as propriedades selecionadas em um grupo ou propriedade já existente ou criar um novo destino para a promoção, clicando em Novo Grupo ou Nova Propriedade. É possível renomear grupos e propriedades, selecionando-as e clicando em Renomear.
  7. Clique em OK para confirmar suas seleções e fechar a caixa de diálogo Seleção de Destino.

    Se você criar um novo grupo ou uma propriedade usando a caixa de diálogo Seleção de Destino, as mudanças persistirão, mesmo que você selecione Cancelar na caixa de diálogo. Quando a caixa de diálogo for fechada, os grupos ou as propriedades criadas com o uso da caixa de diálogo Seleção de Destino aparecerão na caixa de diálogo Promover Propriedade. É possível remover qualquer uma dessas propriedades da caixa de diálogo Promover Propriedade, selecionando-as e clicando em Remover.

  8. Clique em OK para confirmar suas mudanças e fechar a caixa de diálogo Propriedade Promovida. Se você clicar em Aplicar, as alterações serão confirmadas mas a caixa de diálogo permanecerá aberta.

As propriedades do nó do fluxo de mensagens são promovidas para o fluxo de mensagens. Quando tiver promovido uma propriedade, não será mais possível fazer alterações nessa propriedade no nível do nó; é possível atualizar seu valor apenas no nível do fluxo de mensagens. Para visualizar as propriedades do fluxo de mensagens, clique no fluxo de mensagens (não nos nós individuais) no editor do Fluxo de Mensagens para exibir as propriedades na visualização Propriedades. As propriedades que foram promovidas são organizadas nos grupos criados. Se agora você configurar um valor para uma destas propriedades, esse valor aparecerá como o valor padrão para a propriedade sempre que o fluxo de mensagens for incluído em outros fluxos de mensagens.

Quando você seleciona um fluxo de mensagens integrado em outro fluxo de mensagens (um subfluxo) e visualiza suas propriedades, você vê os valores da propriedade promovida. Se você examinar o fluxo incorporado (selecionando Abrir Subfluxo), verá os valores originais para as propriedades. O valor de uma propriedade promovida não substitui a propriedade original, mas tem precedência na implementação do fluxo de mensagens.

Promovendo Propriedades Arrastando

Também é possível promover propriedades da caixa de diálogo Promover Propriedade, arrastando a propriedade ou propriedades selecionadas da área de janela Propriedades de Nó Disponíveis da caixa de diálogo Promover Propriedade, para a área de janela Propriedades Promovidas, conforme descrito nas etapas a seguir.
  1. Selecione a propriedade que você deseja promover. É possível selecionar várias propriedades, mantendo pressionada a tecla Ctrl e selecionando as propriedades.
  2. É possível promover as propriedades selecionadas utilizando os seguintes métodos:
    • Solte a propriedade ou propriedades selecionadas em um espaço vazio.

      É criado automaticamente um novo grupo para o fluxo de mensagens e a propriedade é colocada nele, com o nome original da propriedade e o nome do nó do fluxo de mensagens a partir do qual ele foi exibido abaixo da entrada da propriedade.

      O nome do primeiro grupo criado é Group1 por padrão. Se um grupo chamado Group1 já existir, o grupo receberá o nome de Group2 e assim por diante. Você pode renomear o grupo, dando um clique duplo nele e digitando novo texto, ou selecionando o grupo na área de janela Propriedades Promovidas e clicando em Renomear.

      Quando você cria uma nova propriedade promovida, o nome inserido é o nome pelo qual a propriedade é conhecida no sistema e deve atender a algumas restrições de nomenclatura Java™ e XML. Estas restrições são impostas pela caixa de diálogo e será exibida uma mensagem se você digitar um nome que inclua um caractere inválido. Por exemplo, não é possível incluir um espaço ou o símbolo de aspas duplas (").

      Se estiver desenvolvendo um fluxo de mensagens em um projeto definido pelo usuário que será entregue como um incluir do Eclipse, poderá incluir traduções para as propriedades promovidas que foram incluídas. Os nomes traduzidos podem conter caracteres, tais como, espaço, que são restritos para nomes do sistema. A opção para fornecer sequências traduzidas para propriedades promovidas não estará disponível se você estiver trabalhando com um fluxo de mensagens em um Projeto do Message Broker.

    • Solte a propriedade ou propriedades selecionadas em um grupo já existente, para agrupar as propriedades relacionadas a partir de nós iguais ou diferentes no fluxo de mensagens.

      Por exemplo, talvez você queira agrupar todas as propriedades que estão relacionadas a interações do banco de dados. É possível alterar a qualquer momento os grupos aos quais as propriedades promovidas pertencem, selecionando uma propriedade na área de janela Propriedades Promovidas e arrastando-a para um grupo diferente.

    • Solte a propriedade ou propriedades selecionadas em uma propriedade já existente, para convergir as propriedades relacionadas a partir de nós iguais ou de nós diferentes no fluxo de mensagens.

      Por exemplo, talvez você queira criar uma única propriedade promovida que substitua a propriedade em cada nó que define uma origem de dados.

      Para obter informações adicionais sobre como convergir propriedades, consulte Convergindo Várias Propriedades.

Promovendo Propriedades Obrigatórias

Se você promover uma propriedade obrigatória (ou seja, aparece um asterisco ao lado do nome na visualização Propriedades), a característica obrigatória da propriedade será preservada. Quando uma propriedade obrigatória for promovida, seu valor não precisará ser configurado no nível do nó. Se o fluxo que contém a propriedade promovida obrigatória está incluído como um subfluxo em outro fluxo, a propriedade deve ser preenchida para o nó do subfluxo.

Promovendo Propriedades Através de uma Hierarquia de Fluxos de Mensagens

Você pode repetir o processo de promoção de propriedades do nó do fluxo de mensagens através de vários níveis de fluxo de mensagens. Você pode promover propriedades a partir de qualquer nível na hierarquia para o próximo nível acima e assim por diante, através da hierarquia até o nível superior. O valor de uma propriedade será propagado do ponto mais alto da hierarquia no qual está definido para o nó do fluxo de mensagens original quando o fluxo de mensagens for implementado para um intermediário. O valor dessa propriedade no nó de fluxo de mensagens original será substituído.

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


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | ac02380_