Déclencheurs de formulaire
Les déclencheurs de formulaire rendent vos formulaires de saisie intelligents. Cachez ou affichez des champs, modifiez des valeurs et adaptez l'interface en temps réel selon les données saisies par l'utilisateur.
Introduction
Les déclencheurs de formulaire complètent les règles métier en agissant côté formulaire. Tandis que les règles métier réagissent aux événements serveur (création, modification...), les déclencheurs de formulaire réagissent aux interactions de l'utilisateur pendant la saisie.
Analogie
Pensez aux déclencheurs de formulaire comme aux options d'un formulaire web : quand vous cochez "Livraison à une autre adresse" sur un site e-commerce, de nouveaux champs apparaissent. C'est exactement ce que font les déclencheurs.
Caractéristiques d'un déclencheur
| Propriété | Description |
|---|---|
| Nom | Identifiant du déclencheur |
| Libellé | Nom affiché dans la configuration |
| Événement | Quand le déclencheur s'active |
| Action | Ce que fait le déclencheur |
| Condition | Expression MEL optionnelle pour conditionner l'exécution |
| Champs dépendants | Champs dont le changement déclenche la réévaluation |
Événements
Deux types d'événements peuvent déclencher l'exécution :
À l'ouverture du formulaire
S'exécute immédiatement quand le formulaire s'affiche. Idéal pour cacher des champs dès le départ selon l'état initial de l'objet.
Changement de valeur
S'exécute quand un des champs dépendants est modifié par l'utilisateur. C'est l'événement le plus courant pour rendre un formulaire dynamique.
Actions
Voici les actions que vous pouvez déclencher :
Cacher
Cache un ou plusieurs champs du formulaire. Les champs cachés ne sont pas visibles par l'utilisateur et ne sont pas pris en compte lors de la validation.
Afficher
Affiche un ou plusieurs champs précédemment cachés.
Modifier l'affichage
Change l'état d'affichage de champs selon une expression MEL. Permet un contrôle dynamique plus fin que Cacher/Afficher.
Changer la valeur d'un champ
Remplace automatiquement la valeur d'un champ. Pratique pour pré-remplir des champs en fonction d'autres données saisies.
Modifier le caractère obligatoire
Rend des champs obligatoires ou facultatifs dynamiquement selon une expression MEL.
Fonctionnement
Voici le cycle de vie d'un déclencheur de formulaire :
- Le formulaire s'ouvre → les déclencheurs "à l'ouverture" s'exécutent immédiatement
- L'utilisateur modifie un champ → les déclencheurs "changement de valeur" liés à ce champ sont réévalués
- Si la condition est remplie (ou absente), l'action est exécutée
- L'interface se met à jour instantanément (affichage/masquage de champs, etc.)
Bon à savoir
Les actions "Modifier l'affichage" et "Modifier le caractère obligatoire" utilisent des expressions MEL qui sont réévaluées à chaque modification des champs dépendants. C'est un fonctionnement réactif : l'interface s'adapte en temps réel.
Exemples concrets
Afficher les champs professionnels
Événement : Changement de valeur du champ "Type de client"
Condition : Le type est "Professionnel"
{ "$form.typeClient": { "$eq": "professionnel" } }Action : Afficher les champs "SIRET", "TVA intracommunautaire" et "Raison sociale"
Les champs spécifiques aux professionnels n'apparaissent que lorsque le type "Professionnel" est sélectionné, gardant le formulaire épuré pour les particuliers.
Pré-remplir le taux de TVA
Événement : Changement de valeur du champ "Pays"
Condition : Le pays est la France
{ "$form.pays": { "$eq": "FR" } }Action : Changer la valeur du champ "Taux TVA" à 20
Rendre un champ obligatoire selon le contexte
Événement : Changement de valeur du champ "Mode de livraison"
Condition : Le mode est "Livraison à domicile"
Action : Rendre le champ "Adresse de livraison" obligatoire
L'adresse n'est requise que si l'utilisateur choisit une livraison à domicile. Pour un retrait en magasin, le champ reste facultatif.
Prochaine étape
Apprenez maintenant à créer des modèles de documents professionnels avec les exports PDF.