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

SCARequest

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.

Nota: Da Versão 7.5 em diante, o WebSphere Process Server foi renomeado para IBM® Business Process Manager Avançadas. As informações deste tópico referentes ao WebSphere Process Server Versão 7.0 também são aplicáveis ao IBM Business Process Manager Avançadas Versão 7.5.

Propósito

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:

Ícone do Nó SCARequest

Utilizando Este Nó em um Fluxo de Mensagens

É possível usar o nó em qualquer fluxo de mensagens que precisar chamar um aplicativo em execução no WebSphere Process Server.

Você pode alterar o alias de chave de autenticação de cliente SSL alterando o valor no seguinte local no ambiente local:
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

Configurando o Nó SCARequest

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.

Arrastando um nó para a tela
Se você arrastou uma instância do nó da paleta para a tela, use um dos seguintes métodos para começar a configurá-la:
  • Arraste uma definição SCA do Broker com uma extensão .outsca para o nó.
  • Digite o nome do arquivo na opção Nome do Arquivo SCA na visualização Propriedades do nó.
  • Navegue para o arquivo (opção Nome do Arquivo SCA na visualização Propriedades do nó.)
Arrastando um arquivo .outsca para a tela
  • Se o arquivo .outsca contiver um WSDL que possui uma única operação unidirecional definida, um nó SCARequest será criado.
  • Se o arquivo .outsca contiver um WSDL que possui apenas operações de pedido-resposta, você precisará primeiro selecionar a operação e informar se deseja que o pedido de saída seja enviado de forma síncrona ou assíncrona. Para um pedido síncrono, um nó SCARequest é criado e configurado. Para um pedido assíncrono, um par de nós PedidoAssíncronoSCA e RespostaAssíncronaSCA é criado e configurado.
  • Se o arquivo .outsca contiver um WSDL que possui uma mistura de operações unidirecionais e de pedido-resposta definida e você selecionar uma operação unidirecional, um nó SCARequest será criado.

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.

Os domínios SOAP, XMLNSC, XMLNS, MRM, MIME, JSON, DFDL e BLOB estão disponíveis para analisar a resposta.
  • Se o Tipo de Ligação for Serviço da Web, o domínio de mensagem será SOAP.
  • Se o Tipo de Ligação for MQ, o domínio padrão será BLOB se alguma operação tiver ligações de dados não-XML. Se todas as operações tiverem ligação de dados XML, o domínio padrão será XMLNSC. A ligação de dados será identificada como XML se a Exportação SCA usar com.ibm.websphere.sca.mq.data.impl.mqdatabindingimplxml ou com.ibm.wbiserver.datahandler.xml.XMLDataHandler.

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 .

Terminais e Propriedades

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.
As propriedades Básicas do nó SCARequest são descritas na tabela a seguir.
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.
As propriedades de Ligação do nó SCARequest são descritas na tabela a seguir.
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.
As propriedades de Serviços da Web são descritas na tabela a seguir. Estas propriedades serão mostradas apenas se o tipo de ligação for Serviços da Web.
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:
  • O Tipo de porta selecionado não contém pelo menos uma operação.

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

Ligação Importada Sim Não 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:
  • Nenhuma ligação SOAP (com transporte HTTP ou JMS) no arquivo WSDL está associada ao tipo de Porta.
  • A ligação selecionada não possui nenhuma operação.

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

Operação 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:
  • 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 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:
  • http://<nome_do_host> deve ser especificado.
  • <port> tem um padrão de 80. Se você especificar um valor, deverá incluir os dois pontos : antes do número da porta.
  • <path> possui um padrão igual a /. Se um valor for especificado, você deve incluir a / antes do caminho.

Para obter detalhes adicionais sobre como substituir esta propriedade, consulte Alterando a URL padrão para um nó SOAPRequest ou um SOAPAsyncRequest pedido de nó.

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.
As propriedades de MQ são descritas na tabela a seguir. Estas propriedades serão mostradas apenas se o tipo de ligação for MQ.
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.
As propriedades de validação são descritas na tabela a seguir. Para obter informações adicionais, consulte Propriedades de Validação.
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.
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:31:01


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