[AEM_Forms]{class="badge positive" title="S’applique à AEM Forms)."}

Ajout de règles à un formulaire adaptatif adaptive-forms-rule-editor

L’éditeur de règles d’Adobe Experience Manager (AEM) permet aux auteurs de formulaires d’ajouter des règles à un formulaire adaptatif, ce qui permet de contrôler le comportement du formulaire en réponse à une entrée utilisateur. Les règles appliquent une logique métier aux champs de formulaire et aux composants de formulaire sans nécessiter de code personnalisé. À l’aide de l’éditeur de règles, les auteurs définissent des conditions et des actions qui déterminent ce qui se passe lorsqu’un utilisateur interagit avec le formulaire.

Les règles d’un formulaire adaptatif remplissent généralement les fonctions suivantes :

Comme les règles encapsulent cette logique dans le formulaire lui-même, elles créent des expériences dynamiques et adaptatives qui répondent en temps réel à l’utilisateur ou l’utilisatrice. Cela réduit les scripts manuels, améliore la précision des données et rationalise les workflows de formulaires complexes. L’article ci-dessous décrit l’interface de l’éditeur de règles pour les composants de base, tandis que les conseils équivalents pour les autres versions et types de composants d’AEM sont liés dans le tableau.

Vue d’ensemble overview

L’éditeur de règles est un outil de création visuel de Forms adaptatif qui permet aux utilisateurs professionnels et aux développeurs de formulaires d’écrire des règles sur des objets de formulaire adaptatif. Les règles définissent les actions qui se déclenchent sur des objets de formulaire en fonction des conditions prédéfinies, des entrées de l’utilisateur et des actions de l’utilisateur sur le formulaire. L’éditeur de règles simplifie le remplissage du formulaire, en garantissant précision et vitesse en automatisant la manière dont le formulaire répond lorsque les utilisateurs et utilisatrices interagissent avec celui-ci.

L’éditeur de règles offre une interface utilisateur intuitive et simplifiée pour la création de règles, ainsi qu’un éditeur visuel disponible pour tous les utilisateurs et utilisatrices. Les règles s’exécutant automatiquement en réponse aux conditions et aux entrées, elles réduisent les efforts manuels et réduisent les erreurs de saisie de données lors de la saisie du formulaire.

Actions clés prises en charge par les règles

Les règles vous permettent d’effectuer les actions clés suivantes sur des objets de formulaire adaptatif :

Autorisations et accès utilisateur

L’accès à la création et à l’utilisation de règles est régi par l’appartenance à un groupe d’utilisateurs :

Cette séparation garantit que la création de règles reste contrôlée tout en permettant à des groupes plus larges de bénéficier des règles déjà en place.

Différences entre l’éditeur de règles dans les composants principaux et l’éditeur de règles dans les composants de base

La principale différence est architecturale : l’Éditeur de règles dans Composants principaux est conçu pour le modèle de création Forms adaptatif standard moderne dans Adobe Experience Manager (AEM), tandis que l’Éditeur de règles dans Composants de base prend en charge l’ancien modèle de création. Tous deux permettent aux auteurs d’ajouter une logique conditionnelle dynamique aux champs de formulaire sans écrire de code, mais ils opèrent sur différents frameworks de composant et exposent différentes fonctionnalités.

Éditeur de règles dans les composants principaux

L’Éditeur de règles dans Composants principaux est conçu pour fonctionner avec les nouveaux composants principaux extensibles de Forms adaptatif. Les composants principaux suivent une architecture normalisée et conviviale pour les systèmes de style. Aussi leurs règles sont-elles conçues pour être plus portables, plus faciles à gérer et mieux alignées sur les scénarios de diffusion réactifs, découplés et Edge. Les auteurs l’utilisent généralement pour créer des règles de validation, de visibilité, d’activation et de calcul de valeur qui se comportent de manière cohérente sur les cibles de rendu modernes. Comme cela est largement reconnu dans les pratiques de développement AEM, les composants principaux représentent la base prospective recommandée pour les nouveaux projets de formulaire. Par conséquent, leur éditeur de règles est l’environnement destiné à recevoir des améliorations continues.

Éditeur de règles dans les composants de base

Le Éditeur de règles dans Composants de base cible le framework hérité des composants de base. Il fournit les fonctionnalités traditionnelles longtemps disponibles dans AEM Adaptive Forms, notamment le comportement d’affichage/masquage conditionnel, l’activation des champs, le basculement des champs obligatoires et les expressions scriptées. Contrairement à l’éditeur de composants principaux, l’éditeur de règles des composants de base est lié à l’ancien modèle de composant, ce qui peut rendre ses règles moins portables pour les modèles de diffusion modernes et plus dépendantes de la pile de rendu héritée. Par conséquent, il est plus pertinent pour les formulaires existants déjà créés avec des composants de base.

Principales différences en un coup d’œil

Quand utiliser chaque

Les deux éditeurs étant liés à des structures de composants fondamentalement différentes, les règles créées dans l’un ne sont pas directement interchangeables avec l’autre. C’est pourquoi les équipes qui planifient des stratégies de Forms adaptatif à long terme se fondent généralement sur les composants principaux et leur éditeur de règles, en réservant l’éditeur de règles composants de base à la continuité des implémentations héritées.

Présentation d’une règle understanding-a-rule

Une règle est une combinaison d’actions et de conditions. Dans l’éditeur de règles, les actions incluent des activités telles que masquer, afficher, activer, désactiver ou calculer la valeur d’un objet dans un formulaire. Les conditions sont des expressions booléennes que l’éditeur de règles évalue en effectuant des vérifications et des opérations sur l’état, la valeur ou la propriété d’un objet de formulaire. L’éditeur de règles exécute des actions en fonction de la valeur (True ou False) renvoyée lorsqu’il évalue une condition. Par conséquent, une condition qui renvoie True déclenche son action associée, ce qui n’est pas le cas d’un résultat False.

L’éditeur de règles fournit un ensemble de types de règle prédéfinis pour vous aider à créer des règles. Ces types de règle sont les suivants :

Chaque type de règle vous permet de définir des conditions et des actions dans une règle. Le document décrit de façon plus détaillée chaque type de règle.

Une règle suit généralement l’une des structures suivantes :

Condition-action Dans ce concept, une règle définit d’abord une condition suivie d’une action à déclencher. Le concept est comparable à l’instruction if-then des langages de programmation, où une condition spécifiée détermine si l’action s’exécute.

Dans l’éditeur de règles, le type de règle Lorsque applique le concept de condition-action.

Action-condition Dans ce concept, une règle définit d’abord une action à déclencher suivie de conditions d’évaluation. Une autre variante de ce concept est l’action alternative d’action-condition, qui définit également une action alternative à déclencher si la condition renvoie une False.

