Edit Fields: câmpuri noi și tipuri de date
Edit Fields (numit și Set) este nodul pe care îl vei folosi cel mai des: creează câmpuri noi, schimbă valori și păstrează doar datele de care ai nevoie. Azi înveți ce face fiecare opțiune a lui și, mai ales, de ce contează tipul unui câmp: 12 și "12" arată la fel, dar pentru n8n sunt lucruri diferite.
Ce face Edit Fields
Gândește-te la Edit Fields ca la un formular pe care îl completezi pentru fiecare item: scrii numele câmpului, valoarea și ce fel de valoare este. Nodul rulează pentru fiecare item primit și produce un item nou, cu câmpurile tale.
| Opțiune | Ce face |
|---|---|
| Mode: Manual Mapping | adaugi câmpurile unul câte unul, cu Add Field (modul obișnuit) |
| Mode: JSON | scrii direct tot item-ul în format JSON (util când ai multe câmpuri) |
| Fields to Set | lista câmpurilor: Name (numele), Value (valoarea), Type (tipul) |
| Include Other Input Fields | pornit: păstrează și câmpurile primite; oprit: ieșirea are doar câmpurile tale |
| Options → Support Dot Notation | un nume ca adresa.oras creează un obiect adresa cu câmpul oras în el |
| Options → Ignore Type Conversion Errors | nu se oprește dacă o valoare nu se potrivește cu tipul ales |
Tipurile de date
Fiecare câmp are un tip: îi spune lui n8n ce fel de informație este, ca să știe ce poate face cu ea. E la fel ca în Excel, unde o celulă poate fi text, număr sau dată.
| Type | Ce este | Exemplu de valoare | Cum apare în JSON |
|---|---|---|---|
| String | text | Mouse wireless | "Mouse wireless" |
| Number | număr (cu punct pentru zecimale) | 89.9 | 89.9 |
| Boolean | da / nu | true | true |
| Array | o listă | ["negru", "alb"] | ["negru", "alb"] |
| Object | o fișă în fișă | {"oras": "Cluj"} | {"oras": "Cluj"} |
Pentru câmpurile de mai jos, cu tipurile alese corect, Edit Fields produce exact acest item:
produs (String) Mouse wireless pret (Number) 89.9 disponibil (Boolean) true
{
"produs": "Mouse wireless",
"pret": 89.9,
"disponibil": true
}Observă: textul are ghilimele, numărul și true nu au. Dacă ai fi lăsat pret pe String, ai fi obținut "pret": "89.9", adică un text care doar arată ca un număr.
De ce contează tipul
Mai târziu vei compara valori (este prețul mai mare de 100?), le vei aduna sau le vei scrie în Google Sheets. Toate acestea merg corect doar cu tipul potrivit:
- Ca număr, 12 > 9 este adevărat. Ca text, „12” vine înaintea lui „9” în ordine alfabetică, exact ca în agenda telefonului, unde „10” apare înaintea lui „9”.
- Ca număr, 89.9 + 10 dă 99.9. Ca text, lipirea dă „89.910”.
- Nodul If din modulul următor refuză să compare un text cu un număr și îți arată o eroare de tip.
Eroarea de conversie
Dacă alegi tipul Number și scrii o valoare care nu e număr (de exemplu doar), nodul se oprește cu mesajul:
Câmpul „pret” are tipul Number, dar valoarea „doar” nu este un număr
Mesajul îți spune exact ce câmp și ce valoare au problema. Repari valoarea sau tipul și rulezi din nou. Opțiunea Ignore Type Conversion Errors există, dar folosește-o rar: preferi să afli de problemă acum, nu peste o săptămână, când tabelul e plin de valori greșite.
La numere folosește punctul pentru zecimale: 89.9, nu 89,9. Așa le scriu toate programele și toate API-urile, chiar dacă în România scriem cu virgulă.
Include Other Input Fields și notația cu punct
În lecția trecută ai păstrat doar nume și oras, cu Include Other Input Fields oprit. Când îl pornești, Edit Fields păstrează tot item-ul primit și doar adaugă sau suprascrie câmpurile tale. Alegi după ce vrei să obții:
- Oprit: vrei un item curat, doar cu câmpurile de care are nevoie pasul următor (de exemplu, un mesaj pentru Slack).
- Pornit: vrei să îmbogățești fișa, de exemplu să adaugi pret_cu_tva lângă toate celelalte date ale produsului.
Cu Support Dot Notation pornit (în Options), un câmp numit adresa.oras cu valoarea Cluj devine un obiect în obiect:
{
"adresa": {
"oras": "Cluj"
}
}Fără opțiune, câmpul s-ar numi literal „adresa.oras”. Ai nevoie de asta rar, de obicei când o aplicație cere datele într-o anumită formă.
Pașii în editor
Numele câmpurilor se scriu de obicei cu litere mici, fără spații și fără diacritice (pret_cu_tva, nu „Preț cu TVA”). Așa le folosești ușor în expresii și nu ai surprize când trimiți datele în alte aplicații.
Exemple din viața reală
Suma (Number) se adună corect în raportul lunar, iar numărul facturii (String) își păstrează zerourile din față: „000123”.
Un câmp Boolean abonat = true permite filtrarea simplă a celor care au acceptat emailurile.
Curierul cere adresa ca obiect: adresa.oras, adresa.strada, create cu notația cu punct.
Creează în nodul Edit Fields fișa unui produs TehnoPlus, cu trei câmpuri de tipuri diferite, apoi rulează și verifică în Output (JSON) că tipurile sunt corecte.
- Deschide nodul Edit Fields și adaugă câmpul produs = Mouse wireless, tip String.
- Adaugă câmpul pret = 89.9, tip Number.
- Adaugă câmpul disponibil = true, tip Boolean.
- Apasă Execute workflow (sau Execute step) și verifică Output-ul în vizualizarea JSON.
Soluția exercițiului
1. Deschide Edit Fields. 2. Add Field: produs, valoarea Mouse wireless, Type String. 3. Add Field: pret, valoarea 89.9, Type Number. 4. Add Field: disponibil, valoarea true, Type Boolean. 5. Apasă Execute workflow.
