Accéder au contenu principal Passer au contenu complémentaire

Configurer un déclenchement cron pour les tâches de Jobs

Utilisez un déclenchement Cron pour exécuter votre tâche de Job de manière régulière sur une période de temps donnée.

Une expression cron est une chaîne de caractères consistant en cinq, six ou sept champs séparés par un espace. Ces champs peuvent contenir n'importe quelles valeurs autorisées, ainsi que différentes combinaisons des caractères autorisés, selon le champ.

Avant de commencer

Vous devez avoir l'autorisation Execute (Exécution) sur l'espace de travail où se situe la tâche, afin de configurer les étapes du planning Schedule lors de la création ou de la modification d'une tâche.

Procédure

  1. Si vous modifiez votre tâche après sa création, allez à la page de ses détails, puis cliquez sur l'icône Edit trigger (Modifier le déclenchement) près de Trigger (Déclencheur).
  2. Cliquez sur l'icône Add trigger (Ajouter un déclencheur).
  3. Saisissez le nom du déclencheur.
    Le nom ne peut contenir que des caractères alphanumériques et -, #, _. Les espaces et autres caractères spéciaux ne sont pas autorisés.
  4. Sélectionnez Cron dans la liste déroulante Trigger type (Type de déclencheur).
  5. Dans le champ Location (Time Zone) (Emplacement (Fuseau horaire)), définissez le fuseau horaire pour vos exécutions.
  6. Saisissez la date de début de l'exécution.
  7. Spécifiez les valeurs des champs suivants :
    Le tableau suivant présente les options utilisées pour définir un déclenchement cron.
    Champ Description Valeurs et caractères autorisé·es
    Minutes Intervalles de minutes durant lesquels vous souhaitez exécuter la tâche.
    • 0 - 59
    • , * / -

      */5 (toutes les 5 minutes) est l'intervalle minimal.

      Notez que la planification CRON se réinitialise au début de chaque heure, quel que soit l'intervalle spécifié. Assurez-vous que l'intervalle de minutes dans votre expression CRON planifie toujours la dernière exécution planifiée de chaque heure au moins cinq minutes avant le début de l'heure. Sinon, l'expression ne peut être sauvegardée.

      Il est recommandé de configurer une valeur d'intervalle multiple de cinq. Si vous utilisez un intervalle différent, calculez-le prudemment, ou configurez l'intervalle de minutes à une seule heure, par exemple */7 12 * * *, qui planifie les tâches toutes les sept minutes pour une durée d'une heure. Cela permet de s'assurer que la planification s'arrête sans risquer d'intervalle final plus court à la fin de l'heure.

    Hours Intervalles d'heures durant lesquels vous souhaitez exécuter la tâche.
    • 0 - 23
    • , * / -
    Day of month (Jour du mois) Jour du mois durant lequel vous souhaitez exécuter la tâche.
    • 1 - 31
    • , * / - ? L W
    Months Mois durant lesquels vous souhaitez exécuter la tâche.
    • 1 - 12
    • JAN - DEC
    • , * / -
    Day of week (Jour de la semaine) Jour de la semaine durant lequel vous souhaitez exécuter la tâche.
    • 1 - 7
    • SUN - SAT
    • , * / - ? L #
    Years Années durant lesquelles vous souhaitez exécuter la tâche.
    • Vide, de cette année à 2099
    • , * / -

    Vous pouvez également copier-coller une expression cron déjà définie avec cinq, six ou sept champs.

    Lorsque vous copiez-collez une expression de cinq champs sans valeur dans le champ Years, un astérisque est automatiquement ajouté dans ce champ.

    Lorsque vous copiez-collez une expression de sept champs, le premier est considéré comme des secondes et est ignoré, car les secondes ne sont pas supportées.

    Voici la liste des caractères autorisés :
    • La virgule ( , ) spécifie une liste de valeurs. Par exemple, 2,5,6 dans Day of week (Jour de la semaine) signifie lundi, jeudi et vendredi (le dimanche étant considéré comme le premier jour de la semaine.

    • L'astérisque ( * ) spécifie n'importe quelle valeur possible pour un champ. Par exemple, un astérisque dans Months (Mois) signifie chaque mois.

    • La barre oblique ( / ) spécifie un intervalle de valeurs. Utilisez un chiffre ou un nombre devant la barre oblique pour configurer la valeur initiale. Par exemple, 9/10 dans Hours (Heures) signifie toutes les dix heures, à partir de 9 heures. Vous pouvez également utiliser un astérisque devant la barre oblique. Par exemple */10 dans Hours (Heures) signifie toutes les 10 heures.

    • Le tiret ( - ) spécifie un intervalle de valeurs. Par exemple, 15-17 équivaut à 15, 16, 17.

    • Le point d'interrogation ( ? ) indique "aucune valeur spécifique" dans les champs Day of month (Jour du mois) et Day of week (Jour de la semaine).

      • Utilisez le point d'interrogation dans Day of month (Jour du mois) lorsque vous spécifiez un élément dans le champ Day of week (Jour de la semaine). Par exemple, vous configurez un déclenchement pour qu'il démarre le cinquième jour de la semaine, sans spécifier de jour du mois spécifique. Saisissez ? dans Day of month (Jour du mois) et 5 dans Day of week (Jour de la semaine).

      • Utilisez le point d'interrogation dans Day of week (Jour de la semaine) lorsque vous spécifiez un élément dans le champ Day of month (Jour du mois). Par exemple, vous configurez un déclenchement pour qu'il démarre le cinquième jour du mois, sans spécifier de jour de semaine. Saisissez 5 dans Day of month (Jour du mois) et ? dans Day of week (Jour de la semaine).

    • Le caractère L indique le dernier jour du mois dans Day of month (Jour du mois) et le dernier jour de la semaine ou le dernier jour "X" du mois dans Day of week (Jour de la semaine).

      • Utilisez le caractère L dans Day of month (Jour du mois) pour spécifier le dernier jour du mois sélectionné. Par exemple, ce jour sera le 31 pour le mois de mars, ou le 29 pour le mois de février, lors des années bissextiles.

      • Utilisez le caractère L dans Day of week (Jour de la semaine) pour spécifier le dernier jour de la semaine. Il sera le jour 7 ou SAT (pour samedi). Vous pouvez également utiliser le caractère L après une autre valeur, afin de spécifier le dernier jour "X" du mois. Par exemple, 5L signifie le dernier jeudi du mois.

      Il n'est pas recommandé de combiner une liste ou un intervalle de valeurs au caractère L.

    • Le caractère W spécifie le jour ouvré de la semaine (lundi-vendredi) le plus proche du jour spécifié dans Day of month (Jour du mois). Par exemple, 10W signifie le jour ouvré le plus proche du dixième jour du mois.

    • Le caractère dièse ( # ) indique le énième jour "X" du mois dans Day of week (Jour de la semaine). Par exemple, 5#1 signifie le premier jeudi du mois (5 signifiant jeudi et #1 signifiant le premier du mois).

    Le tableau suivant présente des exemple d'expressions cron et leur signification.
    Expression Cron Description
    15 10 ? * 6L * Exécution de la tâche à 10h15 du matin, le dernier vendredi de chaque mois
    15 10 ? * 6L 2022-2024 Exécution de la tâche à 10h15 du matin, le dernier vendredi de chaque mois, au cours des années 2022, 2023 et 2024
    15 10 ? * 6#3 2022-2024 Exécution de la tâche à 10h15 du matin, le troisième vendredi de chaque mois, au cours des années 2022, 2023 et 2024
  8. Facultatif : Configurez le délai avant expiration du déclenchement en sélectionnant Same as task (Même que pour la tâche), No timeout (Aucun délai avant expiration) ou Custom (Personnalisé).
    Par défaut, la valeur du délai avant expiration du déclenchement est la même que celle du délai avant expiration de la tâche.
    Le délai avant expiration du déclenchement écrase le délai avant expiration de la tâche.
  9. Cliquez sur Save and close (Sauvegarder et fermer).

Résultats

Un message de confirmation s'affiche en haut de la page. Vous êtes redirigé·e vers la page affichant les détails de la tâche. La planification que vous avez définie s'affiche sous Trigger (Déclencheur) > Trigger type (Type de déclencheur) > Cron.

Vous pouvez également voir le planning dans l'onglet Tasks (Tâches). Cliquez sur l'icône Triggers and plans (Déclenchements et plans).

Résolution de problèmes :

Si vous avez sélectionné un fuseau horaire avec des changements d'heure pour votre planning, le passage à l'heure d'été ou d'hiver affecte le planning d'exécution, puisqu'un intervalle d'une heure est répété ou supprimé. L'exécution suivante est ajustée en fonction. Pour plus d'information, consultez Plannings comprenant un changement d'heure (Daylight Saving Time, DST).

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.