Déclencheur : À une date

Le déclencheur À une date lance une automatisation selon un calendrier défini par un champ de date d'un formulaire. Une fois par jour, à une heure que vous choisissez, ActivityInfo recherche les enregistrements dont le champ de date tombe un nombre de jours choisi avant ou après ce jour, et lance une exécution pour chacun d'eux.

Alors que les déclencheurs d'enregistrement réagissent à une action d'un utilisateur, ce déclencheur réagit au calendrier : une visite de suivi prévue dans trois jours, une subvention qui expire à la fin du mois, une inscription qui a un an aujourd'hui. C'est le déclencheur à utiliser pour les rappels, les échéances et les anniversaires.

Paramètres

| Paramètre | Description ||---|---|| Formulaire | Le formulaire dont les enregistrements sont vérifiés. Comme pour les autres déclencheurs, les enregistrements des sous-formulaires ne sont pas inclus ; sélectionnez le sous-formulaire lui-même pour programmer à partir de l'un de ses champs. | | Champ de date | Le champ de date du formulaire qui définit le calendrier. Seuls les champs de type date sont proposés : les champs de type semaine, mois et calculé ne peuvent pas être utilisés. Un enregistrement dont le champ de date est vide ne déclenche jamais le déclencheur. | | Fuseau horaire | Le fuseau horaire dans lequel l'heure et le jour du calendrier lui-même sont interprétés. Par défaut, il s'agit du fuseau horaire de votre navigateur. | | Heure | L'heure, de 00:00 à 23:00, à laquelle le déclencheur se déclenche. | | Quand démarrer | Le premier jour où le déclencheur se déclenche pour un enregistrement, par rapport à la date dans le champ : À la date du champ, un certain nombre de jours avant la date du champ, ou un certain nombre de jours après la date du champ. Le nombre de jours peut aller jusqu'à 3650. | | Durée de répétition | Pendant combien de jours consécutifs, comptés à partir du premier jour, le déclencheur continue de se déclencher pour le même enregistrement. Voir ci-dessous. |

Durée de répétition

| Choix | Effet ||---|---|| Une fois | Le déclencheur se déclenche pour un enregistrement uniquement le premier jour. | | Chaque jour jusqu'à la date du champ | Le déclencheur se déclenche le premier jour et chaque jour suivant jusqu'à la date du champ incluse. Ce choix n'est disponible que lorsque le déclencheur démarre un certain nombre de jours avant la date du champ. | | Pendant un nombre de jours | Le déclencheur se déclenche le premier jour et les jours suivants, pour le nombre de jours que vous saisissez, jusqu'à 366. |

Quelques exemples, pour un enregistrement dont le champ de date contient le 20 novembre :

| Quand démarrer | Nombre de jours | Durée de répétition | Se déclenche le ||---|---|---|---|| À la date du champ | | Une fois | 20 novembre | | Jours avant la date du champ | 3 | Une fois | 17 novembre | | Jours avant la date du champ | 3 | Chaque jour jusqu'à la date du champ | 17, 18, 19 et 20 novembre | | Jours après la date du champ | 1 | Pendant un nombre de jours : 7 | du 21 au 27 novembre |

Comment le déclencheur se déclenche

ActivityInfo vérifie chaque automatisation À une date une fois par heure. Lorsque l'heure dans le fuseau horaire du déclencheur correspond à l'heure du déclencheur, il recherche les enregistrements du formulaire dont le champ de date fait de ce jour un jour de déclenchement, et lance une exécution par enregistrement. Les exécutions apparaissent dans l'Historique de l'automatisation comme les exécutions de tout autre déclencheur.

Quelques conséquences de cette programmation sont à connaître :

• Un enregistrement se déclenche au maximum une fois par jour. Si les étapes de l'automatisation échouent et sont réessayées, ou si la vérification s'exécute deux fois, l'enregistrement n'obtient pas une deuxième exécution le même jour.
• Un enregistrement est vérifié une fois par jour, à l'heure choisie. Un enregistrement qui est ajouté, ou dont la date est modifiée, plus tard dans la journée n'est pas pris en compte ce jour-là. Il se déclenchera le jour de déclenchement suivant, si les paramètres de répétition le permettent.
• La modification de l'enregistrement entre-temps n'a pas d'importance. Le déclencheur ne regarde que la valeur du champ de date le jour de la vérification. La suppression d'un enregistrement l'empêche de se déclencher.
• Les automatisations en pause ne se déclenchent pas. La reprise d'une automatisation ne rattrape pas les jours où elle a été mise en pause.
• Seule l'heure choisie compte. Le jour du passage à l'heure d'été, l'heure sautée n'a pas lieu ; un déclencheur réglé pour se déclencher à cette heure-là ne se déclenchera pas ce jour-là.
• Une automatisation lance au maximum 10 000 exécutions par jour. Si plus d'enregistrements que cela sont qualifiés le même jour, les enregistrements restants sont ignorés pour ce jour-là.