Les types de règle Afficher, Masquer, Activer, Désactiver, Définir la valeur de et Valider de l’éditeur de règles appliquent le concept de règle d’action-condition. Par défaut, l’action alternative pour Afficher est Masquer et l’action alternative pour Activer est Désactiver, et inversement. Vous ne pouvez pas modifier l’action alternative par défaut, car ces paires opposées sont intégrées à l’éditeur de règles pour que le comportement reste prévisible et réversible.

Pour plus d’informations sur les types de règles disponibles dans l’éditeur de règles, reportez-vous à la section Types de règles disponibles dans l’éditeur de règles.

Recommandations pour la sélection d’un concept de règle guidelines-for-choosing-a-rule-construct

Vous pouvez obtenir la plupart des cas d’utilisation avec n’importe quel concept de règle, mais les instructions suivantes vous aident à choisir un concept plutôt qu’un autre. Pour plus d’informations sur les règles disponibles dans l’éditeur de règles, voir Types de règle disponibles dans l’éditeur de règles.

Types d’opérateur et événements disponibles dans l’éditeur de règles available-operator-types-and-events-in-rule-editor

L’éditeur de règles fournit les opérateurs logiques (conditions) et événements (déclencheurs) suivants, que les auteurs de formulaires utilisent pour créer des règles conditionnelles qui contrôlent le comportement du formulaire. Les opérateurs évaluent la valeur ou l’état d’un objet de formulaire, tandis que les événements répondent à des actions spécifiques dans le cycle de vie du formulaire, telles que le rendu, les modifications de valeur, la navigation ou l’envoi de données.

Opérateurs de comparaison et de valeur

Événements

Types de règle disponibles dans l’éditeur de règles available-rule-types-in-rule-editor

L’éditeur de règles fournit un ensemble de types de règle prédéfinis qui servent de blocs de création pour la création de règles. Chaque type de règle prédéfini est un modèle prêt à l’emploi qui définit un type spécifique de logique ou de condition. Vous n’avez donc pas à créer entièrement des structures de règle. Les types de règle prédéfinis établissent des modèles cohérents et réutilisables, ce qui réduit les erreurs et accélère la création de règles.

Cette section examine en détail chaque type de règle disponible, en décrivant son objectif et son utilisation type. Comme les types de règle sont prédéfinis, ils appliquent une structure normalisée à toutes les règles, ce qui facilite leur lecture, leur maintenance et leur dépannage au fil du temps.

Pourquoi utiliser des types de règle prédéfinis ?

Les types de règle prédéfinis offrent plusieurs avantages pratiques :

Pour plus d’informations sur la création de règles dans l’éditeur de règles, reportez-vous à la section Création de règles.

Lorsque whenruletype

Le type de règle Lorsque suit le concept de règle action-condition-action-alternative ou, dans des cas plus simples, simplement le concept condition-action. Dans ce type de règle, vous spécifiez d’abord une condition à évaluer, suivie d’une action qui se déclenche lorsque la condition est remplie (est évaluée sur True). Lors de l’utilisation du type de règle Lorsque, vous pouvez combiner plusieurs opérateurs AND et OR pour créer des expressions imbriquées.

Avec le type de règle Lorsque, vous pouvez évaluer une condition sur un objet de formulaire et exécuter des actions sur un ou plusieurs objets.

En clair, un type de règle Lorsque standard est structuré comme suit :

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

Action 2 sur l’objet B ;
ET
Action 3 sur l’objet C ;

Lorsque vous disposez d’un composant à plusieurs valeurs, tel que des boutons radio ou une liste, Experience Manager récupère automatiquement les options et les met à la disposition du créateur de la règle lors de la création de la règle pour ce composant. Le créateur de la règle n’a pas besoin de saisir à nouveau les valeurs d’option.

Prenons l’exemple d’une liste comportant quatre options : rouge, bleu, vert et jaune. Lors de la création de la règle, ces options (boutons radio) sont automatiquement récupérées et présentées au créateur de la règle afin que chaque valeur (rouge, bleu, vert et jaune) puisse être sélectionnée directement dans le créateur de règles sans saisie manuelle.

Lors de la création d’une règle Lorsque, vous pouvez déclencher l’action Effacer la valeur de. L’action Effacer la valeur de efface la valeur de l’objet spécifié. Cela garantit que les champs dépendants sont réinitialisés de manière appropriée. Par conséquent, l’option Effacer la valeur de dans l’instruction Lorsque permet de créer des conditions complexes qui s’étendent sur plusieurs champs.

Actions disponibles dans le type de règle Lorsque

Le type de règle Lorsque prend en charge les actions suivantes :

Masquer Masque l’objet spécifié.

Afficher Affiche l’objet spécifié.

Activer Active l’objet spécifié.

Désactiver Désactive l’objet spécifié.

Appel du service Appelle un service configuré dans un modèle de données de formulaire (FDM). Lorsque vous sélectionnez l’opération Appel du service, un champ s’affiche. Lorsque vous appuyez sur le champ, il affiche tous les services configurés sur tous les modèles de données de formulaire (FDM) de votre instance Experience Manager. Lorsque vous choisissez un service de modèle de données de formulaire (FDM), des champs supplémentaires permettant de mapper les objets de formulaire avec les paramètres d’entrée et de sortie du service spécifié apparaissent. Voir l’exemple de règle pour appeler les services de modèle de données de formulaire.

Outre un service de modèle de données de formulaire, vous pouvez spécifier une URL WSDL (Web Services Description Language) directe pour appeler un service web. Cependant, comme un service de modèle de données de formulaire (FDM) offre de nombreux avantages, il est recommandé d’appeler un service.

Pour plus d’informations sur la configuration des services dans un modèle de données de formulaire (FDM), voir Intégration de données ​.

Définir la valeur de Calcule et définit la valeur de l’objet spécifié. Vous pouvez définir la valeur de l’objet sur une chaîne, la valeur d’un autre objet, une valeur calculée dérivée d’une expression ou d’une fonction mathématique, la valeur d’une propriété d’un objet ou la valeur de sortie d’un service de modèle de données de formulaire configuré. Lorsque vous choisissez l’option Service web, elle affiche tous les services configurés sur tous les modèles de données de formulaire (FDM) de votre instance de Experience Manager. Lorsque vous choisissez un service de modèle de données de formulaire, des champs supplémentaires dans lesquels vous pouvez mapper des objets de formulaire avec les paramètres d’entrée et de sortie pour le service spécifié apparaissent.

Pour plus d’informations sur la configuration des services dans un modèle de données de formulaire (FDM), voir Intégration de données ​.

Le type de règle Définir la propriété permet de définir la valeur d’une propriété de l’objet spécifié en fonction d’une action de condition. Vous pouvez définir la propriété sur l’une des options suivantes :

Par exemple, la règle Définir la propriété permet de définir des règles qui ajoutent dynamiquement des cases à cocher au formulaire adaptatif. Vous pouvez utiliser une fonction personnalisée, un objet de formulaire ou une propriété d’objet pour définir une telle règle.

