Ligne de Table modifiée ou date atteinte

Démarre le workflow quand une ligne d’une Table est ajoutée ou modifiée, ou quand la date d’une ligne est atteinte (« un mois avant l’échéance »). La ligne arrive dans data.table, sans mail déclencheur.

Le déclencheur Ligne de Table modifiée ou date atteinte surveille une Table de l’instance et lance une exécution par ligne concernée. Trois façons de partir, au choix dans « Démarrer quand » :

• Une ligne est ajoutée ou modifiée : la fiche d’un dossier change, on prévient le consultant ;
• Une ligne est ajoutée : seulement les nouvelles lignes ;
• La date d’une ligne est atteinte : la valeur d’une colonne date, décalée d’un délai — « un mois avant l’échéance du bail », « le jour de la signature », « dix jours après la remise des clés ».

Aucune connexion n’est à choisir : la Table appartient à l’instance. L’exécution n’a pas de mail porteur ; Envoyer reste utilisable si vous choisissez la boîte d’envoi sur le nœud.

En bref

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

Les ports de « Ligne de Table modifiée ou date atteinte » : ce qui entre à gauche, ce qui sort à droite

Paramètres

table

Table — Choisie dans la liste, ou par son identifiant court (son « slug »), qui peut venir d’un template.

• Type : Ressource distante (resourceLocator)
• Requis : Oui
• Façons de choisir : dans une liste, saisir un identifiant (table)

event

Démarrer quand

• Type : Un choix (options)
• Requis : Oui
• Défaut : changed
• Options :
  • changed — Une ligne est ajoutée ou modifiée
  • created — Une ligne est ajoutée
  • date — La date d’une ligne est atteinte : La valeur d’une colonne date, décalée d’un délai : « un mois avant l’échéance ».

dateColumn

Colonne date — La clé machine de la colonne (par exemple echeance). Une ligne sans date est ignorée.

• Type : Texte (string)
• Requis : Non
• Défaut : "" (vide)
• 60 caractères au plus
• Affiché quand : event vaut date
• Expressions : {{ }} refusé

offsetAmount

Délai — 0 : le jour même.

• Type : Nombre (number)
• Requis : Non
• Défaut : 0
• Nombre entier, de 0 à 730
• Affiché quand : event vaut date

offsetUnit

Unité du délai

• Type : Un choix (options)
• Requis : Non
• Défaut : days
• Options :
  • days — jours
  • weeks — semaines
  • months — mois
• Affiché quand : event vaut date

offsetDirection

Avant ou après la date

• Type : Un choix (options)
• Requis : Non
• Défaut : before
• Options :
  • before — avant la date
  • after — après la date
• Affiché quand : event vaut date

everyMinutes

Vérifier toutes les (minutes) — Une vérification lit la Table de l’instance : elle ne coûte aucun appel extérieur.

• Type : Nombre (number)
• Requis : Non
• Défaut : 15
• Nombre entier, de 5 à 1440
• Rangé sous « Avancé » dans l’éditeur

Sorties

• main — Emprunté une fois par ligne trouvée lors d’une vérification : chaque ligne lance sa propre exécution.

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.table.row.<column> }} — object. Les cellules de la ligne, par clé machine de colonne ({{ data.table.row.locataire }}).
• {{ data.table.rowId }} — string. L’identifiant de la ligne.
• {{ data.table.event }} — string. Ce qui a fait partir le déclencheur : changed (ajoutée ou modifiée), created (ajoutée) ou date (date atteinte).
• {{ data.table.table }} — string. La table, telle que choisie sur le nœud (son identifiant court ou son identifiant).
• {{ data.table.updatedAt }} — string. La dernière modification de la ligne (ISO 8601). createdAt porte sa création.
• {{ data.table.date }} — string. Date atteinte seulement : la valeur de la colonne date (2026-06-04).
• {{ data.table.fireDay }} — string. Date atteinte seulement : le jour du déclenchement, date décalée du délai (2026-05-04 pour « un mois avant le 4 juin »).

Exemple

Une table « Baux » a une colonne date echeance et une colonne email_locataire. Pour écrire au locataire un mois avant l’échéance :

table            baux
event            date
dateColumn       echeance
offsetAmount     1
offsetUnit       months
offsetDirection  before

Le 4 mai, chaque bail dont l’échéance tombe le 4 juin lance une exécution. Un nœud Envoyer écrit à {{ data.table.row.email_locataire }} et cite {{ data.table.date | date:"d MMMM yyyy" }}.

Conseils

• Position de départ. À la publication, le déclencheur part « de maintenant » : les lignes déjà modifiées ne sont pas rejouées, et pour une date atteinte, ce sont les dates atteintes à partir du jour de la publication qui partent. Republier conserve la position.
• Le jour d’une date atteinte est celui de l’UTC : une date atteinte part à la première vérification après minuit UTC. Une panne de plusieurs jours ne perd rien : la vérification suivante rattrape tous les jours manqués.
• Pas de doublon. Une exécution est identifiée par la ligne et sa modification (ou sa date) : une même modification, une même échéance ne lancent jamais deux exécutions. Une échéance repoussée à une autre date repart à la nouvelle date.
• Une ligne sans date n’est jamais concernée par une date atteinte. Une colonne date et heure fonctionne aussi : seul son jour compte.
• Rythme. Entre 5 et 1 440 minutes, 15 par défaut (réglage avancé) ; l’instance peut imposer un plancher (INTEGRATION_POLL_MIN_MINUTES). Une vérification lit la Table de l’instance : elle ne coûte aucun appel extérieur.
• Volume. Une vérification ramène au plus 200 lignes. Le reste attend la vérification suivante.
• Une ligne écrite par le workflow lui-même est une ligne modifiée : un workflow déclenché par « ajoutée ou modifiée » qui réécrit la même table se relancerait sur sa propre écriture. Préférez « ajoutée », ou une autre table.
• Les suppressions ne sont pas détectées.
• Tester. Tester depuis ce déclencheur lit réellement la table : la ligne la plus récemment modifiée (ou les dates atteintes aujourd’hui) ; l’essai ne déplace jamais la position (voir Essais).