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

RespostaAssíncronaSCA

Utilize o nó RespostaAssíncronaSCA com o nó PedidoAssíncronoSCA para construir um par de fluxos de mensagens que iniciam um componente de forma assíncrona.

Propósito

O nó permite que o broker receba a resposta para um pedido assíncrono anterior feito a partir de um nó PedidoAssíncronoSCA.

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

O nó está contido no grupo SCA da paleta e é representado no WebSphere® Message Broker Toolkit pelo seguinte ícone:

Ícone do nó SCAAsyncResponse

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 recuperar dados de contexto que foram armazenados pelo nó SCAAsyncRequest a partir do seguinte local no ambiente local:

LocalEnvironment.SCA.Response.UserContext

É possível acessar informações de cabeçalho e contexto SOAP em uma resposta de entrada no ambiente local, nos seguintes locais:

LocalEnvironment.SCA.Response.Binding.WebServices.SOAP.Header
LocalEnvironment.SCA.Response.Binding.WebServices.SOAP.Context

Configurando o Nó

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ó será configurado.

Há dois métodos para colocar uma instância do nó em um fluxo de mensagens: É possível arrastar uma instância do nó a partir da paleta do nó ou arrastar uma definição de SCA do Broker com uma extensão .outsca de um conjunto de mensagens para a tela do editor de fluxo de mensagens. Arrastar uma definição SCA do Broker com uma extensão .outsca para a tela cria um par de nós PedidoAssíncronoSCA e RespostaAssíncronaSCA.

Se você arrastou uma instância do nó da paleta para a tela, deverá começar a configurá-la arrastando uma definição SCA do Broker com uma extensão .outsca para o nó. Os valores para muitas das propriedades do nó são fornecidos na definição de SCA do Broker. Se você arrastou uma definição de SCA do Broker para a tela e criou um par de nós PedidoAssíncronoSCA e RespostaAssíncronaSCA, muitos dos valores para as propriedades do nó já terão sido fornecidos a partir da 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 o fragmento de URL exclusivo que seja comum a 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ó. 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.
      • 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 SCA do Broker estiver no sistema de arquivos, clique em Usar Recursos Externos, selecione a definição SCA do Broker e, em seguida, 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ó.
      • Digite um nome de arquivo que seja relativo ao projeto de conjunto de mensagens no qual a definição SCA do Broker existe.
  3. Na guia Ligação, especifique as propriedades relacionadas à ligação. 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 e é somente leitura. Os valores possíveis são:
    • WebService. As respostas são enviadas como mensagens SOAP através do transporte HTTP.
    • MQ. As respostas chegam como mensagens.

    A caixa de opção Propagar apenas o corpo SOAP (pertencente ao domínio XMLNSC) será mostrada apenas quando o Tipo de Ligação for Serviços da Web. Ela não é mostrada quando o Tipo de Ligação é MQ; não há nenhuma propriedade de ligação específica do MQ.

  4. Na guia Análise de Mensagem de Entrada, as propriedades são configuradas automaticamente a partir do arquivo de definição SCA do Broker.
    • Se o Tipo de Ligação for Serviços da Web, o domínio de Mensagem será sempre SOAP. Se o Tipo de Ligação for MQ, é possível alterar o domínio para MRM, XMLNSC, XMLNS, MIME, JSON, DFDL ou BLOB.
    • Se o Tipo de Ligação for MQ, o domínio de Mensagem assumirá por padrão XMLNSC se as ligações de dados para todas as operações estiverem usando XML. Caso contrário, o domínio padrão será BLOB.
  5. Na subguia Opções de Analisador , defina as propriedades associadas ao analisador.
    • Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para obter informações sobre como fazer a mensagem ser analisada automaticamente, consulte Analisando On Demand.
    • Opções do Analisador XMLNSC. Configure os valores para as propriedades que determinam como o analisador XMLNSC opera. Para obter mais informações, consulte Manipulando Mensagens no Domínio XMLNSC.
  6. Utilize a guia Validação para fornecer validação com base no conjunto de mensagens para mensagens predefinidas. Para obter informações adicionais sobre validação, consulte Validando Mensagens. Para obter mais informações sobre como completar essa guia, consulte Propriedades da Guia Validação.
  7. Utilize a guia Instâncias para especificar como os encadeamentos adicionais são tratados pelo fluxo de mensagens.
    • A propriedade Conjunto de instâncias adicionais especifica se os encadeamentos de instâncias adicionais para são alocados de um conjunto de encadeamentos para todo o fluxo de mensagens ou de um conjunto de encadeamentos para utilização apenas por esse nó. Por padrão, esta propriedade é configurada para Utilizar Conjunto Associado ao Fluxo de Mensagens.
    • A propriedade Instâncias adicionais especifica o número de encadeamentos adicionais que o broker pode utilizar para atender o fluxo de mensagens e possui o valor padrão 0.

