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 آزمایشی)

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 شاخه پیش‌فرض دارد و هیچ آیتمی از دو مسیر به ثبت تیکت نمی‌رسد.
  • اجرای دوباره، تیکت تکراری نمی‌سازد.
  • شکست با کلید غلط هشدار بدون داده آیتم می‌فرستد.