Restauração de Dados Usando itemMatching() no Nó de Código - Fluxo de trabalho n8n

Esta automação é ideal para:
Desenvolvedores n8n que estão aprendendo técnicas avançadas de script.
Usuários que necessitam de métodos confiáveis para preservar a linhagem dos dados em fluxos de trabalho complexos do n8n.
Engenheiros que criam templates modulares para n8n onde os índices dos itens precisam ser mantidos para correlação de dados.
Qualquer pessoa que busque uma compreensão mais profunda da manipulação de dados no contexto de execução do n8n.

Ao construir fluxos de trabalho complexos no n8n, muitas vezes é necessário transformar ou filtrar fluxos de dados, o que pode resultar na perda temporária de campos originais (como e-mails ou IDs). Este fluxo de trabalho específico do n8n oferece uma solução robusta usando a função nativa itemMatching() disponível dentro do nó Code do n8n.

A vantagem desta automação no n8n está em garantir a integridade dos dados. Ela simula um cenário onde os dados iniciais são gerados, depois drasticamente reduzidos (mantendo apenas os nomes) e, finalmente, o endereço de e-mail original é recuperado e restaurado com precisão usando a correlação do índice do item. Essa abordagem é vital para manipulação avançada de dados e demonstra um dos recursos mais poderosos disponíveis no ambiente de script do n8n para vincular itens de dados entre diferentes etapas do fluxo de trabalho do n8n.

Este fluxo de trabalho do n8n opera em quatro fases distintas:

1. Iniciação (Gatilho Manual): O gatilho do n8n inicia o processo quando o usuário clica em 'Execute Workflow'.


2. Geração de Dados: O nó Customer Datastore (n8n training) do n8n gera uma lista de registros de clientes de exemplo, incluindo nomes e endereços de e-mail. Isso estabelece o fluxo de dados inicial.


3. Redução de Dados: O nó Edit Fields (Set) do n8n remove intencionalmente todos os campos, exceto o nome do cliente. Isso simula um cenário comum onde os dados são simplificados e o contexto original parece ser perdido.


4. Restauração de Dados (Nó de Código): O nó final do n8n, um nó de Código Python, executa a lógica principal. Ele itera pelos itens de dados reduzidos. Para cada item, ele usa o método itemMatching(i), referenciando os dados originais da saída do nó 'Customer Datastore' do n8n, para recuperar o endereço de e-mail correspondente com base no índice i. Este e-mail recuperado é então anexado de volta ao item atual sob um novo campo chamado restoreEmail. Esta técnica poderosa garante a consistência dos dados em todo o fluxo de trabalho do n8n.

Para implantar este template do n8n, siga estes passos:

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' ou 'Import from JSON' e cole o código.


4. Executar: Como este fluxo de trabalho do n8n usa um gatilho manual do n8n e nós de dados simulados (para fins de treinamento), nenhuma credencial externa é necessária.


5. Clique no botão 'Execute Workflow' no nó do n8n 'When clicking "Execute Workflow"' para ver a lógica de correspondência de itens em ação. Revise a saída do nó final do Code n8n para confirmar que os endereços de e-mail foram restaurados com sucesso.

Este fluxo de trabalho do n8n utiliza os seguintes tipos de nós principais do n8n:

When clicking "Execute Workflow" (Gatilho Manual):
Função: Atua como o gatilho inicial do n8n para testes e desenvolvimento.
Configuração Principal: Nenhuma configuração necessária; inicia o fluxo de trabalho do n8n sob demanda.

Customer Datastore (n8n training):
Função: Gera dados de amostra (clientes com nomes e e-mails) para fornecer um fluxo de dados de origem.
Configuração Principal: Operação definida como getAllPeople, com returnAll marcado.

Edit Fields (Set):
Função: Este nó do n8n realiza uma transformação de dados, reduzindo os itens recebidos para reter apenas o campo 'name'. Isso simula o cenário de perda de dados que pretendemos corrigir.
Configuração Principal: Inclui apenas o campo name, definindo a opção de entrada como none para descartar todos os outros campos.

Code (Python):
Função: O nó crítico do n8n onde o método itemMatching() é utilizado. Ele correlaciona o índice do item atual com o índice original do 'Customer Datastore' para buscar o e-mail original.
Configuração Principal: Usa a lógica Python:

for i,item in enumerate(input.all()):
          input.all()[i].json.restoreEmail = ('Customer Datastore (n8n training)').itemMatching(i).json.email
        return input.all();