Règles d'enregistrement des fiches

Ce qui se passe, d'un point de vue fonctionnel, à chaque enregistrement d'une fiche — validation, transitions de workflow, automatismes, formules et notifications.

Cette page explique, d'un point de vue fonctionnel, ce qui se passe à chaque enregistrement d'une fiche — de la validation des champs aux transitions de workflow, en passant par le recalcul des formules, l'exécution des automatismes et les notifications.

Comprendre cette séquence vous aide à concevoir des formulaires, des automatismes et des workflows qui se comportent exactement comme vous l'attendez.

FAQ

Lorsqu'un état de workflow change, quel état les conditions et les formules voient-elles — l'ancien ou le nouveau ?

Toujours le nouvel état. La transition est appliquée pendant l'enregistrement, avant les automatismes d'écriture, les formules, les conditions et les automatismes de lecture. À partir de là, chaque étape évalue la fiche avec son nouvel état. Une condition comme « l'état du workflow est Approuvé » est vraie durant l'enregistrement même qui a effectué la transition Approuver.

Un automatisme d'écriture peut-il voir les valeurs de formule calculées pendant le même enregistrement ?

Non. Les automatismes d'écriture s'exécutent avant le calcul des formules ; ils voient donc encore les valeurs de formule de l'enregistrement précédent. Si un automatisme doit réagir à un résultat de formule, utilisez plutôt un automatisme de lecture — ceux-ci s'exécutent après le recalcul des formules et voient les valeurs fraîches.

Un automatisme de lecture peut-il voir les valeurs de formule calculées pendant le même enregistrement ?

Oui. Les automatismes de lecture (rapports, webhooks, e-mails, notifications mobiles) s'exécutent après le recalcul des formules ; les données qu'ils reçoivent reflètent donc la fiche entièrement calculée, y compris tous les champs formule fraîchement calculés durant cet enregistrement.

Si un enregistrement échoue, qu'est-ce qui est annulé ?

Tout ce qui se trouve dans l'enregistrement protégé est annulé : les données de la fiche, les changements de relations et les effets des automatismes d'écriture ne sont pas enregistrés ; les fichiers téléversés ne sont pas déplacés vers le stockage définitif ; aucune tâche n'est créée. Le numéro séquentiel réservé avant l'enregistrement n'est pas réutilisé (les trous sont normaux). Les étapes qui s'exécutent après l'enregistrement — notifications, formules, automatismes de lecture — ne s'exécutent jamais si l'enregistrement échoue.

Les formules des fiches liées sont-elles recalculées à chaque enregistrement ?

Sur les enregistrements normaux (web, mobile, à l'unité), oui — les formules des fiches liées qui référencent la fiche courante sont recalculées, les grands graphes de relations étant traités en arrière-plan. Pour les mises à jour en masse, les imports et les migrations, ce calcul est différé vers une tâche d'arrière-plan qui s'exécute ensuite.

Qu'est-ce qu'une formule à « calcul unique » ?

Une formule à calcul unique calcule sa valeur une seule fois — généralement à la création — puis la conserve indéfiniment. Lors des enregistrements suivants, la valeur existante est préservée et n'est jamais réévaluée. Utilisez-la pour horodater une valeur qui ne doit jamais changer, comme une date de « réception ».

Les automatismes de lecture se déclenchent-ils lorsque je modifie une fiche clôturée ?

Cela dépend de l'enregistrement. Une simple modification sans transition de workflow sur une fiche déjà clôturée ignore les automatismes de lecture. Un enregistrement qui fait passer la fiche vers un état final exécute bien les automatismes de lecture pour cet enregistrement.

Qu'est-ce que le mode partiel, et quand est-il utilisé ?

Le mode partiel désactive la validation des champs obligatoires afin qu'une fiche puisse être enregistrée avec des champs obligatoires encore vides. Il est utilisé pour les enregistrements mobiles hors ligne (un agent de terrain enregistre une fiche partiellement remplie pour la synchroniser plus tard) et les imports de données (des lignes qui ne contiennent pas tous les champs obligatoires). Les transitions de workflow ne sont pas autorisées en mode partiel.

Si je modifie un champ dont dépend une formule, quand la formule se met-elle à jour ?

Les champs formule sont recalculés après la confirmation de l'enregistrement. La réponse renvoyée à l'écran après l'enregistrement contient déjà les valeurs fraîchement calculées : vous voyez donc la mise à jour immédiatement.

Vue d'ensemble

Enregistrer une fiche n'est pas une opération instantanée unique. Cela se déroule en une séquence répartie en trois phases :

1. Avant l'enregistrement — préparation légère (numérotation, chargement de la définition du formulaire, prise en compte de l'assignation actuelle).
2. L'enregistrement lui-même — l'écriture principale, protégée selon le principe du tout ou rien : validation, transition de workflow et automatismes d'écriture. Si une étape échoue, l'enregistrement est entièrement annulé et rien n'est partiellement écrit.
3. Après l'enregistrement — l'enrichissement qui s'exécute une fois l'enregistrement confirmé : formules, conditions, automatismes de lecture, historique et notifications.

