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

SOAPInput

Use o nó SOAPInput para processar mensagens SOAP do cliente para que o broker opere como um provedor SOAP de Serviços da Web.

Propósito

O nó SOAPInput é geralmente usado com o nó SOAPReply, que pode ser incluído no mesmo fluxo de mensagens ou em um fluxo diferente no mesmo grupo de execução.

É possível conectar um nó SOAPReply ao terminal Out para tratar respostas bem-sucedidas. Se também desejar que seu fluxo de mensagens trate do processamento da resposta após um tempo limite, conecte um nó SOAPReply ao terminal HTTP Timeout.

Não é possível usar um nó HTTPReply para responder a um pedido de serviço da Web que é recebido por um nó SOAPInput; o broker levanta uma exceção quando a resposta é tentada.

Se estiver usando nós SOAP e nós HTTP em fluxos de mensagens em um único broker, você poderá escolher manipular mensagens HTTP usando o listener do broker ou listeners de grupos de execução integrados. Se um listener em sua configuração receber mensagens que os nós SOAPInput e HTTPInput podem obter, você deverá verificar com cuidado as especificações de URL nesses nós. Se ambas as especificações de URL corresponderem a uma mensagem recebida, o tipo errado de nó poderá obter a mensagem e o processamento poderá falhar ou produzir resultados inesperados. Essa situação ocorrerá se você especificar valores idênticos para as propriedades Sufixo de caminho para URL dos nós HTTPInput e SOAPInput. Também poderá ocorrer se você usar curingas em uma das especificações ou em ambas, e uma mensagem recebida corresponder a ambas as propriedades.

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

Ícone do nó SOAPInput

Utilizando este nó em um fluxo de mensagens

O nó SOAPInput pode ser usado em um fluxo de mensagens que aceita e processa mensagens SOAP. O nó é configurado utilizando o WSDL implementável. Examine a amostra a seguir para ver como utilizar esse nó:

Um cliente pode enviar um HTTP GET para o terminal de serviço da Web exposto pelo nó de SOAPInput, com uma cadeia de consultas ?wsdl como sufixo e receber uma resposta com a definição do WSDL utilizada para configurar o fluxo (consulte Configurando Fluxos de Mensagens Usando um WSDL).

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 cliente pode enviar um pedido que tenha uma Codificação de Conteúdo gzip ou deflate. Quando tal pedido é recebido, o conteúdo é decodificado e o cabeçalho de Codificação de Conteúdo é removido.

Você pode configurar WS-RM (sistema de mensagens confiável) para mensagens de entrada processadas pelo nó SOAPInput. Veja informações adicionais na publicação Web Services Reliable Messaging.

É possível escolher entre o listener do broker inteiro e o listener do grupo de execução para gerenciar mensagens HTTP: nós SOAP usam o listener do grupo de execução por padrão. Para obter informações adicionais, consulte Listeners HTTP.

Conectando Terminais

O nó SOAPInput roteia cada mensagem recuperada com êxito para o terminal Out. Se a validação da mensagem falhar, a mensagem será roteada para o terminal de falha (Failure); você poderá conectar nós a esse terminal para identificar essa condição. Se você não estiver conectado o termina de Falha, a mensagem é descartada, o Tempo de espera máximo do cliente expira e um erro é retornado para o cliente.

Se a mensagem for capturada por esse nó após a emissão de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal Catch. Se você não tiver conectado o terminal de Captura, a mensagem é descartada, o Tempo de espera máximo do cliente e um erro é retornado ao cliente.

Se o Tempo máximo de espera do cliente expirar, pelo padrão, o listener enviará uma mensagem de falha de SOAP para o cliente, indicando que seu tempo de espera expirou. Se você tiver conectado o terminal HTTP Timeout, e estiver usando o transporte HTTP, a mensagem SOAP Fault será propagada através do terminal HTTP Timeout. É necessário incluir um nó SOAPReply na sequência de nós conectados ao terminal HTTP Timeout e este nó deve enviar uma mensagem de Falha de SOAP válida. O listener aguarda novamente pelo intervalo definido pela propriedade Tempo de Espera Máximo do Cliente (seg), ou durante 10 segundos, o que for o intervalo mais curto:
  • Se uma resposta for recebida antes deste segundo intervalo expirar, o listener propagará a resposta para o cliente.
  • Se uma resposta não for recebida antes deste segundo intervalo expirar, o listener enviará uma mensagem de falha de SOAP ao cliente, indicando que seu tempo limite expirou.
