Nó AggregateRequest

Este tópico contém as seguintes seções:

Finalidade

Utilize o nó AggregateRequest para registrar o fato de que mensagens de solicitações foram enviadas. Ele também coleta informações que ajudam o nó AggregateReply a construir a mensagem composta.

Agregação é uma extensão do modelo de aplicativo de pedido/resposta. Ela combina a geração e difusão de vários pedidos relacionados à recepção das respostas correspondentes e compila estas respostas em uma única mensagem de resposta agregada.

A função de agregação é fornecida pelos três seguintes nós:

  1. O nó AggregateControl marca o início de uma difusão de solicitações que fazem parte de uma agregação.
  2. O nó AggregateRequest registra o fato de que as mensagens de pedidos foram enviadas. Ele também coleta informação que ajuda o nó AggregateReply a construir a mensagem de resposta agregada.
  3. O nó AggregateReply marca o final de uma captação de agregação. Ele coleta respostas e as combina em uma única mensagem de resposta agregada.

O nó AggregateRequest é representado no pelo seguinte ícone:

 Ícone do nó AggregateRequest

Utilizando este nó em um fluxo de mensagens

Consulte a amostra do para ver como esse nó pode ser utilizado:

Configurando o Nó Aggregate Request

Quando você tiver colocado uma instância do nó AggregateRequest em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades mandatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó AggregateRequest da seguinte forma:

  1. Insira um valor para o Nome da Pasta.Esse nome é utilizado como uma pasta na mensagem composta do nó AggregateReply para armazenar a resposta para esse pedido. Essa propriedade é obrigatória; é necessário digitar um valor. O valor não precisa ser exclusivo.
  2. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  3. Clique em Aplicar para fazer as alterações no nó AggregateRequest sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Terminais e Propriedades

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

Terminal Descrição
Entrada O terminal de entrada que aceita mensagens enviadas como parte de um pedido de agregação.
Saída O terminal de saída para o qual a mensagem de entrada será roteada quando o processamento for concluído com êxito.

As tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é mandatória (marcado com um asterisco no diálogo de propriedades caso seja necessário digitar um valor quando nenhum padrão for definido), a coluna com cabeçalho C indica se a propriedades é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens no arquivo bar para implementá-lo).

A propriedade Básica do nó AggregateRequest é descrita na tabela a seguir.

Propriedade M C Padrão Descrição
Nome da Pasta Sim Não   O nome que é utilizado como uma pasta na mensagem composta do nó AggregateReply. Essa propriedade é obrigatória.

As propriedades de Descrição do nó AggregateRequest são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

Conceitos relacionados
Fluxos de Mensagem
Agregação de Fluxo de Mensagens

Tarefas relacionadas
Decidindo Quais Nós Utilizar
Tratando Erros em Fluxos de Mensagens
Configurando Fluxos de Agregação

Referências relacionadas
Nó AggregateControl
Nó AggregateReply