Terminais e Propriedades

Os terminais do nó são descritos na tabela a seguir.

Terminal Descrição
Falha O terminal de saída para o qual a mensagem será roteada se for detectado um defeito quando a mensagem for propagada.
Out O terminal de saída para o qual a mensagem será roteada se tiver sido propagada com êxito e se for necessário processamento adicional neste fluxo de mensagens.
Fault O terminal de saída para o qual uma mensagem de falha SOAP será roteada se o Tipo de Ligação for Serviços da Web. O terminal de Falha não é usado por nenhum outro tipo de Tipo de Ligação.
Catch O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção de recebimento de dados e capturada por este nó.

Quando tiver colocado uma instância do nó em um fluxo de mensagens, poderá configurá-la; consulte Configurando um Nó do Fluxo de Mensagens. 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.

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 de Descrição do nó 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ó: SOAPAsyncResponse 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ó são descritas na tabela a seguir:

Propriedade M C Padrão Descrição
Identificador exclusivo Sim Não Não configurado Especifique o identificador exclusivo que é comum para o par de nós.
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ó. Você pode clicar em Pesquisar para ver uma lista de todas as definições SCA do Broker relevantes na área de trabalho atual.
.
As propriedades de Ligação do nó são descritas na tabela a seguir:
Propriedade M C Padrão Descrição
Tipo de Ligação Sim Não Não configurado O tipo de ligação que foi localizado na Importação SCA.
extractSOAPBody Não Não Desmarcada Esta opção estará disponível se a ligação for Serviços da Web. Se a caixa de seleção estiver marcada, apenas o corpo SOAP será propagado. Se ela for limpa, a mensagem SOAP inteira será propagada.

As propriedades de Análise de Mensagem de Resposta do nó 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 Tipo de Ligação. Você poderá alterar essa propriedade se o Tipo de Ligação 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 esta propriedade se o Tipo de Ligação for MQ e o domínio de mensagem for MRM. Você não poderá alterar esta 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 Opções do Analisador do nó são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Cronometragem de análise Sim Não On Demand Essa propriedade controla quando uma mensagem de resposta é analisada. Os valores válidos são On Demand, Imediato e Completo.

Por padrão, o tempo de análise é configurado como On demand, o que faz com que a análise da mensagem de entrada 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 o analisador XMLNSC cria elementos de sintaxe na árvore de mensagens com tipos de dados retirados do Esquema XML.
Reter conteúdo misto (Retain mixed content) Sim Não Desmarcada Esta propriedade controla se o analisador criará elementos na árvore de mensagens quando encontrar texto misto em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se a caixa de opção for limpa, o texto misto será ignorado e nenhum elemento será criado.
Reter comentários (Retain comments) Sim Não Desmarcada Esta propriedade controla se o analisador cria elementos na árvore de mensagens quando ele encontra comentários em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se a caixa de opção for limpa, os comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento (Retain processing instructions) Sim Não Desmarcada Esta propriedade controla se o analisador criará elementos na árvore de mensagens quando encontrar instruções de processamento em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se a caixa de opção for limpa, as instruções de processamento serão ignoradas e nenhum elemento será criado.
Elementos opacos Não Não Não configurado Esta propriedade é usada para especificar uma lista de elementos na mensagem de resposta 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 de Validação do nó são descritas na tabela a seguir.

