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.

بعد از این درس می‌توانی

  • بین If و Switch برای مسیریابی آیتم‌ها انتخاب کند و شاخه پیش‌فرض را طراحی کند.
  • تفاوت Merge (ترکیب دو جریان) و Aggregate (چند آیتم به یک آیتم) را بگوید و درست به کار ببرد.
  • بگوید کی حلقه لازم نیست و کی Loop Over Items با Wait برای محدودیت نرخ یا صفحه‌بندی لازم است.
  • منطق تکراری را به زیرورک‌فلو با ورودی و خروجی روشن تبدیل کند.

چرا این درس مهم است

ورک‌فلوی تیکت‌های برگ سبز سه شاخه جدا داشت که هرکدام آخرش «پیام به مدیر» را با گره‌های تکراری می‌ساخت. وقتی متن پیام عوض شد، دو شاخه به‌روز شد و سومی نه. یک تیکت فوری پرداخت هم هم در شاخه «فوری» بود و هم در شاخه «پرداخت»، و مدیر دو پیام گرفت. هفته بعد، سرویس پشتیبانی بیرونی همه درخواست‌ها را با 429 رد کرد، چون ورک‌فلو صد تیکت را یک‌جا فرستاده بود.

مسیریابی، جمع کردن، دسته‌بندی و استفاده دوباره، چهار ابزار ساختاری هر ورک‌فلوی واقعی‌اند. این درس هر چهار را با تیکت‌های برگ سبز می‌سازد و نشان می‌دهد کجا لازم نیستند.

مفاهیم کلیدی

یادآوری: آیتم، Split Out و اجرای هر گره روی هر آیتم را در درس دوم، و محدودیت نرخ را در دوره HTTP دیدی.

  • Branching (شاخه‌بندی): فرستادن آیتم‌ها به مسیرهای مختلف بر اساس شرط، با If (دو مسیر) یا Switch (چند مسیر).
  • Fallback Branch (شاخه پیش‌فرض): مسیری برای آیتم‌هایی که با هیچ شرطی جور نیستند.
  • Merge (ادغام): ترکیب دو جریان آیتم در یک جریان.
  • Aggregate (تجمیع): تبدیل چند آیتم به یک آیتم که فهرست آن‌ها را دارد.
  • Batching (دسته‌بندی): پردازش آیتم‌ها در گروه‌های کوچک، معمولاً با مکث بین گروه‌ها.
  • Sub-workflow (زیرورک‌فلو): ورک‌فلویی که ورک‌فلوی دیگر صدایش می‌زند، با ورودی و خروجی مشخص.

مدل ذهنی

ورک‌فلو را مثل مرکز مرسولات پستی ببین. Switch دستگاه تفکیک بسته‌ها بر اساس شهر است؛ بسته‌ای که شهرش در فهرست نیست به قفسه «بررسی دستی» می‌رود (شاخه پیش‌فرض). Aggregate یعنی همه بسته‌های امروز را در یک گونی بگذاری تا یک برگه خلاصه بنویسی. Loop Over Items یعنی کامیون فقط سه بسته جا دارد، پس سه‌تا سه‌تا بار می‌زنی و بین هر بار صبر می‌کنی. زیرورک‌فلو، واحد بسته‌بندی هدیه است که هر بخش مرکز بسته‌اش را به آن می‌دهد، به‌جای اینکه هر بخش میز بسته‌بندی خودش را داشته باشد.

مسیریابی تیکت‌ها با Switch، زیرورک‌فلو، دسته‌بندی و تجمیع: تیکت‌ها ابتدا با If فوری یا پرداخت به زیرورک‌فلوی اطلاع به مدیر هم می‌روند؛ سپس Switch بر اساس دسته به چهار شاخه شامل شاخه پیش‌فرض می‌فرستد؛ برای ثبت در سامانه بیرونی Loop Over Items دسته‌های سه‌تایی با Wait می‌فرستد؛ در پایان Aggregate همه را برای خلاصه روزانه یکی می‌کند.

مسیریابی تیکت‌ها با Switch، زیرورک‌فلو، دسته‌بندی و تجمیع

این تشبیه کجا غلط است؟ در مرکز پستی، هر بسته فقط در یک قفسه است. در n8n یک گره می‌تواند خروجی‌اش را به چند گره بعدی هم‌زمان بدهد و همان آیتم‌ها در چند مسیر پردازش شوند؛ این قدرت است، ولی منبع پیام تکراری هم هست اگر دو شاخه به یک اقدام برسند.