Pour définir une règle basée sur une fonction personnalisée, sélectionnez Sortie de fonction dans la liste déroulante, puis faites glisser et déposez une fonction personnalisée à partir de l’onglet Fonctions. Lorsque l’action de condition est remplie, le nombre de cases à cocher définies dans la fonction personnalisée est ajouté au formulaire adaptatif.

Pour définir une règle basée sur un objet de formulaire, sélectionnez Objet de formulaire dans la liste déroulante, puis faites glisser et déposez un objet de formulaire à partir de l’onglet Objets de formulaire. Lorsque l’action de condition est remplie, le nombre de cases à cocher définies dans l’objet de formulaire est ajouté au formulaire adaptatif.

Une règle Définir la propriété basée sur une propriété d’objet permet d’ajouter le nombre de cases à cocher dans un formulaire adaptatif en fonction d’une autre propriété d’objet incluse dans le formulaire adaptatif.

La figure ci-dessous présente un exemple d’ajout dynamique de cases à cocher en fonction du nombre de listes déroulantes dans le formulaire adaptatif :

Types d’action de formulaire adaptatif

Chaque action ci-dessous définit un comportement spécifique qui peut être déclenché sur un objet de formulaire, permettant ainsi des expériences de formulaire dynamiques et interactives. Ces actions sont largement utilisées pour contrôler les valeurs de champ, gérer le focus, gérer les envois et créer des structures de contenu répétables.

Effacer la valeur de : efface la valeur de l’objet spécifié. Cela réinitialise un seul champ sans affecter le reste du formulaire, ce qui est utile pour supprimer les entrées dépendantes ou conditionnelles.

Définir la cible d’action: définit la cible d’action sur l’objet spécifié. Cela dirige le curseur de l’utilisateur ou de l’utilisatrice vers un champ ciblé, ce qui guide le flux de saisie et améliore l’utilisation du formulaire.

Enregistrer le formulaire : enregistre le formulaire. Cela permet de conserver les entrées actuelles de l’utilisateur et de reprendre ultérieurement une session partiellement terminée.

Envoyer les formulaires : envoie le formulaire. Les données collectées sont envoyées pour traitement au point d’entrée ou au workflow d’envoi configuré.

Réinitialiser le formulaire : réinitialise le formulaire. Cela efface toutes les valeurs saisies et renvoie chaque champ à son état par défaut.

Valider le formulaire : valide le formulaire. Tous les champs sont ainsi vérifiés par rapport à leurs règles configurées, afin de s’assurer que les données sont complètes et correctes avant de poursuivre l’envoi.

Ajouter une instance : ajoute une instance de la ligne de panneau ou de tableau répétable spécifiée. Le contenu dynamique est ainsi activé, ce qui permet aux utilisateurs de saisir plusieurs ensembles d’informations connexes, telles que l’ajout d’éléments de ligne supplémentaires ou de groupes de champs répétés à la demande.

Supprimer une instance : supprime une instance de la ligne de panneau ou de tableau répétable spécifiée. Cela permet aux utilisateurs de supprimer un jeu de contenu répétable ajouté précédemment, en conservant le formulaire exempt d’entrées inutiles.

Accéder à Permet d’accéder à d’autres ressources Forms adaptatives, à d’autres ressources telles que des images ou des fragments de document ou à une URL externe. Cela permet de prendre en charge des parcours de formulaire à plusieurs étapes et de créer des liens vers des ressources supplémentaires, en connectant une expérience de formulaire au contenu associé.

Définir la valeur de set-value-of

Le type de règle Définir la valeur de définit dynamiquement la valeur d’un objet de formulaire selon qu’une condition spécifiée est évaluée sur TRUE ou sur FALSE. Cette règle établit un lien direct et conditionné entre les objets de formulaire, ce qui permet à un champ de se remplir automatiquement à partir d’une autre source, d’un calcul ou de données principales.

Sources de valeur prises en charge

La règle Définir la valeur de attribue à un objet cible une valeur provenant de l’une des sources suivantes :

De même, la condition qui déclenche la règle peut être évaluée par rapport à un composant, une chaîne, une propriété ou des valeurs dérivées d’une fonction ou d’une expression mathématique. Cette flexibilité permet aux auteurs de créer à la fois des affectations de valeur simples et une logique conditionnelle complexe dans une seule règle.

Le type de règle Définir la valeur de n’est pas disponible pour certains objets de formulaire tels que les panneaux et les boutons de la barre d’outils, car ces objets ne contiennent pas de valeur définissable de la même manière que les champs de saisie.

Structure de règle standard

Une règle standard Définir la valeur de suit cette structure :

Définir la valeur d’Objet A sur :

(chaîne ABC) OU
(propriété d’objet X de l’objet C) OU
(valeur d’une fonction) OU
(valeur d’une expression mathématique) OU
(valeur de sortie d’un service de modèle de données ou d’un service web) ;

Lorsque (facultatif) :

(Condition 1 ET Condition 2 ET Condition 3) est vrai ;

Exemple : renseigner un champ à partir d’un service de modèle de données de formulaire

L’exemple suivant prend la valeur du champ dependentid comme valeur d’entrée et définit la valeur du champ Relation comme valeur de sortie de l’argument Relation du getDependent service de modèle de données de formulaire. Par conséquent, chaque fois qu’un dependentid valide est saisi, le champ Relation est automatiquement renseigné sans saisie manuelle.

Exemple de règle Définir la valeur à l’aide du service de modèle de données de formulaire

Afficher show

Le type de règle Afficher affiche ou masque un objet de formulaire selon qu’une condition définie renvoie Vrai ou Faux. Lorsque vous appliquez la règle Afficher, l’objet cible apparaît chaque fois que sa condition associée est remplie et il est automatiquement masqué lorsque la condition n’est pas remplie. Une condition il s’agit d’une expression logique qui se résout en True (satisfait) ou False (non satisfait).

Ce type de règle est utilisé pour créer comportement dynamique de formulaire conditionnel, de sorte que les objets de formulaire n’apparaissent que lorsqu’ils sont pertinents pour l’utilisateur. Par exemple, un champ de relance peut rester masqué jusqu’à ce que l’utilisateur sélectionne une option qui le rende applicable, ce qui réduit l’encombrement et guide l’utilisateur à travers le formulaire.

Fonctionnement de la règle Afficher how-show-rule-works

Le type de règle Afficher combine deux actions complémentaires en une seule règle :

Ce comportement apparié garantit que la visibilité de l’objet reste toujours synchronisée avec l’état actuel de la condition, car chaque évaluation correspond exactement à un résultat : affiché ou masqué.

Structure des règles show-rule-structure

Une règle Show type est structurée comme suit :

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

