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

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țiuneCe face
Mode: Manual Mappingadaugi câmpurile unul câte unul, cu Add Field (modul obișnuit)
Mode: JSONscrii direct tot item-ul în format JSON (util când ai multe câmpuri)
Fields to Setlista câmpurilor: Name (numele), Value (valoarea), Type (tipul)
Include Other Input Fieldspornit: păstrează și câmpurile primite; oprit: ieșirea are doar câmpurile tale
Options → Support Dot Notationun nume ca adresa.oras creează un obiect adresa cu câmpul oras în el
Options → Ignore Type Conversion Errorsnu 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ă.

TypeCe esteExemplu de valoareCum apare în JSON
StringtextMouse wireless"Mouse wireless"
Numbernumăr (cu punct pentru zecimale)89.989.9
Booleanda / nutruetrue
Arrayo listă["negru", "alb"]["negru", "alb"]
Objecto 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.

Atenție

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

1
Deschide nodul Edit Fields cu dublu-click.
2
La Fields to Set apasă Add Field. Apare un rând cu Name, Value și Type.
3
Scrie numele câmpului (fără spații și fără diacritice, de exemplu pret), valoarea și alege tipul din listă.
4
Repetă pentru fiecare câmp.
5
Apasă Execute step din panou și verifică în Output, pe vizualizarea JSON, că numerele și true apar fără ghilimele.
Bine de știut

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ă

Factura

Suma (Number) se adună corect în raportul lunar, iar numărul facturii (String) își păstrează zerourile din față: „000123”.

Abonat la newsletter

Un câmp Boolean abonat = true permite filtrarea simplă a celor care au acceptat emailurile.

Adresa de livrare

Curierul cere adresa ca obiect: adresa.oras, adresa.strada, create cu notația cu punct.

Exercițiul tău

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.
Tipul se alege din lista Type de pe fiecare rând. În JSON, 89.9 și true trebuie să apară fără ghilimele.

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.
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 5 · Edit Fields: câmpuri noi și tipuri de date
Progres 0% 0 din 12
Lecția curentă 5 / 10 Transformări