Ferramenta Aggregator

O Aggregator agrupa linhas de dados individuais em um único array. Ele funciona como o oposto da ferramenta Iterator:

O Iterator divide um array em elementos separados. O Aggregator combina esses elementos novamente em um array.

Se o Iterator permite processar cada item separadamente, o Aggregator ajuda a montar tudo no formato correto para a etapa final.

Quando uma etapa espera um array (por exemplo, os itens de uma fatura), o sistema precisa receber esse array como um único objeto estruturado.

Se você mapear campos diretamente de etapas diferentes após um Iterator, o sistema não consegue combiná-los automaticamente em um único array. Isso gera um conflito de estrutura e resulta em erro.

O Aggregator resolve esse problema. Ele combina dados de várias etapas em um único array estruturado. A etapa final recebe então tudo de uma única fonte, corretamente formatado e sem conflitos.

Fluxo de trabalho típico:

Iterator → Processamento de dados → Aggregator → Etapa final.

Nas configurações, você precisa adicionar campos. Cada campo representa uma coluna do futuro array.

Para cada campo, você configura dois parâmetros:

Nome Você define o nome do campo. Esse nome ficará disponível nas próximas etapas.

Selecionar um campo A fonte de dados de qualquer etapa anterior na automação. Esses valores selecionados vão formar as novas seções de linha que depois são passadas adiante como um array.

Dentro de uma mesma etapa de Aggregator, você pode coletar dados simultaneamente:

do Iterator; de ferramentas de processamento (por exemplo, Operação matemática); de outras etapas anteriores.

Vamos analisar um exemplo real de automação. O objetivo é criar uma fatura no Zoho Books quando um novo pedido é recebido, e enviar todas as posições do pedido como itens de linha. A automação fica assim:

Webhook → Buscar cliente → Iterator → Processamento de dados → Aggregator → Criar fatura

A automação começa com Webhook: Webhook de entrada.

O webhook envia um pedido que inclui um array de produtos. Cada item contém:

nome do produto; preço; quantidade; imposto; frete; código promocional.

Nessa etapa, os dados existem como um único objeto contendo um array de itens.

A próxima etapa é Google Sheets: Buscar uma linha.

Aqui, a automação usa o e-mail recebido do webhook para buscar o cliente correspondente em uma tabela do Google Sheets. Assim que a linha correta é encontrada, é obtido o ID do cliente, necessário para criar a fatura no Zoho Books.

Essa lógica é independente do processamento do array, mas necessária para a etapa final.

Nessa etapa, o Iterator seleciona o array de Items recebido do webhook.

Ao escolher Webhook de entrada, a automação divide os itens do pedido em linhas individuais. Cada produto é então processado separadamente nas etapas seguintes.

Isso permite calcular impostos, modificar descrições ou ajustar valores para cada item antes de reagrupá-los em um array estruturado.

Depois do Iterator, cada item é processado separadamente.

Nessa etapa, você pode aplicar ferramentas adicionais, por exemplo:

usar a ferramenta Remover Tags para limpar a descrição do produto; usar a ferramenta Operação matemática para calcular o imposto ou outros valores.

Depois do processamento, é adicionada a etapa Ferramenta: Aggregator.

É aqui que acontece a transformação principal.

Nas configurações do Aggregator, são adicionados os campos:

Text → do Remover Tags UnitCost → do Iterator Quantity → do Iterator Item tax → do Iterator Discount → do Webhook de entrada Shipping → do Iterator Tax% → da Operação matemática Product name → do Iterator

O que acontece em seguida?

O Aggregator:

Pega a primeira iteração. Coleta todos os campos especificados. Forma uma linha do array. Passa para a segunda iteração. Repete o processo.

Como resultado, um novo array estruturado é criado. Esse array se torna a única fonte de dados para a próxima etapa.

Depois do Aggregator, é usada a ferramenta Table lookup para transformar valores específicos antes de enviá-los ao Zoho Books.

Nessa etapa, o sistema verifica o valor recebido da etapa anterior (por exemplo, uma porcentagem de imposto ou um código interno) e o substitui pelo ID correspondente exigido pelo Zoho Books.

Isso é necessário porque o Zoho Books não aceita porcentagens brutas como 5 ou 20. Em vez disso, ele exige Tax IDs internos. A etapa Table lookup mapeia os valores legíveis para os IDs exatos esperados pelo serviço.

Depois de configurar as etapas anteriores, adicione a ação Zoho Books: Create Invoice.

Na seção Line items, cada campo é mapeado a partir do resultado do Aggregator:

Name → Aggregator: Product name Description → Aggregator: Text Rate → Aggregator: UnitCost Quantity → Aggregator: Quantity Percentage tax → Aggregator: Tax%

Isso significa que o Zoho Books recebe um array de itens de linha totalmente estruturado, com todos os valores necessários já processados e formatados corretamente.

O Aggregator garante que os dados baseados em array sejam enviados corretamente para o serviço final.

Ele combina as linhas processadas em um único array estruturado que o serviço receptor pode aceitar sem conflitos ou problemas de formatação.

Se a sua automação usa o Iterator e coleta dados de array de várias etapas, o Aggregator se torna uma parte essencial do fluxo de trabalho. Ele torna as automações complexas estáveis, previsíveis e tecnicamente corretas.