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

Convertendo o mapa de mensagem

Depois que os recursos de mapa forem importados, será possível então converter o mapa em um mapa de dados gráficos.

Antes de Iniciar

Se você estiver usando seu próprio mapa de mensagem para este cenário, revise Antes: comportamento do mapa de mensagem inicial ou o tópico Mudanças no comportamento em mapas de dados gráficos convertidos de mapas de mensagens.

Sobre Esta Tarefa

As etapas para converter o mapa de mensagem para este cenário são obtidas das etapas descritas em Convertendo um mapa de mensagem de um arquivo .msgmap em um arquivo .map. As etapas foram customizadas para o cenário, e portanto, não incluem todas as possíveis opções e métodos disponíveis. Revise o tópico Centro de informações para etapas de conversão genérica.

Se você importar suas soluções do sistema de mensagens a partir do WebSphere Message Broker Versão 6.1 ou do WebSphere Message Broker Versão 7.0, poderá ainda compilar e implementar fluxos de mensagens que usam arquivos de mapeamento de mensagens (.msgmap), desde que o fluxo de mensagens seja construído em um arquivo BAR que tenha a opção Recursos de compilação e Sequenciais configurada. No entanto, em WebSphere Message Broker Versão 8.0 e mais recente, arquivos de mapeamento de mensagens são acessíveis no modo somente leitura e não podem ser modificados usando o Toolkit.

No WebSphere Message Broker Versão 8.0 e mais recente, se você desejar modificar as operações de mapeamento definidas em um mapa de mensagem, deverá primeiro converter o mapa de mensagem em um arquivo de mapa de dados gráficos (.map).

Ao converter um mapa de mensagem, os fluxos de mensagens que fazem referência ao mapa de mensagem não convertido não poderão ser implementados até que você modifique cada fluxo de mensagens para fazer referência ao novo mapa de dados gráficos.

Para converter o mapa de mensagem do cenário em um mapa de dados gráficos implementável usando o Toolkit, execute as etapas a seguir:

Procedimento

  1. Na visualização Desenvolvimento de Aplicativo, clique com o botão direito em MembersMFPFlow_Mapping.msgmap (ou um .msgmap que você deseja converter) e clique em Converter Mapa de Mensagem de .msgmap em .map.

    Seu novo mapa de dados gráficos é criado e exibido na visualização Desenvolvimento de Aplicativo. Seu mapa de mensagem é renomeado para MembersMFPFlow_Mapping.msgmap_backup e é exibido após seu novo mapa de dados gráficos na visualização Desenvolvimento de Aplicativo.

Na visualização Desenvolvimento de Aplicativo, é possível ver que o fluxo de mensagens do cenário tem um problema que é indicado por uma caixa vermelha com uma cruz:

MembersMFPFlow.msgflow com uma caixa com cruz vermelha indicando que há um problema com o fluxo de mensagens.

Agora, você deve modificar o fluxo de mensagens que fez referência ao mapa de mensagem anterior para que o fluxo de mensagens faça referência ao seu novo mapa de dados gráficos. Neste cenário, use MembersMFPFlow.msgflow MembersMFPFlow_Mapping.map.

  1. Na visualização Desenvolvimento de Aplicativo, dê um clique duplo em MembersMFPFlow.msgflow. O fluxo de mensagens é aberto no editor Fluxo de Mensagens.
    O fluxo de mensagens, conforme exibido no editor de Mapeamento de Dados Gráficos.
  2. No editor de Fluxo de Mensagens, identifique o nó Mapping de uma versão anterior do WebSphere Message Broker. Se você clicar em um nó Mapping antigo, obterá uma caixa de mensagem de aviso, que informa que o nó não pode localizar seu mapa de mensagem anterior.
    Exemplo da mensagem de informação para a etapa.

    Também é possível identificar uma versão anterior de um nó Mapping clicando nele. Na visualização Propriedades, o título do nó inclui o tipo de Mapeamento (descontinuado).

    Janela de propriedades do Nó Mapeamento mostrando o texto "Mapeamento (descontinuado)".
    O nó Mapping deve ser substituído para que ele possa aceitar o novo mapa de dados gráficos.

Marque a guia Básico na visualização Propriedades do nó Mapping descontinuado. O campo Rotina de Mapeamento contém o valor MembersMFPFlow_Mapping. Esse valor é o nome da rotina do mapa, que é necessário para o novo nó Mapping.

  1. Na Paleta, expanda a seção Transformação; em seguida, arraste um novo nó Mapping da Paleta para a tela do Editor de Fluxo de Mensagens. Um novo nó Mapping é incluído no fluxo de mensagens e um nome padrão é designado a ele. Se você renomear o nó, o nome que escolher deverá ser exclusivo no fluxo de mensagens.
    Nota: Se você não alterar o nome padrão neste momento, poderá alterá-lo posteriormente usando o campo de nome na guia Descrição .
  2. Selecione o novo nó Mapping. As propriedades do nó são exibidas na visualização Propriedades.
  3. Na visualização Propriedades, a propriedade Rotina de Mapeamento contém um valor padrão, que deve ser substituído. Clique em Navegar... para localizá-lo, ou especifique seu arquivo .map no formato {BrokerSchemaName}:MapName.

    {default} indica que nenhum esquema do broker é usado pelo mapa de dados gráficos. Não há nenhum esquema para o cenário e portanto {default} é mostrado.

    Para o cenário, substitua o valor MapName por MembersMFPFlow_Mapping.
    Propriedades do Nó Mapeamento com o valor das etapas incluídas no campo Rotina de Mapeamento.
  4. Mova as conexões existentes do nó Mapping anterior para o novo nó Mapping. Arraste os conectores usando o mouse. É possível também usar a caixa de diálogo Seleção de terminal para mover as conexões, mas isso não é abrangido neste cenário; para obter mais informações, consulte Criando conexões do nó com a caixa de diálogo Seleção de terminal.
  5. Selecione seu nó Mapping anterior e pressione a tecla de exclusão (del) para removê-lo do seu fluxo de mensagens.
  6. Você substituiu o nó Mapping e atualizou o fluxo de mensagens para fazer referência ao novo mapa de dados gráficos. Salve as mudanças.

Resultados

O mapa de mensagem é convertido em um mapa de dados gráficos que pode ser modificado usando o editor de Mapeamento de Dados Gráficos e MembersMFPFlow.msgflow aceita o novo mapa, conforme mostrado na imagem a seguir:
MembersMFPFlow.msgflow não está mais exibindo uma caixa com cruz vermelha.

O que Fazer Depois

Depois de converter um mapa de mensagem, abra e verifique o mapa com relação a quaisquer avisos ou erros em transformações. Neste cenário, você deve configurar as transformações para resolver erros e avisos. Em seguida, siga as tarefas em Configurando as transformações convertidas