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

SOAPRequest

Utilize o nó SOAPRequest para enviar um pedido SOAP ao serviço da Web remoto.

Finalidade

O nó SOAPRequest é um nó de solicitação e resposta síncronas, que bloqueia o processamento após enviar a solicitação até que a resposta seja recebida. Esse nó ativa o método Keep-Alive de HTTP 1.1, por padrão.

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

Ícone do nó SOAPRequest

Utilizando este nó em um fluxo de mensagens

O nó SOAPRequest pode ser usado em qualquer fluxo de mensagens que precise chamar um serviço da Web. Examine a amostra a seguir para ver como utilizar esse nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Você pode ativar o sistema de mensagens confiável para solicitações SOAP de saída associando um nó SOAPRequest com um conjunto de políticas configurado para WS-RM. Veja informações adicionais na publicação Web Services Reliable Messaging.

Terminais e Propriedades

Os terminais do nó SOAPRequest são descritos na tabela a seguir.

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual uma mensagem será roteada se for detectada uma falha quando a mensagem for propagada para o fluxo Out (como por exemplo, uma falha de validação de mensagem). As falhas roteadas para este terminal incluem falhas causadas pelo processamento de repetição que ocorre antes da repetição propagar a mensagem para o fluxo Out.
Saída O terminal de saída para o qual a mensagem será roteada se o pedido SOAP tiver sido enviado e respondido com êxito, e se for necessário processamento adicional neste fluxo de mensagens. Se não ocorrerem erros no nó SOAPRequest e uma resposta SOAP sem falhas for recebida do recurso externo será sempre enviada primeiramente ao terminal Out.
Falha As mensagens de falha SOAP recebidas em resposta ao pedido enviado são direcionadas ao terminal Failure. Se nenhuma conexão for fornecida para o terminal Fault, não ocorrerá nenhum processamento adicional para uma falha recebida neste fluxo de mensagens.

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 se você precisar inserir um valor quando nenhum padrão for definido; a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

Algumas propriedades do nó SOAPRequest são inicialmente configuradas a partir das propriedades no WSDL importado. Essas propriedades são analisadas diferentemente dependendo de qual formato da URI é usado pelo elemento endereço no WSDL. Veja detalhes na seção Formatos de URI WSDL para JMS.

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

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

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

Propriedade M A Padrão Descrição
Modo de operação Sim Sim Chamar um serviço da Web específico definido por uma interface WSDL

Essa propriedade permite que você especifique o modo de operação do nó, o que determina se ele age no modo WSDL ou no modo de gateway. No modo WSDL, o nó executa as operações de acordo com o WSDL com o qual ele é configurado. Entretanto, o modo de gateway permite configurar o fluxo para identificar solicitação/resposta SOAP genérica e mensagens unidirecionais, ou agir como fachada entre vários clientes de serviços da Web e vários provedores de serviços da Web de backend.

Chamar um serviço da Web específico definido por uma interface WSDL
Configure o nó com um WSDL implementável, configurando a propriedade de nome do arquivo WSDL ou arrastando um WSDL para o nó. Esta é a opção padrão.
Chamar um serviço da Web genérico
Configure o nó para agir no modo de gateway sem nenhum WSDL necessário. Consulte Modo de Operação de Gateway para Nós SOAP para obter uma explicação mais completa do modo de gateway.
Nome do arquivo do WSDL Sim Não Nenhum

Essa propriedade indica o local do arquivo WSDL que você deseja usar para configurar o nó. Insira o caminho completo para o arquivo WSDL ou clique em Navegar para localizar o arquivo WSDL na área de trabalho.

Quando você seleciona um arquivo WSDL para a propriedade nome do arquivo WSDL, o WSDL é validado para garantir que ele seja compatível com WS-I. Se o WSDL tiver uma ligação utilizando SOAP/JMS que não seja compatível com WS-I, pelo padrão, nenhum erro será mostrado. Para ativar a validação de WS-I restrita e exibir um aviso quando um trnasporte SOAP/JMS for usado, clique em Janela > Preferências > Broker Development > Conjunto de Mensagens > Validação e desmarque a caixa de opções WS-I BP 1.1: Permitir SOAP/JMS como URI de transporte.

