Itens e JSON

Tudo o que passa de um node para outro no n8n é uma lista de itens. Cada item é um objeto com a chave json, que guarda os campos. Arquivos ficam em outra chave, binary.

1
[
2
  { "json": { "nome": "Ana", "cidade": "São Paulo" } },
3
  { "json": { "nome": "Bruno", "cidade": "Recife" } }
4
]

Na tela do node, o n8n mostra esses itens em tabela, em JSON ou em esquema. A visão em JSON é a mais fiel ao que circula de verdade.

Um item, uma operação

Quando um node recebe vários itens, ele roda uma vez para cada um. Um node que cria um contato no CRM, recebendo os dois itens acima, cria dois contatos. Isso dispensa laços na maioria dos casos.

Faça o teste: no node Edit Fields do seu workflow, ative a opção de incluir outros campos e mande dois itens pelo node anterior. A saída mostra dois itens, cada um com o próprio valor.

Campos aninhados

Um campo pode guardar outro objeto:

1
{ "nome": "Ana", "endereco": { "cidade": "São Paulo", "uf": "SP" } }

Na visão em tabela, o n8n destaca o campo endereco para indicar que ele tem campos internos. Para chegar à cidade, você usa o caminho endereco.cidade, assunto do guia de expressões.

Arraste para mapear

No painel de entrada de um node, você pode arrastar um campo até um parâmetro. O n8n cria a expressão com o caminho do campo. Para cada item processado, o parâmetro recebe o valor daquele item.