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

Transformando elementos na pasta Propriedades usando a função Substituir

É possível usar a função Substituir para copiar um tipo complexo da mensagem de entrada para a mensagem de saída, enquanto atualiza alguns dos elementos filho no tipo complexo. Um componente do conjunto da mensagem é descrito por uma estrutura de dados complexos.

Antes de Iniciar

Crie um mapa de mensagem. Para obter informações adicionais, consulte Criando um mapa de mensagem para transformar mensagens SOAP.

Sobre Esta Tarefa

A pasta Propriedades possui uma transformação Mover definida automaticamente quando você cria um mapa de mensagem para que todos os elementos na pasta Propriedades sejam copiados para a estrutura de pasta Propriedades de saída. A figura a seguir mostra o mapa de mensagem criado anteriormente:

Esta figura mostra graficamente o resultado da inclusão de uma transformação Mover entre a pasta Propriedades de entrada e a pasta Propriedades de saída.
Nota: É possível usar apenas a função Substituir para incluir transformações Mover e Designar.

No cenário, você define uma transformação Designar para alterar o valor do elemento CodedCharSetId na pasta Propriedades de UTF-16 em UTF-8. O suporte para codificação UTF-16 (Universal Transformation Format) é requerido pelo WS-I Basic Profile 1.0. UTF-16 é um esquema de codificação Unicode que usa valores de 16 bits para armazenar caracteres Conjunto de Caracteres Universais (UCS). UTF-8 é a codificação mais comum usada na Internet e a codificação UTF-16 é em geral usada para aplicativos de produtos Java e Windows. Para obter informações adicionais sobre os valores que podem ser configurados para o elemento CodedCharSetId, consulte Páginas de códigos suportadas.

Procedimento

Conclua as etapas a seguir para modificar o elemento CodedCharSetId da pasta de propriedades:

  1. Clique com o botão direito no elemento CodedCharSetId e, em seguida, selecione a opção de menu Criar Designar.

    A figura a seguir mostra o mapa de mensagem com as opções que podem ser escolhidas a partir de quando você clica com o botão direito no elemento CodedCharSetId.

    Esta figura mostra as opções de menu que você obtém ao clicar com o botão direito em um elemento. A opção Criar Designar é selecionada.

    A transformação Designar é definida e conectada ao elemento CodedCharSetId na pasta Propriedades de saída.

    Esta figura mostra graficamente a transformação Designar conectada ao elemento CodedCharSetId de saída.
    Você obtém os ícones a seguir no lado esquerdo superior da transformação:
    • Um ícone de Erro representado por um ponto de exclamação vermelho. É possível ignorar esse erro e continuar. Você obtém o erro porque definiu duas transformações em um elemento e isso não é permitido. Usando a função Substituir, você corrige o problema.
      Esta figura exibe a mensagem de erro: CodedCharSetId é mapeado por um mapeamento Mover no elemento pai Propriedades, bem como um mapa designar diretamente no elemento CodedCharSetId.
    • Um ícone de sugestão representado por uma lâmpada amarela.

      Ao passar o mouse sobre o ícone, você obtém a janela pop-up a seguir:

      Esta figura mostra a janela pop-up que se abre quando você passa o mouse sobre o ícone de lâmpada.
  2. Configure o valor do CodedCharSetId como 1208. Este é o valor para UTF-8.

    Na guia Propriedades da transformação Designar, você configura o valor na guia Geral. Você define o elemento Valor como 1208.

    Esta figura mostra a guia de propriedades de transformação Designar. Na guia geral, configure o valor como 1208.
  3. Ao passar o mouse sobre a lâmpada amarela, escolha Agrupar as transformações conflitantes em um grupo de substituição. Essa opção é a abordagem recomendada e permite manter a visibilidade das transformações definidas no mapa de transformação principal.
    Esta figura mostra a transformação Substituir que contém a transformação Mover do componente-pai e a transformação Designar do elemento CodedCharSetid.

Resultados

Você transformou elementos da pasta Propriedades usando a função Substituir.

Se você escolher Aninhar as transformações no mapa pai, uma transformação Mapa local será definida entre a pasta Propriedades de entrada e a pasta Propriedades de saída.

Esta figura mostra a transformação de mapa local que é definida ao escolher Aninhar as transformações no mapa pai.

O mapa local que é criado contém uma transformação Mover por elemento, com exceção do elemento CodedCharSetId que possui uma transformação Designar.

Esta imagem mostra graficamente as transformações Mover para cada elemento, exceto CodedCharSetId que possui uma transformação Designar.

O que Fazer Depois

Configure o mapa de mensagem para incluir a árvore do ambiente local. Para obter informações adicionais, consulte Customizando um mapa de mensagem para incluir na árvore do ambiente local.