Se a validação falhar, a mensagem será propagada para o terminal de falha, se este terminal estiver conectado. Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Propriedade M C Padrão Descrição
Validar Sim 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 Sim Sim 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, Lista de Exceções, Log de Erros Local e Exceção.
As propriedades de Segurança do nó são descritas na tabela a seguir. Configure valores para estas propriedades para controlar a extração de uma identidade de uma mensagem (quando um perfil de segurança estiver associado ao nó). Para obter informações adicionais sobre estas propriedades, consulte Identidade, Configurando a Extração de uma Identidade ou Token de Segurança, Visão Geral de Segurança do Fluxo de Mensagens e Configurando a Segurança do Fluxo de Mensagens.
Propriedade M C Padrão Descrição
Tipo de token de identidade Não Não Nenhum(a) Essa propriedade especifica o tipo de token de identidade presente na mensagem de entrada. Os valores válidos são: Padrão do Transporte, Nome de Usuário, Nome de Usuário + Senha, Asserção SAML e Certificado X.509. Se esta propriedade não for especificada, a identidade será recuperada a partir do cabeçalho de transporte Basic-Auth e o tipo será configurado como Nome de Usuário + Senha.
Local do token de identidade Não Não Nenhum(a) Essa propriedade especifica onde, na mensagem, a identidade pode ser localizada. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou uma cadeia literal. Se você utilizar uma cadeia literal, ela será colocada entre aspas e deverá conter um ponto final (.). Se essa propriedade não for especificada, a identidade será recuperada do cabeçalho de transporte MQMD.UserIdentifier.
Local da senha de identidade Não Não Nenhum(a) Essa propriedade especifica onde, na mensagem, a senha pode ser localizada. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou uma cadeia literal. Se você utilizar uma cadeia literal, ela será colocada entre aspas e deverá conter um ponto final (.). Se não for especificada, a senha não será configurada. Esta propriedade poderá ser configurada apenas se Tipo de token de identidade estiver configurado como Nome de Usuário + Senha.
Local de IssuedBy da identidade Não Não Nenhum(a) Esta propriedade especifica uma cadeia ou expressão de caminho que descreve o emissor da identidade. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou uma cadeia literal. Se você utilizar uma cadeia literal, ela será colocada entre aspas e deverá conter um ponto final (.). O valor especifica o Emissor que é passado para um provedor WS-Trust v1.3 STS. Se essa propriedade não for especificada, o valor MQMD.PutApplName será utilizado. Se você deixar o campo Local issuedBy da Identidade em branco e MQMD.PutApplName também estiver em branco, a cadeia MQ será utilizada.
Tratar exceções de segurança como exceções normais Não Não False Esta propriedade especifica se as exceções de segurança (como "Acesso Negado") devem ser tratadas como exceções normais e propagadas para o terminal Failure (se conectado). Esta propriedade é desativada por padrão, assegurando que as exceções de segurança restaurarão a mensagem, mesmo que o terminal Failure esteja conectado.

As propriedades de Instâncias do nó são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Conjunto de instâncias adicionais Não Sim Fluxo O conjunto do qual as instâncias adicionais são obtidas.
  • Se você selecionar Fluxo, instâncias adicionais serão obtidas do valor do fluxo de mensagens.
  • Se você selecionar , instâncias adicionais serão alocadas do conjunto de instâncias adicionais para esse nó; a quantidade alocada é especificada na propriedade Instâncias Adicionais.
Instâncias Adicionais Não Sim 0 O número de instâncias adicionais que o nó poderá iniciar se a propriedade Conjunto de Instâncias Adicionais estiver configurada como . Por padrão, não são concedidas instâncias adicionais ao nó.
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 | ac68540_.dita