زمان‌بند

Schedule Trigger

اجرای خودکار workflow در زمان‌های مشخص با Cron یا فواصل زمانی

ابزارهای توسعه
مقدماتی
ویژه
۰بازدید
اشتراک‌گذاری:
مستندات رسمی

نمای کلی

نود Schedule Trigger به شما اجازه می‌دهد workflowها را در زمان‌های مشخص یا با فواصل زمانی معین اجرا کنید.

قابلیت‌های کلیدی:

  • اجرای خودکار در زمان‌های مشخص
  • پشتیبانی از Cron Expression
  • تنظیم فواصل زمانی (هر ساعت، روز، هفته، ماه)
  • تعیین دقیق تاریخ و زمان اجرا
  • امکان توقف موقت (Pause) بدون حذف workflow

کاربردها:

  • گزارش‌گیری خودکار روزانه/هفتگی/ماهانه
  • بک‌آپ دوره‌ای اطلاعات
  • بررسی وضعیت سرویس‌ها
  • ارسال ایمیل/پیام یادآوری
  • بروزرسانی خودکار داده‌ها
  • پاکسازی فایل‌های قدیمی

تفاوت با سایر نودها:

این نود یک Trigger Node است، یعنی workflow را شروع می‌کند و باید در ابتدای workflow قرار گیرد.

کاربردهای متداول

1. گزارش روزانه فروش

ارسال خودکار گزارش فروش هر شب:

  • Schedule: هر روز ساعت 23:00
  • Cron: 0 23 * * *
  • عملیات: دریافت داده از دیتابیس > فرمت کردن > ارسال به تلگرام/ایمیل

مثال Workflow:

code
Schedule (23:00) → MySQL (گزارش فروش) → Set (فرمت داده) → Telegram (ارسال)

2. بک‌آپ خودکار هفتگی

بک‌آپ دیتابیس هر یکشنبه:

  • Schedule: هر یکشنبه ساعت 3 صبح
  • Cron: 0 3 * * 0
  • عملیات: Export دیتابیس > فشرده‌سازی > آپلود به Google Drive

3. یادآوری قبض‌ها

یادآوری پرداخت قبوض هر ماه:

  • Schedule: روز 25 هر ماه ساعت 9 صبح
  • Cron: 0 9 25 * *
  • عملیات: لیست قبوض > بررسی تاریخ > ارسال پیام یادآوری

4. بروزرسانی نرخ ارز

دریافت نرخ ارز هر 30 دقیقه:

  • Schedule: Interval - هر 30 دقیقه
  • عملیات: HTTP Request به API نرخ ارز > ذخیره در دیتابیس

5. پاکسازی فایل‌های موقت

حذف فایل‌های قدیمی‌تر از 7 روز:

  • Schedule: هر روز ساعت 2 صبح
  • Cron: 0 2 * * *
  • عملیات: لیست فایل‌ها > بررسی تاریخ > حذف قدیمی‌ها

6. مانیتورینگ سرور

بررسی وضعیت سرور هر 5 دقیقه:

  • Schedule: Interval - هر 5 دقیقه
  • عملیات: HTTP Request (Health Check) > IF (بررسی وضعیت) > Telegram (اعلان خطا)

نکات حرفه‌ای

💡 نکات حرفه‌ای:

  1. 1Cron Expression های پرکاربرد:
code
هر ساعت:        0 * * * *
   هر روز 9 صبح:   0 9 * * *
   هر شنبه:        0 0 * * 6
   هر ماه:         0 0 1 * *
   هر 30 دقیقه:    */30 * * * *
   روزهای کاری:    0 9 * * 1-5
   آخر ماه:        0 0 L * *
  1. 1تست Cron Expression: از سایت [crontab.guru](https://crontab.guru) برای تست و توضیح Cron استفاده کنید.
  1. 1Timezone: برای ایران از UTC+3:30 استفاده می‌شود. ساعت 9 صبح تهران = 5:30 صبح UTC.
  1. 1Execution History: در بخش Executions می‌توانید تاریخچه اجراها را ببینید و Debug کنید.
  1. 1Interval vs Cron:
  • Interval: برای فواصل ساده (هر 1 ساعت، هر 30 دقیقه)
  • Cron: برای زمان‌بندی دقیق (هر روز ساعت 9، هر شنبه)
  1. 1جلوگیری از اجرای همزمان: اگر workflow طولانی است، از گزینه "Prevent execution overlap" استفاده کنید.
  1. 1تست قبل از Active کردن: workflow را Manual اجرا کنید تا مطمئن شوید درست کار می‌کند.
  1. 1Monitoring: از Error Trigger برای دریافت اعلان خطا استفاده کنید:
code
Schedule → [workflow شما] → Error Trigger → Telegram (اعلان خطا)
  1. 1بهینه‌سازی: برای workflowهای سنگین، زمان‌بندی را در ساعات کم‌تردد تنظیم کنید.
  1. 1Pause موقت: اگر می‌خواهید موقتاً Schedule متوقف شود، workflow را Deactivate کنید (بدون حذف).
  1. 1Multiple Schedules: می‌توانید چند Schedule Node در یک workflow داشته باشید (مثلاً یکی برای صبح، یکی برای شب).
  1. 1Date & Time Mode: برای اجرای یکبار در زمان مشخص (مثل کمپین تبلیغاتی) از این حالت استفاده کنید.

رفع مشکلات

خطاهای رایج

1. Workflow اجرا نمی‌شود

علت: Workflow غیرفعال (Inactive) است

راه‌حل

  • مطمئن شوید Workflow را Active کرده‌اید (دکمه Active در بالای صفحه)
  • فقط workflowهای Active می‌توانند توسط Schedule اجرا شوند
  • در لیست Workflows، وضعیت را بررسی کنید

2. زمان اجرا اشتباه است

علت: تنظیمات Timezone

راه‌حل

  • n8n از Timezone سرور استفاده می‌کند
  • برای ایران: UTC+3:30 (تهران)
  • در Cron Expression زمان را با توجه به timezone سرور تنظیم کنید
  • یا در تنظیمات n8n، Timezone را تغییر دهید

3. Cron Expression کار نمی‌کند

علت: فرمت Cron اشتباه است

راه‌حل

  • فرمت صحیح: * * * * * (دقیقه ساعت روز ماه روز_هفته)
  • از Cron Expression Generator استفاده کنید
  • مثال‌های صحیح:
  • 0 9 * * 1-5 → ساعت 9 صبح، روزهای هفته
  • */15 * * * * → هر 15 دقیقه
  • 0 0 1 * * → اول هر ماه نیمه‌شب

4. اجرای چندباره

علت: چند workflow با Schedule فعال دارید

راه‌حل

  • یک Schedule Node برای هر workflow کافی است
  • Duplicate workflowها را بررسی کنید
  • Workflowهای غیرضروری را Deactivate کنید

5. Execution Error

علت: خطا در نودهای بعدی Schedule

راه‌حل

  • Execution Log را بررسی کنید
  • نودهای بعدی را تست کنید
  • از Error Trigger برای مدیریت خطا استفاده کنید
  • Retry on Fail را در تنظیمات فعال کنید

آیا این مستندات مفید بود؟