Dans cette structure, l’Objet A s’affiche lorsque l’une des conditions répertoriées est TRUE, car les conditions sont jointes à l’opérateur OR. Si aucune des conditions n’est remplie, la clause Else exécute l’action Hide et Object A est masqué.

Masquer hide

Le type de règle Masquer affiche ou masque un objet de formulaire selon qu’une condition spécifiée est remplie ou non. De la même manière que le type de règle Afficher, les auteurs de formulaire peuvent utiliser le type de règle Masquer pour contrôler dynamiquement la visibilité d’un objet de formulaire au moment de l’exécution.

Le type de règle Masquer se comporte comme suit :

Lorsque plusieurs conditions sont combinées, elles sont associées à l’opérateur AND, ce qui signifie que chaque condition doit être True pour que l’action Masquer s’exécute.

Structure de règle

Une règle standard Masquer est structurée comme suit :

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

Dans cette structure, Objet A n’est masqué que lorsque la condition combinée Condition 1 ET Condition 2 ET Condition 3 est évaluée comme TRUE. Dans le cas contraire, la branche Else exécute l’action Afficher l’objet A, ce qui rend l’objet visible.

Activer enable

Le type de règle Activer active ou désactive un objet de formulaire selon qu’une condition spécifiée est évaluée sur TRUE ou FALSE. Lorsque la condition est remplie (renvoie TRUE), l’objet cible est activé et devient interactif pour l’utilisateur. Lorsque la condition n’est pas remplie ou renvoie False, le type de règle Activer déclenche automatiquement l’action Désactiver en désactivant l’objet cible.

Ce comportement réciproque signifie qu’une seule règle Activer régit les deux états d’un objet : puisque l’action Désactiver est appelée automatiquement chaque fois que la condition échoue, vous n’avez pas besoin d’une règle distincte pour gérer l’état désactivé. Cela garantit que la disponibilité de l’objet reste synchronisée de manière cohérente avec le résultat de la condition tout au long de l’interaction de l’utilisateur avec le formulaire.

Le type de règle Activer est généralement appliqué pour créer des formulaires dynamiques et conditionnels. Par exemple, un bouton Envoyer peut rester désactivé jusqu’à ce que toutes les conditions requises soient remplies, ou un champ dépendant peut être activé uniquement lorsqu’une sélection associée est effectuée. Cela permet de guider les utilisateurs à travers des chemins d’entrée valides et de réduire les envois incomplets ou incohérents.

Une règle Activer standard est structurée comme suit :

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

Dans cette structure, l’objet A est activé uniquement lorsque la condition 1, la condition 2 et la condition 3 sont toutes TRUE simultanément, puisque les conditions sont combinées avec l’opérateur AND. Si l’une de ces conditions renvoie FALSE, la clause Else s’exécute et Objet A est désactivé, en conservant l’état de l’objet directement lié au résultat combiné de chaque condition spécifiée.

Désactiver disable

Tout comme le type de règle Activer, le type de règle Désactiver désactive un objet de formulaire lorsqu’une condition spécifiée est remplie et l’active dans le cas contraire. La désactivation d’un objet de formulaire le rend non interactif — le champ apparaît dans le formulaire, mais les utilisateurs ne peuvent pas le modifier, le sélectionner ni y saisir des données tant que la condition de désactivation n’est pas remplie.

Fonctionnement de la règle Désactiver

Le type de règle Désactiver inclut un comportement complémentaire intégré : il déclenche également l’action Activer lorsque la condition n’est pas remplie ou renvoieFalse. Cela signifie qu’une règle Désactiver unique gère les deux états de l’objet . Lorsque la condition définie est évaluée sur True, l’objet est désactivé ; lorsque la condition est évaluée sur False, l’objet est automatiquement activé à nouveau.

Ce double comportement garantit que l’objet de formulaire ne reste jamais verrouillé dans un état obsolète. Par conséquent, vous n’avez pas besoin de créer une règle Activer distincte pour inverser l’effet : la règle Désactiver gère les deux résultats, en conservant l’état interactif du formulaire cohérent avec les conditions sous-jacentes en temps réel.

Le type de règle Désactiver est généralement utilisé pour restreindre la saisie utilisateur de manière dynamique, par exemple en empêchant la saisie dans un champ jusqu’à ce qu’une sélection de conditions préalables soit effectuée, ou en grisant les options qui ne sont pas pertinentes sur la base des réponses précédentes.

Syntaxe et structure

Une règle Désactiver standard est structurée comme suit :

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

Dans cette structure, Objet A est désactivé lorsque l’une conditions spécifiées (Condition 1, Condition 2 ou Condition 3) est évaluée sur True, car les conditions sont jointes avec l’opérateur OR. Si aucune des conditions n’est remplie (l’expression combinée renvoie False), la clause Else s’exécute et Object A est activé.

Valider validate

Le type de règle Valider valide la valeur saisie dans un champ en évaluant une expression logique. La règle exécute l’expression par rapport à la valeur du champ : lorsque l’expression est résolue sur TRUE, la valeur est acceptée et lorsqu’elle est résolue sur FALSE, la valeur est rejetée. Cela permet de s’assurer que seules les données répondant à vos critères définis sont envoyées, ce qui contribue à maintenir l’intégrité des données et à réduire les erreurs causées par une entrée incorrecte ou inattendue.

Par exemple, vous pouvez écrire une expression qui vérifie que la zone de texte permettant de spécifier un nom contient uniquement des caractères alphabétiques, c’est-à-dire qu’elle n’inclut pas de caractères spéciaux ou de chiffres. Cette utilisation pratique de la validation empêche les entrées non valides au point d’entrée, de sorte que les systèmes en aval reçoivent des données propres et correctement formatées.

Une règle Valider standard est structurée comme suit :

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

Dans cette structure, plusieurs conditions sont combinées avec l’opérateur AND, ce qui signifie que l’expression every doit évaluer indépendamment la valeur TRUE pour que la règle globale soit transmise. Si une seule expression échoue, le résultat combiné est FALSE et la valeur n’est pas conforme. Vous pouvez ainsi appliquer simultanément plusieurs conditions de validation sur le même champ.

Définir les options de setoptionsof

Le type de règle Définir les options de ajoute dynamiquement des cases à cocher à un formulaire adaptatif. Ce type de règle permet de définir les options de case à cocher d’un champ de formulaire de l’une des deux manières suivantes : à partir d’un modèle de données de formulaire (FDM) ou d’une fonction personnalisée. Comme les cases à cocher sont générées par la règle plutôt que codées en dur, les options restent pilotées par les données et se mettent à jour automatiquement lorsque la source sous-jacente change.

Définition d’une règle à l’aide d’une fonction personnalisée

Pour définir une règle basée sur une fonction personnalisée :

