Convertendo um Mapa de Mensagem de um Arquivo .msgmap para um Arquivo .map

Você deve converter um mapa de mensagem de uma versão anterior do IBM® Integration Bus em um mapa de dados gráficos antes de ser possível modificá-lo usando o Editor de Mapeamento de Dados Gráficos.

Antes de converter um arquivo de mapa de mensagem, você deve concluir uma das tarefas a seguir: Além disso, revise Considerações para Converter um Mapa de Mensagem em um mapa de dados gráficos e Considerações para Mapear Mensagens Modeladas em Conjuntos de Mensagens antes de iniciar.

Se você importar suas soluções do sistema de mensagens do WebSphere Message Broker Versão 6.1 ou Versão 7.0, é possível ainda compilar e implementar fluxos de mensagens que usam arquivos de mapa de mensagem (arquivos.msgmap ). Entretanto, no WebSphere Message Broker Versão 8.0 e posterior, os arquivos de mapa de mensagem são acessíveis no modo somente leitura e não podem ser modificados usando o IBM Integration Toolkit.

No WebSphere Message Broker Versão 8.0 e posterior, se você desejar modificar operações de mapeamento definidas em um mapa de mensagem, deverá primeiro converter o mapa de mensagem em um mapa de dados gráficos (arquivo .map). O processo de conversão não é reversível.
Importante: Ao converter um mapa de mensagem, fluxos de mensagens que fazem referência ao mapa de mensagem não convertido não podem ser implementados até que você modifique cada fluxo de mensagens para referenciar o novo mapa de dados gráficos. Para informações adicionais, consulte Substituindo um Nó de Mapeamento do WebSphere Message Broker Versão 7.0.

Para converter um mapa de mensagem em um mapa de dados gráficos usando o IBM Integration Toolkit, conclua as etapas a seguir:

  1. No visualização Desenvolvimento de Aplicativo, clique com o botão direito do mouse no arquivo .msgmap que você deseja converter e clique em Converter Mapa de Mensagem de .msgmap para .map. Para converter diversos mapas de mensagens, clique com o botão direito do mouse em uma pasta, projeto, aplicativo ou biblioteca que contém um ou mais arquivos .msgmap e clique em Converter Mapa de Mensagem de .msgmap para .map para converter todos os mapas de mensagens que ele contém. Seu novo mapa de dados gráficos é criado e exibido no visualização Desenvolvimento de Aplicativo. Seu mapa de mensagem é renomeado MessageMapName.msgmap_backup e exibido no visualização Desenvolvimento de Aplicativo.
  2. No visualização Desenvolvimento de Aplicativo, clique duas vezes no novo mapa de dados gráficos (arquivo .map). O mapa de dados gráficos é aberto no Editor de Mapeamento de Dados Gráficos.
  3. Revise a lógica da transformação que foi criada pela conversão para assegurar que produza a saída correta para seu aplicativo.
  4. As transformações em seu novo mapa de dados gráficos podem exibir um ícone de anotação de conversão, o que indica que precisam ser revisadas. Os ícones de anotação de conversão são exibidos no canto inferior esquerdo da transformação no Editor de Mapeamento de Dados Gráficos. Para revisar um aviso em uma conversão:
    1. No Editor de Mapeamento de Dados Gráficos, selecione uma transformação que exibe um ícone de anotação de conversão. As propriedades de transformação são exibidas na visualização Propriedades.
    2. Na visualização Propriedades, clique na guia Documentação para revisar detalhes sobre o aviso. Para obter informações adicionais, consulte Avisos sobre Transformações Convertidas.
    3. No Editor de Mapeamento de Dados Gráficos, clique com o botão direito na transformação e clique Aceitar para remover o aviso dessa transformação ou clique em Rejeitar para remover a transformação do mapa e substituí-la por uma transformação de Tarefa.
    Como alternativa, após revisar todas as transformações em um mapa convertido, é possível usar uma ação de menu para aceitar ou rejeitar todas as transformações anotadas. Selecione uma área do mapa de forma que nenhuma transformação seja selecionada e clique com o botão direito na área para abrir o menu.
  5. Repita a etapa 4 para cada conversão no arquivo .map que contém um aviso.
  6. Se o mapa de mensagem continha estruturas de mapeamento complexas que o processo de conversão não era capaz de recriar, o novo mapa de dados gráficos incluirá conversões de Tarefa para ajudar você a recriar essas estruturas manualmente. Você deve revisar e substituir cada conversão de Tarefa para poder usar o mapa de dados gráficos em uma solução do sistema de mensagens. As transformações de tarefas são listadas na visualização Problemas. Para revisar uma conversão de Tarefa:
    1. No Editor de Mapeamento de Dados Gráficos, selecione uma transformação de Tarefa. As propriedades de conversão são exibidas na visualização Propriedades.
    2. Na visualização Propriedades, clique na guia Documentação para revisar detalhes sobre a estrutura de mapeamento que não foi recriada pelo processo de conversão.
    3. No Editor de Mapeamento de Dados Gráficos, altere a transformação de Tarefa em um tipo de transformação funcional clicando na seta na caixa de transformação e, em seguida, selecionando na lista de transformações disponíveis. Para obter informações adicionais sobre a edição de mapas de dados gráficos, consulte Editando um Mapa de Dados Gráficos.
  7. Repita a etapa 6 para cada conversão de Tarefa no arquivo .map.
Seu mapa de mensagem é convertido em um mapa de dados gráficos que pode ser modificado usando o Editor de Mapeamento de Dados Gráficos.
A seguir:

Depois de converter um mapa de mensagem, você deve modificar cada fluxo de mensagens que fazia referência ao mapa de mensagem para que façam referência ao seu novo mapa de dados gráficos; consulte Substituindo um Nó de Mapeamento do WebSphere Message Broker Versão 7.0.

Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização:
        
        Última atualização: 2013-07-16 02:10:21


Tópico de TarefaTópico de Tarefa | IBM Integration Bus Versão 9.0.0.0 | br40806_