O que é item linking
Item linking é o vínculo que o n8n mantém entre cada item e o item que o originou. Ele permite que uma expressão volte a um Node anterior e encontre o registro correspondente àquela linha.
O vínculo é a referência que diz de onde o item veio. É ela que faz a expressão apontar para o registro certo quando o fluxo tem vários itens.
Onde a expressão busca o valor
Uma expressão como $('Buscar contato').item.json.email consulta o item do Node anterior que corresponde ao item atual. O n8n usa o vínculo para responder, em vez de devolver o primeiro item da lista.
Quando o vínculo está correto, cada linha recebe o seu próprio valor. Quando está ausente, a mesma resposta aparece em todas as linhas, e o defeito só fica visível com mais de um registro.
O que quebra o vínculo
Um Code node que devolve um array novo sem declarar pairedItem interrompe a ligação. Um agregador que junta várias linhas em uma também precisa dizer quais itens formaram o resultado.
A correção passa por declarar a origem na saída ou por usar a opção que preserva os campos do item anterior. Depois disso, o teste precisa rodar com mais de um item, porque o erro não aparece com um só.
Como conferir
Execute o workflow com pelo menos dois registros e confira se cada linha recebe o valor correspondente. Abra o item na saída do Node e veja se a referência de origem aparece.
Para montar e revisar fluxos com esse nível de detalhe, a Formação n8n Experts trata da construção e da operação.
Dúvidas frequentes
Perguntas frequentes sobre Item linking
- O que o item linking resolve?
- Ele permite que uma expressão consulte um Node anterior e receba o item que gerou aquele item atual. Sem o vínculo, a consulta devolve o primeiro item do Node ou um valor que não corresponde à linha em processamento.
- Por que o vínculo se perde depois de um Node?
- Alguns Nodes criam itens novos sem informar de onde vieram. Um `Code node` que devolve um array novo, um agregador ou uma chamada que gera várias saídas pode deixar o vínculo incompleto.
- Como corrigir no Code node?
- A saída precisa declarar o item de origem, com `pairedItem`. Quando a transformação é uma cópia de um item para outro, a referência pode ser a posição; quando junta vários, é preciso indicar a lista de origens.
- O erro aparece sempre?
- Não. O fluxo pode funcionar com um item e falhar com vários, porque o vínculo só é exercitado quando a expressão consulta o Node anterior. O teste precisa usar mais de um registro.
Para continuar
Recursos relacionados
Documentação
n8n: conceitos de item linking
Explica como o vínculo é mantido e o que o quebra.
Abrir recursoDocumentação
n8n: Code node
Mostra como escrever a saída e declarar o item de origem.
Abrir recursoAplicação na formação
n8n Experts
Na Formação n8n Experts, o item linking aparece quando uma expressão precisa buscar o registro certo em um fluxo com várias ramificações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.