As informações do cabeçalho do WS-Addressing podem ser colocadas na árvore de ambiente local na qual elas ficam visíveis para um fluxo de mensagens. As informações de cabeçalho de WS-Addressing são processadas apenas pelos nós SOAP.
As informações de entrada são colocadas no ambiente local pelo nó SOAP somente se o endereçamento for colocado no nó e você selecionar a propriedade Colocar Cabeçalhos do WS-Addressing no LocalEnvironment nos nós SOAPInput, SOAPAsyncResponse ou SOAPRequest.
A tabela a seguir descreve as informações de WS-Addressing específicas do nó na árvore de ambiente local.
Nó | Preenche a propriedade de ambiente local |
---|---|
SOAPInput | LocalEnvironment.SOAP.Input.WSA.type |
SOAPAsyncResponse | LocalEnvironment.SOAP.Response.WSA.type |
SOAPRequest | LocalEnvironment.SOAP.Request.WSA.type |
Em que type é a estrutura da subseção do esquema XML do WS-Addressing do ambiente local. Para obter detalhes sobre como type mapeia para as propriedades de WS-Addressing definidas pela especificação de WS-Addressing, consulte a seção Propriedade do Ambiente Local type deste tópico.
As informações do ambiente local para mensagens de entrada são apenas para sua informação. Se você comprometer o endereçamento no nó e selecionar a propriedade Colocar Cabeçalhos WS-Addressing no LocalEnvironment no nó, as informações de WS-Addressing estarão disponíveis para você consultar e usar em seu fluxo. As propriedades de WS-Addressing são colocadas no ambiente local após o processamento pelo nó. Observe que a pasta WS-Addressing e todos os seus filhos pertencem a um analisador XMLNSC, portanto, é possível copiar elementos diretamente em qualquer outra árvore que pertença a um analisador XMLNSC. Entretanto, esteja ciente que, se você copiar esta pasta (ou qualquer um de seus filhos) em uma árvore que não pertence a um analisador XMLNSC, informações na árvore serão descartadas, a menos que você crie um analisador XMLNSC na árvore de destino primeiro. Este comportamento pode ocorrer se você, por exemplo, copiar da árvore InputLocalEnvironment para a árvore OutputLocalEnvironment.
É possível colocar informações do cabeçalho WS-Addressing de saída no ambiente local; entretanto, esta prática é necessária somente para substituir os padrões que são gerados pelo nó automaticamente. Os cabeçalhos de endereçamento de saída são criados somente se WS-Addressing estiver ativado no nó.
A tabela a seguir descreve as informações de WS-Addressing específicas do nó na árvore de ambiente local que podem ser usadas para substituir os padrões para mensagens de saída.
Nó | Preenche a propriedade de ambiente local |
---|---|
SOAPReply | LocalEnvironment.Destination.SOAP.Reply.WSA.type |
SOAPRequest | LocalEnvironment.Destination.SOAP.Request.WSA.type |
SOAPAsyncRequest | LocalEnvironment.Destination.SOAP.Request.WSA.type |
Em que type é a estrutura da subseção do esquema XML do WS-Addressing do ambiente local. Para obter detalhes sobre como type mapeia para as propriedades de WS-Addressing definidas pela especificação de WS-Addressing, consulte a seção Propriedade do Ambiente Local type deste tópico.
É possível modificar as informações do ambiente local para mensagens de saída. Os nós SOAPReply, SOAPRequest e SOAPAsyncRequest geram configurações do ambiente ambiente local padrão que você pode substituir. Uma exceção para esta tabela é que qualquer tentativa de substituir o endereço ReplyTo de WS-Addressing no nó SOAPAsyncRequest é ignorada.
SET OutputRoot = InputRoot;
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.To.Address = 'jms:jndi:INPUTQ';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.ReplyTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.From.Address = 'jms:jndi:INPUTQ';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.FaultTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.Action = 'http://WMB_BankImport/NewOperation';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.MessageID = 'test:my:msg:ID:1234578';
Elemento | Corresponde ao nome da MAP de WS-Addressing abstrato |
---|---|
A | [terminal de destino] |
De | [terminal de origem] |
ReplyTo | [terminal de resposta] |
FaultTo | [terminal de falha] |
Ação | [ação] |
MessageId | [id de mensagem] |
RelatesTo | [relacionamento] |
ReferenceParameters | [parâmetros de referência] |
Versão | Este elemento não corresponde a MAP, mas ele é usado para identificar a versão do WS-Addressing. As duas versões principais de WS-Addressing são Envio e Final. A versão padrão que é usada por todos os nós é Final. Portanto, para mensagens de saída, configure este elemento somente se você desejar que a versão seja Envio. Para mensagens recebidas, este elemento é preenchido automaticamente com a versão dos cabeçalhos do WS-Addressing que a mensagem de entrada usou. |
Para obter detalhes adicionais sobre as propriedades de endereçamento de mensagem definidas pela especificação de WS-Addressing, consulte WS-Addressing.
Para WS-Addressing de saída, é possível configurar uma propriedade do ambiente local adicional.
Elemento | Descrição |
---|---|
AddMustUnderstandAttribute | Este elemento coloca o atributo SOAPmustUnderstand em cada cabeçalho WS-Addressing antes do envio da mensagem. |