Use o nó SOAPInput para processar mensagens SOAP do cliente para que o broker opere como um provedor SOAP de Serviços da Web.
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:
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.
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.
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 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.
|
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. 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:
Quando você salvar o arquivo do fluxo de mensagens, a validação de algumas das
propriedades relacionadas a WSDL ocorrerá para assegurar que:
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:
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:
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:
|
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:
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:
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:
|
||
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:
|
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ó.
|
|
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 |
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. |