Apenas arquivos WSDL implementáveis podem ser usados para configurar os nós SOAP. Após a seleção de um arquivo WSDL válido, o projeto do conjunto de mensagens ao qual o arquivo WSDL pertence será incluído como um projeto de referência no application or library correspondente, se a referência não existir.

Se o arquivo WSDL não for válido ou um nome de arquivo incorreto for inserido, uma mensagem de erro é exibida na visualização Propriedades e todas as propriedades WSDL ficam em branco.

Esta propriedade utiliza um valor de cadeia.

As situações a seguir resultam em uma condição de erro:

As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway.

Tipo de porta Sim Não Por padrão, o primeiro Tipo de Porta encontrado no arquivo WSDL, que tem uma ligação HTTP associada a ele, é selecionado. Este tipo de propriedade é String. O campo lista todos os Tipos de portas definidos neste arquivo WSDL selecionado na propriedade Nome do Arquivo WSDL.
Condições de Erro:
  • O Tipo de porta selecionado não contém pelo menos uma operação.

As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway.

Ligação importada Sim Não   Este tipo de propriedade é String.

Esta propriedade é atualizada sempre que o valor de Tipo de porta é alterado. O campo lista as ligações SOAP importadas com transporte HTTP ou JMS associado ao Tipo de porta selecionado. Quando você seleciona uma ligação, a guia de propriedades para o transporte associado é ativada, caso contrário ela fica desativada.

As ligações são listadas na mesma ordem em que são exibidas no arquivo WSDL. A ligação selecionada é a que possui portas e operações. Se não existir esta ligação, será selecionada a ligação com portas. Se nenhuma das ligações possui portas, será selecionada a primeira ligação na lista.

Condições de Erro:
  • Nenhuma ligação SOAP (com transporte HTTP ou JMS) no arquivo WSDL está associada ao tipo de Porta.
  • A ligação selecionada não possui nenhuma operação.

As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway.

Operação de ligação Sim Não   Este tipo de propriedade é String.

A caixa Operação de Ligação contém todas as operações definidas pela ligação selecionada. A primeira operação na lista é selecionada por padrão. Essa propriedade é atualizada toda vez que o valor de ligação selecionado mudar

As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway.

Porta de serviço Sim Não   Este tipo de propriedade é String. Este campo é atualizado sempre que a ligação selecionada for atualizada. Este campo lista todas as portas WSDL que apontam para a ligação selecionada. A primeira porta de serviço para a ligação é selecionada por padrão. Essa propriedade é atualizada cada vez que o valor de ligação selecionado é alterado.
Condições de Erro:
  • Nenhuma das portas aponta para a ligação selecionada.

As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway.

Espaço de nomes de destino Sim Não   Espaço de Nomes de Destino é implementado como um campo de leitura.

Este tipo de propriedade oculta é String. Ela é atualizada com o Espaço de Nomes de Destino do arquivo WSDL quando o Nome do Arquivo WSDL é configurado.

As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway.

Transportar Não Não   Essa propriedade é configurada automaticamente quando a propriedade Ligação Importada é selecionada. O valor desta propriedade mostra o transporte usado pela ligação de WSDL selecionada; por exemplo, HTTP ou JMS.

Se você optar por alternar o transporte de JMS para HTTP, será exibida uma caixa de diálogo que permite reconfigurar as propriedades específicas do JMS. Você deve reconfigurar as propriedades do JMS para implementar o fluxo de mensagens em um ambiente de tempo de execução, versão anterior ao fix pack V7.0.0.1.