گام‌به‌گام

گام ۱: If برای دو راه، Switch برای چند راه

مستندات n8n برای فرستادن آیتم‌ها به شاخه‌های مختلف If و Switch را نام می‌بردsrc-n8n-flow-logic. قاعده عملی:

  • If وقتی پرسش بله یا نه است: «فوری است؟».
  • Switch وقتی یک فیلد چند مقدار دارد: دسته تیکت. به‌جای زنجیره If‌های تودرتو.
  • همیشه شاخه پیش‌فرض داشته باش. دسته تازه‌ای که فردا اضافه می‌شود (یا خطای تایپی در داده) نباید بی‌صدا گم شود؛ شاخه پیش‌فرض آن را به صف بررسی می‌فرستد.

گام ۲: یک اقدام، یک مسیر

اگر دو شاخه (مثلاً «فوری» و «payment») هر دو به «اطلاع به مدیر» برسند، آیتمی که در هر دو هست دو بار می‌رسد. پیش از اقدام، شرط را یکی کن: یک If با «فوری یا payment». قاعده: پیش از هر اقدام بیرونی (پیام، ثبت، پرداخت) بپرس آیا یک آیتم می‌تواند از دو راه به اینجا برسد؟

گام ۳: Merge و Aggregate دو کار متفاوت‌اند

  • Merge دو جریان را کنار هم می‌گذارد: مثلاً تیکت‌ها از یک گره و اطلاعات مشتری از گره دیگر، که بر اساس فیلد مشترک (مثل شناسه مشتری) ترکیب یا پشت سر هم افزوده می‌شوند. مستندات Merge را در کنار گره‌های مقایسه و Code برای ادغام نام می‌بردsrc-n8n-flow-logic.
  • Aggregate تعداد را کم می‌کند: ده آیتم را یک آیتم با فهرست ده‌تایی می‌کند. وقتی یک خروجی برای همه می‌خواهی، مثل یک ایمیل خلاصه روزانه به‌جای ده ایمیل.

یادت باشد پس از ادغام یا تجمیع، پیوند آیتم‌ها با گره‌های قبلی ممکن است دیگر یک‌به‌یک نباشد (درس قبل).

گام ۴: حلقه، معمولاً لازم نیست

مستندات می‌گوید n8n تکرار را خودش انجام می‌دهد و گره‌ها معمولاً برای هر آیتم یک بار اجرا می‌شوندsrc-n8n-loop. پس برای «برای هر تیکت، یک کار» حلقه نساز. حلقه وقتی لازم است که:

  • محدودیت نرخ داری: Loop Over Items با اندازه دسته کوچک و یک گره Wait بین دسته‌ها؛ مستندات همین را برای پرهیز از محدودیت نرخ پیشنهاد می‌کندsrc-n8n-loop.
  • صفحه‌بندی را دستی می‌سازی: مستندات می‌گوید گره HTTP Request در تکرار صفحه‌ها خودکار نیست و باید صفحه‌بندی را خودت مدیریت کنیsrc-n8n-loop (درس بعد گزینه داخلی صفحه‌بندی را می‌بیند).
  • حلقه دستی با If که خروجی را به گره قبلی برمی‌گرداند، آخرین راه است؛ شرط توقف را دقیق بنویس و سقف تعداد بگذار.

گام ۵: زیرورک‌فلو برای منطق تکراری

وقتی یک تکه منطق (مثل «ساختن و فرستادن پیام به مدیر») در چند ورک‌فلو یا چند شاخه لازم است، آن را ورک‌فلوی جدا کن: با گره Execute Workflow Trigger شروع می‌شود و ورک‌فلوی اصلی با گره Execute Workflow صدایش می‌زندsrc-n8n-flow-logic. ورودی را مشخص کن (کدام فیلدها) و خروجی را هم. در n8n 2.0 رفتار تغییر کرده است: وقتی زیرورک‌فلو برای Webhook، فرم یا تأیید انسانی متوقف می‌شود، والد خروجی فرزند را می‌گیرد، نه ورودی‌اش را؛ ورک‌فلوهایی که به رفتار قدیمی تکیه داشتند باید بازبینی شوندsrc-n8n-v2-breaking.

مثال‌ها

پیاده‌سازی عملی

مسیریابی تیکت‌های برگ سبز. حدود ۲۴ دقیقه. داده و خواسته در assets/routing-design.md است.

