A példa, amit felépítünk
Egy egyszerű, mégis életszerű folyamatot építünk meg. A workflow minden reggel lefut, lekér egy adatot egy külső API-ról, feldolgozza, majd a végén létrehoz egy kimenetet, például egy értesítést vagy egy rekordot. Négy node kapcsolódik össze egy sorba: egy Schedule Trigger indítja a folyamatot, egy HTTP Request node lekéri az adatot, egy feldolgozó node átalakítja, az utolsó node pedig előállítja a kimenetet. A node-ok között az adat objektumok tömbjeként halad, és minden node a saját kimenetét adja tovább a következő bemenetére.
A hat építési lépés
Egy workflow összeállítása mindig ugyanabból a néhány lépésből áll. Először választunk egy trigger node-ot, majd hozzáadjuk és összekötjük az action node-okat. Beállítjuk a külső szolgáltatáshoz szükséges credentialt, tesztelünk a szerkesztőben manuális futtatással, végül élesítjük a workflow-t, és az Executions fülön követjük a futásokat. Az alábbi lista pontosan ezt a hat lépést járja végig, ebben a sorrendben.
- 1. Trigger node választásaTeszteléshez Manual Trigger, élesben Schedule Trigger az ütemezett futáshoz vagy Webhook a beérkező eseményre. Minden éles workflow-nak legalább egy triggerre szüksége van.
- 2. Action node-ok hozzáadása és összekötéseA HTTP Request és a feldolgozó node hozzáadása, majd a node-ok bemenete és kimenete közötti connection megrajzolása, hogy legyen útvonala az adatnak.
- 3. Credential beállításaA külső szolgáltatás hitelesítő adatai (API kulcs, OAuth) egyszer megadva, titkosítva tárolva. Ezt használja a HTTP Request node a lekéréshez.
- 4. Tesztelés manuális végrehajtássalAz Execute Workflow gombbal a szerkesztőben lefuttatjuk, és node-onként megnézzük, milyen adat érkezik és távozik.
- 5. ÉlesítésA workflow aktiválása után az éles végrehajtás automatikusan indul a triggerre vagy az ütemezésre, emberi kattintás nélkül.
- 6. Futások követése az Executions fülönAz éles futások itt jelennek meg státusz szerint, Success, Running, Failed vagy Waiting, és a meghibásodottak újrapróbálhatók.
Hogyan halad az adat a node-okon át
Amikor a workflow elindul, az adat végigáramlik a node-okon. A trigger elindítja a folyamatot, a HTTP Request lekéri az adatot a külső API-ról, a feldolgozó node átalakítja a formáját vagy kiválasztja a lényeges mezőket, az utolsó node pedig előállítja a kimenetet. Az n8n-ben a node-ok között továbbított minden adat objektumok tömbje, és a fogadó node minden elemet egyenként dolgoz fel. Az alábbi ábra ezt az áramlást animálja.
Trigger a teszthez és trigger az éleshez
Építés közben gyakran érdemes Manual Triggerrel dolgozni, mert így az Execute Workflow gombbal magunk indíthatjuk a futást, amikor kényelmes, automatikus futás nélkül. Élesben ezt lecseréljük arra a triggerre, amelyik a valós indítási feltételt képezi le. A Schedule Trigger fix időközönként és időpontokban futtat, a Unix Cron segédprogramhoz hasonlóan, támogatva a másodperc, perc, óra, nap, hét és hónap alapú intervallumokat. A Webhook node ezzel szemben egy esemény bekövetkeztekor fogad adatot más appoktól, és API végpontként is használható.
Manuális teszt és éles futás
A kettő közötti különbség a workflow életének két szakaszát választja el. A manuális végrehajtás a szerkesztőből indul építés vagy tesztelés közben, és a folyamat közvetlenül a szerkesztő fülön követhető, node-onként látszik a be- és kimenő adat. Az éles végrehajtás akkor történik, amikor egy triggerelő esemény vagy ütemezés automatikusan futtatja a workflow-t, aktiválás után. Az éles futások nem a szerkesztő fülön jelennek meg, hanem a workflow Executions fülén, ahol státusz szerint követhetők, és a meghibásodottak újrapróbálhatók.
Manuális, teszt
- A szerkesztőből indul, kézzel
- Execute Workflow gomb nyomásra fut
- A folyamat a szerkesztő fülön látszik
- Node-onként ellenőrizhető az adat
- Építés és hibakeresés közben használjuk
Éles, production
- Aktiválás után automatikusan fut
- Triggerre vagy ütemezésre indul
- A futások az Executions fülön jelennek meg
- Státusz szerint követhető és szűrhető
- A meghibásodott futás újrapróbálható
A futások követése
Az éles futásokat az Executions listában látjuk, ahol a végrehajtások státusz szerint szűrhetők. Négy státusz létezik: Success a sikeres, Running a még futó, Failed a meghibásodott és Waiting a várakozó végrehajtásokra. Egy jól működő napi workflow-nál a lista tele van Success futásokkal, és ha valami elromlik, a Failed sorból egy kattintással újrapróbálható. Így a workflow élesítés után nem fekete doboz, hanem folyamatosan látható marad, hogy mikor futott le, és mi lett az eredménye.
Ennyi státusszal követi az Executions lista a futásokat. A Success a sikeres, a Running a folyamatban lévő, a Failed a meghibásodott és a Waiting a várakozó végrehajtást jelöli, és a Failed sor újrapróbálható.
Workshop
AI Transformation Day
Egésznapos, vezetőknek szóló program. Feltérképezzük, hol tart a szervezet, mi az első reális lépés, és milyen belső feltételek szükségesek a sikerhez. A nap végén konkrét, prioritizált cselekvési lista.
Érdekel a program →