Comme les cases à cocher sont générées à partir de la sortie de fonction, le nombre de cases à cocher ajoutées au formulaire adaptatif correspond au nombre de cases à cocher définies dans la fonction personnalisée. Cela permet de s’assurer que le formulaire rendu reflète exactement ce que la fonction renvoie.

Pour créer une fonction personnalisée, voir Fonctions personnalisées dans l’éditeur de règles.

Définir une règle à l’aide d’un modèle de données de formulaire (FDM)

Pour définir une règle basée sur un modèle de données de formulaire (FDM) :

Présentation de l’interface utilisateur de l’éditeur de règles understanding-the-rule-editor-user-interface

L’éditeur de règles fournit une interface utilisateur complète et simple permettant d’écrire et de gérer des règles dans un formulaire adaptatif. Les règles automatisent le comportement des formulaires (en contrôlant des actions telles que l’affichage ou le masquage de champs, l’activation ou la désactivation de composants, la définition de valeurs, l’appel de services et la validation des entrées utilisateur) sans nécessiter de codage manuel. Cela permet aux auteurs de créer des formulaires dynamiques et réactifs directement dans l’environnement de création. Vous pouvez lancer l’interface utilisateur de l’éditeur de règles à partir d’un formulaire adaptatif en mode Création.

Lancement de l’interface utilisateur de l’éditeur de règles

Pour ouvrir l’éditeur de règles, procédez comme suit :

Composants de l’interface utilisateur de l’éditeur de règles

Les sections suivantes décrivent en détail chaque composant de l’interface utilisateur de l’éditeur de règles et expliquent son rôle dans la création et la gestion des règles de formulaire.

A. Affichage composant-règle a-component-rule-display

L’affichage composant-règle identifie l’objet de formulaire adaptatif par lequel vous avez lancé l’éditeur de règles, ainsi que le type de règle actuellement sélectionné. Cette zone d’orientation se trouve en haut de l’éditeur de règles et sert de point de référence persistant, confirmant exactement à quel composant de formulaire la règle s’applique et à quelle catégorie de logique est définie.

Dans l’exemple ci-dessus, l’éditeur de règles est lancé à partir d’un objet de formulaire adaptatif intitulé Salary et le type de règle sélectionné est Lorsque. Cela vous indique que toutes les conditions et actions que vous configurez seront associées au composant Salary et évaluées sous la forme d’une règle When, ce qui signifie que la logique est déclenchée en réponse à un événement ou une condition défini sur cet objet.

Comme un seul formulaire adaptatif peut contenir de nombreux composants (chacun ayant ses propres règles), l’affichage Component-rule vous aide à confirmer que vous modifiez la logique pour l’objet et le type de règle prévus. Par conséquent, il réduit le risque d’appliquer une règle au mauvais champ et fournit un contexte immédiat chaque fois que vous ouvrez ou revenez à l’éditeur de règles.

B. Objets de formulaire et fonctions b-form-objects-and-functions-br

Le volet situé à gauche de l’interface utilisateur de l’éditeur de règles comporte deux onglets: Objets de formulaire et Fonctions.

L’onglet Objets de formulaire affiche une vue hiérarchique de tous les objets contenus dans le formulaire adaptatif, affichant le titre et le type de chaque objet. Lors de la création d’une règle, vous pouvez faire glisser-déposer des objets de formulaire directement dans l’éditeur de règles. Lorsque vous faites glisser un objet ou une fonction dans un espace réservé, cet espace prend automatiquement le type de valeur approprié. Cela permet de s’assurer que la règle reste valide et de réduire la configuration manuelle de type.

Les objets de formulaire sont marqués visuellement par statut de règle :

L’onglet Fonctions comprend un ensemble de fonctions intégrées que vous pouvez utiliser pour calculer des valeurs dans les panneaux et les lignes de tableau répétables, et pour référencer des instructions d’action et de condition lors de la création de règles. Ces fonctions intégrées incluent :

Vous pouvez également créer des fonctions personnalisées pour étendre cet ensemble intégré.

Dans l’arborescence de gauche des objets de formulaire, vous pouvez sélectionner n’importe quel objet de formulaire pour afficher les règles appliquées à cet objet. En plus de parcourir les règles des différents objets de formulaire, vous pouvez également copier-coller des règles entre les objets de formulaire, ce qui vous permet de réutiliser la logique de règle existante au lieu de la recréer. Pour plus d’informations, reportez-vous à la section Règles de copier-coller.

C. Basculement entre les objets de formulaire et les fonctions c-form-objects-and-functions-toggle-br

Appuyez sur le bouton de basculement pour afficher ou masquer le volet Objets de formulaire et fonctions. Cette commande unique fait basculer le panneau entre ses états visible et masqué, ce qui vous donne une commande directe pour savoir si le panneau apparaît dans l’espace de travail.

Le volet Objets et fonctions de formulaire est le panneau qui répertorie les éléments interactifs disponibles pour créer ou modifier un formulaire, tels que les champs, les contrôles et les fonctions qui peuvent leur être appliquées. Comme ce volet occupe de l’espace dans l’interface, le bouton (bascule) a un objectif pratique : le masquage libère de la zone d’écran pour la zone de travail du formulaire, tout en l’affichant pour restaurer l’accès immédiat aux objets et fonctions dont vous avez besoin.

Comportements clés du bouton bascule :

Ce bouton est particulièrement utile lorsque vous souhaitez obtenir une vue claire du formulaire lors de la mise en page et de la révision, puis que vous devez réafficher les objets et les fonctions lorsque vous reprenez la modification.

D. Éditeur de règles visuel visual-rule-editor

L’éditeur de règles visuel est la zone de l’interface utilisateur de l’éditeur visuel de l’éditeur de règles dans laquelle vous créez des règles. Il sert d’espace de travail principal pour créer une logique de règle sans script manuel, ce qui vous permet de créer des règles par le biais d’une interface graphique pilotée par les formulaires.

L’éditeur visuel de règles vous permet de sélectionner un type de règle, puis de définir ses conditions et actions en conséquence. Étant donné que le comportement des règles dépend du type de règle sélectionné, l’éditeur adapte les conditions et actions disponibles pour correspondre à ce type, en s’assurant que la logique que vous créez est valide pour la règle que vous avez l’intention de créer.

Fonctionnalités clés de l’éditeur de règles visuel :

Vous pouvez faire glisser et déposer des objets et des fonctions de formulaire à partir du volet Objets et fonctions de formulaire afin que la logique des règles soit assemblée visuellement plutôt que saisie manuellement, ce qui réduit les erreurs manuelles et accélère la création de règles.

Pour plus d’informations sur l’utilisation de l’éditeur de règles visuel, voir Création de règles.

E. Boutons Terminé et Annuler done-and-cancel-buttons

