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

SOAPEnvelope

Utilize o nó SOAPEnvelope para incluir um envelope SOAP em uma mensagem existente. Esse nó é designado para ser utilizado com o nó SOAPExtract.

Este tópico contém as seguintes seções:

Propósito

O comportamento padrão do nó do SOAPEnvelope é anexar o envelope SOAP a partir de um local padrão ($LocalEnvironment/SOAP/Envelope) na árvore de ambiente local; é possível especificar um local explícito usando uma expressão XPath.

Também pode utilizar o nó em um fluxo sem um nó SOAPExtract correspondente; o nó possui uma opção para criar um envelope SOAP padrão.

O nó SOAPEnvelope está contido no repositório da paleta do Serviços da Web e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

 Ícone do nó Filter

Utilizando o Nó SOAPEnvelope em um Fluxo de Mensagens

Esse nó foi projetado para ser utilizado em conjunto com o nó SOAPExtract; consulte Nó SOAPExtract.

Configurando o Nó SOAPEnvelope

Quando tiver colocado uma instância do nó SOAPEnvelope em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades.

Analisadores Suportados

Este nó foi projetado para funcionar com mensagens SOAP. Utilize um dos seguintes analisadores:
  • XMLNSC
  • MRM
  • XMLNS
Outros analisadores XML não são suportados, porque não suportam espaços de nomes. Será emitida uma exceção se for recebida uma mensagem que não esteja utilizando o analisador correto ou não estiver em conformidade com a estrutura básica de uma mensagem SOAP.

A validação completa não é feita na mensagem SOAP, que precisa conter apenas um elemento body.

Como o domínio SOAP não é suportado pelo nó SOAPEnvelope, não é possível incluir o envelope extraído pelo nó SOAPExtract, do domínio SOAP, de volta no fluxo de mensagens; ou seja, um fluxo tal como o exemplo a seguir não é suportado:
SOAPInput node-> SOAPExtract node->SOAPEnvelope node

Mensagens SOAP de Exemplo

Envelope SOAP de Entrada

<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <tns:requestHeader>
            <tns:assessorUrl>header1</tns:assessorUrl>
        </tns:requestHeader>
    </soapenv:Header>
</soapenv:Envelope>

Corpo da Mensagem SOAP que Chega

<?xml version="1.0"?>
<tns:requestAvailability
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <tns:carDetails>body1</tns:carDetails>
    <tns:claimID>body2</tns:claimID>
    <tns:location>body3</tns:location>
    <tns:reqDate>body4</tns:reqDate>
</tns:requestAvailability>

Mensagem SOAP de Saída

<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <tns:requestHeader>
            <tns:assessorUrl>header1</tns:assessorUrl>
        </tns:requestHeader>
    </soapenv:Header>
    <soapenv:Body>
        <tns:requestAvailability>
            <tns:carDetails>body1</tns:carDetails>
            <tns:claimID>body2</tns:claimID>
            <tns:location>body3</tns:location>
            <tns:reqDate>body4</tns:reqDate>
        </tns:requestAvailability>
    </soapenv:Body>
</soapenv:Envelope>

Terminais e Propriedades

Os terminais do nó SOAPEnvelope são descritos na tabela a seguir:

Terminal Descrição
In O terminal de entrada que aceita uma mensagem SOAP para processamento pelo nó.
Out O terminal de saída que produz a mensagem SOAP que foi construída a partir do corpo da mensagem SOAP e de um envelope SOAP.
Failure O terminal de saída para o qual a mensagem será roteada se for detectado um defeito durante o processamento.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó SOAPEnvelope são descritas na tabela a seguir.

Propriedade M P Default Descrição
Nome de nó Não Não O tipo de nó O nome do nó.
Short description Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó SOAPEnvelope são descritas na tabela a seguir.

Propriedade M P Default Descrição
Criar Novo Envelope Não Não Não selecionada Esta propriedade controla se o nó criará um envelope SOAP ou se obterá um existente da árvore de mensagens. Se você selecionar a caixa de opção, o nó criará um novo envelope. Se você limpar a caixa de opção, o nó copiará o envelope do valor digitado na propriedade Local do Envelope Existente.
Local do Envelope Existente Não Não $LocalEnvironment/SOAP/Envelope Uma expressão XPath que representa o local do qual o nó copiará o envelope SOAP. Estão disponíveis os seguintes nomes de correlação:
$Root
A raiz da árvore de mensagens.
$Body
O último filho da raiz da árvore de mensagens (equivalente a /).
$LocalEnvironment
A raiz da árvore de ambiente local.
$Environment
A raiz da árvore de ambiente global.
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

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:28:49


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac60020_