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

PedidoAssíncronoSCA

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.

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ó 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.

Diagrama mostrando o relacionamento entre o nó SCAAsynchronousRequest e o nó SCAAsynchronousResponse.

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:

Ícone do nó SCAAsyncRequest

Utilizando Este Nó em um Fluxo de Mensagens

Consulte o seguinte exemplo para ver como usar o nó:

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
É possível alterar o alias de chave de autenticação SSL alterando o valor no seguinte local no ambiente local:
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.KeyAlias

Configurando o Nó PedidoAssíncronoSCA

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.

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.

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.

  1. Opcional: Na guia Descrição , digite uma Descrição curta, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, configure as propriedades Identificador Exclusivo e Definição SCA do Broker.
    • Identificador Exclusivo. Você deve especificar a cadeia exclusiva que é comum para seu par de nós PedidoAssíncronoSCA e RespostaAssíncronaSCA. Essa propriedade é obrigatória.
    • Em Definição SCA do Broker, especifique o nome da definição SCA do Broker que contém propriedades de configuração para o nó PedidoAssíncronoSCA. Se você criou o nó arrastando uma definição SCA do Broker de um conjunto de mensagens para a tela do editor de fluxo de mensagens, esta propriedade será pré-configurada com o nome da definição SCA do Broker. Se você criou o nó selecionando-o na paleta, poderá configurar esta propriedade de uma das seguintes maneiras:
      • Se você tiver uma definição SCA do Broker, poderá selecioná-la a partir das definições SCA do Broker, clicando em Pesquisar.
      • Digite um nome de arquivo que seja relativo ao projeto de conjunto de mensagens no qual a definição SCA do Broker existe.
      • Se você tiver definições SCA do Broker, mas nenhum conjunto de mensagens, poderá criar um conjunto de mensagens:
        1. Clique em Pesquisar para abrir a área de janela Seleção de Definição SCA do Broker.
        2. Clique em Importar/Criar Novo para abrir o assistente Importar Definição SCA do Broker.
        3. Insira o nome do conjunto de mensagens e o nome do projeto do conjunto de mensagens, em seguida, clique em Avançar.
        4. Escolha a opção relevante:
          • Se sua definição de SCA do Broker existir na área de trabalho, clique em Usar recursos da área de trabalho e selecione a definição de SCA do Broker.
          • Se sua definição de SCA do Broker estiver no sistema de arquivos, clique em Usar recursos externos, selecione a definição de SCA do Broker, clique em Avançar.
        5. Selecione a definição SCA do Broker a ser importada.
        6. Clique em Concluir. Um novo projeto de conjunto de mensagens e conjunto de mensagens com definições de mensagens. A definição SCA do Broker é incluída na pasta Definições SCA do Broker.
        7. Selecione a definição SCA do Broker a partir da janela Seleção de Definição SCA do Broker, em seguida, clique em OK.
      • Se você tiver um conjunto de mensagens, mas nenhuma definição SCA do Broker, gere uma definição SCA do Broker seguindo as instruções em Conjuntos de Mensagens: Gerando uma Definição SCA do Broker a partir de um Conjunto de Mensagens.
      • Arraste uma definição SCA do Broker de um conjunto de mensagens para o nó.
  3. Na guia Ligação, especifique as propriedades relacionadas à ligação do WebSphere Process Server. Algumas das propriedades nessa guia são derivadas da definição SCA do Broker.
    • O valor da propriedade Tipo de Ligação é derivado das informações sobre ligação na definição SCA do Broker. Ele é somente leitura. Os valores possíveis são:
      • WebService. Os pedidos do WebSphere Process Server são enviados como mensagens SOAP através do transporte HTTP. Consulte a tabela de propriedades WSDL em Terminais e Propriedades para obter detalhes das propriedades de ligação que são fornecidas pela definição de SCA do Broker ou que você precisa configurar.
      • MQ. Os pedidos do WebSphere Process Server chegam como mensagens do WebSphere MQ. Consulte a tabela de propriedades do MQ e a tabela de Transacionalidade no Terminais e Propriedades, para obter detalhes das propriedades de ligação que são fornecidas pela definição de SCA do Broker ou que você precisa configurar.

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 .

Terminais e Propriedades

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.

Note: Os valores para as propriedades devem ser fornecidos no nó. Eles não são marcados como obrigatórios no nó porque a definição SCA do Broker pode não conter todos os valores das propriedades, resultando em erros do nó sendo mostrados. Você deve fornecer valores para as propriedades que não foram configuradas pelo arquivo de definição SCA do Broker.
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:
  • O Tipo de Porta selecionado não contém pelo menos uma operação.
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:
  • Nenhuma ligação SOAP (com transporte HTTP) no arquivo WSDL está associada com o Tipo de Porta.
  • A ligação selecionada não possui nenhuma operação.
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:
  • Nenhuma das portas aponta para a ligação selecionada.
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:
  • http://<nome_do_host> deve ser especificado.
  • <port> tem um padrão de 80. Se você especificar um valor, deverá incluir : antes do número da porta.
  • <path> tem um padrão de /. Se você especificar um valor, deverá inclui / antes do caminho.
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.

Note: Os valores para as propriedades devem ser fornecidos no nó. Eles não são marcados como obrigatórios no nó porque a definição SCA do Broker pode não conter todos os valores das propriedades, resultando em erros do nó sendo mostrados. É necessário fornecer valores para as propriedades que não foram configuradas pelo arquivo de definição de SCA do Broker.
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.
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:59


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