Le bouton Terminé permet d’enregistrer une règle. Vous pouvez enregistrer une règle incomplète. Toutefois, les règles incomplètes ne sont pas valides et ne s’exécutent pas, car elles ne remplissent pas les conditions ou n’effectuent pas les actions requises pour leur exécution. Les règles enregistrées sur un objet de formulaire sont répertoriées chaque fois que vous lancez l’éditeur de règles à partir de ce même objet de formulaire, ce qui vous permet de les réviser, de les modifier ou de les supprimer. Vous pouvez gérer toutes les règles existantes à partir de cette vue. Pour plus d’informations, consultez la section Gérer les règles.

Le bouton Annuler ignore toutes les modifications apportées à une règle et ferme l’éditeur de règles sans enregistrer.

Règles d’écriture write-rules

L’éditeur de règles visuel permet aux utilisateurs et utilisatrices de créer et de gérer des règles par le biais d’une interface graphique sans code. Les règles définissent les conditions et actions qui contrôlent la manière dont un système répond à des entrées, des événements ou des données spécifiques, par exemple le déclenchement d’une action lorsqu’une condition est remplie. L’éditeur de règles visuel présente ces composants visuellement, de sorte que les règles sont créées en sélectionnant et en configurant des éléments plutôt qu’en écrivant du code à la main.

Qu’est-ce que l’éditeur de règles visuel ?

L’éditeur de règles visuel est un outil graphique permettant de créer des règles sans codage manuel. Il représente généralement chaque règle comme une combinaison de conditions (les critères qui doivent être remplis) et actions (ce qui se produit lorsque ces conditions sont remplies). Comme la logique s’affiche visuellement, les utilisateurs et utilisatrices peuvent réviser, ajuster et valider les règles plus facilement que lors de la modification de code brut, ce qui réduit la probabilité d’erreurs de syntaxe.

Écriture de règles à l’aide de l’éditeur visuel

L’écriture de règles dans l’éditeur visuel suit généralement une séquence simple :

Cette approche visuelle et détaillée permet aux utilisateurs et utilisatrices techniques et non techniques d’accéder à la création de règles.

Pourquoi utiliser l’éditeur de règles visuel ?

L’éditeur de règles visuel offre plusieurs avantages pratiques :

L’utilisation de l’éditeur de règles visuel est le point de départ recommandé pour créer des règles, car il fournit une manière intuitive et guidée de traduire la logique commerciale en conditions de travail et en actions.

À l’aide de l’éditeur visuel using-visual-editor

Découvrez comment créer une règle dans l’éditeur visuel à l’aide de l’exemple de formulaire de demande de prêt suivant. Cette procédure pas à pas crée deux règles : l’une contrôle la visibilité des champs en fonction des entrées de l’utilisateur et l’autre effectue un calcul mathématique pour dériver une valeur.

La section Exigences de prêt de l’exemple de formulaire de demande de prêt exige que les demandeurs précisent leur état civil, leur salaire et, s’ils sont mariés, le salaire de leur conjoint. En fonction des entrées de l’utilisateur, la règle calcule le montant d’éligibilité de prêt et l’affiche dans le champ Éligibilité de prêt. Appliquez les deux règles suivantes pour implémenter le scénario :

Pour écrire ces règles, procédez comme suit :

Règle 1 : Contrôler la visibilité du champ Salaire du conjoint

Règle 2 : calculer l’éligibilité d’un prêt

Fonctions personnalisées dans l’éditeur de règles custom-functions

Outre les fonctionnalités prêtes à l’emploi, comme Somme de, qui sont répertoriées sous Fonctions, vous pouvez créer des fonctions personnalisées dont vous avez besoin fréquemment. Assurez-vous de la présence de la balise jsdoc au-dessus de la fonction que vous créez.

La balise jsdoc associée est nécessaire :

L’éditeur de règles prend en charge la syntaxe JavaScript ES5 pour les scripts et les fonctions personnalisées.
Pour plus d’informations, consultez jsdoc.app.

Balises jsdoc prises en charge :

Ajout d’une fonction personnalisée

Par exemple, vous souhaitez ajouter une fonction personnalisée qui calcule l’aire d’un carré. La longueur du côté correspond à l’entrée de l’utilisateur de la fonction personnalisée, qui est acceptée à l’aide d’une zone numérique dans votre formulaire. La sortie calculée s’affiche dans une autre zone numérique dans votre formulaire. Pour ajouter une fonction personnalisée, vous devez d’abord créer une bibliothèque cliente, puis l’ajouter au référentiel CRX.

Pour créer une bibliothèque cliente et l’ajouter au référentiel CRX, procédez comme suit :

Une fois que vous avez ajouté votre bibliothèque client dans le référentiel CRX, utilisez-la dans votre formulaire adaptatif. Par conséquent, la fonction personnalisée peut être utilisée comme règle dans votre formulaire. Pour ajouter la bibliothèque cliente dans votre formulaire adaptatif :

Types pris en charge pour la déclaration de fonction function-declaration-supported-types

Instruction de fonction

function area(len) {
    return len*len;
}

Cette fonction est incluse sans commentaires jsdoc.

Expression de fonction

var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

Expression et instruction de fonction

var b={};
/** */
b.area = function(len) {
    return len*len;
}

Déclaration de fonction en tant que variable

/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

Limitation : la fonction personnalisée sélectionne uniquement la première déclaration de fonction dans la liste des variables, si elle est déclarée ensemble. Pour chaque fonction déclarée, utilisez une expression de fonction pour vous assurer que chaque fonction est reconnue.

Déclaration de fonction en tant qu’objet

var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};

Prendre en charge des fonctions personnalisées dans les expressions de validation supporting-custom-functions-in-validation-expressions-br

Lorsque les formulaires nécessitent des règles de validation complexes, la logique de validation réside dans des fonctions personnalisées que l’auteur doit appeler directement à partir d’une expression de validation de champ. Pour rendre cette bibliothèque de fonctions personnalisées visible et disponible lors de la validation côté serveur, l’auteur du formulaire configure le nom de la bibliothèque cliente Adobe Experience Manager (AEM) sous l’onglet De base des propriétés du conteneur de formulaires adaptatifs, comme illustré ci-dessous.

Cette configuration établit un emplacement unique et réutilisable pour la logique de validation qui s’exécute à la fois sur le client et sur le serveur. Étant donné que la même bibliothèque cliente est référencée lors de la validation côté serveur, les fonctions de validation personnalisées se comportent de manière cohérente, quel que soit l’endroit où la validation s’exécute.

Configuration d’une bibliothèque de fonctions personnalisées par formulaire adaptatif :

L’auteur du formulaire peut configurer une bibliothèque JavaScript personnalisée par formulaire adaptatif. Dans cette bibliothèque, conservez uniquement les fonctions réutilisables appelées à partir des expressions de validation. Cela permet à la bibliothèque de rester concentrée, d’éviter le code inutile côté serveur et de faciliter la gestion et la réutilisation de la logique de validation entre les champs.

