Une règle de dépendance adapte un formulaire aux réponses de l'utilisateur : afficher un champ seulement quand il a du sens, le rendre obligatoire dans certains cas. Les variables fournissent aux règles des valeurs qui ne viennent pas du formulaire : l'utilisateur courant, la date du jour, une valeur lue dans la CMDB…
Ces réglages se font dans l'écran Formulaires (voir « Concevoir un formulaire »), ouvert aux Administrateurs et aux Administrateurs des formulaires.
Ajouter une règle
Sur un brouillon, la carte Règles de dépendance liste les règles de la version (Quand … → effet → champs visés), dans la langue de l'écran : libellés des champs, conditions et combinaison (« et », « ou »…) en toutes lettres, valeurs comparées en pastilles. Suit le formulaire d'ajout :
- Combiner les conditions par : ET (toutes), OU (au moins une), OU EXCLUSIF (une seule), ET SAUF (la première, aucune autre) ou OU SAUF (la première, ou aucune autre) ;
- Effet : afficher, masquer, rendre obligatoire ou rendre facultatif ;
- Champs visés : cochez le ou les champs concernés ; quand le formulaire en compte beaucoup, une recherche filtre la liste ;
- une ou plusieurs conditions (+ Condition pour en ajouter) :
- Champ déclencheur : un champ du formulaire, ou Groupes de l'utilisateur courant. Pour un champ qui désigne un utilisateur, Comparer les groupes de l'utilisateur désigné par ce champ compare ses groupes plutôt que sa valeur ;
- Condition : est égal à, n'est pas égal à, contient, ne contient pas, commence par, finit par, est parmi, n'est pas parmi, contient toutes les valeurs, est renseigné, n'est pas renseigné, et pour un nombre ou une date est supérieur à, est inférieur à (ou égal), est entre, n'est pas entre ;
- Valeurs : séparées par des points-virgules. Une valeur peut être une variable (voir plus bas).
Cliquez sur Ajouter. Une condition qui attend une valeur (est égal à, contient, est parmi…) et n'en a aucune est signalée sous le champ Valeurs, et la règle n'est pas ajoutée ; une ligne de condition laissée vierge (jamais touchée) n'est pas envoyée. Une condition se retire par l'icône de corbeille de sa ligne. Une règle ne se modifie pas : supprimez-la (icône de corbeille) et recréez-la.
Testez vos règles dans l'Aperçu : saisissez des valeurs et regardez les champs apparaître ou disparaître. Rien n'est enregistré.
La publication est refusée si une règle est incohérente : champ déclencheur ou champ visé absent de la version, condition sans valeur alors qu'elle en attend une, groupe de conditions vide, comparaison d'ordre sur un champ qui n'est ni un nombre ni une date, comparaison de groupes sur un champ qui ne désigne pas un utilisateur, ou champ obligatoire qui ne peut jamais s'afficher. Un motif qui porte sur une règle la cite en toutes lettres (conditions → effet → champs visés) et mène à sa ligne dans la carte des règles ; un motif qui porte sur un champ cite son libellé. Quand deux champs portent le même libellé, leur identifiant suit le libellé, en discret, entre parenthèses ; un champ supprimé depuis se lit « champ supprimé ».
Les variables livrées
Dans les Valeurs d'une condition, ces variables sont toujours proposées : L'utilisateur courant, Le demandeur, Le service du catalogue demandé (celui qui a ouvert ce formulaire), Maintenant, Aujourd'hui, Début du mois, Fin du mois, Premier lundi du mois et Début de la semaine. Dans une règle, la valeur d'un autre champ du formulaire s'écrit {{field:identifiant}} (avec deux-points, alors que le gabarit d'affichage et les bornes d'un nombre utilisent {{field.identifiant}}).
Définir ses propres variables
Le bouton Variables de la liste des formulaires ouvre l'écran Variables (/dynamicforms/admin/variables). Chaque variable a un Token (minuscules, chiffres, _ et : uniquement ; le préfixe field: est réservé), un Libellé et une Nature :
- Date calculée : une Base (Maintenant ou Aujourd'hui), une Ancre facultative (début ou fin du mois, début de la semaine, premier lundi du mois) et un Décalage (jours) ;
- Requête SQL : une seule instruction SELECT, en lecture seule ; la première colonne de la première ligne est la valeur. Seules les colonnes listées sous le champ peuvent être citées en
@colonne. Cette nature est réservée aux Administrateurs : un administrateur des formulaires ne la voit pas proposée ; sur une variable SQL existante, il ne peut changer que le token et le libellé, ni la requête, ni la nature, ni supprimer la variable ; - Chemin CMDB : un Point de départ (Utilisateur courant, Demandeur, ou un Champ du formulaire de type Sélecteur d'objet CMDB), un Chemin de sauts successifs (type de relation, Sortant ou Entrant) et la Valeur à comparer (Utilisateur lié, Identifiant de l'actif ou Libellé affiché). Indisponible si le module CMDB est désactivé.
Sur la fiche d'une variable, Tester calcule sa valeur. Pour une requête SQL ou un chemin CMDB qui dépend d'une saisie réelle, indiquez l'identifiant d'une Saisie existante.
Une variable utilisée par au moins une règle ne peut pas être supprimée.
Voir aussi
- « Concevoir un formulaire » : les champs, les versions et la publication.