Promovendo uma Propriedade

Você pode promover uma propriedade do nó para o nível do fluxo de mensagens para simplificar a manutenção do fluxo de mensagens e de seus nós e para fornecer valores comuns para vários nós no fluxo, transportando as propriedades promovidas.

Antes de começar:

Para promover propriedades do nó do fluxo de mensagens para o nível do fluxo de mensagens:

  1. Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
  2. Abra o fluxo de mensagens para o qual você deseja promover propriedades, dando um clique duplo no fluxo de mensagens na visualização Navegador. Você também pode abrir o fluxo de mensagens, clicando nele com o botão direito do mouse na visualização Navegador e clicando em Abrir. O conteúdo do fluxo de mensagens é mostrado na visualização do editor.

    Se esse for o primeiro fluxo de mensagens a ser aberto, a janela de controle do fluxo de mensagens e a lista de nós do fluxo de mensagens internos disponíveis também serão exibidas à esquerda da visualização do editor.

  3. Na visualização do editor, clique com o botão direito do mouse no símbolo do nó do fluxo de mensagens cujas propriedades você deseja promover.
  4. Selecione Promover Propriedade.

    É exibido o diálogo Promover Propriedade.

    Diálogo Promover Propriedade

    O lado esquerdo do diálogo lista todas as propriedades disponíveis para todos os nós no fluxo de mensagens. As propriedades para o nó realçadas são expandidas. Você pode acessar as propriedades de todos os nós no fluxo de mensagens aberto a partir deste diálogo, independentemente do nó selecionado quando o diálogo foi aberto pela primeira vez, expandindo as propriedades para todos os outros nós no fluxo (eles estão inicialmente reduzidos).

    O lado direito do diálogo lista o nome do fluxo de mensagens aberto e todas as propriedades que foram promovidas para o fluxo de mensagens. Se ainda não promoveu nenhuma das propriedades, apenas o nome do fluxo de mensagens como a raiz da árvore de propriedades promovidas será exibido à direita. Na imagem mostrada, o fluxo de mensagens não contém propriedades promovidas, portanto, apenas o nome do fluxo de mensagens é exibido.

    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:
    • As propriedades que nomeiam módulos Mapeamento.
    • Um grupo de propriedades, mas você pode promover uma propriedade individual.
    • Uma propriedade que não pode ser editada (por exemplo, a propriedade Corrigir no grupo de propriedades Validar para o nó MQInput).
    • As propriedades de descrição (Descrição Resumida e Descrição Longa).
  5. Selecione a propriedade que deseja promover para o fluxo de mensagens. A lista à esquerda inicialmente mostra a lista expandida de todas as propriedades disponíveis para o nó selecionado. Se já tiver promovido propriedades a partir desse nó, elas não aparecerão à esquerda, mas à direita.

    A lista à esquerda também inclui os outros nós no fluxo de mensagens aberto. Você pode expandir as propriedades listadas em cada nó e trabalhar com todas essas propriedades ao mesmo tempo. Não é necessário fechar o diálogo e selecionar outro nó da visualização do editor para continuar promovendo propriedades.

    É possível selecionar várias propriedades para promoção, selecionando uma propriedade, mantendo pressionada a tecla Ctrl e selecionando uma ou mais outras propriedades.

    Se você tiver selecionado várias propriedades para promoção, todas as propriedades selecionadas deverão estar disponíveis para promoção. Se uma ou mais das propriedades selecionadas não estiverem disponíveis para promoção, toda a seleção se tornará indisponível para promoção e o botão Promover na área de janela à direita ficará esmaecido.

  6. Clique no botão Promover para promover a propriedade ou propriedades

    Clicar no botão Promover chama o diálogo Seleção de Destino:

    O diálogo Seleção de Destino

    O diálogo Seleção de Destino exibe apenas os destinos válidos para a promoção da propriedade ou propriedades selecionadas anteriormente e permite criar um novo destino para a promoção, como para um novo grupo ou para uma nova propriedade.

  7. No diálogo Seleção de Destino, selecione o grupo de destino ou a propriedade para a propriedade ou propriedades que você deseja promover. É possível agrupar as propriedades relacionadas dos mesmos nós ou de nós diferentes do fluxo de mensagens, eliminando a propriedade ou propriedades selecionadas em um grupo ou propriedade já existente. Como alternativa, você pode clicar em Novo Grupo ou em Nova Propriedade para criar um novo destino para a promoção. Você pode renomear grupos e propriedades selecionando-os e clicando em Renomear ou dando um clique duplo no grupo ou propriedade.
  8. Clique em OK para confirmar suas seleções.
    Nota: Se você criar um novo grupo ou propriedade utilizando o diálogo Seleção de Destino, as alterações persistirão, mesmo que você selecione Cancelar no diálogo. Quando o diálogo for fechado, os grupos ou propriedades criados utilizando o diálogo Seleção de Destino aparecerão no diálogo Promover Propriedades.
  9. Quando tiver selecionado as propriedades a serem promovidas para o fluxo de mensagens, clique em OK Suas atualizações serão confirmadas e o diálogo Propriedade Promovida será fechado. Se você clicar em Aplicar, isto confirmará as alterações mas deixará o diálogo aberto.

    Quando tiver promovido uma propriedade, você não poderá mais fazer alterações nessa propriedade através do diálogo de propriedades do nó. Você pode atualizar apenas seu valor no nível do fluxo de mensagens.

