Use o nó PedidoAssíncronoSCA com o nó RespostaAssíncronaSCA para construir um par de fluxos de mensagens que chamam um componente de serviço do WebSphere Process Server de forma assíncrona.
O nó PedidoAssíncronoSCA envia um pedido para um processo de negócios em execução no WebSphere Process Server, mas o nó não aguarda o recebimento da resposta associada. No entanto, o nó PedidoAssíncronoSCA aguarda uma confirmação antes de continuar com o fluxo de mensagens. A resposta ao pedido do Process Server é recebida pelo nó RespostaAssíncronaSCA, que pode estar no mesmo fluxo de mensagens ou em um fluxo de mensagens separado. Os nós são utilizados como um par e correlacionam respostas em relação aos pedidos originais.
O nó PedidoAssíncronoSCA é a primeira metade do par de nós de pedido e resposta assíncronos. O nó PedidoAssíncronoSCA envia um pedido para um processo de negócios em execução no WebSphere Process Server. O pedido é enviado pelo nó PedidoAssíncronoSCA, mas o nó PedidoAssíncronoSCA não recebe a resposta. A resposta é recebida por um nó RespostaAssíncronaSCA que está em execução em um encadeamento diferente. Geralmente o nó RespostaAssíncronaSCA está no início de um fluxo de mensagens diferente; no entanto, deve estar no mesmo grupo de execução que o nó PedidoAssíncronoSCA.
Uma definição SCA do Broker é necessária para configurar o nó PedidoAssíncronoSCA e o nó RespostaAssíncronaSCA. A definição SCA do Broker contém dados específicos relacionados à ligação do Process Server.
O nó PedidoAssíncronoSCA está contido no repositório SCA da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
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.
É possível alterar a operação que deveria ser invocada alterando o valor no seguinte local do ambiente local:
LocalEnvironment.Destination.SCA.Request.Operation
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
É possível armazenar dados de contexto no seguinte local no ambiente local. O nó SCAAysncResponse pode, posteriormente, recuperar estes dados.
LocalEnvironment.Destination.SCA.Request.UserContext
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.KeyAlias
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ó PedidoAssíncronoSCA será configurado.
Há dois métodos para colocar uma instância do nó PedidoAssíncronoSCA em um fluxo de mensagens: você pode arrastar uma instância do nó a partir 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.
Os valores para muitas das propriedades do nó são fornecidos na definição de 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ó PedidoAssíncronoSCA para usar SSL, consulte Configurando uma Infraestrutura da Chave Pública e revise as informações relacionadas ao nó SOAPAsyncRequest .
Os terminais do nó PedidoAssíncronoSCA são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
In | O terminal de entrada que aceita uma mensagem. |
Failure | O terminal de saída para o qual a mensagem será enviada se for detectada uma falha no nó. |
Out | O terminal de saída para o qual a mensagem é enviada após o nó enviar com êxito a mensagem para o recurso SCA. |
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ó PedidoAssíncronoSCA 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ó PedidoAssíncronoSCA são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Identificador exclusivo | Sim | Sim | Não configurado | A propriedade especifica um identificador exclusivo que é comum para o par de nós PedidoAssíncronoSCA e RespostaAssíncronaSCA. |
Definição do SCA do Broker | Sim | Sim | Não configurado | A propriedade especifica o nome da definição SCA do Broker que contém as propriedades de configuração para o nó PedidoAssíncronoSCA. Você pode clicar em Pesquisar para ver uma lista de todas as definições SCA do Broker relevantes na área de trabalho atual. |
A propriedade Ligação do nó PedidoAssíncronoSCA é descrita na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tipo de Ligação | Sim | Não | A partir da exportação SCA | Esta propriedade é somente leitura. Ela é fornecida pelo kit de ferramentas quando o arquivo de configuração de exportação SCA é analisado. A propriedade descreve o tipo de ligação que foi localizado na definição SCA do Broker. Se a ligação for Serviços da Web, apenas as propriedades de WSDL serão mostradas. Se a ligação for MQ, apenas as propriedades de MQ serão mostradas. |
As propriedades de WSDL 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 | Não configurado | O nome do arquivo WSDL é obtido do arquivo WSDL referenciado pela definição SCA do Broker. |
Espaço de nomes de destino | Não | Não | A partir da definição SCA do Broker | Este tipo de propriedade é String. Ele é fornecido pelo kit de ferramentas quando o arquivo de configuração WSDL referenciado pela definição SCA do Broker é analisado. |
Tipo de porta | Sim | Não | Por padrão, o Tipo de Porta referenciado na definição SCA do Broker. | Este tipo de propriedade
é String. Esta propriedade
é somente leitura. Condições de Erro:
|
Ligação importada | Sim | Não | A partir da definição SCA do Broker | Este tipo de propriedade
é String. Ele é fornecido
pelo kit de ferramentas quando o WSDL referenciado pela definição SCA do
Broker é analisado. Condições de Erro:
|
Operação | Sim | Não | A partir da definição SCA do Broker | Este tipo de propriedade
é String. A propriedade Operação lista as operações definidas pelo tipo de porta. A primeira operação bidirecional na lista é selecionada por padrão. Apenas operações bidirecionais são suportadas. |
Porta de serviço | Sim | Não | A partir da definição SCA do Broker | Este tipo de propriedade
é String. Ela é fornecido
pelo kit de ferramentas quando o arquivo de configuração WSDL é analisado. Condições de Erro:
|
URL de serviço da Web | Sim | Sim | A partir da definição SCA do Broker | Este tipo de propriedade
é String. Essa propriedade é derivada automaticamente a partir do elemento <soap:address> da Porta de Serviço selecionada.
No entanto, a porta selecionada é atualizada, a URL de Serviço da Web é atualizada, conforme necessário.
Entretanto, se você substituir o valor, 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://<nome_do_host>[:<porta>]/[<caminho>], onde:
|
Alias de chave de autenticação de cliente SSL | Não | Sim | "" (sequência vazia) | A propriedade keyAlias especifica um alias de chave de autenticação SSL para o lado do cliente de uma conexão PedidoAssíncronoSCA. 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 da definição SCA do Broker | As operações disponíveis que estão localizadas na interface da definição SCA do Broker. Apenas operações bidirecionais são suportadas. |
Nome da fila | Sim | Sim | A partir da definição SCA do Broker | O nome da fila que recebe uma mensagem de pedido
do WebSphere Message Broker. Isso é obtido
a partir da definição SCA do Broker, mas pode ser atualizado diretamente no
nó. Esta pode ser uma fila remota; consulte "Como o Enfileiramento Distribuído Funciona?" na seção Intercomunicação do centro de informações do WebSphere MQ. |
Nome do gerenciador de filas | Sim | Sim | A partir da definição SCA do Broker | O nome do gerenciador de filas que recebe
uma mensagem do WebSphere Message Broker. Isto é obtido da definição de SCA do Broker, mas pode
ser atualizado diretamente no nó. Se for usada uma fila remota, deixe esta propriedade em branco para permitir que o WebSphere MQ resolva o nome do gerenciador de filas. |
Nome da Fila de Resposta | Sim | Sim | A partir da definição SCA do Broker | O nome da fila que recebe uma mensagem de resposta do WebSphere Process Server. Isto é obtido da definição de SCA do Broker, mas pode ser atualizado diretamente no nó. |
Nome do Gerenciador de Filas de Resposta | Não | Sim | A partir da definição SCA do Broker | O nome do gerenciador de filas que recebe
uma resposta do WebSphere Process Server. Isto é obtido da definição de SCA do Broker, mas pode
ser atualizado diretamente no nó. Este gerenciador de filas deve ser local para o broker. |
Correlação de Mensagem de Resposta | Sim | Não | A partir da definição SCA do Broker | Esta propriedade indica como o WebSphere Process Server fornece
informações do ID de correlação na mensagem de resposta. Essas informações de correlação são usadas pelo WebSphere Message Broker, para determinar qual mensagem
é uma resposta para qual pedido e são fornecidas pelo kit de ferramentas quando
o arquivo de exportação SCA é analisado. Selecione Do ID de Mensagem se for esperado que o WebSphere Process Server copie o campo MQMD MSGID no pedido para o campo MQMD CORRELID na resposta. Selecione Do ID de Correlação se for esperado que o WebSphere Process Server copie o campo MQMD CORRELID no pedido para o campo MQMD CORRELID na resposta. |
A propriedade Transacionalidade do nó PedidoAssíncronoSCA é descrita na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Não | Não | Para MQ, 'sim' | Esta propriedade pode ser 'automático', 'não' ou 'sim'. A propriedade é ativada apenas quando o Tipo de Ligação é MQ. |
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. |