תיעוד

תזמון (cron)

הפעלת pipeline במרווחי זמן קבועים — יומי, שבועי, או ביטוי cron שרירותי.

תזמון (cron)

הערוץ schedule מפעיל pipeline לפי לוח זמנים מוגדר. זהו המקבילה של cron, אך מנוהל מתוך הממשק ונרשם ביומן כמו כל ה-exchanges האחרים.

למה הערוץ הזה

לא כל ה-pipelines הם תגובתיים (לאימייל, לשיחה, ל-webhook). רבים מהם יזומים: דוח יומי, תזכורת שבועית, בדיקה שעתית של מערכת חיצונית. זה מה שהערוץ schedule מכסה.

הגדרה

  1. ניהול → תזמון → משימה חדשה.
  2. בחרו:
    • Pipeline יעד
    • לוח זמנים — הרכיבו אותו חזותית באמצעות ה-CronBuilder (יומי, שבועי, ימים ושעות), או הזינו ביטוי cron קלאסי (0 8 * * 1-5 = 8:00 בימי חול) או קיצור (@daily, @hourly). אין צורך בידע בתחביר cron.
    • אזור זמן — כברירת מחדל, אזור הזמן של הארגון. ניתן להגדרה לכל משימה.
    • Objectif — תווית חופשית (לדוגמה briefing_hebdo, alerte_impayes) המועברת ל-pipeline לצורך ניתובו.
    • Payload סטטי — JSON שרירותי המועבר כקלט ל-pipeline

pipeline אחד, מספר מטרות. אותו pipeline יכול להיות מופעל על ידי מספר משימות מתוזמנות, כל אחת עם objectif שונה. תנאים (filter) בתחילת ה-pipeline מכוונים אז את הביצוע לפי המטרה שהתקבלה — לדוגמה תדריך שבועי ביום שני והתראה יומית באותה תבנית (ראו CFO IA).

מה ה-pipeline מקבל

בכל הפעלה, נוצר exchange עם:

  • schedule.task_id — מזהה המשימה המתוזמנת
  • schedule.objectif — תווית המטרה המוגדרת (לניתוב רב-משימתי)
  • schedule.scheduled_at — חותמת זמן מתוכננת
  • schedule.actual_at — חותמת זמן בפועל (במקרה של drift)
  • schedule.payload — ה-JSON הסטטי שהוגדר (אם קיים)

סובלנות והשלמה בדיעבד

אם betool אינה זמינה ברגע ההפעלה (תחזוקה, תקלה), המשימה מושלמת אוטומטית בהפעלה מחדש, בתוך חלון הסובלנות שאתם מגדירים (כברירת מחדל שעה אחת).

מעבר לחלון, ההפעלה מסומנת כשהוחמצה בהיסטוריה ואינה מנוגנת מחדש — מוטב דוח חסר מאשר דוח מאוחר ולא מסונכרן.

תרחישי שימוש טיפוסיים

  • דוח יומי 8:00 — סוכן ששואל מספר מערכות, מסכם ושולח תדריך באימייל.
  • סנכרון שעתי — pipeline שמושך את הפריטים החדשים ממערכת חיצונית, מעביר אותם לסוכן classifier, ודוחף את התוצאות ל-CRM שלכם.
  • בדיקה שבועית — סוכן שמבקר את מצב התשתית ומסמן את הסטיות.
  • תזכורת J+7 — על לידים שהוגשו לפני שבוע ועדיין ללא מענה.

שיטות עבודה מומלצות

  • הימנעו מהתחלות בדקה עגולה — מערכות רבות פועמות ב-0 * * * *. העדיפו 7 * * * * כדי לפזר את העומס.
  • רשמו ביומן את המשימות שאין להן מה לעשות. משימה שמתבצעת אך אינה עושה דבר (כי אין פריט לטפל בו) צריכה לתעד זאת במפורש. אחרת, לא תוכלו להבחין בין «הכול בסדר» לבין «המשימה כבר לא מתבצעת».
  • התריעו על משימות שהוחמצו. ראו קרדיטים ו-metering → התראות.