...
← Curs Automatizări AI cu n8n: toate lecțiile
Lecția 4 · Introducere

Items și JSON, explicate simplu

Între noduri circulă date: clienți, comenzi, produse. n8n le împarte în items, câte unul pentru fiecare client sau comandă, iar fiecare item este scris în formatul JSON. Sună tehnic, dar e la fel de simplu ca o fișă de client completată de mână. După această lecție vei citi fără grijă datele din orice nod.

Un item = o fișă

Imaginează-ți un dosar cu fișe de client, câte o fișă pentru fiecare om: nume, email, oraș. În n8n, dosarul este lista de items, iar fiecare fișă este un item. Când un nod citește clienții firmei, nu primește „un tabel”, ci 5 fișe separate, câte una pe client.

Asta are o consecință foarte importantă: fiecare nod rulează o dată pentru fiecare item. Dacă dai unui nod Edit Fields 5 clienți, el face aceeași operație de 5 ori, câte o dată pentru fiecare fișă. Nu trebuie să scrii nicio buclă: n8n o face pentru tine.

Ideea de bază

Item = o fișă cu câmpuri. Lista de items = toate fișele care trec de la un nod la altul. Pe săgeata dintre noduri vezi câte au trecut: „1 item”, „5 items”.

Ce este JSON

JSON este felul în care calculatoarele scriu o fișă, astfel încât orice program să o poată citi. Iată fișa Anei Popescu, așa cum vine ea de la API-ul magazinului TehnoPlus:

{
  "id": 1,
  "nume": "Ana Popescu",
  "email": "ana.popescu@exemplu.ro",
  "oras": "Cluj-Napoca",
  "activ": true,
  "total_comenzi": 7
}

Regulile sunt puține:

  • Fișa începe cu { și se termină cu } (acolade).
  • Fiecare rând este o pereche nume: valoare, de exemplu "oras": "Cluj-Napoca". Numele câmpului e mereu între ghilimele.
  • Textul stă între ghilimele: "Ana Popescu".
  • Numerele se scriu fără ghilimele: 7, 89.9 (cu punct, nu cu virgulă).
  • Da / nu se scrie true sau false, tot fără ghilimele.
  • Perechile sunt despărțite prin virgulă.

Liste și obiecte în obiecte

Uneori o valoare are mai multe bucăți. O listă stă între paranteze drepte [ ], iar un obiect (o fișă în fișă) stă între acolade. De exemplu, o comandă are lista de produse cumpărate:

{
  "id": 5004,
  "status": "noua",
  "produse": [
    { "nume": "Mouse wireless", "cantitate": 1, "pret": 89 }
  ],
  "total": 89
}

Despre liste vorbim pe larg în modulul al doilea. Acum e suficient să le recunoști.

Table, JSON și Schema: trei feluri de a privi aceleași date

Când deschizi un nod, în Input (ce a primit) și în Output (ce a produs) ai trei butoane care schimbă doar felul în care vezi datele, nu datele însele:

VizualizareCum aratăCând o folosești
Tableun tabel: un rând pe item, o coloană pe câmpvrei să vezi repede toți clienții, ca în Excel
JSONtextul JSON al tuturor items, ca mai susvrei să vezi exact ce valori și ce tipuri sunt
Schemalista câmpurilor, cu tipul fiecăruiavrei să tragi un câmp într-un parametru

Din Input poți trage un câmp (de exemplu nume) direct într-un parametru al nodului. n8n scrie singur expresia corectă, {{ $json.nume }}, care înseamnă „valoarea câmpului nume din item-ul curent”. Expresiile le iei pe larg în lecția 6; azi doar le folosești prin tragere.

Exemplu: clienții TehnoPlus

