Help Center > Foundation Help

S’applique à :

  • Winshuttle Foundation

Types de règles

Il existe quatre types de base dans Winshuttle Composer : Validation, Formatage, Action et JavaScript (voir le guide de référence JavaScript pour plus d’informations sur les règles JavaScript.)

Chaque type de règle est également régi par un ensemble commun de propriétés générales.

Dans cette page

Propriétés de règle générales

Retour au début

 

Écran Créer une règle de Winshuttle Composer

Exécuter la règle lors du chargement du formulaire

Indique si la règle doit être exécutée immédiatement lorsque le formulaire est chargé.

Arrêter l’exécution dans le débogueur avant d’exécuter cette règle

Cette option est pratique pour résoudre les problèmes liés aux règles. L’activation de cette option permet d’insérer un point d’arrêt de débogage dans le code Javascript avant d’exécuter la règle. Si les outils de développement du navigateur sont actifs et que cette règle est exécutée, la session de débogage de navigateur s’arrête juste avant d’exécuter la règle pour continuer d’interroger le code.

Désactiver la règle

L’activation de cette option permet d’empêcher l’exécution de la règle lorsque le formulaire est exécuté.

Type
Définissez le type de règle à créer. D’autres options s’affichent en fonction du type de règle sélectionné. Cliquez sur un type de règle pour plus d’informations :

Condition
Si la condition définie est true, la règle est exécutée. Autrement, elle ne l’est plus.

Remarque : si vous utilisez une condition pour une comparaison à une colonne SharePoint Yes/No :

  • la valeur doit être True ou False (sans guillemets, etc.)
  • La première lettre doit être en majuscule, à savoir, True ou False, mais pas true/false

Règles de validation

Retour au début

Une règle de validation peut être utilisée pour afficher un message d’erreur lorsque les données entrées dans un champ du formulaire ne sont pas valides. Vous pouvez définir les conditions d’affichage du message d’erreur.

Par exemple, vous pouvez créer une règle pour afficher une erreur si un nombre entré dans un champ est supérieur à une certaine valeur, inférieur à une valeur donnée ou les deux.

  • Libellé : Champ descriptif de la règle.
  • Exécuter la règle lors du chargement du formulaire : Cochez cette case pour exécuter la règle au premier chargement du formulaire.
  • Condition : Cochez cette option pour ouvrir le créateur Condition de la règle afin de définir les conditions sous laquelle la règle est appliquée. Les conditions peuvent être des comparaisons de valeurs de base ou impliquer des formules complexes.
  • Type : Type de règle.
  • Message d’erreur : Texte du message d’erreur à afficher lorsque les conditions que vous avez définies sont remplies.
  • Utiliser une boîte de dialogue contextuelle : Affiche une boîte de dialogue avec le message de validation au lieu de mettre en évidence l’erreur du formulaire.
    Remarque : Cette option est utilisée pour afficher uniquement un message. La règle n’est pas validée avant d’envoyer le formulaire.
  • Titre de la boîte contextuelle : Titre de la zone contextuelle.

Règles de formatage

Retour au début

Les règles de formatage appliquent un formatage spécifique à un champ de formulaire lorsque certaines conditions sont remplies.

Par exemple, si la valeur entrée dans un champ du formulaire est trop élevée, vous pouvez créer une règle pour remplacer la couleur du champ de formulaire par la couleur jaune.

  • Libellé : Champ descriptif de la règle.
  • Exécuter la règle lors du chargement du formulaire : Cochez cette case pour exécuter la règle au premier chargement du formulaire.
  • Condition : Cochez cette option pour ouvrir le créateur Condition de la règle afin de définir les conditions sous laquelle la règle est appliquée. Les conditions peuvent être des comparaisons de valeurs de base ou impliquer des formules complexes.
  • Type : Type de règle.
  • Appliquer des styles aux champs : Champ auquel s’applique le formatage.
  • Options de formatage : Options de police et de couleur : gras, italique, souligné, fond barré et couleur de texte.

Zone de règle de formatage - Composer 11.0.3

Modifications du style de police

Modifications des composants d’un formulaire

Modifications du style de police (pour appliquer le composant de formulaire au champ)

  • Gras
  • Italique
  • Souligné
  • Barré
  • Couleur de fond
  • Couleur de texte

Pour masquer, requérir ou désactiver un champ, créez une action de règle en utilisant Changer les propriétés d’un champ. Voir l’entrée pour Changer les propriétés d’un champ dans le tableau de référence rapide des règles d’action pour plus d’informations.

