Skip to content

Planification ​

Démarre le workflow à intervalle régulier, sans mail déclencheur. L’heure prévue, l’heure réelle et le fuseau arrivent dans data.schedule.

Le déclencheur Planification démarre le workflow à intervalle régulier, sans mail déclencheur : toutes les N minutes, ou selon une expression cron (« tous les lundis à 8 h »). Utilisez-le pour un récapitulatif quotidien, un export périodique, des relances, ou pour interroger un service qui n’a pas de webhook.

L’exécution n’a pas de mail porteur : les nœuds qui agissent sur le mail déclencheur (répondre dans le fil, Classer, Marquer) ne peuvent pas suivre ce déclencheur, et l’éditeur les signale par une erreur bloquante. Envoyer reste utilisable si vous choisissez la boîte d’envoi sur le nœud.

En bref ​

  • Type : trigger.schedule · version 1
  • Catégorie : Déclencheurs
  • Nature : Déclencheur — lance une exécution
  • Effet : Sans effet externe (none) — rien n’est écrit hors de Mankomail ; rejouable sans risque
  • Exige un mail porteur : Non
  • Connexion : Aucune
  • Sorties : main

Paramètres ​

mode ​

Rythme

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : interval
  • Options :
    • interval — Toutes les N minutes : Le plus simple : une exécution à intervalle régulier.
    • cron — Expression cron : Pour « tous les lundis à 8 h » et les rythmes que N minutes n’exprime pas.

everyMinutes ​

Toutes les (minutes)

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 60
  • Nombre entier, de 5 à 44640
  • Affiché quand : mode vaut interval

cron ​

Expression cron — Cinq champs : minute, heure, jour du mois, mois, jour de la semaine. 0 8 * * 1 = tous les lundis à 8 h. Une expression qui tirerait plus souvent que toutes les 5 minutes est refusée.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 120 caractères au plus
  • Exemple : 0 8 * * 1
  • Affiché quand : mode vaut cron
  • Expressions : {{ }} refusé

timezone ​

Fuseau horaire — Nom IANA (Europe/Paris). Vide = UTC.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : Europe/Paris
  • Expressions : {{ }} refusé

Sorties ​

  • main — Emprunté par chaque exécution lancée par une occurrence de la planification.

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.schedule.plannedFor }} — string. L’heure prévue de cette occurrence (l’heure ronde demandée, par exemple 08:00), ISO 8601 en UTC.
  • {{ data.schedule.firedAt }} — string. L’heure à laquelle l’exécution a réellement été créée, ISO 8601 en UTC. Quelques secondes après plannedFor, davantage après un rattrapage.
  • {{ data.schedule.timezone }} — string. Le fuseau utilisé pour calculer les occurrences : le nom IANA réglé sur le nœud, ou UTC quand le champ est vide.

Example ​

Envoyer une synthèse chaque matin de semaine. Ajoutez un déclencheur Planification avec :

mode       cron
cron       0 8 * * 1-5
timezone   Europe/Paris

Chaque jour ouvré à 8 h, heure de Paris, une exécution démarre sur le port main avec data.schedule.plannedFor égal à ce 8 h (écrit en UTC). Un nœud en aval peut intituler son mail Synthèse du {{ data.schedule.plannedFor }}.

Pour récupérer ce qui a changé dans Notion depuis le passage précédent, passez {{ data.schedule.plannedFor }} à l’opération « Entrées créées ou modifiées depuis… » du nœud Notion, ou utilisez le déclencheur dédié Entrée Notion modifiée, qui tient sa propre position.

Tips ​

  • Le rythme le plus court est toutes les 5 minutes, dans les deux modes : une expression cron qui tirerait plus souvent est refusée. En mode intervalle, le maximum est de 44 640 minutes (31 jours).
  • Le cron a cinq champs : minute, heure, jour du mois, mois, jour de la semaine. Avec un fuseau, les changements d’heure sont pris en compte. Le panneau du nœud liste les prochaines occurrences, calculées exactement comme la publication les armera.
  • La planification est armée à la publication et vit en base : un redémarrage ne perd rien, et une même occurrence ne lance jamais deux exécutions.
  • Après une interruption, seule la dernière occurrence manquée est rattrapée, en quelques minutes ; les occurrences manquées antérieures ne sont pas rejouées.
  • Un workflow en pause garde sa planification mais ne lance rien ; le reprendre ne demande pas de republier. Dépublier, archiver ou retirer le nœud arrête la planification.
  • Quand vous testez depuis ce déclencheur dans l’éditeur, aucune heure n’est fournie : data.schedule est absent d’une essai, et les expressions qui le lisent rendent une valeur vide, avec un avertissement.