În exercițiu, nodul HTTP Request cere de la API-ul magazinului lista de clienți (GET https://api.exemplu.ro/clienti). Ce este un API și cum se configurează acest nod afli în modulul al treilea; acum ajunge să știi că nodul aduce date din alt program. Răspunsul are 5 clienți, deci nodul dă mai departe 5 items:

idnumeemailorasactivtotal_comenzi
1Ana Popescuana.popescu@exemplu.roCluj-Napocatrue7
2Mihai Ionescumihai.ionescu@exemplu.roBucureștitrue2
3Elena Dumitruelena.dumitru@exemplu.roIașifalse0
4Radu Marinradu.marin@exemplu.roTimișoaratrue12
5Ioana Stanioana.stan@exemplu.roCluj-Napocatrue4

Maria vrea să trimită colegilor de la livrări doar numele și orașul fiecărui client, fără emailuri sau alte detalii. Pentru asta pui după HTTP Request un nod Edit Fields cu două câmpuri. Opțiunea Include Other Input Fields rămâne oprită: așa, ieșirea conține doar câmpurile create de tine, iar restul (id, email…) dispare.

nume  →  {{ $json.nume }}
oras  →  {{ $json.oras }}

Edit Fields rulează de 5 ori, câte o dată pe client, și produce tot 5 items, de forma:

{
  "nume": "Ana Popescu",
  "oras": "Cluj-Napoca"
}

Greșeli frecvente

  • Crezi că un nod primește „un tabel”. Primește items separate și rulează pentru fiecare. De aceea 5 clienți dau 5 emailuri, nu unul.
  • Scrii numărul cu ghilimele. "7" este text, 7 este număr. Diferența contează când compari sau aduni (lecția următoare).
  • Uiți că Include Other Input Fields e oprit implicit. Edit Fields păstrează doar ce creezi tu. Dacă vrei să adaugi un câmp și să păstrezi restul, pornește opțiunea.
  • Scrii numele câmpului greșit. Nume și nume sunt câmpuri diferite. Trage câmpul din Input ca să eviți greșelile de tastare.
Bine de știut

Numele câmpurilor din API-ul demo sunt fără diacritice (oras, nu oraș), cum se obișnuiește în programare. Valorile pot avea diacritice: București.

Exemple din viața reală

Lista de clienți

Fiecare client din CRM devine un item; un nod Gmail trimite automat câte un email fiecăruia.

Comenzile zilei

Magazinul dă 30 de comenzi = 30 de items; n8n le scrie pe toate în Google Sheets, câte un rând pe comandă.

Doar ce trebuie

Colegii de la livrări primesc numai nume, oraș și telefon, nu tot dosarul clientului.

Exercițiul tău

Nodul HTTP Request aduce cei 5 clienți TehnoPlus. Adaugă după el un nod Edit Fields care păstrează pentru fiecare client doar numele și orașul.

  • Apasă Execute workflow și uită-te în Output-ul nodului HTTP Request (încearcă Table, JSON și Schema).
  • Adaugă după HTTP Request un nod Edit Fields.
  • Creează câmpul nume cu valoarea {{ $json.nume }} (trage câmpul din Input).
  • Creează câmpul oras cu valoarea {{ $json.oras }}.
  • Lasă Include Other Input Fields oprit și rulează din nou.
Dacă în Output apar și email sau id, ai pornit Include Other Input Fields: oprește-l. Dacă panoul Input e gol, rulează întâi workflow-ul.

Soluția exercițiului

1. Apasă Execute workflow și deschide HTTP Request ca să vezi cei 5 clienți.
2. Click pe + de la ieșirea lui HTTP Request → Edit Fields (Set).
3. Add Field: nume, valoarea {{ $json.nume }}.
4. Add Field: oras, valoarea {{ $json.oras }}.
5. Lasă Include Other Input Fields oprit și apasă Execute workflow.
Excelent! Continuă cu lecția următoare →
workflow.jsonn8n
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași cu n8n Lecția 4 · Items și JSON, explicate simplu
Progres 0% 0 din 12
Lecția curentă 4 / 10 Introducere