As propriedades Transporte de HTTP do nó SOAPRequest são descritas na tabela a seguir. Essas configurações são usadas somente quando o nó usa o transporte HTTP

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
URL de serviço da Web Sim Sim Endereço SOAP da porta selecionada A URL do endereço SOAP selecionado. Essa propriedade é derivada automaticamente a partir do elemento <soap:address> da Porta de Serviço selecionada. No entanto, a porta selecionada é atualizada, a URL de Serviço da Web é atualizada, conforme necessário. No entanto, se você substituir o valor, então, seu valor persiste e a URL não é mais atualizada a partir da porta de serviço.
Se optar por substituir essa propriedade, você deve especificá-la no formato http://<hostname>[:<port>]/[<path>], onde:
  • http://<nome_do_host> deve ser especificado.
  • <port> tem um padrão de 80. Se você especificar um valor, deverá incluir os dois pontos : antes do número da porta.
  • <path> possui um padrão igual a /. Se um valor for especificado, você deve incluir a / antes do caminho.

Para obter detalhes adicionais sobre como substituir esta propriedade, consulte Alterando a URL padrão para um nó SOAPRequest ou um SOAPAsyncRequest pedido de nó.

webServiceURL
Tempo limite do pedido (em segundos) Não Sim 120 O número de segundos que o cliente espera para que um servidor remoto responda com uma confirmação 'mensagem recebida'. O tempo de espera pode levar até um segundo a mais do que o valor especificado.

Se nenhuma resposta for recebida nesse tempo, uma exceção de Falha de SOAP será gerada e propagada para o terminal de Falha.

 
Local de proxy HTTP(S) Não Sim Em Branco O local do servidor proxy para o qual os pedidos são enviados. httpProxyLocation
Protocolo (se utilizando SSL) Não Sim TLS O protocolo selecionado se você usar SSL. Este tipo de propriedade é Enumerate. As opções a seguir estão disponíveis:
SSL
Esta opção tenta se conectar usando o protocolo SSLv3 primeiro, mas permite que o handshake efetue fallback para o protocolo SSLv2 onde o protocolo SSLv2 é suportado pelo provedor JSSE subjacente.
SSLv3
Esta opção tenta conectar-se apenas ao protocolo SSLv3. O retorno ao SSLv2 não é permitido.
TLS
O padrão. Esta opção tenta conectar-se apenas ao protocolo TLS. O retorno ao SSLv3 ou SSLv2 não é permitido.

Ambas as extremidades de uma conexão SSL devem concordar com o protocolo a usar; portanto, o protocolo escolhido deve ser aquele que o servidor remoto pode aceitar.

sslProtocol
Cifras SSL Permitidas (se utilizando SSL) Não Sim Nenhum O código ou códigos SSL específicos que estão sendo usados. Essa configuração permite que você especifique um único código (como SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA) ou uma lista de códigos que são apenas aqueles usados pela conexão. Esse conjunto de cifras deve incluir uma ou mais copiadas pelo servidor remoto.

É possível especificar uma lista de códigos por ordem de prioridade. O servidor seleciona o primeiro código aceitável na lista. Se nenhum dos códigos da lista for adequado, o servidor retornará um alerta de falha de handshake e fechará a conexão.

Uma vírgula é utilizada como um separador entre as cifras. O valor padrão é uma cadeia vazia, a qual permite que o nó utilize qualquer uma ou todas as cifras disponíveis durante o protocolo de reconhecimento de conexão SSL. Esse método permite maior escopo para estabelecer uma conexão SSL com êxito.

allowedSSLCiphers
Use compactação Não Não Nenhum Esta propriedade controla se o conteúdo do pedido HTTP é compactado. Os valores válidos são nenhum, gzip, zlib (deflate) e deflate. Se o pedido for compactado, o cabeçalho de Codificação de Conteúdo será configurado para indicar que o conteúdo está compactado.

zlib (deflate) representa RFC 1950 + RFC 1951 combinados.

deflate representa somente RFC 1951.

