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

SOAPAsyncRequest

Use o nó SOAPAsyncRequest com o nó SOAPAsyncResponse para construir um par de fluxos de mensagens que chamam um serviço da Web assincronamente.

Propósito

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 suporta dois métodos de solicitações assíncronas ao usar o transporte HTTP:
  1. Usando WS-Addressing para direcionar a resposta para o nó SOAPAsyncResponse com par. O nó SOAPAsyncRequest aguarda pelo reconhecimento de HTTP 202 antes de continuar com o fluxo de mensagens e o nó SOAPAsyncRequest será bloqueado se o reconhecimento não for recebido. Uma nova conexão HTTP é feita pelo servidor de backend para responder ao nó SOAPAsyncResponse. Esse não é o comportamento padrão.
  2. Usando Solicitação-resposta Assíncrona de HTTP. Quando a propriedade SOAPAsyncRequest Usar Solicitação-Resposta Assíncrona de HTTP for selecionada, o nó SOAPAsyncRequest passa pelo soquete de HTTP para o nó SOAPAsyncResponse com par para permitir que o servidor de backend responda usando o mesmo soquete. Quando essa opção estiver selecionada, os cabeçalhos WS-Addressing serão enviados, mas não precisarão ser entendidos pelo servidor de backend. Os cabeçalhos WS-Addressing não são marcados como mustUnderstand e o cabeçalho replyTo é configurado como anônimo. O nó usa portanto manipulação de soquete de HTTP assíncrono em vez de WS-Addressing para fazer solicitações de HTTP e receber uma resposta assíncrona.
Para obter informações adicionais, consulte Escolhendo Comportamento Assíncrono para o Nó SOAPAsyncRequest.
O diagrama mostra os relacionamentos entre os nós SOAPAsyncRequest e SOAPAsyncResponse e é descrito no texto.

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:

A Imagem Mostra um Ícone do Nó SOAPAsyncRequest.

Utilizando este nó em um fluxo de mensagens

Um nó SOAPAsyncRequest é vinculado como um par com um SOAPAsyncResponse usando um identificador exclusivo para correlacionar mensagens de solicitação e resposta.

A seguinte amostra demonstra como utilizar os nós SOAP assíncronos quando você chama um serviço da Web. O serviço da Web simula um serviço de pedido, e o cliente mostra como as interfaces existentes do WebSphere MQ podem ser estendidas para realizar os pedidos de serviços da Web.

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.

Usando WSDL com o Nó SOAPAsyncRequest

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 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.

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.

  • Se você tiver WSDL Implementável, é possível selecionar entre os arquivos WSDL Implementáveis, clicando em Procurar.
  • Se você tiver definições WSDL, mas nenhum conjunto de mensagens, então, é possível criar um conjunto de mensagens:
    1. Clique em Procurar para abrir a janela Seleção de WSDL.
    2. Clique em Importar/Criar Novo para abrir o assistente Importar Arquivo WSDL.
    3. Insira o nome do conjunto de mensagens e o nome do projeto do conjunto de mensagens. Clique em Avançar.
    4. Selecione a opção relevante:
      • Se seu arquivo WSDL existir na área de trabalho, selecione Usar recursos da área de trabalho e selecione o arquivo WSDL.
      • Se seu arquivo WSDL estiver no sistema de arquivos, selecione Utilizar Recursos Externos. Selecione o arquivo WSDL. Clique em Avançar.
    5. Selecione as ligações WSDL a importar. Quaisquer avisos ou erros são exibidos no banner do assistente.
    6. Clique em Concluir. Resultado: Cria um novo projeto de conjunto de mensagens e conjunto de mensagens com definições de mensagens. As definições WSDL são incluídas na pasta WSDL Implementável.
    7. Agora, é possível selecionar o arquivo WSDL na janela Seleção de WSDL. Clique OK.
  • Se você tiver um conjunto de mensagens, mas nenhuma definição WSDL, deve gerar uma definição WSDL. Consulte Conjuntos de Mensagens: Gerando uma Definição WSDL a partir de um Conjunto de Mensagens.
  • Arraste um arquivo WSDL de um conjunto de mensagens para o nó.
  • Digite um nome de arquivo que é relativo ao projeto de conjunto de mensagens no qual o arquivo WSDL implementável existe.
Ao salvar o arquivo de fluxo, é verificado se o Nome do Arquivo WSDL existe no conjunto de mensagens. Se ele não existir, será gerado um erro e você não poderá incluir um fluxo que contém este nó SOAPAsyncRequest no arquivo broker archive (BAR).

Terminais e Propriedades

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.

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 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 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.

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:
  • 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. 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:
  • 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 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:
  • 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 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:
  • 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> tem um padrão de barra (/). Se você especificar um valor, deverá incluir a barra (/) 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 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:
SSL
Esta opção tenta se conectar usando o protocolo SSLv3 primeiro, mas o handshake pode sofrer 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 handshake não pode sofrer fallback para o SSLv2.
TLS
O padrão. Esta opção tenta conectar-se apenas ao protocolo TLS. O handshake não pode sofrer fallback para o SSLv3 ou SSLv2.

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:
  • Construa o arquivo de ligações antes de implementar um fluxo de mensagens que contém um nó SOAPAsyncRequest.
  • 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 broker. 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ó 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:
  • 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ó 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:
  • 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 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.

Substituições de LocalEnvironment

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.

Trabalhando com Dados WrittenDestination

Após a solicitação ter sido feita, a pasta WrittenDestination em LocalEnvironment é atualizada com WS-Addressing, detalhes de compactação (se estiver em uso) e detalhes do transporte. Um WrittenDestination para um nó SOAPAsyncRequest possui o seguinte formato, com WS-Addressing e Compactação presentes somente se for usado:
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
            )
         )
      )
   )
)
O exemplo a seguir usa o transporte JMS:
WrittenDestination = (
   SOAP  = (
      Request = (
         WSA = (
            To = 'URI'
            ReplyTo = 'http://server:7800/reply'
            MessageID = 'id'
            Action = 'doAllTheStuff'
         )
         Transport = (
            JMS = (
               Destination = 'jms:jndi:B2BQUEUEIN'
            )
         )
      )
   )
)
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 | ac56200_