Ces fonctions réutilisables dépendent des bibliothèques tierces jQuery et Underscore.js. Comme ces dépendances doivent être disponibles pour que les fonctions personnalisées s’exécutent correctement, assurez-vous qu’elles sont chargées avec la bibliothèque cliente configurée afin que la validation côté client et côté serveur soit résolue avec succès.

Gérer les erreurs sur l’action d’envoi error-handling-on-submit-action

Configurer les pages d’erreur personnalisées

Dans le cadre des instructions de sécurité et de renforcement d’Adobe Experience Manager (AEM) configurez des pages d’erreur personnalisées appelées 400.jsp, 404.jsp et 500.jsp. AEM appelle ces gestionnaires chaque fois qu’un envoi de formulaire renvoie une erreur 400, 404 ou 500. AEM appelle également les mêmes gestionnaires lorsque ces codes d’erreur sont déclenchés sur le nœud de publication, ce qui permet d’assurer des réponses d’erreur cohérentes dans les environnements de création et de publication.

Chaque gestionnaire mappe directement à un code d’état HTTP standard :

Les administrateurs peuvent également créer des pages JSP supplémentaires pour d’autres codes d’erreur HTTP, en étendant la gestion des erreurs de marque cohérente à toute réponse qu’un formulaire adaptatif peut générer.

Prévention de la perte de données pour les champs non liés

Les champs non liés perdent leurs données lors du préremplissage lorsque les données fournies n’incluent pas les balises de données de formulaire adaptatif requises. Les champs non liés sont des champs de formulaire adaptatif qui n’ont pas la propriété bindref , ce qui signifie qu’ils ne sont pas mappés à une liaison de schéma.

Cette perte de données se produit lorsque vous préremplissez un modèle de données de formulaire (FDM) ou un formulaire adaptatif basé sur un schéma avec des données XML (eXtensible Markup Language) ou JSON (JavaScript Object Notation) conformes à un schéma, mais qui ne contiennent pas les balises suivantes :

Le schéma pris en charge peut être un schéma XML, un schéma JSON ou un modèle de données de formulaire (FDM). Comme les champs non liés n’ont pas de liaison de schéma via la propriété bindref, AEM s’appuie sur le conteneur <afUnboundData> pour transporter leurs valeurs. Lorsque ce conteneur est absent des données de préremplissage, les valeurs des champs non liés ne peuvent pas être résolues et sont perdues. Pour conserver des données de champ illimitées pendant le préremplissage, incluez toujours les balises <afData>, <afBoundData> et <afUnboundData> dans la payload XML ou JSON.

Gestion des règles manage-rules

Lorsque vous sélectionnez un objet de formulaire et choisissez , l’interface Gérer les règles répertorie toutes les règles existantes sur cet objet, ce qui vous permet d’afficher le titre de chaque règle avec un aperçu de son résumé de règle. L’interface utilisateur vous permet de développer et d’afficher le résumé complet des règles, de modifier l’ordre des règles, de modifier des règles et de supprimer des règles à partir d’une vue unique et centralisée.

Vous pouvez effectuer les actions suivantes sur les règles :

Règles de copier-coller copy-paste-rules

Copiez-collez une règle d’un champ à d’autres champs similaires pour gagner du temps et garantir la cohérence de votre formulaire. Vous pouvez ainsi réutiliser une règle configurée sans la recréer manuellement sur chaque objet de formulaire.

Pour copier-coller des règles, procédez comme suit :

Expressions imbriquées nestedexpressions

L’éditeur de règles prend en charge les expressions imbriquées, ce qui vous permet de combiner plusieurs opérateurs AND et OR dans une seule règle pour créer des règles imbriquées. Le mélange des opérateurs AND et OR permet d’exprimer une logique complexe à plusieurs conditions dans une seule règle, de sorte que les résultats se déclenchent uniquement lorsque des combinaisons spécifiques de conditions sont remplies. Cette fonctionnalité est essentielle pour les scénarios où une seule condition plate est insuffisante et où une logique de décision en plusieurs couches est requise.

Par exemple, une règle imbriquée peut afficher un message à l’intention de l’utilisateur concernant l’éligibilité pour la garde d’un enfant, affichant le message uniquement lorsque toutes les conditions requises sont remplies. Comme les opérateurs sont imbriqués, l’éditeur de règles évalue chaque condition groupée ensemble, en s’assurant que la logique d’éligibilité reflète la combinaison exacte des critères définis dans la règle.

Réorganisation des conditions par glisser-déposer

Vous pouvez également glisser-déposer des conditions dans une règle pour modifier sa structure sans supprimer ni ajouter à nouveau de conditions. Pour repositionner une condition :

Une fois la condition supprimée, la structure de la règle change pour refléter la nouvelle disposition, car l’éditeur réévalue le placement des opérateurs ET et OU par rapport à la condition déplacée. Vous pouvez ainsi affiner rapidement la logique d’une règle imbriquée et conserver les résultats d’éligibilité prévus.

Conditions d’expression de date dateexpression

L’éditeur de règles permet aux comparaisons de dates de créer une logique conditionnelle dans le Forms adaptatif. Les expressions de date comparent une valeur de date à une autre, le plus souvent une date saisie par l’utilisateur par rapport à la date actuelle, et déclenchent un comportement de formulaire en fonction du résultat.

Exemple : affichage d’une note de revenu en fonction de la date du prêt immobilier

L’exemple de condition suivant affiche un objet de texte statique lorsque le prêt hypothécaire sur la maison est déjà utilisé, ce que l’utilisateur indique en saisissant une valeur dans le champ de date.

Étant donné que la date du prêt hypothécaire saisie par l’utilisateur est dans le passé, le formulaire adaptatif affiche une note sur le calcul du revenu. La règle compare la date saisie par l’utilisateur avec la date actuelle, et lorsque la date saisie par l’utilisateur est antérieure à la date actuelle, le formulaire affiche le message texte nommé Revenu.

Fonctionnement de la comparaison de dates

La règle évalue la condition comme suit :

Lorsque la date remplie est antérieure à la date actuelle, le formulaire affiche le message texte Revenu. La condition reste inactive (et le message Revenu reste masqué) chaque fois que la date saisie correspond ou est postérieure à la date actuelle, de sorte que la note apparaisse exclusivement pour les prêts hypothécaires déjà contractés.

Conditions de comparaison des nombres number-comparison-conditions

L’éditeur de règles permet de créer des conditions qui comparent deux nombres. Une condition de comparaison de nombres évalue une valeur numérique par rapport à une autre et déclenche une action définie lorsque la relation spécifiée, telle que inférieur à, supérieur à ou égal à, est satisfaite. Les conditions de comparaison de nombres sont généralement utilisées pour contrôler dynamiquement le comportement du formulaire, afficher, masquer ou modifier le contenu en fonction des valeurs saisies par les demandeurs.

