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:
| Buton | Unde îl găsești | Ce rulează |
|---|---|---|
| Execute workflow | jos, pe canvas | tot 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).
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:
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
Exemple din viața reală
Raportul de la 3:00 nu a ajuns. În Executions vezi că nodul Google Sheets a dat eroare: cineva redenumise foaia.
Emailurile pleacă cu „Bună, !” pentru că expresia folosea $json.Nume. Output-ul nodului arată câmpul gol.
Un 401 Unauthorized în mesajul de eroare îți spune imediat că trebuie reînnoită cheia API-ului.
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.
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. 