Déclencheur : Lors de l'ajout d'un enregistrement

Langue: Français
Cet article a été traduit de l'anglais par IA et peut contenir des erreurs. Vos commentaires nous aideront à l'améliorer.

Le déclencheur Lors de l'ajout d'un enregistrement démarre une automatisation chaque fois qu'un nouvel enregistrement est enregistré dans un formulaire spécifique. Il se déclenche une fois par enregistrement, après que l'enregistrement a été sauvegardé avec succès, y compris les enregistrements ajoutés via la saisie de données, l'application mobile, les importations et l'API.

Le déclencheur est configuré avec un unique Formulaire. Les enregistrements ajoutés à d'autres formulaires, y compris les sous-formulaires du formulaire sélectionné, ne déclenchent pas le déclencheur. Pour réagir aux enregistrements de sous-formulaires, sélectionnez le sous-formulaire lui-même comme formulaire du déclencheur.

Importations

Les enregistrements importés déclenchent ce déclencheur exactement comme le font les enregistrements saisis individuellement : une importation de 500 enregistrements démarre 500 exécutions, une par enregistrement. (Ceci est un changement par rapport à ActivityInfo 4.0, dont les webhooks ignoraient les importations — voir Des webhooks d'ActivityInfo 4.0 aux automatisations.) Gardez cela à l'esprit lorsqu'une automatisation publie sur un système externe : le récepteur doit être préparé à un afflux d'une requête par enregistrement importé.

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 nouvellement ajouté :

| Colonne | Type | Description ||--------|------|-------------|| une colonne par champ de formulaire | le type du champ | La valeur de chaque champ du nouvel enregistrement. Voir ci-dessous comment référencer les champs. | | _id | Texte | L'ID de l'enregistrement du nouvel enregistrement. | | _lastEditTime | Date et heure | L'heure à laquelle l'enregistrement a été ajouté. | | _user.name | Texte | Le nom de l'utilisateur qui a ajouté l'enregistrement. | | _user.email | Texte | L'adresse e-mail de l'utilisateur qui a ajouté l'enregistrement. | | _user.id | Texte | L'ID de l'utilisateur qui a ajouté l'enregistrement. | | _trigger.type | Texte | Toujours RECORD_ADDED 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 inclut également une colonne Parent référençant l'enregistrement parent, dont les champs peuvent être parcourus de la même manière que n'importe quel champ de référence.

Il n'y a pas de colonne _previous pour ce déclencheur : un enregistrement nouvellement ajouté n'a pas d'état antérieur auquel être comparé. Les formules référençant _previous sont rejetées par l'éditeur lorsque le déclencheur est "Lors de l'ajout d'un enregistrement".

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 d'attribuer des codes courts et stables à vos champs et de les utiliser dans les formules et modèles d'automatisation : les codes survivent au renommage de l'étiquette du champ, sont plus faciles à lire que les ID de champ, et n'ont jamais besoin des [crochets] requis pour les étiquettes avec des espaces.

| Référence | Exemple ||-----------|---------|| Par code (recommandé) | NOM | | Par étiquette | [Nom Complet] | | Par ID de champ | cgnp9n6msbq938m7 |

Les valeurs de chaque type de champ apparaissent dans les données d'étape comme suit :

| Type de champ | Valeur dans les données d'étape | Exemple de formule ||-----------|-----------------|-----------------|| Texte, texte multiligne, code-barres | Texte | NOM == "Amina Yusuf" | | Numéro de série | Texte, par ex. "00042" | NUMERO != "" | | Quantité | Nombre | AGE >= 18 | | Date | Date, par ex. 2026-07-30 | DATEDENREGISTREMENT > "2026-01-01" | | Semaine | Semaine, par ex. 2026W31 | SEMAINE == "2026W31" | | Mois | Mois, par ex. 2026-07 | MOIS == "2026-07" | | Sélection unique | L'option sélectionnée | STATUT == "Récupéré" | | Sélection multiple | La liste des options sélectionnées | CONTAINS(SYMPTOMES, "Fièvre") | | Référence | L'ID de l'enregistrement référencé ; naviguez pour atteindre ses champs | CLINIQUE.NOM == "Poste de Santé de Mangina" | | Point géographique | Composants LATITUDE, LONGITUDE et ACCURACY | LIEU.LATITUDE > 0 | | Pièces jointes | La liste des fichiers joints | !ISBLANK(FICHIERS) | | Calculé | Le résultat de la formule du champ | ADULTE |

Un champ de référence contient l'ID de l'enregistrement référencé, mais vous pouvez naviguer à travers celui-ci vers n'importe quel champ du formulaire référencé, y compris ses propres champs de référence : CLINIQUE.DISTRICT.NOM.

Voir aussi

Élément suivant
Déclencheur : En cas de modification d'un enregistrement