Nota: Você também pode promover propriedades a partir do diálogo Promover Propriedade, arrastando a propriedade ou propriedades selecionadas da área de janela à esquerda do diálogo Promover Propriedade para a área de janela à direita:
  1. Selecione a propriedade que deseja promover. É possível selecionar várias propriedades para promoção, selecionando uma propriedade, mantendo pressionada a tecla Ctrl e selecionando uma ou mais outras propriedades.
  2. Você pode soltar a propriedade ou propriedades selecionadas na área de janela à direita utilizando os seguintes métodos:
    1. Solte a propriedade ou propriedades selecionadas em um espaço vazio.

      Um novo grupo é automaticamente criado 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 assume como padrão Group1. 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 o novo texto ou selecionando o grupo na área de janela Propriedades Promovidas e clicando em Renomear.
      Nota:

      Quando você cria uma nova propriedade, o nome inserido é o nome pelo qual a propriedade é conhecida no sistema e deve atender a algumas restrições de nomenclatura Java e XML. Elas são impostas pelo diálogo e uma mensagem será exibida se você digitar um nome que inclua um caractere inválido. Por exemplo, você não pode 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 plug-in Eclipse, você poderá incluir tradução para as propriedades promovidas 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 cadeias traduzidas para propriedades promovidas não estará disponível se você estiver trabalhando com um fluxo de mensagens em um projeto do fluxo de mensagens.

    2. 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. Você pode alterar os grupos aos quais as propriedades promovidas pertencem a qualquer momento, selecionando uma propriedade na área de janela Propriedades Promovidas e arrastando-a para um grupo diferente.

    3. 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.

As propriedades do nó do fluxo de mensagens agora são promovidas para o fluxo de mensagens. Para confirmar isso, clique com o botão direito do mouse no fluxo de mensagens na visualização do Navegador ou clique com o botão direito do mouse na visualização do editor e selecione Propriedades.

O diálogo Propriedades do fluxo de mensagens é exibido, mostrando as propriedades do nó do fluxo de mensagens promovidas, organizadas nos grupos criados. Se agora você definir uma valor para uma dessas propriedades, esse valor será exibido como o valor padrão para a propriedade sempre que o próprio fluxo de mensagens estiver incluído em outros fluxos de mensagens.

Quando tiver promovido uma propriedade, você não poderá mais fazer alterações nessa propriedade através do diálogo de propriedades do nó. Você pode atualizar apenas seu valor no nível do fluxo de mensagens.

Quando selecionar um fluxo de mensagens integrado com outro fluxo de mensagens (um subfluxo) e exibir suas propriedades, você verá os valores de propriedades promovidas. Se você examinar o fluxo incorporado (ou seja, se selecionar 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 Obrigatórias

Se você promover uma propriedade que seja obrigatória (ou seja, aparece um asterisco ao lado do nome no diálogo de propriedades do nó do fluxo de mensagens), a característica obrigatória da propriedade será preservada. Quando uma propriedade obrigatória é promovida, seu valor não precisa ser configurado no nível do nó. Se o fluxo que contém a propriedade promovida obrigatória estiver incluído como um subfluxo em outro fluxo, a propriedade terá que ser preenchida para o nó de 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.

Referências relacionadas
Nós Internos
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac02380_