requestCompressionType
Aceitar Respostas Compactadas por Padrão Não Sim Desmarcada Esta propriedade indica se o pedido aceita respostas compactadas. Se esta opção for selecionada, é possível para o pedido receber respostas com uma Codificação de Conteúdo gzip ou deflate. Se tal resposta for recebida, o conteúdo será decodificado e o cabeçalho de Codificação do Conteúdo será removido.

Se o Cabeçalho do Pedido não contiver um cabeçalho Aceitar Codificação, então selecionar esta opção configura o cabeçalho Aceitar Codificação para "gzip, deflate".

acceptCompressedResponses
Executar verificação de nome do host (se estiver usando SSL) Não Sim Não Essa propriedade especifica se o nome do host do servidor que está recebendo a solicitação deve corresponder ao nome do host no certificado SSL. hostnameChecking
Alias de chave de autenticação de cliente SSL Não Sim "" (sequência vazia) Esta propriedade especifica um alias de autenticação SSL para o lado do cliente de uma conexão SOAP. Tomar o valor padrão significa que a primeira chave apropriada é escolhida para você automaticamente. keyAlias

As propriedades Transporte de JMS do nó SOAPRequest são descritas na tabela a seguir. Essas configurações são usadas somente quando o nó usa o transporte JMS

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Destino Sim Sim Nenhum O destino ao qual o nó envia mensagens de saída. Se o nó SOAPRequest precisar ser usado para enviar mensagens ponto a ponto, insira o nome da fila de Destino para o nome da fila JMS listada no arquivo de ligações.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM® (proprietário). O Destino é configurado para o valor destinationName localizado no WSDL se uma URI de estilo W3C for localizada ou destino se uma URI de estilo IBM for localizada.

jmsDestination
Responder para Destino Não Sim Nenhum O nome do destino de JMS para o qual o aplicativo de recebimento deve enviar uma mensagem de resposta. Esta propriedade não é usada se a operação JMS for de um de caminho único. Para retornar uma mensagem de resposta a esse destino JMS, o nome do destino JMS deve ser conhecido para o domínio do provedor JMS que é utilizado pelo cliente receptor. Se você não especificar um destino de resposta, uma fila dinâmica temporária será usada como o destino de resposta. Se você não especificar um destino de resposta e estiver usando o provedor JMS do WebSphere MQ, você deve configurar as filas dinâmicas temporárias do JMS. Para obter mais informações sobre configuração de filas dinâmicas temporárias do JMS, consulte Configurando Filas Dinâmicas Temporárias do JMS para o Provedor JMS do WebSphere MQ.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM (proprietário). O Destino de Resposta é configurado para o valor replyToName localizado no WSDL se uma URI de estilo W3C for localizado, ou para o primeiro replyToName, replyTo, replyToDestination ou replyDestination se uma URI de estilo IBM for localizada. Se qualquer uma dessas propriedades estiver presente, elas serão exibidas como um par nome-valor na tabela Parâmetros do Usuário.

jmsReplyToDestination
Tempo limite do pedido (em segundos) Não Sim 120 O tempo que o cliente aguarda um servidor remoto enviar uma mensagem de resposta antes de expirar. requestTimeout
Nome do provedor JMS Sim Não WebSphere MQ Selecione um nome de fornecedor JMS na lista ou digite um nome de sua preferência. O nome deve corresponder ao nome de um serviço configurável definido para o broker no qual você implementa o fluxo de mensagens.

Quando selecionar um nome na lista, a propriedade Factory de Contexto Inicial será atualizada automaticamente com a classe Java™ relevante. Se você digitar seu próprio nome de provedor JMS, deverá digitar também um valor para Gerador de Contexto Inicial.

 
Fábrica de contexto inicial Sim Sim com.sun.jndi.fscontext. RefFSContextFactory O ponto inicial para um espaço de nomes JNDI.

