Aller au contenu principal

Trigger CRON

Le trigger CRON déclenche un workflow selon une planification temporelle définie par une expression CRON.

Vue d'ensemble​

Ce type de trigger est idéal pour :

  • Exécuter des tâches planifiées
  • Effectuer des synchronisations périodiques
  • Générer des rapports automatiques
  • Effectuer des sauvegardes régulières

Configuration​

Expression CRON​

L'expression CRON est composée de 5 valeurs séparées par des espaces :

* * * * *
│ │ │ │ │
│ │ │ │ └─── Jour de la semaine (0-7, 0 ou 7 = dimanche)
│ │ │ └───── Mois (1-12)
│ │ └─────── Jour du mois (1-31)
│ └───────── Heure (0-23)
└─────────── Minute (0-59)

Syntaxes disponibles​

Chaque valeur peut utiliser les syntaxes suivantes :

  • * : Toutes les valeurs

    • Exemple : * * * * * = toutes les minutes

  • */n : Toutes les n valeurs

    • Exemple : */5 * * * * = toutes les 5 minutes
    • Exemple : 0 */2 * * * = toutes les 2 heures

  • n-m : Plage de valeurs

    • Exemple : 0 9-17 * * * = toutes les heures de 9h à 17h
    • Exemple : 0 0 1-15 * * = tous les jours du 1er au 15 de chaque mois

  • n,m : Valeurs spécifiques

    • Exemple : 0 0 1,15 * * = le 1er et le 15 de chaque mois
    • Exemple : 0 9,17 * * 1-5 = à 9h et 17h, du lundi au vendredi

  • n : Valeur unique

    • Exemple : 0 9 * * * = tous les jours à 9h
    • Exemple : 30 14 1 * * = le 1er de chaque mois à 14h30

Jours de la semaine​

  • 0 ou 7 : Dimanche
  • 1 : Lundi
  • 2 : Mardi
  • 3 : Mercredi
  • 4 : Jeudi
  • 5 : Vendredi
  • 6 : Samedi

Exemples d'expressions​

Exemples courants​

  • Toutes les minutes : * * * * *
  • Toutes les heures : 0 * * * *
  • Tous les jours à minuit : 0 0 * * *
  • Tous les lundis à 9h : 0 9 * * 1
  • Tous les 1er du mois à 5h : 0 5 1 * *
  • Toutes les 30 minutes : */30 * * * *
  • Toutes les heures et demie le matin : 30 0-12 * * *
  • Tous les 5 minutes le mercredi : */5 * * * 3
  • Dernier jour du mois à 2h40 : 40 2 31 12 *

Exemples avancés​

  • Du lundi au vendredi, de 9h à 17h, toutes les heures : 0 9-17 * * 1-5
  • Le 1er et le 15 de chaque mois à minuit : 0 0 1,15 * *
  • Tous les jours ouvrables à 8h30 : 30 8 * * 1-5
  • Tous les dimanches à 10h : 0 10 * * 0

Configuration dans Ecosystem​

Lors de la création d'un trigger CRON :

  1. Sélectionnez le type CRON
  2. Fuseau horaire : Sélectionnez le fuseau horaire sur lequel se baser pour le déclenchement (exemples : Europe/Paris, America/New_York, UTC)
  3. Intervalle d'exécution (CRON) : Entrez l'expression Cron. Une expression cron est une chaîne composée de 5 champs différents séparés par un espace blanc. Chaque champ peut comprendre n'importe laquelle des valeurs autorisées, ainsi que différentes variantes des caractères spéciaux autorisés pour ce champ
  4. Un aperçu de la prochaine exécution sera affiché
  5. Validez la création

Données transmises​

Lorsqu'un trigger CRON se déclenche, le workflow reçoit :

{
  "triggeredAt": "2024-01-15T09:00:00Z",
  "cronExpression": "0 9 * * *",
  "timezone": "UTC"
}

Exemple d'utilisation​

Scénario : Rapport quotidien​

  1. Créer le trigger :

    • Type : CRON
    • Expression : 0 9 * * * (tous les jours à 9h)

  2. Créer le workflow associé :

    • Récupère les données du jour précédent
    • Génère un rapport
    • Envoie le rapport par email

  3. Déployer :

    • Déployez le trigger dans l'environnement de production
    • Le workflow s'exécutera automatiquement tous les jours à 9h

Bonnes pratiques​

  • Fuseau horaire : Vérifiez le fuseau horaire utilisé (généralement UTC)
  • Fréquence : Évitez les exécutions trop fréquentes (toutes les secondes)
  • Performance : Planifiez les tâches lourdes en dehors des heures de pointe
  • Test : Testez votre expression CRON avant de déployer en production
  • Documentation : Documentez la raison de la planification choisie

Outils utiles​

Vous pouvez utiliser des outils en ligne pour valider et tester vos expressions CRON :

Prochaines étapes​