Editorul n8n: canvas, noduri și conexiuni
Înainte să construiești automatizări adevărate, trebuie să te simți ca acasă în editor. În această lecție înveți să te miști pe canvas, să adaugi noduri, să le legi cu conexiuni, să le redenumești și să dai un nume workflow-ului. Sunt gesturile pe care le vei face în fiecare lecție de acum încolo.
Canvas-ul: tabla ta de lucru
Canvas-ul este suprafața cu puncte pe care stau nodurile. Gândește-te la el ca la o tablă albă din sala de ședințe: desenezi pe ea pașii procesului, de la stânga la dreapta, în ordinea în care se întâmplă.
- Mutare: trage de o zonă goală a canvas-ului cu mouse-ul (sau cu degetul, pe telefon). Pe laptop poți folosi și rotița sau touchpad-ul.
- Zoom: butoanele + și − din stânga jos (sau Ctrl + rotița mouse-ului).
- Încadrează tot: al treilea buton din stânga jos. Aduce toate nodurile în ecran, util când te-ai „pierdut” pe tablă.
- Mutarea unui nod: îl tragi de corp. Poziția nu schimbă ce face workflow-ul, doar cât de ușor se citește.
Un workflow bine aranjat se citește ca o propoziție: de la stânga (trigger-ul) la dreapta (ultimul pas). Când ramurile se despart, pune-le una sub alta. Colegii tăi (și tu, peste o lună) vor înțelege mult mai repede ce face.
Nodurile și lista de noduri
Fiecare nod este un pas: citește date, le schimbă, le trimite undeva. Ca să adaugi un nod ai trei drumuri:
Oricare ai alege, se deschide lista de noduri, împărțită pe grupe. Poți căuta după nume (scrie „Edit” și apare Edit Fields) sau poți răsfoi grupele:
| Grupa | Ce găsești acolo | Exemple |
|---|---|---|
| Declanșatoare (Triggers) | nodurile care pornesc workflow-ul | Manual Trigger, Schedule Trigger, Webhook |
| AI | nodurile cu modele de inteligență artificială | AI Agent, Text Classifier |
| Aplicații (Action in an app) | nodurile care lucrează cu alte programe | Gmail, Slack, Google Sheets |
| Transformarea datelor (Data transformation) | nodurile care schimbă datele | Edit Fields, Sort, Limit |
| Flux (Flow) | nodurile care iau decizii și împart drumul | If, Switch, Merge |
| Core (Helpers) | unelte generale | HTTP Request, Code, Wait |
În acest curs folosești des nodul Edit Fields (în listă apare ca „Edit Fields (Set)”): el creează sau modifică câmpuri, adică informațiile care circulă prin workflow.
Conexiunile: drumul datelor
O conexiune este săgeata dintre două noduri. Ea spune: „după ce termini, trimite rezultatul la nodul următor”. Un nod care nu are nicio conexiune spre el nu rulează niciodată, chiar dacă stă frumos pe canvas, pentru că nu primește nimic.
Cum conectezi două noduri
- Prin tragere: apuci punctul de ieșire din dreapta primului nod și îl duci peste nodul țintă.
- Prin click: dai click pe punctul de ieșire, apoi pe nodul țintă (apare bannerul „Alege nodul la care conectezi…”).
- Din panoul nodului: jos, la „Conexiuni (alternativă la tragerea cu mouse-ul)”, alegi nodul din listă și apeși Conectează. E cea mai sigură variantă pe ecrane mici.
Cum ștergi o conexiune
Dai click pe săgeată și apeși iconița de coș („Șterge conexiunea”), sau, în panoul nodului, butonul x („Deconectează”) de lângă conexiune. Nodurile rămân pe canvas; doar legătura dispare.
Dacă tragi o conexiune „în gol” (pe o zonă fără nod), editorul îți deschide lista de noduri: nodul pe care îl alegi se adaugă acolo și se conectează singur. E un drum rapid când construiești pas cu pas.
Nume clare pentru noduri și pentru workflow
Fiecare nod primește un nume implicit: „Edit Fields”, „HTTP Request”. Când adaugi al doilea nod de același fel, n8n îl numește „Edit Fields1”, apoi „Edit Fields2”. Peste câteva săptămâni nu vei mai ști care ce face. De aceea e bine să le redenumești după rolul lor.
La fel, workflow-ul are un nume, în bara de sus a editorului (câmpul din stânga). Un nume ca „Primul workflow” sau „Comenzi noi → Slack” te ajută să-l găsești în lista de workflow-uri, unde vei avea curând zeci.
Numele nodurilor se folosesc și în expresii (de exemplu $('Salut')), pe care le înveți mai târziu. Când redenumești un nod, n8n actualizează singur expresiile care îl folosesc.
Greșeli frecvente la început
| Ce se întâmplă | De ce | Ce faci |
|---|---|---|
| Un nod nu are bifă verde după rulare | nu e conectat la nodul de dinainte | trage conexiunea de la ieșirea nodului anterior |
| Nodul nou a apărut în alt loc decât voiai | l-ai adăugat cu + din dreapta sus, nu de pe ieșirea unui nod | conectează-l manual sau mută-l și leagă-l |
| Două noduri cu nume aproape identice | n8n adaugă cifre la sfârșit (Edit Fields1) | redenumește-le după ce fac |
| Nu mai vezi nodurile | ai mutat sau micșorat canvas-ul | apasă Încadrează tot |
Exemple din viața reală
În loc de „HTTP Request1” și „Edit Fields2”, la TehnoPlus nodurile se numesc „Comenzi de azi” și „Pregătește mesajul”.
Echipa de marketing aranjează nodurile de la stânga la dreapta, ca un proces desenat pe tablă, și oricine înțelege în câteva secunde ce face.
Cea mai des întâlnită problemă la început: un nod adăugat, dar neconectat. Workflow-ul rulează, dar acel pas nu se întâmplă niciodată.
Pe canvas ai un trigger manual și un nod Edit Fields care nu sunt legate. Conectează-le, adaugă după Edit Fields încă un nod Edit Fields numit Salut, dă un nume workflow-ului și rulează.
- Conectează trigger-ul „When clicking ‘Execute workflow’” la nodul Edit Fields.
- Adaugă după Edit Fields (cu + de pe ieșirea lui) un nou nod Edit Fields și redenumește-l Salut.
- În nodul Salut creează câmpul salut cu valoarea Bună ziua.
- Schimbă numele workflow-ului în Primul workflow (bara de sus).
- Apasă Execute workflow.
Soluția exercițiului
1. Trage conexiunea de la ieșirea trigger-ului la Edit Fields (sau, în panoul trigger-ului, Conectează → Edit Fields). 2. Click pe + de la ieșirea lui Edit Fields → Edit Fields (Set). 3. În panoul nodului nou schimbă numele de sus în: Salut 4. Add Field: salut, valoarea Bună ziua. 5. În bara de sus schimbă numele workflow-ului în: Primul workflow 6. Apasă Execute workflow.
