Use o nó SCARequest para enviar um pedido para o WebSphere Process Server. O nó é um nó de pedido e resposta síncrono e é bloqueado após enviar o pedido, até que a resposta seja recebida. O nó também pode enviar pedidos unidirecionais.
O nó SCARequest envia pedidos síncronos bidirecionais (pedido-resposta) de saída e operações unidirecionais (apenas pedido) para um processo de negócios no WebSphere Process Server.
Um arquivo de definição SCA do Broker de saída (.outsca) é necessário para configurar o nó SCARequest. A definição SCA do Broker contém dados específicos relacionados à ligação que é usada pelo componente de Exportação SCA.
O nó SCARequest está contido no repositório SCA da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
É possível usar o nó em qualquer fluxo de mensagens que precisar chamar um aplicativo em execução no WebSphere Process Server.
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.KeyAlias
É possível alterar o tempo limite alterando o valor no local a seguir no ambiente local:
LocalEnvironment.Destination.SCA.Request.Timeout
É possível alterar o tempo limite alterando o valor no local a seguir no ambiente local:
LocalEnvironment.Destination.SCA.Request.Timeout
Para uma ligação de Serviços da Web, é possível alterar a URL para a qual o pedido é enviado. Altere o valor no seguinte local no ambiente local:
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.WebServiceURL
Para uma ligação MQ, é possível alterar o Gerenciador de Filas de Pedidos e a Fila de Pedidos alterando os valores nos seguintes locais:
LocalEnvironment.Destination.SCA.Request.Binding.MQ.queueManagerName
LocalEnvironment.Destination.SCA.Request.Binding.MQ.queueName
Certifique-se de que o conjunto de mensagens contenha uma definição SCA do Broker com uma extensão .outsca com a qual o nó SCARequest será configurado.
Há dois métodos para colocar uma instância do nó SCARequest em um fluxo de mensagens: você pode arrastar uma instância do nó da paleta do nó ou arrastar uma definição SCA do Broker com uma extensão .outsca de um conjunto de mensagens para a tela do editor de fluxo de mensagens.
Se o pedido contiver uma operação bidirecional, o nó será bloqueado até que uma mensagem de resposta seja recebida ou pelo tempo definido pela propriedade de tempo limite (120 segundos por padrão). Se o período de tempo limite for excedido, a mensagem recebida no terminal de entrada do SCARequest será propagada para o terminal Failure.
Se o pedido contiver uma operação unidirecional, o nó enviará a mensagem de pedido, em seguida, roteará a mensagem de entrada direto para o terminal Out. Nesse caso, as propriedades na guia Análise de Mensagem de Resposta estão disponíveis.
Os valores para as diversas propriedades do nó são fornecidos pela definição SCA do Broker. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário inserir um valor (propriedades que não possuem um valor-padrão definido) são marcadas com um asterisco.
Para obter informações sobre como configurar o nó SCARequest para usar SSL, consulte Configurando uma Infraestrutura da Chave Pública e revise as informações relacionadas ao nó SOAPRequest .
Os terminais do nó SCARequest são descritos na tabela a seguir.
Nome | Tipo | Descrição |
---|---|---|
In | Dados de entrada | O nó é orientado por uma mensagem que chega no terminal In. |
Out | dados de saída | Quando uma mensagem tiver sido enviada para um recurso externo, ela será enviada para o terminal Out inalterada; exceto para a inclusão das informações de status. |
Failure | dados de saída | Uma falha no nó é enviada para o terminal de falha. |
Fault | dados de saída | Uma falha de SOAP do sistema externo é enviada para este terminal. Este terminal é usado apenas quando o Tipo de Ligação é Serviços da Web. |
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).
As propriedades Descrição do nó SCARequest são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | O tipo de nó | O nome do nó. |
Descrição curta | Não | Não | Nenhum | Uma breve descrição do nó. |
Descrição Longa | Não | Não | Nenhum | Texto que descreve a finalidade do nó no fluxo de mensagens. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Definição SCA do Broker | Sim | Não | nenhum | O nome da Definição SCA do Broker que contém propriedades de configuração para o nó SCA Request. Clique no botão Pesquisar para listar todas as Definições SCA do Broker relevantes na área de trabalho atual. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tipo de Ligação | Sim | Não | nenhum | O tipo de ligação que foi localizado na Exportação SCA. |
Tempo Limite de Pedido | Não | Sim | 120 | O tempo em segundos para aguardar por uma resposta do WebSphere Process Server, antes da expiração do pedido. Se o período de tempo limite for excedido, a mensagem recebida no terminal de entrada do SCARequest será propagada para o terminal de Falha. Esta propriedade será desativada se a definição SCA do Broker (entrada) contiver apenas operações unidirecionais. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do arquivo do WSDL | Sim | Não | <nenhum> | Este tipo de propriedade é String. Quando você seleciona um arquivo WSDL para o campo nome do arquivo WSDL, o WSDL é validado para garantir que ele seja compatível com WS-I. Apenas WSDL Implementável pode ser usado para configurar os nós SCA. 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. |
Tipo de porta | Sim | Não | A partir do WSDL | Este tipo de propriedade
é String. O campo lista todos os Tipos de portas definidos neste
arquivo WSDL selecionado na propriedade Nome do Arquivo WSDL. Condições de Erro:
As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway. |
Ligação Importada | Sim | Não | A partir do WSDL | Este tipo de propriedade
é String. Esta propriedade é atualizada sempre que o valor de Tipo de porta é alterado. O campo lista as ligações SOAP importadas com transporte HTTP ou JMS associado ao Tipo de porta selecionado. Quando você seleciona uma ligação, a guia de propriedades para o transporte associado é ativada, caso contrário ela fica desativada. As ligações são listadas na mesma ordem em que são exibidas no arquivo WSDL. A ligação selecionada é a que possui portas e operações. Se não existir esta ligação, será selecionada a ligação com portas. Se nenhuma das ligações possui portas, será selecionada a primeira ligação na lista. Condições de Erro:
As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway. |
Operação | Sim | Não | A partir do WSDL | Este tipo de propriedade
é String. A caixa Operação de Ligação contém todas as operações definidas pela ligação selecionada. A primeira operação na lista é selecionada por padrão. Essa propriedade é atualizada toda vez que o valor de ligação selecionado mudar As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway. |
Porta de serviço | Sim | Não | A partir do WSDL | Este tipo de propriedade
é String.
Este campo é atualizado sempre que a ligação selecionada for atualizada.
Este campo lista todas as portas WSDL que apontam para a ligação selecionada.
A primeira porta de serviço para a ligação é selecionada por padrão. Essa propriedade é atualizada cada vez que o valor de ligação selecionado é alterado. Condições de Erro:
As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway. |
Espaço de nomes de destino | Sim | Não | A partir do WSDL | Espaço de Nomes de Destino é
implementado como um campo de leitura. Este tipo de propriedade oculta é String. Ela é atualizada com o Espaço de Nomes de Destino do arquivo WSDL quando o Nome do Arquivo WSDL é configurado. As propriedades WSDL são desativadas quando o nó é configurado para agir no modo de gateway. |
URL de serviço da Web | Sim | Sim | nenhum | A URL do endereço SOAP selecionado. Essa propriedade é derivada automaticamente a partir do elemento <soap:address> da Porta de Serviço selecionada. No entanto, a porta selecionada é atualizada, a URL de Serviço da Web é atualizada, conforme necessário. No entanto, se você substituir o valor, então, seu valor persiste e a URL não é mais atualizada a partir da porta de serviço. Se optar por substituir essa propriedade, você deve especificá-la no formato http://<hostname>[:<port>]/[<path>], onde:
Para obter detalhes adicionais sobre como substituir esta propriedade, consulte Alterando a URL padrão para um nó SOAPRequest ou um SOAPAsyncRequest pedido de nó. |
Propagar apenas Corpo do SOAP, pertencente ao domínio XMLNSC | Não | Não | falso | Se selecionado, apenas o corpo do SOAP será propagado, caso contrário, a mensagem SOAP inteira será propagada. |
Utilizar Endereçamento do WS | Não | Não | falso | Selecione a caixa de opção se você desejar usar o WS-Addressing. |
Alias de chave de autenticação de cliente SSL | Não | Sim | "" (sequência vazia) | A propriedade keyAlias especifica um alias de autenticação SSL para o lado do cliente de uma conexão SCA. Tomar o valor padrão significa que a primeira chave apropriada é escolhida para você automaticamente. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Operação | Sim | Não | A partir do WSDL | A operação selecionada a partir da ligação selecionada no arquivo WSDL. O WSDL não é exibido; o WSDL está no arquivo de Definição SCA do Broker. |
Nome da fila | Sim | Sim | nenhum | A fila que recebe uma mensagem de pedido do WebSphere Message Broker. |
Nome do gerenciador de filas | Sim | Sim | nenhum | O Gerenciador de Filas que recebe um pedido do WebSphere Message Broker. |
Nome da Fila de Resposta | Sim | Sim | nenhum | A fila que recebe uma mensagem de resposta do WebSphere Process Server. |
Nome do Gerenciador de Filas de Resposta | Não | Sim | nenhum | O Gerenciador de Filas que recebe uma resposta do WebSphere Process Server. |
Correlação de Mensagem de Resposta | Sim | Não | FromMsgId | Esta propriedade indica como o WebSphere Message Broker deve preencher as informações do ID de correlação na mensagem de resposta. |
As propriedades Análise de Mensagem de Resposta do nó SCARequest são descritas na tabela a seguir. O nó configura estas propriedades automaticamente; a tabela descreve quando você pode alterá-las. .
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Domínio de mensagem | Não | Não | Configurado automaticamente de acordo com a ligação definida no nó correspondente. | O domínio que é utilizado para analisar a mensagem de resposta. Ele é determinado de acordo com o Binding type. Você poderá alterar essa propriedade se o Binding type for MQ. A propriedade é somente leitura quando o tipo de ligação é Serviços da Web. |
Modelo de mensagem | Não | Não | Selecionado automaticamente de acordo com a definição SCA do Broker escolhida no nó correspondente. | O nome ou local do modelo de mensagem no qual a mensagem de resposta está definida. O modelo de mensagem é automaticamente configurado para o modelo de mensagem que contém o arquivo SCA que está configurado no nó correspondente. Esta propriedade é somente leitura. |
Message | Não | Não | Selecionado automaticamente de acordo com a definição SCA do Broker escolhida no nó correspondente. | O nó detecta a mensagem automaticamente. Você poderá alterar essa propriedade se o tipo de ligação for MQ e o domínio de mensagem for MRM. Não será possível alterar essa propriedade se o tipo de ligação for Serviços da Web. |
Formato Físico | Não | Não | O nome do formato físico da mensagem de resposta. Você poderá alterar essa propriedade se o tipo de ligação for MQ e o domínio de mensagem for MRM. Não será possível alterar essa propriedade se o tipo de ligação for Serviços da Web. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validar | Não | Sim | Conteúdo e Valor | Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo. |
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. |
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. |