L'enregistrement lui-même fonctionne en tout ou rien. Si une étape échoue — un champ obligatoire manquant, une relation supprimée, une transition de workflow invalide — l'enregistrement est entièrement annulé et rien n'est enregistré.

Phase 1 — Avant l'enregistrement

Ces étapes s'exécutent avant le début de l'enregistrement protégé.

Étape	Ce qui se passe	Pourquoi c'est important
Numéro séquentiel	Une nouvelle fiche reçoit un numéro unique et croissant au sein de son formulaire.	Le numéro est permanent — il ne change jamais, même après modification. Si l'enregistrement échoue, le numéro réservé n'est pas réutilisé : les trous dans la séquence sont donc normaux.
Chargement de la définition du formulaire	La plateforme charge les champs, le workflow, les conditions et la configuration des formules pour la version attachée à la fiche.	La validation applique toujours les règles de la version liée à la fiche.
État initial du workflow	Une nouvelle fiche dont le formulaire possède un workflow est automatiquement placée dans l'état initial.	Une nouvelle fiche commence toujours son cycle de vie dans le bon état initial, même si l'utilisateur n'en a pas choisi.
Instantané de l'assignation	Pour une fiche existante, la plateforme enregistre qui est actuellement assigné et abonné.	Seuls les utilisateurs nouvellement assignés ou abonnés seront notifiés ensuite — pas ceux qui l'étaient déjà.

Phase 2 — L'enregistrement lui-même

Migration du formulaire

Si le formulaire a été mis à jour depuis la dernière ouverture de la fiche, celle-ci est automatiquement migrée vers la dernière version active avant la validation, afin que les règles les plus récentes s'appliquent toujours.

Ce que vous constatez : vous pouvez enregistrer une fiche même si le formulaire a changé depuis son ouverture — la plateforme l'adapte automatiquement. Si la migration est impossible, l'enregistrement est rejeté.

Validation des champs

Chaque champ est validé :

• Les champs simples (texte, nombre, date, liste, utilisateur, fichiers…) sont vérifiés pour le type, les règles obligatoires et le format.
• Les champs relation sont vérifiés pour la cardinalité (nombre minimum / maximum de fiches liées) et l'existence des fiches liées.
• Les champs système ne peuvent pas être écrits par l'utilisateur et sont ignorés.
• En mode partiel (enregistrements mobiles hors ligne, imports), la règle de champ obligatoire est ignorée afin que des fiches incomplètes puissent être enregistrées progressivement.

Utilisateur inactif dans un champ utilisateur : assigner un utilisateur inactif à un champ utilisateur est rejeté — sauf si ce même utilisateur inactif était déjà présent dans le champ avant l'enregistrement, auquel cas la valeur est préservée pour ne pas casser les données existantes.

Transition de workflow

C'est ici que l'état du workflow change réellement. Lorsqu'un enregistrement inclut une action de workflow (l'utilisateur a cliqué sur une transition telle que Soumettre pour validation ou Approuver), la plateforme applique la transition à ce moment et recalcule les conditions de visibilité de la fiche par rapport au nouvel état.

À partir de ce point, chaque étape suivante — automatismes d'écriture, formules, conditions, automatismes de lecture — voit le nouvel état du workflow.

Automatismes d'écriture

Les automatismes d'écriture modifient les données de la fiche dans le cadre de l'enregistrement. Ils s'exécutent juste après la transition de workflow et voient toujours le nouvel état. Comme ils s'exécutent à l'intérieur de l'enregistrement protégé, si l'un d'eux échoue, tout l'enregistrement est annulé.

Automatisme d'écriture	Ce qu'il fait
Changer l'assignation	Assigne ou réassigne la fiche à un utilisateur ou un groupe selon des conditions.
Changer l'état du workflow	Force automatiquement une seconde transition de workflow (par exemple, clôture automatique après approbation).
Modifier la valeur d'un champ	Définit ou efface la valeur de champs de la fiche.