Como o listener aguarda apenas um breve intervalo após a mensagem ter sido propagada através do terminal HTTP Timeout, é necessário assegurar que a sequência de nós que você conecta ao terminal HTTP Timeout inclua um nó SOAPReply, que envia uma resposta antes deste intervalo expirar. Se você tiver conectado o terminal HTTP Timeout, mas não estiver usando o transporte HTTP, a mensagem não será propagada através do terminal HTTP Timeout. O listener enviará uma mensagem de falha de SOAP ao cliente, indicando que seu tempo limite expirou.

Terminais e Propriedades

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

Name Type Descrição
Failure dados de saída O terminal de saída para o qual uma mensagem SOAP é roteada se uma falha for detectada quando a mensagem recebida for propagada para o terminal de Saída (tal como uma falha de validação da mensagem).
Saída dados de saída O terminal de saída para o qual a mensagem SOAP é roteada se tiver sido recebida com êxito e se processamento adicional for necessário neste fluxo de mensagens. Se não ocorrerem erros no nó de entrada, uma mensagem SOAP recebida de um recurso externo será sempre enviada para o terminal Saída primeiro.
HTTPTimeout dados de saída O terminal de saída para o qual uma mensagem de falha de SOAP é roteada se o nó de SOAPReply que está conectado ao terminal Out não responder dentro do intervalo de tempo especificado pela propriedade Tempo máximo de espera do cliente. Esse terminal será usado apenas se a mensagem for enviada pelo transporte HTTP e o WS-RM não estiver sendo usado. Esse terminal funciona somente com um listener do grupo de execução integrado. Se um listener do broker inteiro estiver configurado para nós SOAP, esse terminal não terá efeito.
Catch dados de saída O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó.

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 caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

Algumas propriedades do nó SOAPInput 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 seguintes propriedades de Tentar Novamente não estão mais disponíveis no nó SOAPInput:
  • Tentar mecanismo novamente
  • Tentar limite novamente
  • Intervalo de repetições curtas
  • Intervalo de repetições longas
Quando uma mensagem SOAP através de HTTP falha, uma falha de SOAP é enviada de volta para o cliente; o padrão de troca de mensagens é concluído e não existe nenhuma mensagem para ser tentada novamente. Quando uma mensagem SOAP através de JMS falha, o processamento de nova tentativa é tratado de acordo com as propriedades de restauração definidas na guia Transporte de JMS.

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

Propriedade M P Default Descrição
Nome de nó Não Não O tipo do nó; SOAPInput 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ó SOAPInput são descritas na tabela a seguir.

Propriedade M P Default Descrição
Modo de operação Sim Sim Especifique a interface WSDL a ser exposta

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.

Especifique a interface WSDL a ser exposta
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.
Opere no modo de gateway
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.

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 O primeiro Tipo de Porta localizado no arquivo WSDL (que possui uma ligação HTTP associada a ele). Essa propriedade 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. Esta propriedade utiliza um valor de cadeia.
A situação a seguir causa uma condição de erro:
  • O Tipo de Porta selecionado não contém pelo menos uma operação.
Quando você salvar o arquivo do fluxo de mensagens, a validação de algumas das propriedades relacionadas a WSDL ocorrerá para assegurar que:
  • O arquivo WSDL existe no conjunto de mensagens.
  • Os Tipo de Porta, Operação de Ligação, e Porta de Serviço são todos válidos no conteúdo do arquivo WSDL selecionado.
Se uma ou mais destas condições não forem atendidas, um erro será gerado e você não poderá incluir um fluxo de mensagens que contenha este nó SOAPInput em um arquivo broker archive (BAR).

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