اجرای محلی
  1. ورک‌فلوی تازه: Manual Trigger ← یک Edit Fields (یا Code) که ده تیکت فایل تمرین را بسازد؛ خروجی را سنجاق کن.
  2. If «فوری یا payment» ← زیرورک‌فلوی «Notify Manager» (ورک‌فلوی جدا با Execute Workflow Trigger و یک Edit Fields که متن پیام را می‌سازد). باید ۳ آیتم به آن برسد.
  3. Switch بر اساس category با چهار خروجی و شاخه پیش‌فرض. تعداد هر شاخه را با پاسخ مرجع مقایسه کن.
  4. Loop Over Items با اندازه دسته ۳، یک Wait کوتاه، و یک گره HTTP Request به POST /tickets API آزمایشی (یا برای سادگی یک Edit Fields به‌جای آن). تعداد دور حلقه را ببین.
  5. Aggregate روی ده تیکت و یک Edit Fields که شمارش هر دسته را بسازد.
سرویس میزبانی‌شده (در دسترس قانونی)

همان گام‌ها در n8n Cloud، اگر در دسترس قانونی است؛ به‌جای HTTP Request به API محلی، یک Edit Fields بگذار.

بدون اجرا / شبیه‌ساز

طرح را روی کاغذ بکش و تعداد آیتم هر شاخه را حساب کن؛ سپس با «پاسخ مرجع» در assets/routing-design.md مقایسه کن و بنویس اگر به‌جای If «فوری یا payment» دو شاخه جدا به Notify وصل می‌کردی، مدیر چند پیام می‌گرفت.

اشتباه‌های رایج

اشتباهنتیجهکار درست
Switch بدون شاخه پیش‌فرضدسته تازه یا غلط بی‌صدا گم می‌شودشاخه پیش‌فرض به صف بررسی
دو شاخه که به یک اقدام می‌رسنداقدام تکرارییک شرط ترکیبی پیش از اقدام
حلقه دستی برای «هر آیتم»پیچیدگی و خطر حلقه بی‌پایانn8n خودش تکرار می‌کند
فرستادن همه آیتم‌ها یک‌جا به API محدود429 دسته‌جمعیLoop Over Items + Wait
کپی کردن یک منطق در چند شاخهتغییر در یکی، فراموشی در بقیهزیرورک‌فلو
Aggregate به‌جای Merge (یا برعکس)داده در شکل غلطMerge دو جریان را ترکیب می‌کند؛ Aggregate چند آیتم را یکی

اشکال‌زدایی

یک تیکت دو پیام به مدیر فرستاده است.

آیتم از دو شاخه مختلف به گره پیام رسیده است.

در اجرا، ورودی گره پیام را ببین؛ شناسه تکراری هست؟ مسیرهای منتهی به آن گره را دنبال کن.

شرط‌ها را پیش از اقدام یکی کن؛ اگر ممکن نیست، پیش از اقدام آیتم‌های تکراری را بر اساس شناسه حذف کن.

بخشی از درخواست‌های ثبت با 429 شکست می‌خورند.

آیتم‌ها سریع‌تر از سقف سرویس فرستاده شده‌اند.

تعداد آیتم‌ها و زمان اجرای گره HTTP را با سقف سرویس مقایسه کن.

Loop Over Items با دسته کوچک و Wait؛ به‌علاوه تلاش دوباره محدود برای 429 (درس ششم).

پس از Aggregate، گره بعد برای هر تیکت جدا اجرا نمی‌شود و Expressionهای قبلی خالی‌اند.

Aggregate آیتم‌ها را به یک آیتم با فهرست تبدیل کرده است؛ شکل داده عوض شده.

خروجی Aggregate را ببین: یک آیتم با یک آرایه.

اگر بعد از آن دوباره کار تک‌تک لازم است، Split Out بگذار؛ یا Aggregate را فقط در شاخه خلاصه استفاده کن.

تمرین کوتاه

تمرین · 10 دقیقه

هدف: انتخاب ابزار ساختاری درست.

گام‌ها: برای هر نیاز، گره یا الگوی مناسب را بنویس.

  1. سفارش‌ها را به سه مسیر «پست»، «پیک» و «حضوری» بفرست.
  2. یک ایمیل خلاصه با فهرست همه سفارش‌های امروز.
  3. اطلاعات مشتری (از گره «Customers») را کنار هر سفارش بگذار.
  4. پیامک به ۲۰۰ مشتری با سقف ۱۰ پیامک در دقیقه سرویس.
  5. منطق «ساخت فاکتور PDF» که در سه ورک‌فلو لازم است.

