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

Criando um mapa de mensagem para transformar mensagens SOAP

Crie um mapa de mensagem com uma mensagem SOAP como entrada e uma mensagem SOAP como saída.

Sobre Esta Tarefa

Este cenário demonstra como criar um mapa de mensagem em uma operação de um um serviço.

Se desejar usar seu próprio aplicativo, você poderá seguir as mesmas etapas. A diferença é que você cria o mapa em um fluxo de mensagens ou subfluxo dentro do aplicativo ou da biblioteca referenciada pelo aplicativo.

Procedimento

Conclua as etapas a seguir para criar um mapa no WebSphere Message Broker Toolkit:

  1. Inicie o assistente de Novo Mapa de Mensagem.
    1. Identifique a operação SaveAddress.
      Operação SaveAddress na interface com o usuário
    2. Dê um clique duplo na operação SaveAddress e arraste e solte um nó Mapping.
    3. Nas propriedades do nó Mapping selecione a guia Descrição e insira Normalize_AddressBook_Transform como o Nome do nó.
    4. Conecte o nó Mapping de Normalize_AddressBook_Transform entre os dois nós em que a transformação de mensagem é necessária.
      Esta figura mostra o fluxo depois de criar um nó Mapping.
    5. Dê um clique duplo no nó Mapping de Normalize_AddressBook_Transform para iniciar o assistente de Novo Mapa de Mensagem.
  2. Opcional: Edite o campo Nome do mapa e insira seu nome de mapa.

    É possível manter o nome padrão fornecido pelo WebSphere Message Broker.

    No cenário, o nome do mapa que você usa é o nome padrão SaveAddress_Request_Response_Mapping.map.

  3. Insira o nome do esquema do broker AddressBook no campo Esquema para criar um novo esquema do broker.

    Para organizar seus recursos e definir o escopo de nomes de recursos para garantir exclusividade, você cria esquemas do broker. Para obter mais informações sobre como criar um esquema do broker no WebSphere Message Broker Toolkit, consulte Criando um esquema do broker.

    Depois de inserir AddressBook como o nome do esquema do broker, a janela terá a seguinte aparência:

    Esta figura mostra que a janela Novo Mapa de Mensagem foi concluída com as opções e informações inseridas até esse ponto no processo. Destaca a caixa onde você insere o AddressBook esquema do broker.
  4. Clique em Avançar.
  5. Selecione o mapa de entradas e de saídas.
    1. Selecione o mapa de entrada SOAP_Domain_MSG{}.
    2. Selecione o mapa de saída SOAP_Domain_MSG{}.

    No cenário, você tem um nó SOAPInput que produz um SOAP_Domain_MSG. Um nó do Mapping está conectado ao nó SOAPInput e recebe uma mensagem SOAP_Domain_MSG como entrada.

    Nota: No WebSphere Message Broker, é possível escolher dentre várias entradas e saídas em um mapa de mensagem. No entanto, é possível selecionar apenas uma entrada e uma saída para um mapa de mensagem.
    • Se você usar um nó SOAPInput, deverá mapear o SOAP_Domain_Msg no domínio SOAP.
    • Se você usar um nó SOAPInput seguido por um nó SOAPExtract, deverá mapear o esquema associado à sua operação no domínio XMLNSC. Você usa o nó SOAPExtract para remover envelopes SOAP, permitindo que apenas o corpo de uma mensagem SOAP seja processado.
    • Se você usa nós HTTP ou nós MQ, deverá mapear o SOAP 1.1 ou o esquema SOAP 1.2 como o modelo raiz do mapa no domínio XMLNSC.

    A figura a seguir mostra as opções que você tem como potenciais entradas e saídas de mapa no cenário:

    Esta figura mostra as diferentes opções que você tem como entradas e saídas do mapa.

    A figura a seguir mostra a aparência da janela Selecionar entradas e saídas do mapa após a seleção da entrada e saída do mapa para uma transformação da mensagem SOAP:

    Esta figura mostra a aparência da janela Selecionar entradas e saídas do mapa após a seleção da entrada e saída do mapa para uma transformação da mensagem SOAP
  6. Clique em Avançar.
  7. Selecione a saída de domínio SOAP.
    Nota: A única opção de domínio disponível é o domínio SOAP.

    A figura a seguir mostra a aparência da janela (Novo Mapa de Mensagem – Selecione o domínio para criar a saída depois de você ter selecionado o domínio.

    Esta figura mostra a janela Selecione o domínio para criar a saída depois de você ter selecionado o domínio.
  8. Clique em Concluir.

Resultados

A mensagem do mapa SaveAddress_Request_Response_Mapping.map é criada no visualização Desenvolvimento de Aplicativos , dentro da pasta Mapas localizada em seu projeto AddressBookProvider serviço. O mapa é criado no esquema de AddressBook.

Esta figura mostra o novo recurso de mapa criado na pasta Mapas no projeto AddressBookProvider.

O mapa é aberto no editor de Mapeamento de Dados Gráficos. A figura a seguir mostra a aparência do mapa quando ele é aberto pela primeira vez.

Esta figura mostra a aparência do mapa quando ele é aberto pela primeira vez. Há uma parte de propriedades definida e transformada com uma transformação Mover. A parte SOAP_DOMAIN_Msg{} está disponível como entrada e como saída, mas nenhuma transformação é definida entre qualquer um dos elementos.

O que Fazer Depois

Configure a pasta Propriedades. Para obter informações adicionais, consulte Transformando elementos na pasta Propriedades usando a função Substituir.