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

Substituições do Ambiente Local para o Nó de SOAPRequest

Você pode substituir dinamicamente os valores no ambiente local da mesma maneira que configura valores em outros elementos de uma mensagem.

Outras substituições do ambiente local estão disponíveis para WS-Addressing. Consulte o Endereçamento WS com o Nó SOAPRequest.

Você pode configurar as seguintes propriedades no nó SOAPRequest em LocalEnvironment.Destination.SOAP.Request. Essas substituições de ambiente local também se aplicam ao nó SOAPAsyncRequest.
Configuração Descrição
Operação Substitui a propriedade Operation no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Operation = 'myOperation';
TransportType Substitui a propriedade Transport no nó para alternar o transporte. Por exemplo, se o nó for configurado para usar o transporte JMS, use o seguinte para comutar para o transporte HTTP:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'http';
Para alternar para o transporte JMS:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'jms';
Isso substitui o transporte de solicitação e resposta para essa mensagem.
UserContext É possível armazenar dados de contexto BLOB no seguinte local no ambiente local. O nó SOAPAsyncResponse pode ser recuperado posteriormente nesses dados.
SET OutputLocalEnvironment.Destination.SOAP.Request.UserContext = x'aabbccddeeff11223344556677889900';
Os dados armazenados no UserContext devem estar no formato BLOB. Este campo está incluído no fluxo de bits da mensagem e, portanto, aumenta o tamanho da mensagem.

Essa configuração se aplica apenas ao nó SOAPAsyncRequest e é ignorada por um nó SOAPRequest.

O LocalEnvironment substitui o transporte HTTP

Você pode configurar as seguintes propriedades HTTP no nó SOAPRequest em LocalEnvironment.Destination.SOAP.Request.Transport.HTTP. Essas propriedades aplicam-se somente ao utilizar o transporte HTTP. Você pode comutar entre o transporte HTTP e JMS usando a substituição TransportType, ou o campo To do WS-Addressing; consulte Informações de WS-Addressing no Ambiente Local.
Configuração Descrição
Compactação Substitui a propriedade Usar compactação no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Compression = 'gzip';
Para configurar um tamanho mínimo (em bytes) no qual a compactação é aplicada, use a seguinte substituição:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.MinimumCompressionSize = 1048576;
HTTPVersion Substitui a HTTPVersion. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.HTTPVersion = 
'HTTP/1.1';
Método Substitui o Método. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Method = 'GET';
ProxyConnectHeaders Especifica cabeçalhos adicionais que serão utilizados caso o pedido de saída seja uma conexão SSL através de um proxy. Estes cabeçalhos adicionais são enviados juntamente com o pedido inicial CONNECT ao proxy. Por exemplo, você poderá enviar informações sobre autenticação de proxy para um servidor proxy quando estiver utilizando o SSL. Múltiplos cabeçalhos podem ser enviados mas cada um deve ser separado por um retorno de carro e um avanço de linha (ASCII 0x0D 0x0A) de acordo com o RFC2616; por exemplo:
DECLARE CRLF CHAR CAST(X'0D0A' AS CHAR CCSID 1208);     
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyConnectHeaders =
'Proxy-Authorization: Basic Zm5lcmJsZTpwYXNzd29yZA==' || CRLF || 
'Proxy-Connection: Keep-Alive' || CRLF;
Esta configuração é utilizada apenas se for um pedido SSL através de um servidor proxy. Para enviar informações sobre autenticação de proxy para um pedido não SSL, especifique os cabeçalhos individuais na pasta HTTPRequestHeader, conforme mostrado nos exemplos a seguir:
SET OutputRoot.HTTPRequestHeader."Proxy-Authorization" = 'Basic Zm5lcmJsZTpwYXNzd29yZA==';
SET OutputRoot.HTTPRequestHeader."Proxy-Connection" = 'Keep-Alive';
ProxyURL Substitui a propriedade Local do proxy HTTP(S) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyURL = 
'my.proxy';
RequestURI Substitui a RequestURI, que é o caminho após a URL e a porta. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.RequestURI = 
'/abc/def?x=y&g=h';
SSLCiphers Substitui a propriedade Cifras SSL Permitidas (se estiver utilizando SSL) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLCiphers = 
'SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA';
SSLProtocol Substitui a propriedade SSLProtocol no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLProtocol = 
'TLS';

Os valores válidos são SSL, SSLv3 e TLS.

Timeout Substitui a propriedade Tempo Limite do Pedido (em segundos) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Timeout = 42;
TimeoutMillis Substitui a propriedade Tempo Limite do Pedido (em segundos) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.TimeoutMillis = 5000;
Essa propriedade define o tempo limite em milissegundos. O valor de TimeoutMillis substituirá o valor de Tempo Limite se os dois valores estiverem configurados.
WebServiceURL Substitui a propriedade URL do serviço da Web no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.WebServiceURL = 
'http://ibm.com/abc/';

LocalEnvironment substitui o transporte JMS

Você pode configurar as seguintes propriedades do JMS no nó SOAPRequest em LocalEnvironment.Destination.SOAP.Request.Transport.JMS. Essas propriedades se aplicam apenas quando se utiliza o transporte JMS. É possível alternar entre o transporte HTTP e JMS utilizando a substituição TransportType ou o campo To de WS-Addressing (consulte Informações de WS-Addressing no Ambiente Local).

