Nó 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 . 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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:46:26


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