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.
O nó permite que o broker receba a resposta para um pedido assíncrono anterior feito a partir de um nó PedidoAssíncronoSCA.
O nó está contido no grupo 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 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
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.
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.
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. |
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. |
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.
|
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 Nó. Por padrão, não são concedidas instâncias adicionais ao nó. |
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. |