Help Center > Foundation Help

S’applique à :

  • Winshuttle Foundation

Utilisation des règles

Dans cette page

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ébut

Chaque 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 : Graphique d’exemple de champ avec règle appliquée

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
  1. Dans le volet des propriétés, cliquez sur Propriétés.
  2. Dans le volet des propriétés, en regard de Règles, cliquez sur le bouton [...].
  3. L’inspecteur de règle s’ouvre dans le volet Propriétés, comme indiqué ci-dessous.

    Volet Propriétés : Utilisation des règles

  4. Cliquez sur Ajouter une règle.
  5. 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.
  6. Cliquez sur OK pour terminer.

Modification ou suppression des règles existantes

Retour au début

Cliquez dans le champ ou l’élément ayant la règle à changer.

  1. Dans le volet des propriétés, cliquez sur Propriétés.
  2. Dans le volet des propriétés, en regard de Règles, cliquez sur le bouton [...].
  3. 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.
  4. Cliquez sur OK pour terminer les modifications.

Utilisation de l’inspecteur de règles

Retour au début

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.

Onglet Solution, icône Inspecteur de règles

Écran Inspecteur de règles Winshuttle Composer

Utilisation des conditions

Retour au début

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.

Écran Générateur de conditions Winshuttle Composer Condition

Ci-dessous : Exemple de condition dans le générateur de condition Winshuttle Composer

Écran Générateur de conditions Winshuttle Composer Condition