Exemple : demande d’une preuve de résidence supplémentaire

L’exemple suivant illustre une condition qui affiche un objet de texte statique lorsque le demandeur a séjourné à l’adresse actuelle pendant moins de 36 mois.

Le fonctionnement de la condition est le suivant :

Cela permet de s’assurer que le formulaire ajuste dynamiquement son contenu en fonction de la valeur saisie, invitant les demandeurs à demander des documents supplémentaires uniquement lorsque le seuil de résidence n’est pas atteint. Par conséquent, les formulaires restent concis et demandent une preuve de résidence supplémentaire exactement lorsque la logique commerciale l’exige.

Exemples de règles example

Appeler service de modèle de données de formulaire invoke

L’action Appeler le service appelle un service configuré dans un modèle de données de formulaire (FDM), envoie les valeurs des champs de formulaire en tant qu’entrée à ce service et renseigne la réponse du service dans les champs de formulaire. Cela permet à un formulaire adaptatif de récupérer des données d’un service web externe au moment de l’exécution en réponse à une action de l’utilisateur.

Exemple de scénario

Prenons l’exemple d’un service Web appelé GetInterestRates qui utilise trois données — le montant du prêt, la durée et la cote de solvabilité du demandeur — et renvoie un plan de prêt qui inclut le montant mensualités équivalentes) et le taux d’intérêt. Étant donné que le service accepte les entrées et renvoie une sortie structurée, il s’agit d’une source de données appropriée pour une action d’appel de service sur un formulaire.

Pour implémenter ce scénario, procédez comme suit :

Suite à l’appel, la réponse du service — le montant mensualités équivalentes et le taux d’intérêt — est mise en correspondance avec les champs de sortie correspondants du formulaire. Ce mappage garantit que les détails du plan renvoyés sont renseignés dans les champs appropriés afin que l’utilisateur voit immédiatement le résultat calculé.

Configuration de l’action du service Invoke

La règle suivante indique comment configurer l’action Appeler le service pour accomplir l’exemple de scénario, en définissant les arguments d’entrée transmis au service et le mappage de sortie qui renvoie les résultats aux champs du formulaire.

Déclenchement de plusieurs actions à l’aide de la règle Lorsque triggering-multiple-actions-using-the-when-rule

Une règle Lorsque permet à une seule condition de déclencher plusieurs actions sur un formulaire, en exécutant tous les comportements spécifiés en une seule fois lorsque sa condition est évaluée sur Vrai. Dans un formulaire de demande de prêt, l’auteur du formulaire souhaite capturer si le demandeur de prêt est un client existant, puis piloter plusieurs comportements de champ à partir de cette réponse unique.

Plus précisément, le formulaire doit :

Les deux comportements sont pilotés par la même réponse. C’est pourquoi une seule Règle Lorsque est bien adaptée à ce scénario : une condition déclenche plusieurs actions coordonnées.

Composants de formulaire

Le formulaire de demande de prêt est composé des éléments suivants :

Logique de règle dans l’éditeur visuel

Lorsque vous créez une règle Lorsque la règle sur le bouton radio pour implémenter ce comportement, la règle s’affiche comme illustré ci-dessous dans l’éditeur de règles visuel.

Règle dans l’éditeur visuel

Dans l’exemple de règle, l’instruction de la section Lorsque est la condition. Lorsque la condition renvoie True, la règle exécute les actions spécifiées dans la section Then. Cette structure sépare le déclencheur (la réponse du demandeur) du résultat (en affichant le champ et en définissant la cible), en veillant à ce que toutes les actions définies s’exécutent ensemble chaque fois que la condition est remplie.

Utilisation de la sortie d’une fonction dans une règle using-a-function-output-in-a-rule

La fonction sum vous permet de totaliser les quantités saisies pour chaque instance répétée d’une ligne de tableau et d’afficher le résultat dans une seule cellule non répétable. Dans un formulaire de bon de commande, une table dans laquelle les utilisateurs renseignent leurs commandes peut calculer automatiquement une Quantité totale en appliquant cette fonction dans une règle Définir la valeur de.

Configuration du tableau

Le formulaire de bon de commande contient un tableau avec la structure suivante :

A. Ligne 1 B. Quantité C. Quantité totale

Création de la règle Définir la valeur de

L’objectif est d’ajouter les quantités spécifiées dans la colonne Quantité de produit pour tous les produits et d’afficher la somme dans la cellule Quantité totale. Comme productquantity se répète une fois par produit commandé, la fonction sum est nécessaire pour réduire ces plusieurs valeurs en un seul total. Pour ce faire, écrivez une règle Définir la valeur de dans la cellule Quantité totale.

Pour créer la règle dans l’éditeur visuel, procédez comme suit :

Cela permet de s’assurer que le total reflète toujours le contenu actuel de la ligne répétable sans que les utilisateurs aient à calculer la somme manuellement.

Validation d’une valeur de champ à l’aide d’une expression validating-a-field-value-using-expression

Une Règle de validation permet d’appliquer une logique commerciale à une valeur de champ en évaluant une expression de validation chaque fois que le champ est modifié. Lorsque la condition d’expression est remplie, le formulaire bloque l’entrée et empêche l’utilisateur d’envoyer une valeur non valide. Ainsi, la validation basée sur les expressions est un moyen fiable de se prémunir contre les données incorrectes au point d’entrée, plutôt que de détecter des erreurs ultérieurement pendant le traitement.

Le Scénario De Validation

Dans le formulaire de bon de commande expliqué dans l’exemple précédent, l’objectif est d’empêcher l’utilisateur de commander plus d’une quantité de tout produit dont le prix est supérieur à 10 000 ​. En d’autres termes, les produits de grande valeur (ceux qui dépassent un prix unitaire de 10 000 ) sont limités à une quantité maximale de commande de un , tandis que les produits à bas prix restent sans restriction. Pour appliquer cette règle, définissez une Règle de validation (une expression de validation) dans le champ Quantité, comme illustré ci-dessous.

Fonctionnement de la règle de validation

La règle Valider fonctionne en combinant deux conditions en une seule expression :

Parce que l’expression évalue à la fois le prix et la quantité, la restriction ne s’applique qu’au cas spécifique qui compte — les articles de grande valeur commandés en vrac — tout en permettant à toutes les autres combinaisons de passer sans interruption.

Création de la règle dans l’éditeur visuel

Vous définissez cette logique dans l’éditeur visuel, où la règle Valider est construite à partir des conditions du champ plutôt que écrite manuellement. L’éditeur visuel vous permet de sélectionner les champs pertinents, de définir les opérateurs de comparaison et de combiner les conditions de prix et de quantité dans l’expression de validation complète. Une fois configurée, la règle applique automatiquement la restriction chaque fois qu’un utilisateur tente de définir une quantité pour un produit dont le prix est supérieur à 10 000 .