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.
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:
| Vizualizare | Cum arată | Când o folosești |
|---|---|---|
| Table | un tabel: un rând pe item, o coloană pe câmp | vrei să vezi repede toți clienții, ca în Excel |
| JSON | textul JSON al tuturor items, ca mai sus | vrei să vezi exact ce valori și ce tipuri sunt |
| Schema | lista câmpurilor, cu tipul fiecăruia | vrei 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:
| id | nume | oras | activ | total_comenzi | |
|---|---|---|---|---|---|
| 1 | Ana Popescu | ana.popescu@exemplu.ro | Cluj-Napoca | true | 7 |
| 2 | Mihai Ionescu | mihai.ionescu@exemplu.ro | București | true | 2 |
| 3 | Elena Dumitru | elena.dumitru@exemplu.ro | Iași | false | 0 |
| 4 | Radu Marin | radu.marin@exemplu.ro | Timișoara | true | 12 |
| 5 | Ioana Stan | ioana.stan@exemplu.ro | Cluj-Napoca | true | 4 |
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.
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ă
Fiecare client din CRM devine un item; un nod Gmail trimite automat câte un email fiecăruia.
Magazinul dă 30 de comenzi = 30 de items; n8n le scrie pe toate în Google Sheets, câte un rând pe comandă.
Colegii de la livrări primesc numai nume, oraș și telefon, nu tot dosarul clientului.
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.
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. 