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 concluir esta tarefa, você deve ter concluído a seguinte tarefa:

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 e clique em Promover Propriedade. É exibido o diálogo Promoção de Propriedades. 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 todas as propriedades do nó nesse diálogo, independente do nó selecionado quando o diálogo foi aberto pela primeira vez, expandindo as propriedades para todos os demais nós no fluxo (esses estão inicialmente reduzidos).

    O lado direito lista 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.

    A maioria das propriedades do nó do fluxo de mensagens estão disponíveis para promoção, com as seguintes exceções:

    • 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).
  4. Crie novos grupos e propriedades para promoção. Acima da lista de propriedades promovidas à direita, são exibidos três ícones: o ícone do novo grupo (à esquerda), o ícone da nova propriedade (no meio) e o ícone de exclusão (à direita):

    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.

    1. Clique no ícone do novo grupo O ícone do novo grupo (representação do diálogo de propriedades com um grupo de pequenas caixas coloridas impostas nele) para incluir um novo grupo às propriedades promovidas. O grupo é incluído abaixo da raiz do fluxo de mensagens e recebe o nome padrão de Group1 (a menos que já tenha criado grupos que tenham nomes padrão e, nesse caso, o nome do novo grupo terá o próximo número mais alto).

      O campo nome é realçado; digite sobre ele para renomear o grupo quando ele for criado. Você também pode renomear o grupo posteriormente, dando um clique duplo no nome.

    2. Clique no ícone nova propriedade O ícone nova propriedade (representação do diálogo de propriedades com uma pequena caixa verde imposta sobre ele) para incluir uma nova propriedade promovida sob o grupo selecionado atualmente (ou seguindo a propriedade selecionada atualmente). A propriedade é incluída abaixo do grupo realçado e recebe o nome padrão de Property1 (a menos que você já tenha criado propriedades que tenham nomes padrão e, nesse caso, o nome da nova propriedade terá o próximo número mais alto).

      O campo nome é realçado; digite sobre ele para renomear a propriedade quando ela for criada. Você também pode renomear a propriedade a qualquer hora, dando um clique duplo no nome.

    3. Clique no ícone de exclusão O ícone de exclusão (um x vermelho) para excluir o grupo ou a propriedade selecionada atualmente. Se você excluir um grupo, todas as propriedades promovidas nesse grupo serão excluídas da lista à direita. Não existe confirmação da ação excluir. No entanto, as propriedades promovidas excluídas são retornadas à lista à esquerda onde ficam novamente disponíveis para promoção.
  5. Selecione a propriedade que você deseja promover para o nível de fluxo de mensagens a partir da lista de propriedades disponíveis à esquerda do diálogo Promoção de Propriedades. 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 nós restantes neste fluxo de mensagens. 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.

  6. Arraste sua entrada a partir da lista à esquerda do diálogo Promoção de Propriedade até a lista à direita, para promover uma propriedade a partir de um nó do fluxo de mensagens para o novo fluxo de mensagens:
    1. Você pode soltar a propriedade 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 novo grupo recebe um nome que tem como padrão Group1. Se o grupo Group1 já existir, o próximo nome padrão será Group2 e assim por diante. Renomeie o grupo dando um clique duplo nele e inserindo o novo texto.

    2. Você pode soltá-lo em um grupo já existente, para agrupar 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.
    3. Você pode soltá-lo em uma propriedade já existente, para convergir propriedades relacionadas a partir de nós iguais ou diferentes no fluxo de mensagens (isso é descrito com detalhes adicionais em Convergindo Várias Propriedades). Por exemplo, talvez você queira criar uma única propriedade promovida que substitua a propriedade em cada nó que define uma origem de dados.
    Você pode renomear a propriedade promovida (consulte Renomeando uma Propriedade Promovida), mas não pode atualizar sua identificação original.Isto assegura que você sempre pode determinar o nó ou nós específicos que são a origem de cada propriedade promovida, independentemente do nome da propriedade promovida.
  7. Quando tiver selecionado as propriedades a serem promovidas para o fluxo de mensagens, clique em OK Suas atualizações são consolidadas e o diálogo é fechado. Se você clicar em Aplicar, isto consolidará as alterações, mas deixará o diálogo Promoção de Propriedades 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.

As propriedades do nó do fluxo de mensagens agora são promovidas para o fluxo de mensagens. Se desejar confirmar isso, clique com o botão direito no fluxo de mensagens na visualização Navegador, ou clique com o botão direito 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 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 mandatória (ou seja, aparece um asterisco ao lado do nome no diálogo de propriedades do nó do fluxo de mensagens), a característica mandatória da propriedade será preservada. Você sempre deve definir um valor para cada propriedade mandatória no nível do nó, mesmo que pretenda promover essa propriedade para o nível do fluxo de mensagens e, portanto, substituí-la.

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.

Conceitos relacionados
Propriedades Promovidas
Implementação de Aplicativo de Fluxo de Mensagens

Tarefas relacionadas
Definindo Propriedades Promovidas
Renomeando uma Propriedade Promovida
Convergindo Várias Propriedades
Removendo uma Propriedade Promovida
Editando Propriedades Configuráveis

Referências relacionadas
Nós Internos