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:
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:
  • 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)

Para promover propriedades do nó do fluxo de mensagens para o nível do fluxo de mensagens, desempenhe estas etapas.

  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ó cujas propriedades deseja promover e clique em Promover Propriedade.

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

    Diálogo Promover Propriedade

    O lado esquerdo da caixa de diálogo lista todas as propriedades disponíveis para 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.

    O lado direito da caixa de diálogo lista o nome do fluxo de mensagens aberto e todas as propriedades que foram promovidas para o fluxo de mensagens. Se você ainda não tiver promovido nenhuma das propriedades, apenas o nome do fluxo de mensagens será exibido como a raiz da árvore de propriedades promovidas, conforme mostrado no exemplo acima. Se já tiver promovido propriedades a partir deste nó, elas aparecerão à direita, mas não à esquerda.

  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 se abre e exibe destinos válidos para a promoção.
    A caixa de diálogo Seleção de Destino (Target Selection)
  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 propriedade utilizando a caixa de diálogo Seleção de Destino (Target Selection), as alterações persistirão, mesmo que você selecione Cancelar (Cancel) na caixa de diálogo. Quando a caixa de diálogo for fechada, os grupos ou propriedades criados utilizando a caixa de diálogo Seleção de Destino aparecerão na caixa de diálogo Promover Propriedade. É possível remover qualquer uma destas propriedades a partir da caixa de diálogo Promover Propriedade, selecionando-as e clicando em Remover.

  8. Clique em OK para confirmar suas alterações 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 com o botão direito do mouse no fluxo de mensagens (não nos nós individuais) no editor do Fluxo de Mensagens e clique em Propriedades para exibir a visualização Propriedades ou a caixa de diálogo 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 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 (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 a partir da caixa de diálogo Promover Propriedade, arrastando a propriedade ou propriedades selecionadas da área de janela à esquerda da caixa de diálogo Promover Propriedade para a área de janela à direita, 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, 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 (").

    • 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 estiver incluído como um subfluxo em outro nó, a propriedade deverá 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.

Referências relacionadas
Nós Internos
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:03

ac02380_