Ligação importada Sim Não   A propriedade Ligação importada lista as ligações SOAP importadas associadas ao tipo de porta selecionado. Apenas o transporte HTTP ou JMS é suportado. 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 na qual são exibidas no arquivo WSDL. Pelo padrão, a primeira ligação importada que implementar a operação e tiver uma porta de serviço associada será selecionada. Essa propriedade é atualizada cada vez que o valor Tipo de Porta é alterado. Este tipo de propriedade é String.

As situações a seguir causam uma condição de erro:
  • Nenhuma ligação SOAP importada (com transporte HTTP ou JMS) no arquivo WSDL 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.

Porta de serviço Sim Não   O campo 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. Este tipo de propriedade é String.
A situação a seguir causa uma condição de erro:
  • Nenhuma das portas aponta para a ligação selecionada.

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

Espaço de nomes de destino Sim Não   Esta propriedade exibe o espaço de nomes do arquivo WSDL selecionado. Este tipo de propriedade é String.

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 dessa propriedade mostra o transporte usado pela ligação WSDL selecionada, se uma for 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ó SOAPInput 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
Sufixo de caminho para URL (Path suffix for URL) Sim Sim Nenhuma O Sufixo de caminho para URL é o seletor de caminho HTTP no qual o nó aceita mensagens de entrada. Essa propriedade é configurada automaticamente a partir do elemento <soap:address> element da Porta de Serviço selecionada. Sempre que a porta selecionada for atualizada, o Seletor de URL é atualizado conforme necessário. Entretanto, se você substituir este valor, seu valor persistirá e a URL não será mais atualizada a partir da porta de serviço.

Se optar por substituir essa propriedade, você deve especificar [<path>].

Se você configurar o mesmo caminho HTTP para nós em diversos fluxos de mensagens, uma solicitação de entrada para esse terminal poderá ser processada por qualquer um desses fluxos de mensagens. Se os fluxos de mensagens forem configurados de maneira diferente, eles processarão a mensagem de maneira diferente e isso poderá levar a um comportamento imprevisível.

Se você necessitar de recursos adicionais para um único caminho de HTTP, configure instâncias adicionais em vez de criar diversos fluxos de mensagens. Para informações adicionais, consulte Propriedades Configuráveis do Fluxo de Mensagens.

urlSelector
Utilizar HTTPS Não Sim Desmarcada Este tipo de propriedade é Boleano e é automaticamente configurada do elemento <soap:address> da Porta de Serviço selecionada. Se o endereço contiver uma URL HTTPS, a caixa de opção é selecionada, caso contrário; não será. No entanto, se você substituir o valor dessa propriedade manualmente, não será mais atualizado a partir da porta de serviço correspondente.

Para ativar o protocolo HTTPS quando essa propriedade for selecionada, execute as etapas a seguir:

  1. Crie um novo keystore do tipo "jks" e escolha uma senha.
  2. Crie um novo certificado autoassinado com um rótulo de sua escolha.
  3. Execute o seguinte comando: mqsichangeproperties brokername -o BrokerRegistry -n brokerKeystoreFile -v keystoreFile
  4. Execute o seguinte comando: mqsichangeproperties brokername -o BrokerRegistry -n brokerTruststoreFile -v keystoreFile
  5. Execute o seguinte comando: mqsisetdbparms brokername -n brokerKeystore::password -u na -p keystorePassword
  6. Execute o seguinte comando: mqsisetdbparms brokername -n brokerTruststore::password -u na -p keystorePassword
  7. Implemente o fluxo de mensagens no broker.
  8. Esse processo usa TLS em vez de SSL. Para ativar o SSL, execute o seguinte comando: mqsichangeproperties brokername -e executionGroup -o HTTPSConnector -n sslProtocol -v SSL. Se o fluxo usar um nó SOAPRequest, altere também o valor da propriedade Protocolo no nó SOAPRequest.
