Use o nó SOAPAsyncRequest com o nó SOAPAsyncResponse para construir um par de fluxos de mensagens que chamam um serviço da Web assincronamente.
O nó SOAPAsyncRequest pode usar transporte HTTP ou JMS. Ele é vinculado como um par com um SOAPAsyncResponse usando um identificador exclusivo, e opcionalmente WS-Addressing, para correlacionar mensagens de resposta com a solicitação original. Os nós SOAPAsyncRequest e SOAPAsyncResponse não podem ser usados com operações unidirecionais.
O nó SOAPAsyncRequest envia um pedido de serviço da Web, mas o nó não aguardo o recebimento de uma resposta do serviço da Web associado. Essa funcionalidade assíncrona permite que várias solicitações de saída sejam feitas quase em paralelo porque a solicitação de saída não é bloqueada enquanto aguarda a resposta. A resposta do serviço da Web é recebida pelo nó SOAPAsyncResponse, que pode estar em um fluxo de mensagens separado. Os nós são utilizados como um par e correlacionam respostas em relação aos pedidos originais.
O nó SOAPAsyncRequest é a primeira metade do par de nós de pedido e resposta assíncronos. O nó SOAPAsyncRequest chama um serviço da Web baseado em SOAP remoto. O pedido é enviado pelo nó SOAPAsyncRequest, mas o nó SOAPAsyncRequest não recebe a resposta. A resposta é recebida por um nó SOAPAsyncResponse que está em execução em um encadeamento diferente. Geralmente o nó SOAPAsyncResponse está no início de um fluxo de mensagens diferente; no entanto, deve estar no mesmo grupo de execução que o nó SOAPAsyncRequest.
O nó SOAPAsyncRequest é orientado a WSDL, de maneira semelhante ao nó SOAPRequest.
O nó SOAPAsyncRequest está contido no repositório da paleta do Serviços da Web e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
Um nó SOAPAsyncRequest é vinculado como um par com um SOAPAsyncResponse usando um identificador exclusivo para correlacionar mensagens de solicitação e resposta.
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.
Um nó SOAPAsyncRequest deve ser associado a um arquivo WSDL, a menos que ele esteja operando em modo de gateway. Para obter informações adicionais sobre o modo de gateway, consulte Modo de Operação de Gateway para Nós SOAP.
No modo WSDL, quando você seleciona um arquivo WSDL no campo Nome do Arquivo WSDL, o WSDL é validado para garantir que ele seja compatível com WS-I. Se o WSDL usa um URI de transporte SOAP/JMS, ele não é compatível com WS-I mas, por padrão, nenhum erro é 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
Após um arquivo WSDL válido ser selecionado, o projeto do conjunto de mensagens ao qual o arquivo WSDL pertence é incluído como um projeto de referência no projeto de fluxo 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.
Se o nó foi criado soltando um arquivo WSDL de um conjunto de mensagens no editor de fluxo de mensagens, esta propriedade será pré-configurada como o nome do arquivo WSDL. Se o nome do arquivo WSDL não estiver presente, você poderá configurar esta propriedade de uma das seguintes maneiras.
Os terminais do nó SOAPAsyncRequest são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que recebe a mensagem de pedido SOAP para ser remetida ao destino pelo nó. |
Falha | O terminal de saída para o qual uma mensagem será roteada se uma falha for detectada quando a mensagem de pedido SOAP é remetida ao destino(como uma falha de validação de mensagem). |
Saída | O terminal de saída para o qual a mensagem será roteada se for remetida com êxito ao destino, e se for requerido processamento adicional nesse fluxo de mensagens. A mensagem que sai do terminal Out é igual à que chegou no terminal In. |
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ê tiver que inserir um valor quando nenhum padrão estiver definido). A coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor ao incluir o fluxo de mensagens no arquivo BAR para implementá-lo).
Algumas propriedades do nó SOAPAsyncRequest 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ó SOAPAsyncRequest 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 | Nenhuma | Uma breve descrição do nó. |
Descrição Longa | Não | Não | Nenhuma | Texto que descreve a finalidade do nó no fluxo de mensagens. |
As propriedades Básicas do nó SOAPAsyncRequest são descritas na tabela a seguir.
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Identificador exclusivo | Sim | Não | Essa propriedade é o identificador exclusivo que vincula um par de
nós SOAPAsyncRequest e
SOAPAsyncResponse. Ao usar o transporte HTTP, esse identificador é utilizado como um fragmento de URL exclusivo para identificar mensagens de resposta recebidas para o nó SOAPAsyncResponse. Ao usar o transporte JMS, essa propriedade só será utilizada como um identificador exclusivo se a propriedade Obter Resposta por ID de Correlação estiver marcada. Se a propriedade Obter Resposta por ID de Correlação estiver desmarcada e o transporte JMS for usado, a fila de Destino da Resposta agirá como o identificador exclusivo; portanto, deve ser exclusiva para esse par de nós. |
asyncResponseCorrelator | |
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 | Nenhuma | 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. Se o nó foi criado eliminando um arquivo WSDL de um conjunto de mensagens no editor do fluxo de mensagens, esta propriedade será pré-configurada com o nome do arquivo WSDL. 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 ou JMS associada a ele, é selecionado. | Este tipo de propriedade é String. Esse campo lista todos os tipos de porta definidos pelo arquivo WSDL especificado. Pelo padrão, o primeiro tipo de porta localizado no arquivo do WSDL que tiver uma ligação HTTP ou JMS associada será selecionado. Ao salvar o arquivo de fluxo, é verificado se o Tipo de Porta selecionado é válido no conteúdo do arquivo WSDL selecionado. Se ele não for válido, será gerado um erro e você não poderá incluir um fluxo que contém este nó SOAPAsyncRequest no arquivo broker archive (BAR). 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. A caixa Ligação Importada lista todas as ligações SOAP associadas
ao tipo de porta selecionado. Apenas o transporte HTTP ou JMS é suportado. As ligações são listadas na ordem na qual são exibidas no arquivo WSDL. Por padrão, a primeira ligação que
implementa a operação e tem uma porta de serviço associada é selecionada. Essa propriedade é atualizada cada vez que o valor Tipo de
Porta é alterado. 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 cada vez que o valor de ligação selecionado é alterado. Ao salvar o arquivo de fluxo, é verificado se a Operação de Ligação selecionada é válida no conteúdo do arquivo WSDL selecionado. Se ele não for válido, será gerado um erro e você não poderá incluir um fluxo que contém este nó SOAPAsyncRequest no arquivo broker archive (BAR).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. A caixa Porta de Serviço lista todas as portas de serviço
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. Ao salvar o arquivo de fluxo, é verificado se a Porta de Serviço selecionada é válida no conteúdo do arquivo WSDL selecionado. Se ele não for válido, será gerado um erro e você não poderá incluir um fluxo que contém este nó SOAPAsyncRequest no arquivo broker archive (BAR). 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 | Não | Não | Este tipo de propriedade
é String. Espaço de nomes de destino exibe o espaço de nomes do arquivo WSDL selecionado. As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway. |
||
Transportar | Não | Não | HTTP | 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ó SOAPAsyncRequest são descritas na tabela a seguir. Essas configurações são usadas somente quando o nó usa o transporte HTTP.
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
URL de serviço da Web | Sim | Não | Este tipo de propriedade
é String. 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 | Este tipo de
propriedade é Integer. Esta propriedade tem o valor do tempo de espera
para o servidor remoto para responder com uma confirmação de que
a mensagem foi recebida. Se você selecionar a propriedade Usar Soquete Assíncrono, o valor de Tempo Limite da Solicitação irá se referir então ao valor do tempo de espera para o servidor remoto enviar uma resposta ao nó SOAPAsyncResponse. O tempo em segundos no qual o nó aguarda por uma resposta do serviço da Web. O intervalo válido é de 1 a (231)-1. Não é possível inserir um valor que representa uma espera ilimitada. |
requestTimeout |
Local de proxy HTTP(S) | Não | Sim | Este tipo de propriedade é String. O local do servidor proxy para o qual os pedidos são enviados. Esse valor deve estar na forma hostname:port. | httpProxyLocation | |
Protocolo SSL (se utilizando SSL) | Não | Sim | TLS | Este tipo de propriedade
é Enumerate. O protocolo SSL a ser utilizado ao fazer um pedido HTTPS. Os valores válidos são:
As duas extremidades de uma conexão SSL devem utilizar o mesmo protocolo. O protocolo deve ser um que seja aceito pelo servidor remoto. |
sslProtocol |
Cifras SSL Permitidas (se utilizando SSL) | Não | Sim | Esvaziar | Este tipo de propriedade é String. Uma lista de cifras separadas por vírgulas a ser utilizada ao fazer um pedido SSL. Essa configuração permite que você especifique uma única cifra (como SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA) ou uma lista de cifras que são as únicas utilizadas pela conexão. Esta lista de criptografias deve incluir uma ou mais que sejam aceitas pelo servidor remoto. 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 | Nenhuma | 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 | Não Selecionada | 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 Codificação de 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 |
Ativar verificação do nome do host do certificado 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 |
Usar solicitação-resposta assíncrona de HTTP | Não | Não | Não Selecionada | Configurar essa propriedade especifica que o nó SOAPAsyncRequest passa o soquete
de HTTP para o nó SOAPAsyncResponse com par para permitir que o servidor de backend responda usando o mesmo soquete. Essa propriedade configura o nó para usar manipulação de solicitação-resposta de HTTP assíncrona em vez de WS-Addressing assíncrono. Quando Usar Solicitação-resposta Assíncrona de HTTP estiver selecionada, os cabeçalhos WS-Addressing não são marcados como mustUnderstand e o cabeçalho replyTo será configurado como anônimo. Selecione essa opção se o seu servidor de backend não puder fazer solicitações de saída em uma nova conexão. Para obter informações adicionais, consulte Escolhendo Comportamento Assíncrono para o Nó SOAPAsyncRequest. |
|
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 SOAPAsyncRequest. Tomar o valor padrão significa que a primeira chave apropriada é escolhida para você automaticamente. | keyAlias |
As propriedades Transporte de JMS do nó SOAPAsyncRequest são descritas na tabela a seguir. Essas configurações são usadas somente quando o nó usa o transporte JMS.
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Destino | Sim | Sim | Nenhuma | O destino
ao qual o nó envia mensagens de saída. Se o nó SOAPAsyncRequest 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 | Sim | Sim | Nenhuma | O nome do destino de JMS para o qual o aplicativo de recebimento deve enviar
uma mensagem de resposta. 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 a propriedade Obter Resposta por ID de Correlação estiver desmarcada, essa fila identificará exclusivamente as mensagens destinadas ao nó SOAPAsyncResponse do par. Se a propriedade Obter Resposta por ID de Correlação estiver marcada, essa fila então poderá ser compartilhada entre vários nós. 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 |
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ó SOAPAsyncRequest. 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ó SOAPAsyncRequest 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 as propriedades de usuário que serão enviadas na propriedade requestURI da mensagem de solicitação realizada. As propriedades são pares nome-valor que existem no WSDL e não são utilizadas por outras propriedades do nó de SOAPAsyncRequest. | ||
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ó. |
||
Obter Resposta por ID de Correlação | Não | Sim | Não Selecionada | Se essa propriedade estiver marcada, o nó
SOAPAsyncRequest enviará a mensagem de
solicitação com o ID de Correlação especificado na propriedade
Identificador Exclusivo, enquanto o nó
SOAPAsyncResponse recebe somente as mensagens
de resposta que correspondem a esse ID de Correlação. Isso permite que uma única fila de
Destino da Resposta seja compartilhada entre
diversos pares de nós SOAPAsyncRequest e
SOAPAsyncResponse, se essa propriedade estiver
marcada para todos esses nós. Essa funcionalidade só funciona com provedores de serviços da Web que suportam a leitura do ID de Correlação da mensagem de solicitação e o uso deste como ID de Correlação na mensagem de resposta. |
|
Destino de restauração | Não | Sim | O nó SOAPAsyncResponse envia mensagens de resposta para esse destino quando erros impedem que o fluxo de mensagens de resposta processe a mensagem de resposta. A mensagem é removida do destino da resposta. As propriedades de restauração são configuradas pelo nó SOAPAsyncRequest, mas usadas somente por seu nó SOAPAsyncResponse do par. |
backoutDestination | |
Limite de Backout | Não | Sim | 0 | Esse valor controla quando uma mensagem é colocada no destino de restauração. Por exemplo, se o valor for 3, o provedor JMS tentará entregar a mensagem no destino de entrada três vezes. Após a terceira tentativa de entrega, a mensagem não é retrocedida para o destino de resposta e é enviada para o Destino de Restauração. As propriedades de restauração são configuradas pelo nó SOAPAsyncRequest, mas usadas somente por seu nó SOAPAsyncResponse do par. Consulte o Configurando a Propriedade de Limite de Restauração. |
As propriedades de Entrega da Mensagem do nó SOAPAsyncRequest 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 | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Serviço de Destino | Não | Não | Nenhuma | Usada pelo nó SOAPAsyncRequest 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ó SOAPAsyncRequest. Os valores válidos são texto e bytes. | messageType |
As propriedades Transações do nó SOAPAsyncRequest estão descritas na seguinte tabela. A configuração não se aplica quando o nó usa transporte HTTP.
Propriedade | M | P | Default | 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. Consulte o Configurando para Transações JMS Coordenadas. |
As propriedades Avançadas do nó SOAPAsyncRequest são descritas na tabela a seguir.
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 cabeçalhos devem ser entendidos para WS-Addressing e WS-Security porque eles são entendidos se você configurar Extensões WS.
A lista cabeçalhos que devem ser entendidos configurada nesse nó é aplicada ao nó SOAPAsyncResponse correspondente quando o nó SOAPAsyncResponse recebe a resposta do servidor remoto.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Cabeçalhos de resposta SOAP definidos pelo WSDL | Não | Não | A tabela de Cabeçalhos de resposta
SOAP definidos pelo WSDL é somente leitura e preenchida com base nos 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. 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 | Não | É possível incluir cabeçalhos customizados (cabeçalhos que não estão definidos no arquivo WSDL) na tabela Cabeçalhos SOAP Definidos pelo Usuário. 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 cabeçalho customizado incluído recentemente seja incluído na lista cabeçalhos que devem ser entendidos. |
As propriedades Extensões WS do nó SOAPAsyncRequest são descritas na tabela a seguir.
Propriedade | M | P | Default | Descrição | |
---|---|---|---|---|---|
Utilizar Endereçamento do WS | Não | Não | Selecionados | Não é possível editar essa propriedade. Essa propriedade indica que WS-Addressing sempre está comprometido no nó SOAPAsyncRequest. Para obter detalhes adicionais sobre WS-Addressing com o nó SOAPAsyncRequest, consulte WS-Addressing com Nós SOAPAsyncRequest e SOAPAsyncResponse. |
|
Permitir MTOM | Não | Sim | Não | Essa propriedade controla se o MTOM é ativado para o
analisador. Os valores válidos são
Sim,
Não e
Herdar. Para obter informações adicionais sobre como usar SOAP MTOM com os nós do SOAPReply, SOAPRequest e SOAPAsyncRequest; consulte Utilizando SOAP MTOM com os Nós SOAPReply, SOAPRequest e SOAPAsyncRequest. Para obter informações adicionais sobre o MTOM, consulte SOAP MTOM. O suporte MTOM é desativado quando o nó é configurado para agir no modo de gateway. |
allowMTOM |
WS-Security | Não | Não | Essa tabela possui duas colunas:
|
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. |
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.
WrittenDestination = (
SOAP = (
Request = (
WSA = (
To = 'URI'
ReplyTo = 'http://server:7800/reply'
MessageID = 'id'
Action = 'doAllTheStuff'
)
Transport = (
HTTP = (
WebServiceURL = 'http://server:8080/service'
Compactação = (
OriginalSize = 775
CompressedSize = 411
)
)
)
)
)
WrittenDestination = (
SOAP = (
Request = (
WSA = (
To = 'URI'
ReplyTo = 'http://server:7800/reply'
MessageID = 'id'
Action = 'doAllTheStuff'
)
Transport = (
JMS = (
Destination = 'jms:jndi:B2BQUEUEIN'
)
)
)
)
)