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

Processando anotações de conversão

Uma anotação em uma transformação convertida mostra que, embora a transformação seja bem-sucedida, talvez você queira revisar que o comportamento é conforme o esperado. Também é possível confirmar ou rejeitar a transformação anotada em seu mapa de dados gráficos.

Sobre Esta Tarefa

Se você estiver usando os arquivos de cenário, depois de seguir as etapas em Convertendo o mapa de mensagem seu arquivo MembersMFPFlow_Mapping.map será semelhante à imagem a seguir:

Captura de tela do mapa de mensagem depois de convertê-lo em um mapa de dados gráficos.

Você pode ver que MEMBER_NAME_PART.PERSON_GIVEN_NAMES agora usa a saída de ambas as transformações If e Else. Ambas as transformações possuem avisos e há uma anotação na transformação If. Siga as etapas para revisar uma transformação anotada.

Procedimento

  1. No editor de Mapeamento de Dados Gráficos, selecione a transformação If que mostra 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 a transformação.
    A guia Documentação na Visualização Propriedades para a transformação If.

    O campo Documentação da transformação If recomenda que a função esql:trim usada no mapa de mensagem anterior, que não é um tipo válido em um mapa de dados gráficos, seja convertida em uma função XPath fn:normalize-space. No entanto, o comportamento pode ser alterado e assim o texto no campo sugere que você deve revisar a transformação.

  3. Revise a lógica da transformação que foi criada pela conversão para assegurar que produza a saída correta para o seu aplicativo. É possível revisar a documentação online para expressões XPath para verificar como fn:normalize-space funciona. No cenário, o comportamento da transformação If está correto, portanto é possível aceitá-lo.
  4. No editor de Mapeamento de Dados Gráficos, clique com o botão direito na transformação. Clique em Aceitar para remover o aviso dessa transformação.
    Uma imagem de um aviso de transformação com as opções disponíveis de menu ativado pelo botão direito para Aceitar ou Rejeitar essa transformação ou todas as transformações no mapa.

    Ou então, depois de 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 para que nenhuma transformação seja selecionada e clique com o botão direito na área para abrir o menu.

  5. Salve seu mapa atualizado.

Resultados

Você resolveu todas as anotações em seu mapa de dados gráficos.

Há ainda avisos sobre as transformações filho de MEMBER_NAME_PART no mapa do cenário. O editor de Mapeamento de Dados Gráficos fornece um aviso aqui porque a lógica do mapa supõe que a mensagem de entrada tenha PERSON_NAME_PARTS presente, o que é definido como uma opção no modelo do esquema de mensagens com PERSON_NAME_WHOLE. Para o cenário, essa suposição vem do mapa de mensagem original e portanto ela é válida.

Para evitar esse aviso e aquele no mapeamento PERSON_SURNAME, é possível incluir uma verificação If ou Else para PERSON_NAME_PARTS ou PERSON_NAME_WHOLE. Essa é uma tarefa opcional, pois os avisos não afetam o comportamento do mapa. Você não precisa remover os avisos para concluir o cenário.