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 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 WebSphere Message Broker 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 Mudanças no comportamento de mapas de dados gráficos convertido de mapas de mensagens e Considerações para Mapear Mensagens Modeladas em Conjuntos de Mensagens antes de iniciar.

Se você importar suas soluções de mensagens do WebSphere Message Broker Versão 6.1 ou Versão 7.0, poderá ainda compilar e implementar fluxos de mensagens que usam arquivos de mapa de mensagem (arquivos .msgmap), desde que o fluxo de mensagens seja construído em um arquivo BAR com a opção Recursos de compilação e sequenciais configurada. 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 WebSphere Message Broker 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. Você deve substituir nós Mapeamento e nós de cálculo ESQL de versões anteriores do WebSphere Message Broker por um novo nó Mapeamento. Os nós de cálculo ESQL não são suportados em mapas de dados gráficos, porque os mapas com script são executados em um mecanismo de tempo de execução dedicado que pode ser chamado somente a partir de um novo nó Mapeamento. Para obter 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 WebSphere Message Broker Toolkit, conclua as etapas a seguir:

  1. No Visualização Desenvolvimento do Broker, clique com o botão direito 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 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 do Broker. Seu mapa de mensagem é renomeado MessageMapName.msgmap_backup e exibido no Visualização Desenvolvimento do Broker.
  2. No Visualização Desenvolvimento do Broker, 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 Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:31:46


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | br40806_