ضبط الجدول

لا تبدأ المهمة المجدولة من تلقاء نفسها إلا إذا كان لها مشغّل مجدول أو ويب هوك وكانت حالتها نشط. أما المهمة التي مشغّلها تشغيل يدوي فلا تعمل حتى يشغّلها مستخدم.

إضافة جدول

1. افتح المهمة من قائمة المهام المجدولة.
2. احذف خطوة البداية، واسحب مجدول من المشغّلات إلى لوحة البناء، واربطه بالخطوة الأولى.
3. انقر القلم على المشغّل لتفتح إعداداته.
4. تحت الجدولة اختر إعداد مسبق، أو اختر مخصص واكتب تعبير Cron إن أردت جدولًا من وضعك.
5. اختر المنطقة الزمنية التي يعمل الجدول بتوقيتها، وهي التوقيت العالمي ما لم تغيّرها.
6. انقر حفظ أعلى المنشئ.

تعمل الإعدادات المسبقة في الأوقات التالية بتوقيت المنطقة الزمنية المختارة في المشغّل:

اختيار المنطقة الزمنية

يقرأ كيوبت تعبير Cron بتوقيت المنطقة الزمنية المختارة في المشغّل، فإذا اخترت الرياض (السعودية) عمل الإعداد المسبق يوميًا الساعة 9:00 صباحًا الساعة 9:00 صباحًا بتوقيت الرياض. وفي المناطق التي تغيّر ساعاتها للتوقيت الصيفي يلتزم الجدول بالتوقيت المحلي، فيبقى تشغيل الساعة 9:00 صباحًا في موعده بعد تغيير الساعة.

يعمل الإعداد المسبق أيام الأسبوع الساعة 9:00 صباحًا من الإثنين إلى الجمعة. ولأسبوع عمل من الأحد إلى الخميس، اختر مخصص وأدخل 0 9 * * 0-4.

كتابة تعبير Cron

يتكون تعبير Cron من خمسة حقول تفصل بينها مسافات: الدقيقة، والساعة، ويوم الشهر، والشهر، ويوم الأسبوع. وفي حقل يوم الأسبوع يمثل 0 يوم الأحد ويمثل 6 يوم السبت، ويطابق الرمز * القيم كلها.

• 30 5 * * *: كل يوم الساعة 05:30.
• */15 * * * *: كل 15 دقيقة.
• 0 6 1 1,4,7,10 *: الساعة 06:00 في اليوم الأول من كل ربع سنة.

يبحث كيوبت عن المهام المستحقة مرة كل دقيقة، فأقصر فاصل ممكن دقيقة واحدة. وحين تنقر حفظ أو تشغيل يتحقق كيوبت من التعبير والمنطقة الزمنية، فإن لم يكن التعبير خمسة حقول صالحة، أو دلّ على تاريخ لا يأتي أبدًا مثل 0 9 30 2 *، عرض خطأً ولم يحفظ المهمة. ولتعرف متى يعمل تعبيرك، جرّبه في أداة مثل crontab.guru.

تفعيل الجدول

لا يبدأ الجدول بمجرد حفظه، ففعّل المهمة بإحدى طريقتين:

• في قائمة المهام المجدولة، افتح قائمة الصف واختر تفعيل، فيفحص كيوبت المهمة أولًا ويعرض خطأً إن وجد مشكلة، كخطوة غير مربوطة، أو مشغّل مجدول بلا تعبير Cron أو بتعبير غير صالح أو منطقة زمنية غير صالحة، أو خطوة جامع الويب أو REST API أو خلاصة RSS بلا رابط. ولا تُفعَّل مهمة مشغّلها تشغيل يدوي.
• في المنشئ، اضبط زر الحالة على نشط ثم انقر حفظ.

لإيقاف الجدول، اختر إلغاء التفعيل من القائمة، أو اضبط الحالة في المنشئ على متوقف مؤقتًا أو مسودة واحفظ.

تظهر التشغيلات المجدولة في سجل التنفيذ بالمشغّل scheduled.

حين يتوقف الجدول

إذا تعذّرت قراءة تعبير Cron أو المنطقة الزمنية لمهمة نشطة، أوقف كيوبت جدولها وأبقى جداول المهام الأخرى تعمل. وتتحول حالة المهمة إلى خطأ، ويظهر في سجل تنفيذها تشغيل حالته فشل ومشغّله scheduled يذكر المشكلة. أصلح الجدول في إعدادات المشغّل، ثم فعّل المهمة من جديد.

جدول مشغّل المؤشر

إذا لم يكن في المهمة مشغّل مجدول، حدّدت فترة التحقق في خطوة مشغّل مؤشر جدولها: كل ساعة في بداية كل ساعة، ويوميًا الساعة 09:00 بالتوقيت العالمي، وأسبوعيًا كل إثنين الساعة 09:00 بالتوقيت العالمي. واضبط حالة المهمة على نشط من زر الحالة في المنشئ.

مشغّل الويب هوك

يبدأ مشغّل ويب هوك المهمة حين يرسل إليه نظام آخر طلبًا.

1. احذف خطوة البداية وضع مكانها ويب هوك من المشغّلات، واربطه، ثم انقر حفظ.
2. افتح المهمة ثانيةً من قائمة المهام المجدولة وانقر القلم على المشغّل. يعرض حقل رابط ويب هوك رابط المهمة وزر نسخ ومثالًا لأمر curl.
3. فعّل المهمة: افتح قائمة صفها في المهام المجدولة واختر تفعيل، أو اضبط زر الحالة على نشط وانقر حفظ. وتُرفض الاستدعاءات الموجهة إلى مهمة غير نشطة.

أرسل طلب POST إلى الرابط. وإذا كان محتوى الطلب بصيغة JSON، قرأت الخطوات اللاحقة حقوله بتعبيرات مثل {{ trigger.payload.order_id }}. وأقصى حجم للمحتوى 256 كيلوبايت. ويصل الرد عند انتهاء التشغيل متضمنًا حالته.