Étapes de filtre

Lorsqu'une étape de filtre suit immédiatement le déclencheur, ActivityInfo applique sa condition lors de la recherche d'enregistrements, plutôt que de lancer une exécution pour chaque enregistrement et d'arrêter la plupart d'entre eux au niveau du filtre. Un enregistrement rejeté par le filtre n'apparaît donc pas du tout dans l'historique de l'automatisation. Les filtres qui suivent une étape d'action se comportent comme d'habitude.

La condition peut utiliser les données d'étape du déclencheur, y compris _trigger.date et _trigger.field. Lors de la recherche d'enregistrements, ActivityInfo vérifie la condition par rapport aux propres données du formulaire : il lit _trigger.date depuis le champ de date de chaque enregistrement, et _trigger.field est l'étiquette du champ. _trigger.time n'a pas d'équivalent dans les données du formulaire, donc une condition qui l'utilise ne peut pas être vérifiée lors de la recherche d'enregistrements. Ce filtre s'exécute alors comme une étape normale, après le début de l'exécution, et les enregistrements qu'il rejette apparaissent dans l'historique.

Champs et formulaires supprimés

Lorsque le champ de date, ou le formulaire lui-même, a été supprimé, l'automatisation ne peut plus être vérifiée. Chaque jour, l'historique de l'automatisation enregistre une seule exécution échouée qui nomme le champ ou le formulaire manquant, et l'automatisation affiche l'erreur jusqu'à ce que le déclencheur soit modifié pour utiliser un autre champ, ou que l'automatisation soit mise en pause ou supprimée.

Données d'étape

Chaque déclencheur produit une seule ligne de données d'étape : les valeurs que les étapes ultérieures de l'automatisation (les étapes de filtre, d'e-mail et de webhook) peuvent référencer dans les formules et les modèles.

Pour ce déclencheur, la ligne décrit l'enregistrement dont la date a déclenché le déclencheur :

| Colonne | Type | Description ||---|---|---|| une colonne par champ de formulaire | le type du champ | La valeur de chaque champ de l'enregistrement. Voir Référencer les champs. | | _id | Texte | L'ID de l'enregistrement. | | _lastEditTime | Date et heure | L'heure à laquelle l'enregistrement a été modifié pour la dernière fois. | | _trigger.type | Texte | Toujours DATE_FIELD pour ce déclencheur. | | _trigger.time | Date et heure | L'heure de déclenchement programmée : l'heure du déclencheur le jour du déclenchement, par exemple 09:00 le 17 novembre. | | _trigger.date | Date | La valeur du champ de date qui a déclenché le déclencheur, par exemple 2026-11-20. | | _trigger.field | Texte | L'étiquette du champ de date qui a déclenché le déclencheur. |

Si le formulaire est un sous-formulaire, la ligne inclut également une colonne Parent référençant l'enregistrement parent.

Il n'y a pas de colonne _user : personne n'a rien fait pour démarrer l'exécution. Les formules et les modèles référençant _user sont rejetés par l'éditeur lorsque le déclencheur est À une date. De même, il n'y a pas de colonne _previous.

Webhooks

L'étape de webhook envoie l'enregistrement au format de charge utile Standard ou Personnalisé comme d'habitude. Le format Compatible avec ActivityInfo 4.0 ne peut pas décrire un événement programmé, donc une étape de webhook configurée avec ce format envoie la charge utile Standard lorsque son automatisation utilise ce déclencheur.

Voir aussi

• Rappeler un travailleur social avant une visite de suivi, un tutoriel qui configure ce déclencheur avec une étape d'e-mail
• Déclencheur : Lors de l'ajout d'un enregistrement
• Déclencheur : En cas de modification d'un enregistrement
• Étape de filtre