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

Execute step, Executions și citirea erorilor

Orice workflow are, la început, greșeli: o adresă scrisă greșit, un câmp cu literă mare în loc de mică. Nu e o problemă, dacă știi unde să te uiți. În această lecție înveți să rulezi un singur pas, să citești istoricul execuțiilor și să înțelegi mesajele de eroare, apoi repari un workflow cu două greșeli.

Execute workflow și Execute step

Ai două feluri de a rula în timp ce construiești:

ButonUnde îl găseștiCe rulează
Execute workflowjos, pe canvastot workflow-ul, de la trigger până la ultimul nod
Execute stepîn panoul unui nod, sus (sau iconița de pe nod)nodul acela și nodurile de dinaintea lui, nu și pe cele de după

Execute step e util când lucrezi la un singur nod: îi schimbi o setare, apeși Execute step și vezi imediat Output-ul lui, fără să rulezi și pașii de după (care poate trimit emailuri sau scriu în tabele).

Bine de știut

Dacă un nod nu are încă date în Input, panoul îți arată butonul Execute previous nodes: rulează nodurile de dinainte, ca să ai cu ce lucra.

Ce îți arată canvas-ul după o rulare

  • Bifă verde pe nod: a rulat fără erori.
  • Nod roșu, cu semn de eroare: aici s-a oprit execuția. Nodurile de după nu mai rulează.
  • Numărul de pe conexiune („1 item”, „5 items”): câte items au trecut pe acolo. Un 0 sau lipsa numărului îți spune că datele nu au ajuns.

Uitându-te doar la canvas afli deja două lucruri: unde s-a oprit workflow-ul și câte date au trecut până acolo. De multe ori asta e suficient ca să ghicești problema.

Tab-ul Executions: istoricul rulărilor

Sus în editor, lângă Editor, ai tab-ul Executions. Fiecare rulare apare acolo, cea mai nouă prima, cu:

  • numărul execuției (#1, #2…) și starea: Succeeded sau Error;
  • ora la care a pornit, durata și modul (test sau producție);
  • lista nodurilor care au rulat, cu bifă sau semn de eroare și numărul de items;
  • ieșirea fiecărui nod, pe care o deschizi cu un click.

Executions e ca jurnalul de bord al unui avion: chiar dacă nu erai de față (de exemplu, workflow-ul a rulat singur noaptea), poți vedea exact ce s-a întâmplat la fiecare pas.

Cum citești o eroare

Când un nod dă eroare, deschide-l. În Output apare o casetă roșie Eroare în nod cu mesajul. Iată ce primești dacă adresa API-ului are o greșeală (scrisă cu „ț” în loc de „t”):

Resursa cerută nu a fost găsită (The resource you are requesting could not be found) · 404 Not Found · {"eroare":"Adresa /clien%C8%9Bi nu există în API-ul demo"}

Mesajul pare lung, dar se citește pe bucăți:

1
Ce s-a întâmplat: „Resursa cerută nu a fost găsită”, adică adresa nu există.
2
Codul: 404 Not Found. Codurile HTTP le vei întâlni des: 404 = adresa nu există, 401 = nu ai voie (lipsește cheia), 500 = problema e la celălalt server.
3
Detaliul de la server: „Adresa /clien%C8%9Bi nu există”. %C8%9B este litera „ț” codificată pentru internet. Deci problema e diacriticul din adresă.
Atenție

Adresele web (URL-urile) nu au diacritice și nici spații. https://api.exemplu.ro/clienti, nu /clienți.

Greșelile care nu dau eroare

Cele mai perfide greșeli sunt cele pentru care nodul nu se înroșește. Dacă scrii {{ $json.Nume }} (cu N mare), nodul rulează cu bifă verde, dar câmpul rezultat este gol, pentru că în date câmpul se numește nume. Previzualizarea Result îți arată [gol].

De aceea, după fiecare rulare, nu te uita doar la bifele verzi. Deschide ultimul nod și verifică în Output că valorile sunt cele așteptate.

Metoda de depanare în 4 pași

1
Rulează și găsește primul nod roșu sau primul nod cu rezultat ciudat.
2
Deschide-l și compară Input cu Output: datele intră corect? Ies corect?
3
Citește mesajul de eroare sau previzualizarea Result a fiecărui parametru.
4
Repară un singur lucru, rulează din nou și verifică. Apoi treci la următorul.

Exemple din viața reală

Execuția de noapte

Raportul de la 3:00 nu a ajuns. În Executions vezi că nodul Google Sheets a dat eroare: cineva redenumise foaia.

Majuscula

Emailurile pleacă cu „Bună, !” pentru că expresia folosea $json.Nume. Output-ul nodului arată câmpul gol.

Cheia expirată

Un 401 Unauthorized în mesajul de eroare îți spune imediat că trebuie reînnoită cheia API-ului.

Exercițiul tău

Workflow-ul de pe canvas ar trebui să aducă clienții și să scrie numele fiecăruia în câmpul client. Are însă două greșeli. Rulează-l, citește erorile și repară-l.

  • Apasă Execute workflow și deschide nodul roșu. Citește mesajul de eroare.
  • Corectează URL-ul din HTTP Request în https://api.exemplu.ro/clienti (fără diacritice).
  • Rulează din nou și deschide Edit Fields: câmpul client e gol. Corectează expresia în {{ $json.nume }}.
  • Rulează încă o dată și verifică în Output că apare „Ana Popescu”. Uită-te și în tab-ul Executions.
Numele câmpurilor din API sunt cu litere mici. Dacă nu ești sigur cum se numește un câmp, deschide Input-ul nodului Edit Fields.

Soluția exercițiului

1. Apasă Execute workflow: HTTP Request dă eroarea 404.
2. În HTTP Request schimbă URL-ul în https://api.exemplu.ro/clienti
3. Rulează: Edit Fields are câmpul client gol.
4. În Edit Fields schimbă valoarea în {{ $json.nume }}
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 8 · Execute step, Executions și citirea erorilor
Progres 0% 0 din 12
Lecția curentă 8 / 10 Depanare