Utilize o nó SOAPRequest para enviar um pedido SOAP ao serviço da Web remoto.
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:
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.
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.
|
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 WS-I BP 1.1: Permitir SOAP/JMS como URI de transporte. e desmarque a caixa de opções 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:
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:
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:
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:
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:
|
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:
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:
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:
|
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. |
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. |
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
)
)
)
)
)
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.
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.
SET OutputRoot.HTTPRequestHeader.SOAPAction = InputRoot.HTTPInputHeader.SOAPAction