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 subfluxos que incluem outros recursos de legado

É possível converter um subfluxo criado como um arquivo .msgflow em um arquivo .subflow usando a função Converter em subfluxo no WebSphere Message Broker. Se o subfluxo incluir outros recursos de legado, você deverá convertê-los para que possa converter seu subfluxo.

Antes de Iniciar

Defina a configuração inicial do Criando a configuração inicial para a amostra MembersMFP.

Procedimento

Você deve concluir as etapas a seguir para converter a amostra de subfluxo MembersMFPFlow.msgflow em um subfluxo criado como um arquivo .subflow:

  1. Na visualização Desenvolvimento do broker, identifique o projeto do Message Broker localizado sob a pasta Recursos independentes que contém o subfluxo que você deseja converter. Selecione o subfluxo, em nosso exemplo, MembersMFPFlow.msgflow.
    Esta figura mostra que o fluxo de mensagens principal contém um nó MQInput, um subfluxo denominado MembersMFPFlow e um nó MQOutput.
  2. Clique com o botão direito no subfluxo e selecione Converter em subfluxo.
    Esta figura mostra graficamente as etapas para iniciar o processo de conversão. Identifique o subfluxo que deseja converter, clique com o botão direito nele e selecione Converter em subfluxo.
  3. Uma janela de erro será aberta informando que não é possível converter o subfluxo. O subfluxo contém um nó Mapeamento de legado que você deve converter para poder selecionar Converter em subfluxo.
    Esta figura mostra a janela de erro que é exibida quando você tenta converter um subfluxo criado como um arquivo .msgflow que inclui um nó Mapeamento do WebSphere Message Broker Versão 7. O erro diz: O nó Mapeamento no fluxo de mensagens não é válido em um subfluxo.
  4. Na visualização Desenvolvimento do broker, identifique o projeto do Message Broker localizado sob a pasta Recursos independentes que contém o subfluxo que você deseja converter. Identifique o mapa que precisa ser convertido. Em nosso exemplo, ele é o MembersMFPFlow_Mapping.msgmap. Selecione Converter Mapa de Mensagem de .msgmap em .map.
    Esta figura mostra graficamente as etapas que você precisa seguir para converter o mapa de legado. Identifique o mapa, clique com o botão direito nele e selecione Converter Mapa de Mensagem .msgmap em .map.
  5. A janela Progresso da conversão do Mapa de Mensagem é aberta e detalha os resultados da conversão do seu mapa. Clique em Concluir.
    Esta figura mostra a mensagem que a conversão do mapa exibe quando ele estiver concluído. A mensagem diz: Conversão do mapa de mensagem concluída.
  6. Depois de clicar em Fechar, a função Converter Mapa de Mensagem .msgmap em .map é concluída. É possível ver seu mapa convertido na visualização Desenvolvimento do broker, na pasta Mapas em seu projeto do Message Broker. O mapa convertido possui uma extensão de arquivo .map.
    Esta figura mostra que depois de ter convertido o mapa, você tem duas cópias do mapa: uma é um mapa com um formato da Versão 8, ou seja, um arquivo .map, a segunda é um backup do mapa original e tem uma extensão .backup.
  7. Depois de converter o mapa, será necessário corrigir os erros a seguir:
    • Erros relacionados às funções de transformação que requerem etapas de conversão manual para finalizar a sua conversão. Para obter informações adicionais, consulte Cenário: Convertendo um mapa de mensagem em um mapa de dados gráficos.
    • O erro relacionado ao nó Mapping que tinha o mapa de legado configurado. O nó é um nó anterior e precisa ser substituído pelo nó Mapeamento do WebSphere Message Broker Versão 8.
      Esta figura mostra como o nó Mapeamento original no fluxo de mensagens principal é exibido em erro. A mensagem que você obtém é a seguinte: Não é possível localizar o mapa denominado "MembersMFPFlow_Mapping" no esquema do broker padrão dentro do projeto ou em um projeto de referência.

  8. Para substituir o nó Mapeamento anterior pelo nó Mapeamento do WebSphere Message Broker Versão 8, conclua as etapas a seguir:
    • Identifique o novo nó Mapeamento na Paleta.
    • Arraste e solte o nó Mapeamento para a tela do fluxo de mensagens.
      Esta figura mostra graficamente como se deve arrastar e soltar um nó Mapeamento da versão 8 para o fluxo de mensagens principal, para que seja possível substituir o nó Mapeamento antigo pelo novo.
    • Selecione o mapa que você deseja associar ao nó Mapeamento. Este é o mapa cuja conversão acabou de ser concluída.
      Esta figura mostra a janela que você obteve para validar o mapa que você associa ao novo nó Mapeamento, ou seja, o mapa que você converteu nas etapas anteriores.
    • Exclua o nó Mapeamento antigo.
      Esta figura mostra as etapas para excluir o nó Mapeamento antigo. Clique com o botão direito no nó mapeamento antigo e selecione Excluir.

    • Conecte o novo nó Mapeamento em que você acabou de remover o nó Mapeamento antigo.
      Esta figura mostra como você conecta o novo nó Mapeamento nas mesmas posições que as do nó Mapeamento antigo.
  9. Depois de ter convertido o mapa de legado e substituído o nó Mapeamento antigo pelo novo, selecione o subfluxo MembersMFPFlow.msgflow. Clique com o botão direito no subfluxo e selecione Converter em subfluxo.
    Esta figura mostra as etapas para iniciar novamente a conversão do subfluxo, depois de ter substituído o mapa de legado. Clique com o botão direito no subfluxo e selecione Converter em subfluxo.
  10. Na janela Converter fluxo de mensagens em subfluxo, selecione Atualizar todos os arquivos e clique em OK. A conversão é iniciada.
    Depois de selecionar Converter em subfluxo, uma nova janela é aberta, onde você escolhe Atualizar todos os arquivos e, em seguida, seleciona OK para concluir a conversão.
  11. Opcional: Se a janela Falha na Conversão for aberta, clique em OK.
    Esta figura mostra uma das mensagens que você pode obter se o processo de conversão falhar. A mensagem indica o seguinte: A conversão do subfluxo requer que os recursos da área de trabalho sejam construídos. Ative "Projeto-> Construir automaticamente" ou "Projeto > Limpar" antes de executar a conversão do subfluxo.

    Em seguida, selecione Projeto > Limpar.

    Esta figura mostra graficamente como iniciar o processo de Limpeza. Selecione Projeto> Limpar.

O que Fazer Depois

Você deve verificar se o subfluxo convertido está criado e disponível:
  1. Depois que a conversão é concluída, verifique se o subfluxo inicial desaparece da pasta Fluxos e o subfluxo convertido aparece na pasta Subfluxos.

    Esta figura mostra a saída do processo de conversão, ou seja, o subfluxo MembersMFPFlow.subflow é exibido agora nos subfluxos como um arquivo .subflow.
  2. Verifique se o fluxo de mensagens inclui o subfluxo como um nó.

    Esta figura mostra o fluxo de mensagens principal aberto no editor de Fluxo de Mensagens para que seja possível verificar se o subfluxo não exibe nenhum erro.