useHTTPS
Tempo de espera máximo do cliente (seg) Sim Sim 180 O tempo em que o cliente aguarda um servidor remoto responder com uma confirmação de "mensagem recebida". O intervalo válido é de zero (que significa uma espera curta) até (231)-1. Essa propriedade especifica a duração máxima de tempo que o listener TCP/IP que recebeu a mensagem de entrada do cliente de serviço da Web aguarda por uma resposta de um nó de SOAPReply. Se for recebida uma resposta nesse período, o listener propagará a resposta para o cliente. Se uma resposta não for recebida nesse tempo, uma mensagem de falha de SOAP será gerada indicando que o tempo limite expirou. Essa mensagem de falha é enviada pelo listener ou, quando se utiliza o transporte HTTP, pelo processamento do terminal Timeout.

Consulte as seções Conectando Terminais e Terminais e Propriedades para obter informações adicionais sobre o termina HTTP Timeout.

maxClientWaitTime
Ativar suporte para ?wsdl N S Desmarcada Se esta propriedade for selecionada, o broker retornará informações do WSDL e do Esquema XML relacionadas a este terminal em resposta a um pedido HTTP GET com uma cadeia de consultas ?wsdl. Isso permite controlar a distribuição de seu WSDL. Para obter uma descrição integral, consulte Configurando Fluxos de Mensagens Usando um WSDL.

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

 

As propriedades Transporte de JMS do nó SOAPInput 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
Origem Sim Não Nenhuma

O nome da fila a partir da qual o nó recupera mensagens que chegam.

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 Origem é configurada para o valor destinationName localizado no WSDL se uma URI de estilo W3C for localizada ou o destino se uma URI do estilo IBM for localizada.

origem
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. 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. O nome deve corresponder ao nome de um serviço configurável definido para o broker no qual você implementa o fluxo de mensagens.  
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ó SOAPInput.

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ó SOAPInput.
  • Não inclua o nome do arquivo de ligações nesse campo.
  • Se você tiver especificado um local do LDAP que exija autenticação, configure o proprietário LDAP (ID do usuário) e as credenciais LDAP (senha) separadamente. Estes valores são configurados no nível do intermediário. Para obter informações sobre esses valores, consulte Comando mqsicreatebroker and Comando mqsichangebroker.
  • O valor de cadeia deve incluir um prefixo de URL suportado que possua 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ó SOAPInput 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 da Connection Factory deve ser uma 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
Destino de restauração Não Sim   O nó SOAPInput envia mensagens de entrada para este destino quando erros impedem o fluxo de mensagens de processar a mensagem e a mensagem deve ser removida do destino de entrada. O nome de destino da restauração deve existir no arquivo de ligações. backoutDestination
Limite de Backout Não Sim 0

O valor que 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 entrada e é enviada para o Destino de Restauração.

Uma falha de SOAP é enviada somente quando o limite de restauração foi atingido.

Consulte o Configurando a Propriedade de Limite de Restauração.

 
Parâmetros de Contexto de JNDI Não Não   Uma tabela que mapeia parâmetros de contexto de JNDI para seus tipos. Essas propriedades são inicialmente configuradas a partir do WSDL importado.

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

 

As propriedades Seletores de Mensagens do nó SOAPInput estão descritas na tabela a seguir. Essa guia é ativada apenas de a guia ligação selecionada na guia Básico utilizar o transporte JMS.

Para obter uma descrição de como construir o seletor de mensagem JMS, consulte Seletor de mensagem JMS.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Propriedade do aplicativo Não Sim   O seletor de mensagem que filtra mensagens de acordo com o valor da propriedade do aplicativo.

Se o provedor JMS tiver que filtrar mensagens com base nas propriedades da mensagem configuradas pelo aplicativo cliente JMS original, insira uma sequência de seletores para Propriedade do Aplicativo, especificando o nome da propriedade e as condições de seleção, por exemplo, OrderValue > 200.

Deixe a Propriedade do Aplicativo em branco se você não desejar que o nó de entrada faça uma seleção com base na propriedade do aplicativo.

 
Registro de Data e Hora Não Sim   O seletor de mensagem que filtra mensagens de acordo com o JMSTimestamp.