La condition d'un automatisme d'écriture est évaluée par rapport aux valeurs de champs enregistrées par l'utilisateur et au nouvel état du workflow. Elle ne voit pas encore les résultats des formules — celles-ci sont calculées plus tard, après l'enregistrement. Si votre automatisme doit réagir à une formule, utilisez plutôt un automatisme de lecture.

Fichiers et tâches

Les fichiers téléversés ne sont déplacés vers leur stockage définitif qu'une fois l'enregistrement confirmé, afin qu'un enregistrement échoué ne laisse jamais de fichiers orphelins. Si le formulaire est configuré pour créer automatiquement une tâche, celle-ci est créée et liée ici.

Phase 3 — Après l'enregistrement

Une fois la fiche enregistrée en toute sécurité, une seconde séquence d'enrichissement et de notification s'exécute. Ces étapes n'annulent pas l'enregistrement si elles échouent — la fiche est déjà enregistrée.

Notifications push

La plateforme compare la liste actuelle des assignés et abonnés avec l'instantané pris avant l'enregistrement. Tout utilisateur nouvellement assigné ou abonné reçoit une notification push mobile.

Calcul des formules

Tous les champs formule sont recalculés ici, sur la fiche enregistrée — ils voient donc le nouvel état du workflow, les valeurs saisies par l'utilisateur et les modifications apportées par les automatismes d'écriture.

• Si la fiche est liée à d'autres fiches via des champs relation, les formules de ces fiches liées peuvent également être recalculées (par exemple, une formule d'agrégation sur une fiche parente). Pour les grands graphes de relations, ce calcul est effectué en arrière-plan afin de garder des enregistrements rapides.
• Pour les mises à jour en masse, les imports et les migrations, le recalcul sur les fiches liées est différé vers une tâche d'arrière-plan afin de ne pas surcharger la plateforme.
• Les formules à calcul unique calculent leur valeur une seule fois, puis la conservent indéfiniment — utile pour horodater une date de « réception » ou une valeur « créé par » qui ne doit jamais changer.

Conditions

Toutes les conditions (visibilité des champs, surcharges de champs obligatoires, visibilité des sections) sont recalculées par rapport à l'état final de la fiche, formules déjà appliquées, et le résultat est mis en cache afin qu'au prochain affichage de la fiche, la bonne visibilité des champs soit immédiatement disponible.

Automatismes de lecture

Les automatismes de lecture réagissent à l'enregistrement mais ne modifient pas les données de la fiche. Ils s'exécutent après les formules et les conditions, et voient donc la fiche entièrement enrichie.

Automatisme de lecture	Ce qu'il fait
Rapport simple	Génère un rapport à partir d'un modèle et l'attache ou l'envoie.
Notification mobile	Envoie une notification push ciblée à des utilisateurs ou groupes spécifiés.
Webhook	Appelle un point de terminaison externe avec les données de la fiche, pour l'intégration avec des systèmes tiers.
Envoyer un e-mail	Envoie un e-mail formaté aux destinataires configurés.

Fiches clôturées : si une fiche est déjà dans un état final (clôturé) et que l'enregistrement n'inclut pas de transition de workflow, les automatismes de lecture sont ignorés — cela évite des notifications ou rapports intempestifs lors de modifications mineures sur des fiches clôturées. Si l'enregistrement est la transition qui amène la fiche vers un état final, les automatismes de lecture s'exécutent bien pour cet enregistrement.

Historique de restauration

Un instantané des valeurs de champs de la fiche (telles qu'elles sont après l'enregistrement complet) est stocké dans le journal d'historique. C'est cet instantané qui permet aux administrateurs de restaurer une fiche à un état antérieur.

Cas particuliers

Scénario	Ce qui change
Mode partiel (mobile hors ligne, import)	Les minimums de champs obligatoires et de cardinalité ne sont pas appliqués. Les transitions de workflow ne sont pas autorisées.
Pré-remplissage	Tous les automatismes sont ignorés ; les formules ne renvoient que les valeurs de pré-remplissage. Utilisé pour pré-remplir une fiche avant sa création officielle.
Mise à jour en masse / import / migration	Le recalcul des formules sur les fiches liées et la mise à jour des tâches planifiées sont différés afin de protéger la plateforme lorsque de nombreuses fiches changent en même temps.
Créée pour le compte d'un autre utilisateur	La fiche est attribuée à l'utilisateur cible, et l'historique enregistre le changement de propriété.
Restaurée depuis l'historique	Les données restaurées sont appliquées comme un enregistrement normal ; les automatismes et les formules s'exécutent comme d'habitude, et l'état de workflow de l'instantané est rétabli.