Remarque : Les solutions créées dans les versions antérieures de Composer (version 11.0.2 et versions antérieures) affichent toujours les options suivantes.

  • Masquer un groupe de composants : Masque le groupe qui contient le champ si la condition est vraie.
  • Masque le composant : Masque le champ et son libellé si la condition est true.
  • Désactiver ce composant : Désactive le champ si la condition est vraie.
  • Composant requis : Indique que le champ est obligatoire (à savoir que le formulaire ne peut pas être envoyé si le champ est vide) si la condition est vraie.

Les règles créées dans Composer 11.0.3 et les versions suivantes doivent utiliser la nouvelle option Règle d’action - Changer les propriétés du champ, comme indiqué ci-dessous.

Règles d’action

Retour au début

Les règles d’action sont les règles les plus versatiles. Les règles d’action peuvent exécuter un grand nombre de fonctions, telles que définir des valeurs dans des champs spécifiques, comparer les valeurs des champs, calculer des valeurs en fonction de formules, etc.

  • Libellé : Libellé descriptif de la règle
  • Exécuter la règle lors du chargement du formulaire : Cochez cette case pour exécuter la règle au premier chargement du formulaire.
  • Condition : Cochez cette option pour ouvrir le créateur Condition de la règle afin de définir les conditions sous laquelle la règle est appliquée. Les conditions peuvent être des comparaisons de valeurs de base ou impliquer des formules complexes.
  • Type : Type de règle.
  • Ajouter : Cliquez pour ajouter la règle et ouvrir la boîte de dialogue Ajouter une action de règle (voir ci-dessous).

Après avoir défini les informations de base et les conditions d’une règle d’action :

  • Action : Sélectionnez l’action dans le menu déroulant. Voir le guide de référence rapide des règles pour la description des actions de règle.
  • Champ : Sélectionnez le champ auquel l’action doit être appliquée. Vous pouvez également entrer le nom d’un champ pour le rechercher automatiquement.
  • Valeur : Entrez une valeur ou cliquez sur f(x) (fonction) pour insérer une formule qui s’exécute dans le cadre de l’action.

Tableau de référence rapide des règles d’action

Retour au début

Le tableau ci-dessous contient les règles d’actions disponibles, explique sa fonction et décrit les paramètres associés à l’action.

Action

Description

Ajouter une nouvelle ligne

Ajoute une nouvelle ligne à une table ou un groupe répétitif.

Paramètres

  • Groupe : Groupe répétitif auquel une nouvelle ligne est ajoutée.

Changer les propriétés de champ

Change les propriétés d’un champ pour afficher, masquer, activer/désactiver ou demander/ne pas demander d’entrée.

Paramètres

  • Options disponibles : Afficher | Masquer | Activer | Désactiver | Requis \ Non requis
  • Champ : Champ à modifier.

Changer l’affichage de groupe

Affiche, masque, développe ou réduit un groupe en fonction d’un champ dans le groupe.

Paramètres

  • Champ dans le groupe : Données de champ qui régissent l’état d’affichage du groupe contenant. (Afficher | Masquer | Développer | Réduire)
Copier comme des lignes

Cette règle peut être utilisée pour copier des lignes d’une table répétitive ou d’un groupe répétitif vers une table répétitive ou un groupe répétitif.

Cette règle correspond à la valeur de la colonne dans l'élément répétitif source pour déterminer les lignes à copier en fonction de la propriété du champ sélecteur.

L'action Copier comme lignes détermine si les lignes correspondantes doivent être remplacées ou ajoutées à l'élément répétitif cible en tant que nouvelles lignes.

Supprimer les options de ligne

  • Activer : Affiche l’icône (supprimer) de corbeille
  • Désactiver : Masque l’icône (supprimer) de corbeille

Paramètres

  • Groupe : Groupe répétitif pour lequel les options de suppression de ligne doivent être activées/désactivées.

Table vide

Efface toutes les données d’une table ou d’un groupe répétitif.

Paramètres

  • Groupe : Groupe répétitif dont toutes les données doivent être effacées.

Exécuter la requête

Exécute un contrôle Requête au sein du formulaire.

Paramètres

  • Contrôle Requête : Requête à exécuter.

Exécuter des règles pour le champ

Exécute la règle sur un autre champ. Cette option peut être pratique si deux champs ont des règles liées l’un à l’autre.

Paramètres

  • Champ : Champ sur lequel la règle doit être exécutée.