معیار پذیرش: ۱ Switch با پیش‌فرض؛ ۲ Aggregate؛ ۳ Merge بر اساس فیلد مشترک؛ ۴ Loop Over Items با Wait؛ ۵ زیرورک‌فلو.

راه‌حل نمونه

۱: Switch بر اساس روش ارسال، با شاخه پیش‌فرض برای مقدار ناشناخته. ۲: Aggregate و سپس یک گره ایمیل. ۳: Merge با ترکیب بر اساس شناسه مشتری. ۴: Loop Over Items با دسته ۱۰ و Wait حدود یک دقیقه، به‌علاوه تلاش دوباره برای 429. ۵: زیرورک‌فلو با Execute Workflow Trigger و ورودی و خروجی مستند.

چالش

تمرین · 35 دقیقه

موقعیت: ورک‌فلوی کار خودت (از چالش‌های درس‌های قبل) را از نظر ساختار بازطراحی کن. اگر داده‌اش حساس است، با داده ساختگی یا ناشناس بیازما.

  1. هر جا زنجیره If داری، بررسی کن Switch با شاخه پیش‌فرض خواناتر است یا نه.
  2. هر اقدام بیرونی را پیدا کن و بپرس: آیا آیتمی می‌تواند از دو راه به آن برسد؟ اگر بله، اصلاح کن.
  3. اگر به سرویسی با سقف نرخ وصلی، دسته‌بندی و Wait بگذار و زمان کل را حساب کن.
  4. دست‌کم یک منطق تکراری (یا منطقی که در ورک‌فلوی دیگر هم لازم می‌شود) را زیرورک‌فلو کن، با ورودی و خروجی مستند.

خروجی مورد انتظار: نمودار پیش و پس از بازطراحی، فهرست اقدام‌های بیرونی با بررسی مسیر تکراری، محاسبه زمان دسته‌بندی، و زیرورک‌فلو با قرارداد ورودی و خروجی.

معیار پذیرش:

  • هر Switch شاخه پیش‌فرض دارد.
  • هیچ اقدام بیرونی از دو مسیر برای یک آیتم اجرا نمی‌شود.
  • دسته‌بندی با سقف نرخ سرویس سازگار است.
  • زیرورک‌فلو ورودی و خروجی مستند دارد و داده آزمون ساختگی یا ناشناس است.

پرسش‌های سنجش

جمع‌بندی

  • If برای بله یا نه، Switch برای چند مقدار؛ همیشه شاخه پیش‌فرض.
  • پیش از هر اقدام بیرونی بپرس آیا یک آیتم از دو راه می‌رسد؛ شرط‌ها را یکی کن.
  • Merge دو جریان را ترکیب می‌کند؛ Aggregate چند آیتم را یک آیتم می‌کند.
  • برای «هر آیتم» حلقه لازم نیست؛ Loop Over Items با Wait برای سقف نرخ، و صفحه‌بندی دستی.
  • منطق تکراری را زیرورک‌فلو کن؛ در n8n 2.0 رفتار خروجی زیرورک‌فلوی متوقف‌شده تغییر کرده است.
  • گره Code آخرین ابزار، با خروجی مستند.

پرسش‌های سنجش

ورک‌فلوی سفارش‌ها با سه If تودرتو روش ارسال را تشخیص می‌دهد (post، courier، pickup). روزی روش تازه‌ای به نام locker اضافه شد و سفارش‌های آن هیچ‌جا نرفتند. طرح بهتر را بنویس.

پاسخ نمونه و معیار ارزیابی

یک Switch بر اساس فیلد روش ارسال با سه خروجی post، courier، pickup و یک شاخه پیش‌فرض که هر مقدار ناشناخته (مثل locker یا خطای تایپی) را به صف بررسی انسانی می‌فرستد و هشدار می‌دهد تا مسیر تازه طراحی شود.

  • Switch به‌جای If تودرتو (1 امتیاز)
  • شاخه پیش‌فرض (1 امتیاز)
  • صف بررسی یا هشدار برای مقدار ناشناخته (1 امتیاز)
  • یک If دیگر برای locker ← مقدار ناشناخته بعدی دوباره گم می‌شود؛ شاخه پیش‌فرض لازم است.

می‌خواهی پایان روز یک پیام به مدیر بفرستی که فهرست همه ۴۰ تیکت امروز را دارد. کدام گره پیش از گره پیام لازم است؟

  • Merge
  • Aggregate
  • Split Out
  • Loop Over Items
