تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.
CronJobManager هو مدير مهام مجدولة توفره NocoBase، يعتمد على cron. يسمح هذا المدير للإضافات (Plugins) بتسجيل مهام مجدولة على الخادم لتنفيذ منطق معين بشكل دوري.
تعريف نوع CronJobParameters هو كما يلي (من cron):
| المعلمة | النوع | الوصف |
|---|---|---|
| cronTime | string | Date | DateTime | تعبير الوقت للمهمة المجدولة. يدعم تعبيرات cron القياسية، على سبيل المثال 0 0 * * * يعني التنفيذ يوميًا في الساعة 00:00. |
| onTick | function | الدالة الرئيسية للمهمة. سيتم تشغيلها في الوقت المحدد. |
| onComplete | function | تُنفّذ عندما تتوقف المهمة بواسطة job.stop() أو بعد اكتمال دالة onTick. |
| timeZone | string | يحدد المنطقة الزمنية للتنفيذ (مثل Asia/Shanghai). |
| context | any | السياق عند تنفيذ onTick. |
| runOnInit | boolean | ما إذا كان سيتم التنفيذ مرة واحدة فورًا عند التهيئة. |
| utcOffset | string | number | يحدد إزاحة المنطقة الزمنية. |
| unrefTimeout | boolean | يتحكم فيما إذا كانت حلقة الأحداث (event loop) تبقى نشطة. |
| التعبير | المعنى |
|---|---|
* * * * * | تُنفّذ كل دقيقة |
0 * * * * | تُنفّذ كل ساعة |
0 0 * * * | تُنفّذ يوميًا في الساعة 00:00 |
0 9 * * 1 | تُنفّذ كل يوم اثنين في الساعة 09:00 |
*/10 * * * * | تُنفّذ كل 10 دقائق |
💡 يمكنك استخدام crontab.guru للمساعدة في إنشاء التعبيرات.
تُشغّل المهام المجدولة وتتوقف مع تشغيل التطبيق وإيقافه. بشكل عام، لا تحتاج إلى بدء أو إيقافها يدويًا.