nodulz

Planification

Catalogue des nœuds Déclencheurs
Sur cette page

Intervalle régulier ou horaires fixes (quotidien, hebdomadaire, mensuel, annuel). Publiez le workflow pour activer la planification.

Utilisation et spécificités

Choisissez intervalle, calendrier ou cron. Le fuseau horaire et les jours sélectionnés changent l’heure effective du déclenchement. Publiez pour activer la planification.

Type technique : schedule. Runtime : nodulz.

Exemple guidé

Pour lancer un traitement du lundi au vendredi à 09:00, heure de Paris :

  1. Choisissez le mode Calendrier et la fréquence Hebdomadaire.
  2. Sélectionnez lundi à vendredi, puis ajoutez l’horaire 09:00.
  3. Renseignez le fuseau Europe/Paris plutôt que garder UTC si vous visez l’heure locale.
  4. Reliez les étapes à exécuter et testez leur traitement depuis l’éditeur.
  5. Publiez, puis vérifiez une exécution déclenchée automatiquement à l’horaire attendu.

La configuration correspondante est :

json
{
  "mode": "calendar",
  "timezone": "Europe/Paris",
  "calendar": {
    "frequency": "weekly",
    "times": ["09:00"],
    "weekdays": [1, 2, 3, 4, 5]
  }
}

Les jours techniques vont de 0 (dimanche) à 6 (samedi). Pour une expression cron personnalisée, la même règle hebdomadaire s’écrit 0 9 * * 1-5 et s’évalue dans le fuseau choisi. Pour une simple cadence, le mode Intervalle accepte par exemple 5m ou 1h.

La sortie du nœud expose triggeredAt, timezone, mode et les réglages de planification. triggeredAt est un horodatage ISO ; comparez-le au fuseau voulu plutôt qu’à l’affichage brut d’une heure UTC.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre Type Par défaut Valeurs / limites
mode enum "interval" interval, calendar
interval string "1h" -
timezone string "UTC" -
calendar object {"frequency":"daily","times":["09:00"],"weekdays":[1,2,3,4,5],"monthDays":[1],"yearlyDates":["01-01"],"cron":"0 9 * * *"} -
calendar.frequency enum "daily" daily, weekly, monthly, yearly, custom
calendar.times array ["09:00"] -
calendar.weekdays array [1,2,3,4,5] -
calendar.monthDays array [1] -
calendar.yearlyDates array ["01-01"] -
calendar.cron string "0 9 * * *" -

Aide de configuration

interval
Intervalle
Raccourci (5m, 1h, 1d) ou expression cron complète avec espaces.
timezone
Fuseau horaire
Fuseau IANA utilisé pour évaluer la planification.

Exemples

  • Intervalle 1h → toutes les heures
  • Horaires fixes → lun–ven à 09:00
  • 0 9 * * 1-5 → en semaine à 09h00

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json
{
  "mode": "interval",
  "interval": "1h",
  "timezone": "UTC",
  "calendar": {
    "frequency": "daily",
    "times": [
      "09:00"
    ],
    "weekdays": [
      1,
      2,
      3,
      4,
      5
    ],
    "monthDays": [
      1
    ],
    "yearlyDates": [
      "01-01"
    ],
    "cron": "0 9 * * *"
  }
}

Vérification

Vérifiez séparément le traitement manuel et le déclenchement automatique après publication. Contrôlez le jour et l’heure en tenant compte du fuseau configuré. Après un changement d’horaire ou de fuseau, republiez. Un clic sur Exécuter ne prouve pas que la planification est active.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.

Pour aller plus loin