Langue: Français
Le déclencheur En cas de modification d'un enregistrement lance une automatisation chaque fois qu'un enregistrement existant dans un formulaire spécifique est modifié et enregistré. Il se déclenche une fois par modification, après que la modification a été enregistrée avec succès, y compris les modifications effectuées via la saisie de données, l'application mobile, les importations et l'API. L'ajout ou la suppression d'un enregistrement ne déclenche pas ce déclencheur — voir Lors de l'ajout d'un enregistrement et Lorsqu'un enregistrement est supprimé.
Le déclencheur est configuré avec un seul Formulaire. Les modifications apportées aux enregistrements d'autres formulaires, y compris les sous-formulaires du formulaire sélectionné, ne déclenchent pas ce déclencheur.
Les importations qui mettent à jour des enregistrements existants déclenchent ce déclencheur une fois par enregistrement mis à jour, exactement comme le font les modifications individuelles — un changement par rapport à ActivityInfo 4.0, dont les webhooks ignoraient les importations.
Données de l'é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 après la modification, ainsi qu'un instantané de l'enregistrement avant la modification sous le nom réservé _previous :
| Colonne | Type | Description ||---|---|---|| une colonne par champ de formulaire | le type du champ | La valeur de chaque champ après la modification. | | _previous | Instantané | L'état de l'enregistrement avant la modification, avec une entrée par champ de formulaire. | | _id | Texte | L'ID de l'enregistrement de l'enregistrement modifié. | | _lastEditTime | Date et heure | L'heure de la modification. | | _user.name | Texte | Le nom de l'utilisateur qui a effectué la modification. | | _user.email | Texte | L'adresse e-mail de l'utilisateur qui a effectué la modification. | | _user.id | Texte | L'ID de l'utilisateur qui a effectué la modification. | | _trigger.type | Texte | Toujours RECORD_EDITED pour ce déclencheur. | | _trigger.time | Date et heure | L'heure à laquelle l'événement s'est produit. |
Si le formulaire est un sous-formulaire, la ligne contient également une colonne Parent référençant l'enregistrement parent.
Comparaison avant et après
L'instantané _previous permet à une formule de ne réagir qu'aux modifications significatives. Chaque champ du formulaire est disponible sous _previous en utilisant le même code, la même étiquette ou le même ID de champ que la ligne actuelle :
_previous.STATUS != STATUS
poursuit le flux uniquement lorsque la modification a changé le champ Statut, et
STATUS == "Recovered" && _previous.STATUS != "Recovered"
poursuit uniquement lorsque cette modification particulière a fait passer l'enregistrement au statut Récupéré — une modification qui laisse l'enregistrement comme Récupéré ne déclenche pas à nouveau les actions.
Les champs de référence contenus dans l'instantané peuvent être parcourus exactement comme sur la ligne actuelle : _previous.CLINIC.NAME est le nom de la clinique vers laquelle l'enregistrement pointait avant la modification — utile pour détecter qu'un enregistrement est déplacé d'une clinique à une autre :
_previous.CLINIC.NAME != CLINIC.NAME
Notez que la navigation se joint toujours à l'état actuel de l'enregistrement référencé ; seule la référence elle-même — l'enregistrement vers lequel elle pointe — est capturée dans l'instantané.
Référencer les champs
Les champs peuvent être référencés par code, par étiquette ou par ID de champ ; nous recommandons vivement les codes. Consultez Déclencheur : Lors de l'ajout d'un enregistrement pour le tableau complet des types de champs et des valeurs de leurs données d'étape — les valeurs sont identiques pour ce déclencheur, à la fois sur la ligne actuelle et sous _previous.