Um aplicativo JMS utiliza o contexto inicial para obter e consultar a connection factory e objetos de fila ou tópico para o provedor JMS. Se você selecionar um nome de provedor JMS na lista em Nome de Provedor JMS, a propriedade Gerador de Contexto Inicial é atualizada automaticamente com a classe Java relevante. Se você digitar seu próprio nome de provedor JMS, deverá digitar também um valor para Gerador de Contexto Inicial. O valor padrão é com.sun.jndi.fscontext.RefFSContextFactory, que define o Gerador de Contexto Inicial baseado em arquivo para o provedor de JMS WebSphere MQ.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM (proprietário). O Factory de contexto inicial é configurado para o valor jndiInitialContextFactory localizado no WSDL se uma URI de estilo W3C for localizada, ou initialContextFactory se uma URI de estilo IBM for localizada.

initialContextFactory
Local das ligação da URL do JNDI Sim Sim   O caminho do sistema ou local LDAP para o arquivo de ligações O arquivo de ligações contém definições para objetos administrados de JNDI que são utilizados pelo nó SOAPRequest.

Esta propriedade é desativada quando o Factory de Contexto Inicial é com.ibm.mq.jms.Nojndi.

Quando você inserir um valor para Local das ligações da URL do JNDI, assegure-se de que ele esteja em conformidade com as seguintes instruções:
  • Construa o arquivo de ligações antes de implementar um fluxo de mensagens que contém um nó SOAPRequest.
  • Não inclua o nome do arquivo de ligações nesse campo.
  • Se você tiver especificado um local do LDAP que exija autenticação, configure o proprietário LDAP (ID do usuário) e as credenciais LDAP (senha) separadamente. Estes valores são configurados no nível do intermediário. Para obter informações sobre esses valores, consulte Comando mqsicreatebroker and Comando mqsichangebroker.
  • O valor da cadeia deve incluir um prefixo URL suportado que tenha um manipulador de URL que esteja disponível no caminho de classe.

Para obter informações sobre a construção de arquivo de ligações de objetos JNDI administrados, consulte a documentação do provedor de JMS.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM (proprietário). O local das ligações da URL do JNDI é configurado para o valor jndiURL localizado no WSDL se uma URI de estilo W3C for localizada, ou jndiProviderURL se uma URI de estilo IBM for localizada.

locationJndiBindings
Nome de fábrica da conexão Sim Sim   O nome da connection utilizada pelo nó SOAPRequest para criar uma conexão com o provedor JMS. Essa propriedade é inicialmente configurada a partir do WSDL importado. Este nome deve existir no arquivo de ligações. O Nome de Connection Factory deve ser um JMS QueueConnectionFactory.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM (proprietário). O Nome do connection factory é configurado para o valor jndiConnectionFactoryName localizado no WSDL se uma URI de estilo W3C for localizada, ou connectionFactory se uma URI de estilo IBM for localizada.

connectionFactoryName
Parâmetros do Usuário Não Não   Esta tabela descreve propriedades de usuário que foram definidas no pedido. As propriedades são pares nome-valor que existem no WSDL e não são utilizadas por outras propriedades do nó de SOAPRequest.  
Parâmetros JNDI Não Não   Uma tabela que mapeia parâmetros de contexto de JNDI para seus tipos.

Essas propriedades assumem seus valores iniciais a partir de qualquer propriedade WSDL do estilo W3C iniciando com jndi-. O WSDL estilo IBM não suporta parâmetros JNDI, mas você pode definir essas propriedades no nó.

 

As propriedades de Entrega da Mensagem do nó SOAPRequest são descritas na tabela a seguir. Esta subguia é ativada somente se a ligação selecionada na guia Básica usar transporte JMS.

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Serviço de Destino Não Não Nenhum Usada pelo nó SOAPRequest ao despachar o pedido de serviço.

Essa propriedade assume seu valor inicial a partir da propriedade targetService do WSDL.

targetService
Modo de entrega Não Sim Persistente Essa propriedade controla o modo de persistência que um provedor JMS utiliza para uma mensagem. Os valores válidos são:
  • Persistente: a mensagem sobrevive se o provedor JMS tem uma falha do sistema.
  • Não Persistente: a mensagem é perdida se o provedor JMS tem uma falha do sistema.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM (proprietário). O Modo de entrega é configurado para o valor deliveryMode localizado no WSDL se um URI de estilo W3C for localizada ou para o primeiro deliveryMode ou persistência se uma URI do estilo IBM for localizada. Se ambas as propriedades estiverem presentes, a segunda propriedade será exibida como um par nome-valor na tabela Parâmetros de Contexto do Usuário.