Algumas substituições do ambiente local JMS para o nó SOAPRequest possui propriedades equivalentes no cabeçalho JMSTransport. Se você especificar uma substituição de ambiente local, ela tem precedência sobre qualquer propriedade equivalente configurada no cabeçalho JMSTransport.

Configuração Descrição
BindingsLocation Substitui a propriedade Local das ligações da URL do JNDI no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.BindingsLocation = 
'file:/C:/mqsi6/Webservices/SOAP/JMS/JNDI';
ConnectionFactoryName Substitui a propriedade Nome da connection factory no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters Especifique os parâmetros de contexto JNDI além dos parâmetros de contexto JNDI definidos no nó. É possível definir os parâmetros de contexto JNDI, por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property2 = 
'value2';
CorrelationID Configura a mensagem de solicitação CorrelID. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationID  = 
'myCorrelID';
CorrelationPattern Configura o padrão de correlação de mensagem de solicitação. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationPattern  = 
1;
Os valores permitidos são os números inteiros 1 e 2:
  • 1 indica que as mensagens devem ser correlacionadas automaticamente pelo CorrelID se um estiver presente. Caso contrário, as mensagens serão correlacionadas pelo ID de mensagem. Esse não é o comportamento padrão.
  • 2 força as mensagens a serem correlacionadas pelo ID de mensagem, mesmo que um CorrelID esteja presente.
DeliveryMode Substitui a propriedade DeliveryMode no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.DeliveryMode = 
'NON_PERSISTENT';
Os valores permitidos para esta propriedade são PERSISTENT e NON_PERSISTENT. Se UriFormat for ibm, 1 e 0 são valores adicionais permitidos para DeliveryMode.
Destino Substitui a propriedade Destination no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Destination = 
'REPLYTOQ2';
DestinationURI É possível substituir múltiplas propriedades do JMS ao mesmo tempo no ambiente local usando a configuração DestinationURI. As propriedades que você configura desta maneira podem ser substituídas configurando as substituições do ambiente local para as propriedades individuais do JMS conforme exibido nas tabelas a seguir.
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.DestinationURI = 
	'jms:jndi:INPUTQ1?jndiConnectionFactoryName=QCF&
	replyToName=REPLYTOQ2&
	jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
	jndiURL=file:/C:/Webservices/SOAP/JMS/JNDI&
	userParam1=value1&
	userParam2=value2&
	timeToLive=30000';
Essa substituição do ambiente local pode ser configurada com um formato de URI de estilo W3C ou de estilo IBM. Para obter informações adicionais, consulte Formatos de URI WSDL para JMS.
Expiração Substitui a propriedade Expiration no nó. Esta propriedade é especificada em milissegundos. Por exemplo, para configurar uma expiração de 100 milissegundos:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Expiration = 
'100';
InitialContextFactory Substitui a propriedade Factory de contexto inicial no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
MessagePriority Substitui a propriedade MessagePriority no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessagePriority = 
'7';
MessageType Substitui a propriedade MessageType no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessageType = 
'text';
Os valores permitidos para esta propriedade são text e bytes.
ProviderName Substitui a propriedade Nome do Provedor JMS no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ProviderName = 
'WebSphere MQ';
ReplyToDestination Substitui a propriedade ReplyToDestination no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ReplyToDestination = 
'REPLYTOQ3';
TargetService Substitui a propriedade TargetService no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TargetService = 
'testService';
Timeout Substitui a propriedade Timeout no nó. Esse valor é especificado em segundos. Por exemplo, para configurar um valor de tempo limite de 30 segundos:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Timeout = 
'30';
TransactionMode Substitui a propriedade Modo de Transação no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TransactionMode = 'Yes';
Os valores permitidos para essa propriedade são Sim, Não e ForceLocal.
  • Não significa que nenhuma transação ocorre e é equivalente a Nenhum.
  • Sim significa que uma transação local ocorrerá se a Transação Coordenada do fluxo não estiver selecionada, ou uma transação coordenada por XA ocorrerá se a propriedade Transação Coordenada do fluxo estiver selecionada.
  • ForceLocal significa que uma transação local sempre será usada, mesmo que a propriedade Transação Coordenada do fluxo seja selecionada.
UriFormat Substitui a propriedade UriFormat no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.UriFormat  = 
'w3c';
Os valores permitidos para esta propriedade são w3c e ibm.
UserProperties Especifique os parâmetros de contexto do usuário além dos parâmetros de contexto do usuário definidos no nó. É possível definir os parâmetros de contexto do usuário específicos, por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property2 = 
'value2';
Configuração Descrição
OneWay Instrui o nó que a mensagem de entrada era uma mensagem unidirecional e que nenhuma mensagem de resposta é necessária. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Gateway.OneWay = True

Se a mensagem for enviada por meio do transporte HTTP, o nó aguardará uma mensagem de resposta HTTP 202 de reconhecimento do servidor remoto. Se a mensagem for enviada por meio do transporte JMS, nenhuma resposta será esperada. Neste exemplo, a mensagem de saída não possui Fila de Resposta e o nó não aguarda nenhuma resposta.

Para obter mais informações, consulte Mensagens Unidirecionais no Modo de Gateway.

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:47


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