- Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
- 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.
- 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.
- Selecione Promover Propriedade.
É exibido
o 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).
- 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.
- 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 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.
- 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.
- 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.
- 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:
- 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.
- Você pode soltar a propriedade ou propriedades selecionadas na área de janela
à direita utilizando os seguintes métodos:
- 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.
- 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.
- 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.