deliveryMode
Prioridade de Mensagem Não Sim 4

Esta propriedade designa a importância relativa para a mensagem e pode ser usada para seleção da mensagem por um serviço da Web de recebimento.

Selecione um valor entre 0 (prioridade mais baixa) e 9 (prioridade mais alta). O valor-padrão é 4, que indica prioridade média. As prioridades no intervalo 0 - 4 indicam entrega típica. As prioridades no intervalo 5 - 9 indicam entrega mais rápida.

Essa propriedade assume seu valor inicial de uma propriedade do URI do WSDL, dependendo de o URI address do WSDL estar formatado no estilo W3C (padrões) ou no estilo IBM (proprietário). A Prioridade é configurada para o valor prioridade localizado no WSDL se uma URI de estilo W3C for localizada ou para a primeiraprioridade ou Prioridade se uma URI de estilo IBM for localizada. Se ambas as propriedades estiverem presentes, a segunda propriedade será exibida como um par nome-valor na tabela Parâmetros de Contexto do Usuário.

messagePriority
Expiração da Mensagem (Message Expiration (ms)) Não Sim 0 Esta propriedade controla o período de tempo, em milissegundos, durante o qual o provedor JMS mantém a mensagem JMS de saída. O valor-padrão, 0, é usado para indicar que a mensagem não deve expirar.

Essa propriedade assume seu valor inicial a partir da propriedade timeToLive do WSDL.

messageExpiration
Tipo de Mensagem Não Sim bytes Selecione um valor na lista para configurar o tipo de mensagem JMS que é produzida pelo nó SOAPRequest. messageType

As propriedades Transações do nó SOAPRequest estão descritas na seguinte tabela. A configuração não se aplica quando o nó usa transporte HTTP.

Propriedade M A Padrão Descrição
Modo de Transação Sim Não Automático

Essa propriedade controla se a mensagem é enviada em uma transação JMS. Os valores válidos são Sim, Não e Automático.

Selecione Não para enviar a mensagem usando uma sessão JMS não transacional.

Selecione Sim para enviar a mensagem usando uma sessão JMS transacional. A transação JMS pode ser local ou coordenada por XA. Para usar uma transação coordenada por XA usando uma sessão JMS XA, você também deve selecionar a propriedade de fluxo de mensagens Transação Coordenada nas propriedades do arquivo BAR.

Selecione Automático para que a transacionalidade de mensagem seja herdada da configuração Modo de Transação no nó Input no início do fluxo. Esse valor só é usado quando a operação selecionada é unidirecional.

Consulte o Configurando para Transações JMS Coordenadas.

As propriedades Avançadas do nó SOAPRequest são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Cabeçalhos de resposta SOAP definidos pelo WSDL Não Não   Esta tabela é de leitura e é preenchida por cabeçalhos SOAP definidos na parte de saída das operações selecionadas. Por padrão, as caixas de opção, na segunda coluna da tabela, são desmarcadas para todas as entradas da tabela Cabeçalhos de Resposta SOAP Definidos por WSDL. Você deve selecionar a caixa de opção relevante para incluir o cabeçalho na lista cabeçalhos que devem ser entendidos.

Os cabeçalhos SOAP que fazem parte da lista cabeçalhos que devem ser entendidos são incorporados ao fluxo, em vez de causar uma falha de SOAP. Incluir cabeçalhos na lista cabeçalhos que devem ser entendidos pára as falhas SOAP que estão sendo geradas pelos cabeçalhos SOAP.

Não é necessário incluir os cabeçalhos devem ser entendidos para WS-Addressing e WS-Security, pois eles serão entendidos se você configurar Extensões WS.

