S’applique à :
- Winshuttle Foundation
Utilisation des règles
Rubriques connexes
Dans cette page
- Actions de règle
- Ajout d’une nouvelle règle
- Modification ou suppression de règles
- Utilisation de l’inspecteur de règles
- Utilisation des conditions
Les règles sont des outils puissants qui contrôlent la logique et permettent d’automatiser des fonctions dans un formulaire, telles que la mise à jour d’un champ automatiquement lorsque les données d’un autre champ changent. Les règles peuvent appliquer des formules aux données, changer les données et modifier l’apparence des données dans un formulaire.
Par exemple, vous pouvez utiliser une règle pour qu’un bouton déclenche une fonction, telle qu’une recherche dans une base de données, activer un service Web ou définir une valeur de champ. Vous pouvez également utiliser une règle pour indiquer une entrée de données incorrecte en remplaçant la couleur d’un champ par la couleur rouge pour indiquer une valeur incorrecte.
Pour les règles avancées :
Si l’assistant Règle de Composer ne donne pas la flexibilité suffisante pour créer un règle, les utilisateurs avancés peuvent créer des règles en utilisant du code JavaScript. Voir le Guide de référence JavaScript Composer pour plus d’informations sur les encapsuleurs pris en charge, la syntaxe JavaScript, etc.
Actions de règle
Retour au débutChaque règle peut être constituée d’une ou de plusieurs Actions. Dans l’exemple ci-dessus, une seule règle peut être utilisée pour gérer deux fonctions pouvant être chacune une action distincte. Par exemple, vous pouvez utiliser une règle pour calculer et mettre à jour automatiquement un champ de prix total en fonction des valeurs entrées par l’utilisateur dans un champ de prix d’article et dans un champ de quantité.
Lors de l’application de plusieurs règles à un champ ou un bouton, les actions suivantes peuvent être utilisées une seule fois et doivent être la dernière règle dans la séquence :
- Exécuter la requête
- Exécuter le service Web
- Envoyer le formulaire
Cela s’explique par le fait qu’une demande est effectuée sur le serveur ; par conséquent aucune règle supplémentaire ne peut être exécutée une fois la demande effectuée.
Conseil : Les champs auxquels sont appliqués des règles apparaissent avec une icône de coche à côté de leur nom dans le volet Solution de l’onglet Solution. Par exemple :
Une règle Composer est constituée d’un type de règle (Action, Formatage ou Validation), d’une ou de plusieurs conditions, d’une ou de plusieurs actions.
Ajout d’une nouvelle règle
Retour au début- Dans le volet des propriétés, cliquez sur Propriétés.
- Dans le volet des propriétés, en regard de Règles, cliquez sur le bouton [...].
- L’inspecteur de règle s’ouvre dans le volet Propriétés, comme indiqué ci-dessous.
- Cliquez sur Ajouter une règle.
- Entrez les informations suivantes pour la règle :
- Libellé : Entrez le nom explicite de la règle.
- Exécuter la règle lors du chargement du formulaire : Sélectionnez cette option pour exécuter la règle dès que le formulaire est chargé.
- Type : Sélectionnez un type de règle : Validation, Formatage ou Actions.
- Condition : Cliquez pour créer la ou les conditions de déclenchement de la règle, par exemple, lorsqu’un champ de formulaire change. Voir Utilisation des conditions (ci-dessous) pour plus d’informations.
- Message : Entrez un message à l’attention de l’utilisateur lorsque la règle est exécutée.
- Utiliser une fenêtre contextuelle : Cochez cette case pour utiliser une fenêtre contextuelle pour afficher le message à l’attention de l’utilisateur.
- Titre de la fenêtre contextuelle : Si vous avez sélectionné Utiliser une fenêtre contextuelle, entrez le nom de la fenêtre contextuelle dans ce champ.
- Cliquez sur OK pour terminer.
Modification ou suppression des règles existantes
Retour au débutCliquez dans le champ ou l’élément ayant la règle à changer.
- Dans le volet des propriétés, cliquez sur Propriétés.
- Dans le volet des propriétés, en regard de Règles, cliquez sur le bouton [...].
- Dans l’éditeur de règle :
- Cliquez sur Ajouter pour ajouter une action de règle.
- Cliquez sur l’icône Modifier pour ouvrir la règle dans l’éditeur.
- Cliquez sur l’icône Supprimer (corbeille) pour supprimer la règle.
- Cliquez sur la condition pour changer la condition de la règle. Voir Utilisation des conditions (ci-dessous) pour plus d’informations.
- Cliquez sur Supprimer la condition (corbeille) pour supprimer une condition.
- Cliquez sur OK pour terminer les modifications.
Utilisation de l’inspecteur de règles
Utilisez l’inspecteur de règle pour accéder à un « tableau de bord » instantané de toutes les règles de la solution.
Dans l’inspecteur de règle, vous pouvez :
- Rechercher des règles dans la barre de recherche pour filtrer les résultats.
- Imprimer les résultats.
- Modifier une règle en cliquant sur son nom.
- Afficher toutes les règles appliquées à un champ en cliquant sur le nom du champ.
Utilisation des conditions
Le générateur de condition fournit une interface simple pour créer la logique et les règles d’une condition.
- Cliquez sur Ajouter une condition pour ajouter une condition.
- Cliquez sur Ajouter un groupe pour ajouter un sous-groupe de conditions.
- Sélectionnez Champs de formulaire et des opérateurs logiques (tels que « is equal to » ou « not equal to », par exemple) dans les menus déroulants.
- Cliquez sur Supprimer pour supprimer une condition ou un groupe.
Ci-dessous : Exemple de condition dans le générateur de condition Winshuttle Composer