Se o provedor JMS tiver que filtrar mensagens que foram geradas em horários específicos, insira uma sequência de seletores para Registro de data e hora, em que o valor é um horário Java em milissegundos não qualificado; por exemplo, 105757642321. Qualifique o seletor com operadores, como =, BETWEEN ou AND.

Deixe o Registro de Data e Hora em branco de você não desejar que o nó de entrada faça uma seleção com base no JMSTimeStamp.

 
Modo de entrega Não Sim Todos O seletor de mensagem que filtra as mensagens de acordo com o modo de entrega da mensagem.
Se o provedor de JMS tiver que filtrar mensagens com base no valor de cabeçalho do JMSDeliveryMode nas mensagens JMS, selecione uma opção para Modo Entrega a partir da lista:
  • Selecione Não Persistente para receber mensagens que são marcadas como não persistentes pelo aplicativo cliente JMS de origem.
  • Selecione Persistente para receber mensagens que são marcadas como persistentes pelo aplicativo cliente JMS de origem.
  • Selecione Todos para receber mensagens persistentes e não persistentes. (Este valor é o padrã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.

 
Priority Não Sim   O seletor de mensagem que filtra as mensagens de acordo com a prioridade da mensagem.

Se o provedor JMS tiver que filtrar mensagens com base no valor do cabeçalho JMSPriority na mensagem JMS, insira uma sequência de seletores para Prioridade.

Os valores válidos para Prioridade vão de 0 (o mais baixo) a 9 (o mais alto). Por exemplo, insira = 5 para receber mensagens de prioridade 5, > 4 para receber mensagens com uma prioridade maior que 4, ou BETWEEN 4 AND 8 para receber mensagens com uma prioridade no intervalo 4 - 8.

Deixe Prioridade em branco se você não desejar que o nó de entrada faça uma seleção baseada em JMSPriority.

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 priority localizado no WSDL se um URI de estilo W3C for localizado ou para a primeira das propriedades priority ou Priority se um URI de estilo IBM for localizado.

 
ID da Mensagem Não Sim   O seletor de mensagem que filtra as mensagens de acordo com o ID de mensagem.

Se o provedor JMS tiver que filtrar mensagens com base no cabeçalho JMSMessageID, insira uma sequência de seletores para ID de Mensagem. Por exemplo, insira > WMBRK123456 para retornar mensagens em que o ID de Mensagem seja maior que WMBRK123456.

Deixe ID de Mensagem em branco se você não quiser que o nó de entrada faça uma seleção com base em JMSMessageID.

 
Entregue Novamente Não Sim   Se o provedor JMS tiver que filtrar mensagens com base no cabeçalho JMSRedelivered, insira uma sequência de seletores para Reentregue:
  • Insira = FALSE se o nó de entrada aceitar apenas mensagens que não foram reentregues pelo provedor JMS.
  • Insira = TRUE se o nó de entrada aceitar apenas mensagens que foram reentregues pelo provedor JMS.
  • Deixe Reentregue em branco se você não quiser que o nó de entrada faça uma seleção com base em JMSRedelivered.
 
ID de Correlação Não Sim   O seletor de mensagem que filtra as mensagens de acordo com o ID de correlação.

Se o provedor JMS tiver que filtrar mensagens com base no cabeçalho JMSCorrelationID, insira uma sequência de seletores para ID de Correlação. Por exemplo, = WMBRKABCDEFG retorna mensagens com um ID de Correlação que corresponde a este valor.

Deixe ID de Correlação em branco se você não quiser que o nó de entrada faça uma seleção com base em JMSCorrelationID.

 
Serviço de Destino Não Não   Esta propriedade é configurada a partir do valor da propriedade targetService localizada na URL do local do terminal JMS que está contida na seção da porta do WSDL. A mensagem SOAP/JMS será lida a partir da fila de origem apenas se a mensagem tiver um valor de targetService que corresponda ao valor definido no nó. Esse valor é utilizado pelo componente do servidor para determinar o componente de porta ao qual o pedido será despachado.

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

targetService

As propriedades Transações do nó SOAPInput estão descritas na seguinte tabela. Essa configuração não se aplica quando o nó está usando o transporte HTTP.

Propriedade M P Default Descrição
Modo de Transação Sim Não Não

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

Selecione Não para receber 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.

Consulte o Configurando para Transações JMS Coordenadas.

O valor configurado para Modo de Transação no nó SOAPInput é herdado pelo recebimento de dados de nós no fluxo de mensagens que têm seu Modo de Transação configurado como Automático.

Outros recursos que executam trabalho no fluxo de mensagens, como DB2 ou WebSphere MQ, usam transações independentemente da configuração Modo de Transação do nó e confirmam suas transações após o processamento da mensagem.

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

Propriedade M P Default Descrição  
Agente do SOAP 1.1 (função do SOAP 1.2) Sim Não Destino Final (Receptor Final) Use esta propriedade para configurar o agente SOAP (protocolo SOAP 1.1) ou função SOAP (protocolo SOAP 1.2) que é executada pelo nó do SOAPInput. O valor padrão é Destino Final (Receptor Final). (Destino Final está relacionado ao SOAP 1.1 e Receptor Final está relacionado ao SOAP 1.2). É possível inserir qualquer valor predefinido ou definido pelo usuário.

As funções predefinidas são especificadas nas especificações SOAP 1.1 ou SOAP 1.2 respectivas e são utilizadas para processar Cabeçalhos SOAP destinados à função específica.

Se você selecionar vazio, ocorrerá um erro quando o fluxo de mensagens for validado.

Esta propriedade utiliza um valor de cadeia.

 
Configurar lista de destino Não Não Selecionados Especifica se deve incluir o nome de ligação do método para a lista de destino de rota para o rótulo. Se você selecionar esta caixa de opção, o nome da ligação do método será incluído para que seja possível utilizar um nó RouteToLabel no fluxo de mensagens após o nó SOAPInput. Este tipo de propriedade é Boolean.  
Prefixo do rótulo Não Não Nenhuma O prefixo a ser incluído no nome do método ao rotear para o rótulo. Inclua um Prefixo de rótulo para evitar um conflito de nós de rótulos correspondentes quando você incluir múltiplos nós de entrada no mesmo fluxo de mensagens. Por padrão, não há prefixo de etiqueta, portanto o nome do método e da etiqueta são idênticos.

O prefixo padrão é uma cadeia vazia para que o nome da operação e o nome do rótulo sejam idênticos, mas o campo exibe a instrução do usuário: <digite um prefixo, se necessário>. Esta propriedade é ativada somente se a propriedade setDestinationList estiver ativada.

 
Rotear falhas no processamento de entrada para o terminal de falhas Não Sim Desmarcada Selecione esta caixa de opções para enviar qualquer falha ao terminal Failure durante o processamento SOAP de entrada. Se essa propriedade for selecionada, em uma situação durante o processamento SOAP de entrada que resulte em uma falha de SOAP, em vez enviar imediatamente a falha de SOAP de volta ao cliente, a falha será enviada para o terminal Failure em vez de permitir o processamento de registro no log e de recuperação. Nesta situação, é enviada uma lista de exceções para o terminal Failure com a mensagem de entrada como um BLOB. Por padrão, essa caixa de opções é limpa. sendProcessingFaultsToFailure
Cabeçalhos 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. A tabela é atualizada automaticamente quando a operação selecionada for atualizada. Pelo padrão, as caixas de opção na segunda coluna da tabela estão desmarcadas para todas as entradas na tabela definida pelo WSDL.

Você deve selecionar as caixas de opções para os cabeçalhos que deseja incluir 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 no fluxo em vez de causarem uma falha 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 que devem ser entendidos para WS-Addressing e WS-Security porque estes elementos são entendidos se você configurar Extensões WS.

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 SOAP definidos pelo usuário Não Sim Nenhuma É possível incluir cabeçalhos customizados nesta tabela. Utilize os controles Incluir, Editar e Excluir para manipular as linhas nesta tabela. É necessário assegurar que a caixa de opção para o cabeçalho customizado que você incluiu esteja selecionada (na segunda coluna da tabela), para que o cabeçalho seja incluído na lista cabeçalhos que devem ser entendidos. Esta propriedade é gerada no arquivo CMF.

Quando o nó é configurado para agir no modo de gateway, sem nenhum WSDL necessário, os cabeçalhos customizados dessa tabela têm sua Operação configurada como *. Os valores originais desses campos serão restaurados se o modo de operação do nó for alterado novamente para o modo do WSDL.

 

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

Propriedade M P Default Descrição
Utilizar Endereçamento do WS Não Não Desmarcada Essa propriedade indica se conectar ou não o Endereçamento WS no nó SOAPInput. Por padrão, essa caixa de opções é limpa. Se essa propriedade for selecionada, uma resposta poderá ser enviada de volta para um cliente de serviço da Web diferente, conforme especificado nas propriedades WS-Addressing. A resposta pode ser enviada usando um transporte diferente daquele usado para a mensagem recebida.
Colocar Cabeçalhos WS-Addressing no LocalEnvironment Não Não Desmarcada Esta propriedade especifica se o nó coloca cabeçalhos WS-Addressing recebidos na mensagem para a árvore de ambiente local. Os cabeçalhos WS-Addressing não são acessíveis para o fluxo se essa caixa de opção estiver desmarcada porque, pelo padrão, todos os cabeçalhos são processados e removidos.
WS-Security Não Sim   Esta propriedade complexa está no formato de uma tabela e consiste em duas colunas:
  • Alias
  • Expressão XPath
Você pode incluir expressões XPath com uma tabela Alias associada na tabela WS-Security. O Alias é resolvido em um conjunto de política criado pelo administrador. O Conjunto de Política resolve o Alias para criptografar ou assinar a parte da mensagem referida pela Expressão XPath. Você pode utilizar os controles Incluir, Editar e Excluir nesta tabela.

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

Propriedade M P Default Descrição
Domínio de mensagem Não Não SOAP O domínio utilizado para analisar a mensagem que chega. Por padrão, a mensagem propagada do nó SOAPInput está no domínio SOAP. Você não pode especificar um domínio diferente.

As propriedades de análise de mensagem de entrada 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 que chega é definida. Esse valor é configurado automaticamente para o conjunto de mensagens que contém o arquivo WSDL quando o 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 entrada são desativadas quando o nó é configurado para agir no modo de gateway.

Tipo de Mensagem Não Não   O nome da mensagem que chega. 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 que chega. Você não pode configurar esta propriedade.

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

Propriedade M P Default Descrição
Cronometragem de análise (Parse timing) Não Não On Demand Esta propriedade controla quando uma mensagem de entrada é 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 Selecionados Esta propriedade controla se os elementos da sintaxe na árvore de mensagens possuem tipos de dados obtidos do Esquema XML.

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 Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. 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 Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. 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 Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. 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 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ó SOAPInput são descritas na tabela a seguir. Consulte o Propriedades de Validação.

Propriedade M P Default 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 entrada contra o esquema XML gerado a partir do conjunto de mensagens. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo. O analisador SOAP invoca 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, Registro de Erros Local, Exceção e Lista de Exceções.

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

 

As propriedades Instâncias do nó SOAPInput são descritas na tabela a seguir.

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Conjunto de instâncias adicionais Não Sim Utilizar Conjunto Associado ao Fluxo de Mensagens Esta propriedade especifica se os encadeamentos de instância adicionais são alocados a partir de um conjunto de encadeamentos para todo o fluxo de mensagens ou de um conjunto de encadeamentos para utilização apenas por este nó.
  • Se você selecionar Utilizar Conjunto Associado ao Fluxo de Mensagens, as instâncias adicionais serão obtidas do valor do fluxo de mensagens.
  • Se você selecionar Usar Conjunto Associado ao Nó, instâncias adicionais serão alocadas com base no número especificado na propriedade Instâncias Adicionais.
 
Instâncias Adicionais Não Sim 0 O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. Por padrão, não são concedidas instâncias adicionais ao nó. additionalInstances
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.

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


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