A tabela é atualizada automaticamente quando a operação selecionada for atualizada. Esta propriedade é gerada no arquivo CMF.

Quando o nó é configurado para agir no modo de gateway, sem nenhum WSDL necessário, essa tabela é limpa. Os valores originais desses campos serão restaurados se o modo de operação do nó for alterado novamente para o modo do WSDL.

Cabeçalhos de resposta SOAP definidos pelo usuário Não Sim Nenhum É possível incluir cabeçalhos customizados (cabeçalhos que não estão definidos no arquivo WSDL) nesta tabela. Utilize Incluir, Editar e excluir para essa tabela. Você deve selecionar a caixa de opção na segunda coluna da tabela para assegurar que o novo cabeçalho customizado incluído seja incluído na lista cabeçalhos que devem ser entendidos. Esta propriedade é gerada no arquivo CMF.

As propriedades Extensões WS do nó SOAPRequest são descritas na tabela a seguir.

Propriedade M A Padrão Descrição  
Utilizar Endereçamento do WS Não Não   Essa propriedade especifica se o Endereçamento WS será utilizado ou não.

Para obter detalhes adicionais sobre WS-Addressing com o nó SOAPRequest, consulte Endereçamento WS com o Nó SOAPRequest.

 
Colocar Cabeçalhos WS-Addressing no LocalEnvironment Não Não Desmarcada Essa propriedade especifica se o nó coloca os cabeçalhos WS-Addressing recebidos na mensagem de resposta na árvore do ambiente local. Os cabeçalhos WS-Addressing não estão acessíveis para o fluxo se esta caixa de opção estiver limpa porque, por padrão, todos os cabeçalhos são processados e removidos.  
Permitir MTOM Não Sim Não Esta propriedade controla se o MTOM está ativado para o analisador. Os valores válidos são Sim, Não e Herdar. Para obter informações adicionais sobre o uso do SOAP MTOM com os nós SOAPReply, SOAPRequest, e SOAPAsyncRequest, consulte Utilizando SOAP MTOM com os Nós SOAPReply, SOAPRequest e SOAPAsyncRequest.

O suporte MTOM é desativado quando o nó é configurado para agir no modo de gateway.

allowMTOM
WS-Security Não Sim   Esta propriedade complexa está no formato de uma tabela e consiste em duas colunas:
  • Alias
  • Expressão XPath
Você pode incluir expressões XPath com uma tabela Alias associada na tabela WS-Security. O Alias é resolvido em um Conjunto de Política criado pelo administrador. O Conjunto de Política resolve o Alias para criptografar ou assinar a parte da mensagem referida pela Expressão XPath. É possível Incluir, Editar e Excluir nesta tabela.
 

As propriedades Análise de Mensagem de Resposta do nó SOAPRequest são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Domínio de mensagem Não Não SOAP O domínio que é utilizado para analisar a mensagem de resposta. Por padrão, a mensagem propagada do nó SOAPInput está no domínio SOAP. Você não pode especificar um domínio diferente. Para obter mais informações, consulte o manual Analisador e Domínio SOAP.

As propriedades de Análise de Mensagem de Resposta são desativadas quando o nó é configurado para agir no modo de gateway.

Conjunto de Mensagens Sim Não Defina automaticamente a partir da propriedade Nome do Arquivo WSDL. O nome do conjunto de mensagens no qual a mensagem de resposta está definida. Essa propriedade é definida automaticamente para o conjunto de mensagens que contém o arquivo WSDL, quando WSDL é associado ao nó.

Se você configurar esta propriedade e, posteriormente, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, será emitido um aviso. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto de conjunto de mensagens.

As propriedades de Análise de Mensagem de Resposta são desativadas, e essa propriedade é limpa, quando o nó é configurado para agir no modo de gateway.

Tipo de Mensagem Não Não   O nome da mensagem de resposta. O nó detecta o tipo de mensagem automaticamente. Você não pode configurar esta propriedade.
Formato de Mensagem Não Não   O nome do formato físico da mensagem de resposta. Você não pode configurar esta propriedade.