Exécuter le service Web

Exécute un contrôle Service Web dans le formulaire.

Paramètres

  • Contrôle Service Web : Service Web à exécuter.

Filtrer le contenu répétitif

Active le filtrage des tables/groupes répétitifs tout en conservant le contenu. Vous pouvez définir une « condition » à utiliser avec this : field1= « this » et field2 != « that ». Seules les lignes qui répondent à la condition/aux conditions s’affichent dans la table ou le groupe répétitif.

Paramètres

  • Groupe : Groupe à filtrer en fonction de critères de filtrage.
  • Filtre : Créer la logique de filtrage de la liste déroulante. Par exemple, vous pouvez définir « Is equal to » et entrer une valeur, ainsi que les opérateurs and et or.

Options de nouvelle ligne

  • Activer : Affiche le lien « Ajouter une nouvelle ligne » dans une table ou un groupe répétitif
  • Désactiver : Masque le lien « Ajouter une nouvelle ligne » dans une table ou un groupe répétitif

Paramètres

  • Groupe : Groupe répétitif pour lequel les options de nouvelle ligne doivent être activées/désactivées.

Recharger les options déroulantes

Recharge les options d’une liste déroulante ou d’une liste modifiable déroulante. L’option peut être utilisée pour les listes d’options dynamiques.

Paramètres

  • Champ : Champ de liste déroulante où sont rechargées les options.

Afficher la carte

Envoie une nouvelle adresse à un contrôle de carte sur le formulaire.

Paramètres

  • Élément de carte : Contrôle de carte à mettre à jour avec une nouvelle adresse.
  • Description : Description à attribuer à l’emplacement sur la carte.
  • Adresse : Adresse du nouvel emplacement sur la carte.
  • Ville : Ville du nouvel emplacement sur la carte.
  • État : État du nouvel emplacement sur la carte.
  • Code postal : Code postal du nouvel emplacement sur la carte.
  • Pays : Pays du nouvel emplacement sur la carte.

Rechercher le contenu répétitif

Fournit un mécanisme de recherche d’un « modèle » dans tous les champs (par exemple, si un champ contient « abcd »). Dans ce cas, toutes les lignes dans lesquelles au moins un champ contient le modèle s’affichent dans la table ou le groupe répétitif.

Paramètres

  • Groupe : Nom du groupe
  • Contient : Nom du champ

Définir une valeur de champ

Cette action permet de changer la valeur d’un champ dans le formulaire.

Paramètres

  • Champ : Champ cible dont la valeur doit être définie.
  • Valeur : Formule à évaluer pour obtenir la nouvelle valeur du champ. La formule peut contenir d’autres valeurs de champ, appels de fonction, références de données externes ou valeurs constantes.

Définir une étiquette

Cette action de règle est similaire à Définir une valeur de champ (ci-dessus), mais change le libellé (ou le sous-libellé) d’un élément de formulaire.

Paramètres

  • XPath : Champ (sélectionné depuis une liste déroulante) dont vous voulez changer la valeur de libellé de l’élément de formulaire.
  • Valeur : Formule à évaluer pour obtenir la nouvelle valeur du champ. Elle peut contenir d’autres valeurs de champ, appels de fonction, références de données externes ou valeurs constantes
  • Sous-libellés (True/False) : Définissez la valeur True pour changer le sous-libellé de l’élément défini.

Afficher le message

Affiche une boîte de dialogue contextuelle contenant le texte du message spécifié dans la règle. Les propriétés sur cette règle proviennent des champs d’un formulaire par défaut.

Trier le contenu répétitif

Trie les éléments dans une table répétitive.

Paramètres

  • Champ dans le groupe : Champ en fonction duquel le contenu répétitif doit être exécuté.
  • Ordre de tri : Croissant ou décroissant
  • Persister : si la valeur est True, les données restent triées entre les différentes vues. Si la valeur est false, les données ne le sont pas.

Envoyer le formulaire

Cette action permet de simuler le bouton Envoyer du formulaire.

Paramètres

  • Type d’envoi : Disposition ou type d’envoi :
  • Exécuter : Exécute la tâche en cours.
  • Approuver : Exécute la tâche en cours avec la disposition Approuvé.
  • Rejeter : Exécute la tâche en cours avec la disposition Rejeté.
  • Enregistrer : Enregistre le formulaire, mais ne lance pas le processus ou ne le fait pas avancer.
  • Enregistrer ou router : Enregistre le formulaire et démarrer le processus.