n8n Fundamentals
Deterministic, debuggable n8n workflows before AI: hosting and license, items and expressions, flow logic, credentials, pagination and errors.
What you will learn
- Choose where to run n8n and understand the Sustainable Use License limits
- Build a deterministic workflow with a trigger, data mapping and an error path
- Work with items, expressions, branches, loops and sub-workflows
- Connect services with credentials and HTTP Request and handle pagination
- Debug with execution history and pinned data
Prerequisites
- The Common Language of Software: HTTP, JSON and APIs
Tools
- n8n 2.x (اجرای محلی با Docker یا Cloud در صورت دسترسی قانونی)
- Python 3.9 یا بالاتر (API آزمایشی)
- What n8n Is, Where to Run It, and What Its License Allows
Get to know n8n, choose between Cloud and self-hosting with reasons, run it locally with Docker, and know what its license allows.
- Your First Deterministic n8n Workflow
Build a complete workflow without AI: trigger, HTTP request, splitting items, a condition and output; then test, schedule and publish it.
- Data in n8n: Items, Expressions and Mapping
Reach current-item and earlier-node data with expressions, map fields with Edit Fields, and know when item linking helps or breaks.
- Flow Logic: Branches, Loops, Aggregation and Sub-workflows
Route items with If and Switch, combine with Merge and Aggregate, batch with Loop Over Items and Wait, and reuse logic in sub-workflows.
- Credentials, HTTP Request and Pagination
Keep keys in credentials, call any API with the HTTP Request node, read every page with built-in pagination, and surface error responses.
- Errors and Debugging in n8n
Choose per-node error behavior, enable retries only where they help, build an error workflow with alerts, and debug failed runs with their own data.
Setup and First Workflow
موقعیت (ساختگی): برگ سبز میخواهد هر صبح فهرست سفارشهای «processing» قدیمیتر از سه روز را برای مسئول انبار بفرستد. یکی از کارکنان پیشنهاد میدهد n8n را روی سرور اجارهای بالا بیاورد و به دو کتابفروشی دوست هم حساب بدهد تا خودشان ورکفلو بسازند. تحویل بده: (۱) پاسخ به پیشنهاد از نظر مجوز و محل اجرا؛ (۲) گرههای ورکفلو به ترتیب با تعداد آیتم پیشبینیشده برای داده API آزمایشی؛ (۳) دو آزمون لبه با داده سنجاقشده؛ (۴) گامهای انتشار و بررسی اولین اجرای زمانبندیشده.
- دادن n8n به کتابفروشیهای دیگر برای ساخت ورکفلو را خارج از مجوز بدون قرارداد میداند (2)
- Split Out پیش از شرط و تعداد آیتمها درست است (2)
- آزمون لبه شامل فهرست خالی است (2)
- انتشار و دیدن اولین اجرای واقعی آمده است (2)
Data and Logic
موقعیت (ساختگی): ورکفلوی تیکتهای برگ سبز برای هر تیکت سفارش مربوط را میخواند و پاسخ میسازد. شکایتها: (الف) با چند تیکت همزمان، همه پاسخها وضعیت یک سفارش را دارند؛ (ب) تیکتهای فوری پرداخت دو پیام به مدیر میدهند؛ (ج) سامانه پشتیبانی بیرونی روزهای شلوغ 429 میدهد؛ (د) دسته تازه «gift» هیچجا نمیرود. تحویل بده: علت و اصلاح هر چهار مورد با نام گره و Expression یا تنظیم.
- الف: .first() به .item و آزمون با چند آیتم (2)
- ب: یکی کردن شرط پیش از اقدام (2)
- ج: Loop Over Items یا Batching با Wait (2)
- د: شاخه پیشفرض Switch به صف بررسی (2)
Connections and Errors
موقعیت (ساختگی): گزارش ماهانه فروش برگ سبز همیشه کمتر از حسابهاست، کلید سامانه در هدر گره نوشته شده، گزینه Never Error روشن است، و هیچ ورکفلوی خطایی وجود ندارد. تحویل بده: (۱) ترتیب اقدامها برای کلید؛ (۲) تنظیم صفحهبندی با شرط توقف و سقف؛ (۳) تصمیم درباره Never Error و جایگزینش؛ (۴) طرح ورکفلوی خطا با متن هشدار نمونه.
- کلید باطل و عوض و به Credential منتقل میشود (2)
- $pageCount + 1 با شرط توقف next_page و سقف صفحه (2)
- Never Error خاموش یا همراه بررسی صریح کد وضعیت (2)
- هشدار با نام ورکفلو، گره، خطا و پیوند و بدون داده آیتم (2)
Skip challenge
در حدود ۴۵ دقیقه، با n8n محلی و API آزمایشی برگ سبز ورکفلویی بساز که: همه صفحههای GET /orders را با Credential از نوع Header Auth بخواند؛ سفارشها را جدا کند و با Switch بر اساس وضعیت (با شاخه پیشفرض) مسیریابی کند؛ برای سفارشهای shipped با Edit Fields پیام بسازد و با POST /tickets و هدر Idempotency-Key ثبت کند؛ و یک ورکفلوی خطا داشته باشد که با کلید غلط هشدار بدهد. اگر نصب ممکن نیست، طرح کامل گرهها و تنظیمات را با پیشبینی تعداد آیتم هر گره بنویس.
- هفت سفارش آزمایشی در سه درخواست خوانده میشوند و صفحه اول تکرار نمیشود.
- هیچ کلیدی در گره یا خروجی ورکفلو نیست.
- Switch شاخه پیشفرض دارد و هیچ آیتمی از دو مسیر به ثبت تیکت نمیرسد.
- اجرای دوباره، تیکت تکراری نمیسازد.
- شکست با کلید غلط هشدار بدون داده آیتم میفرستد.