As propriedades Opções do Analisador do nó SOAPRequest são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Cronometragem de análise (Parse timing) Não Não On Demand Essa propriedade controla quando uma mensagem de resposta é analisada. Os valores válidos são On Demand, Imediato e Completo. O valor-padrão, On Demand, faz com que a análise da mensagem seja atrasada.

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Construir árvore utilizando tipos de dados de esquema XML Não Não Configurar Esta propriedade controla se os elementos da sintaxe na árvore de mensagens possuem tipos de dados obtidos do Esquema XML. As propriedades Opções do Analisador SOAP determinam como o analisador SOAP opera. As opções do analisador SOAP são transmitidas para o analisador XMLNSC.

Para obter mais informações, consulte Manipulando Mensagens no Domínio XMLNSC.

Essa propriedade é limpa e desativada quando o nó é configurado para agir no modo de gateway.

Reter conteúdo misto (Retain mixed content) Não Não Desmarcada Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter comentários (Retain comments) Não Não Desmarcada Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento (Retain processing instructions) Não Não Desmarcada Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.
Elementos opacos Não Não Em Branco Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada.

As propriedades Validação do nó SOAPRequest são descritas na tabela a seguir. Essas propriedades se aplicam apenas à mensagem de resposta; a mensagem de pedido não é validada.

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Conteúdo e Valor Esta propriedade controla se o analisador SOAP valida o corpo de cada mensagem de resposta contra o Esquema XML gerado a partir da mensagem. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo. Por padrão, a validação está ativada. o analisador SOAP inicia o analisador XMLNSC para validar o corpo XML do serviço da Web SOAP. Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada.

Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

As propriedades de validação são desativadas, enquanto a propriedade Validar é configurada como Nenhum, quando o nó está configurado para agir no modo de gateway.

validateMaster
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode definir essa propriedade somente se definir Validar para Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Log de Erros Local, Exceção e Lista de Exceção.

As propriedades de validação são desativadas quando o nó é configurado para agir no modo de gateway.

 
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.

Trabalhando com Dados WrittenDestination

Após o pedido ser feito, a pasta WrittenDestination no ambiente local é atualizada com o Endereçamento WS (se estiver em uso), os detalhes de compactação (se estiverem em uso) e os detalhes de transporte. Um WrittenDestination para um nó SOAPRequest possui o seguinte formato, com WS-Addressing e Compactação presentes somente se estiverem em uso, em que jmsDestination é o nome de seu destino JMS:
WrittenDestination = (
   SOAP  = (
      Request = (
         WSA = (
            To = 'URI'
            MessageID = 'id'
            Action = 'doAllTheStuff'
         )
         Transport = (
            HTTP = (
               WebServiceURL = 'http://server:8080/thing'
               Compression   = (
                  OriginalSize   = 775
                  CompressedSize = 411
            )
            JMS = (
               Destination = jmsDestination
            )
         )
      )
   )
)

Substituições do Ambiente Local

Você pode substituir dinamicamente valores de configuração no ambiente local da mesma maneira que valores de configuração em outros elementos de uma mensagem. Para obter uma lista integral de valores que você pode substituir no ambiente local, consulte Substituições do ambiente local.

Cabeçalhos do HTTPRequest

Para controlar o conteúdo de um cabeçalho do HTTPRequest que está incluído em uma mensagem, você deve incluir um nó Compute para incluir um cabeçalho do HTTPRequest na mensagem de entrada antes do nó HTTPRequest no fluxo de mensagens.

Se uma SOAPAction estiver configurada como uma sequência de caracteres vazia no cabeçalho do HTTPInput, ela será substituída, a menos que a ação esteja configurada explicitamente no cabeçalho do HTTPRequest, por exemplo:
SET OutputRoot.HTTPRequestHeader.SOAPAction = InputRoot.HTTPInputHeader.SOAPAction
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 | ac56190_