Consolidação de Dados e Transformação de Array usando o Nó Function - Fluxo de trabalho n8n

• Usuários do n8n que precisam reestruturar e consolidar payloads de dados divididos.


• Desenvolvedores que necessitam de lógica de transformação personalizada em JavaScript dentro de um fluxo de trabalho do n8n.


• Especialistas em automação que trabalham com APIs que exigem um array JSON único e unificado como entrada.


• Pessoas que estão aprendendo técnicas avançadas de manipulação de dados em templates do n8n.

A transformação de dados é um requisito fundamental para automações robustas. Embora muitos nós do n8n gerem itens de saída individuais (dividindo os dados), os serviços subsequentes frequentemente exigem um array único e unificado contendo todos os registros. Este poderoso fluxo de trabalho do n8n resolve esse desafio ao fornecer uma configuração de nó reutilizável no n8n que mescla múltiplos itens em um único array JSON abrangente.

Este template específico do n8n usa o nó Function do n8n para mapear os itens de entrada, resolvendo o problema comum de consolidação de itens de forma eficiente e confiável, tornando seu fluxo de trabalho geral do n8n mais limpo e rápido.

Este fluxo de trabalho fundamental do n8n começa sem um gatilho (trigger) externo do n8n, dependendo de nós internos de teste para demonstrar o fluxo de dados.

1. Simulação de Dados: O nó do n8n 'Mock Data' gera três itens de entrada separados, simulando dados recebidos de uma etapa anterior (como uma consulta a banco de dados ou chamada de API).


2. Lógica de Consolidação: Todos os três itens fluem para o nó do n8n 'Create an array of objects'. Este nó Function do n8n executa JavaScript personalizado para iterar sobre o array de entrada (items).


3. Transformação: O script usa items.map(item => item.json) para extrair o payload bruto de cada item individual do n8n e compilá-lo em um array JavaScript coeso.


4. Saída Final: O fluxo de trabalho do n8n conclui a saída enviando um único item contendo o array recém-formado sob a chave data_object. Esta técnica garante que os nós subsequentes do n8n recebam os dados consolidados, prontos para processamento em lote.

Para começar a usar este fluxo de trabalho do n8n de consolidação de dados:

1. Importar o Fluxo de Trabalho do n8n: Copie o código JSON fornecido.


2. Abra sua instância do n8n e navegue até a seção 'Workflows'.


3. Clique em 'New' (Novo) e selecione 'Import from JSON' (Importar de JSON). Cole o código inteiro.


4. Execução: Como este template do n8n usa apenas nós Function, nenhuma credencial externa é necessária. Basta clicar em 'Test Workflow' (Testar Fluxo de Trabalho) ou ativar o fluxo de trabalho e executá-lo manualmente para ver a transformação dos dados em ação.


5. Revise a saída do nó final do n8n para ver a estrutura do array consolidado.

Este fluxo de trabalho do n8n utiliza dois nós Function chave do n8n:

Nome do Nó: Mock Data (Function)
Função: Simula os dados de entrada para o fluxo de trabalho do n8n gerando três itens distintos do n8n, cada um contendo um objeto simples (id e name).
Configuração Chave: Contém JavaScript codificado que retorna um array de três objetos separados para imitar a estrutura frequentemente vista após um nó do n8n como 'Split In Batches' ou de Banco de Dados.

Nome do Nó: Create an array of objects (Function)
Função: Este nó crítico do n8n executa a consolidação dos dados, mesclando os itens recebidos separadamente em uma única estrutura de array.
Configuração Chave: O código JavaScript utilizado é return [ { json: { dataobject: items.map(item => item.json), }, } ];. Este código mapeia sobre os items de entrada, extrai o payload (item.json) e envolve o array JavaScript resultante em um único item de saída sob a chave dataobject. Isso demonstra técnicas essenciais de manipulação de dados para qualquer template complexo do n8n.