پاسخ نمونه و معیار ارزیابی
  • a ← Merge دو جریان را ترکیب می‌کند؛ تعداد آیتم‌ها را یکی نمی‌کند.
  • c ← Split Out برعکس است: یک آیتم را چند آیتم می‌کند.
  • d ← حلقه چهل بار پیام می‌فرستد.

همکارت برای فرستادن ۵۰ ایمیل، Loop Over Items با اندازه دسته ۱ ساخته و داخل حلقه یک If گذاشته که خروجی را به ابتدای حلقه برمی‌گرداند. ورک‌فلو گاهی هرگز تمام نمی‌شود. چه ایرادهایی هست و طرح ساده‌تر چیست؟

پاسخ نمونه و معیار ارزیابی

اگر سرویس ایمیل سقف نرخ ندارد، اصلاً حلقه لازم نیست: گره ایمیل خودش برای هر آیتم یک بار اجرا می‌شود. ترکیب Loop Over Items با حلقه دستی If، شرط توقف مبهم می‌سازد و می‌تواند بی‌پایان شود. طرح ساده: آیتم‌ها مستقیم به گره ایمیل؛ اگر سقف نرخ هست، فقط Loop Over Items با دسته مناسب و Wait، بدون If برگشتی.

  • حلقه برای هر آیتم لازم نیست (1 امتیاز)
  • حلقه دستی با If علت بی‌پایانی (1 امتیاز)
  • Loop Over Items فقط برای سقف نرخ (1 امتیاز)
  • اندازه دسته را بزرگ کن ← مشکل اصلی حلقه دستی و نبود شرط توقف روشن است.

منطق «ساختن پیام اطلاع‌رسانی و فرستادن به مسئول» در سه ورک‌فلو کپی شده است. آن را به زیرورک‌فلو تبدیل کن: گره شروع، ورودی‌های لازم، خروجی، و نحوه صدا زدن از ورک‌فلوی اصلی را بنویس.

پاسخ نمونه و معیار ارزیابی

زیرورک‌فلوی «Notify Owner» با Execute Workflow Trigger شروع می‌شود؛ ورودی: owner (نقش یا نشانی)، subject، ticket_id، severity. گره‌ها: Edit Fields برای ساختن متن، گره ارسال، و Edit Fields پایانی که خروجی { sent: true/false, message_id } برمی‌گرداند. ورک‌فلوهای اصلی با گره Execute Workflow آن را صدا می‌زنند و فقط همین چهار فیلد را می‌فرستند.

  • Execute Workflow Trigger و Execute Workflow (1 امتیاز)
  • ورودی‌های مشخص (1 امتیاز)
  • خروجی مستند (1 امتیاز)
  • همه داده آیتم را بفرست ← ورودی کمینه و مشخص، زیرورک‌فلو را قابل استفاده دوباره و امن‌تر می‌کند.

ورک‌فلویی دو شاخه دارد: «مبلغ بالای سقف» و «مشتری جدید»؛ هر دو به گره «درخواست تأیید از مدیر» می‌رسند. سفارشی که هر دو شرط را دارد چه می‌شود و چطور اصلاحش می‌کنی؟

پاسخ نمونه و معیار ارزیابی

دو درخواست تأیید تکراری به مدیر می‌رسد (و ممکن است دو بار تأیید یا رد شود). اصلاح: پیش از گره تأیید یک If با شرط «مبلغ بالای سقف یا مشتری جدید» بگذار و دلیل‌ها را در یک فیلد جمع کن تا یک درخواست با هر دو دلیل برود.

  • تکرار درخواست را می‌بیند (1 امتیاز)
  • شرط ترکیبی یا حذف تکرار پیش از اقدام (1 امتیاز)
  • مشکلی نیست ← مدیر دو درخواست برای یک سفارش می‌گیرد؛ تصمیم‌ها ممکن است متناقض شوند.

فایل‌های درس

ده تیکت ساختگی و خواسته مسیریابی با پاسخ مرجع

routing-design.md

ابزارها و جایگزین‌ها

  • n8n 2.x — ساخت منطق جریان — n8n Cloud در صورت دسترسی قانونی — مسیر بدون نصب

منابع

Flow logic n8n accessed 2026-10-16

Looping in n8n n8n accessed 2026-10-16

n8n v2.0 breaking changes n8n n8n 2.0; accessed 2026-10-16

Course

n8n Fundamentals