Éditeur de règles de formulaires adaptatifs adaptive-forms-rule-editor

Présentation overview

La fonction d’éditeur de règles d’Adobe Experience Manager Forms permet aux utilisateurs professionnels et aux développeurs de formulaires d’écrire des règles sur des objets de formulaire adaptatif. Ces règles déterminent les actions à déclencher 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. Cela permet de rationaliser davantage l’expérience de remplissage de formulaire en assurant précision et vitesse.

L’éditeur de règles fournit une interface utilisateur intuitive et simplifiée pour la création de règles. L’éditeur de règles met un éditeur visuel à disposition de tous les utilisateurs. En outre, l’éditeur de règles fournit un éditeur de code pour la création de règles et de scripts uniquement pour les utilisateurs experts en formulaires. Voici quelques-unes des actions clés que vous pouvez effectuer sur les objets de formulaire adaptatif utilisant des règles :

L’éditeur de règles remplace les fonctionnalités de script dans AEM Forms 6.1 et les versions antérieures. Toutefois, les scripts existants sont conservés dans le nouvel éditeur de règles. Pour plus d’informations sur l’utilisation de scripts existants dans l’éditeur de règles, voir Impact de l’éditeur de règles sur les scripts existants

Les utilisateurs ajoutés au groupe forms-power-users peuvent créer de nouveaux scripts et modifier des scripts existants. Les utilisateurs du groupe forms-users peuvent utiliser les scripts, mais pas créer ni modifier des scripts.

Compréhension 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 qui sont évaluées en effectuant des vérifications et des opérations sur l’état, la valeur ou la propriété d’un objet de formulaire. Les actions sont exécutées en fonction de la valeur (True ou False) renvoyée par l’évaluation d’une condition.

L’éditeur de règles fournit un ensemble de types de règle prédéfinis, tels que Lorsque, Afficher, Masquer, Activer, Désactiver, Définir la valeur de et Valider pour vous aider à créer des règles. 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’un des concepts suivants :

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.

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 une action alternative d’action-condition, qui définit également une action alternative à déclencher si la condition renvoie la valeur False.

Les types de règles 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 d’Afficher est Masquer et l’action alternative d’Activer est Désactiver, et inversement. Vous ne pouvez pas modifier l’action alternative par défaut.

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

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

Même si vous pouvez obtenir la plupart des cas d’utilisation avec n’importe quel concept de règle, voici quelques recommandations pour sélectionner un concept plutôt qu’un autre. Pour plus d’informations sur les règles disponibles dans l’éditeur de règles, reportez-vous à la section Types de règles 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 et les événements suivants à l’aide desquels vous pouvez créer des règles.

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 que vous pouvez utiliser pour créer des règles. Examinons en détail chaque type de règle. Pour plus d’informations sur l’écriture de règles dans l’éditeur de règles, voir Règles d’écriture.

Quand when

Le type de règle Lorsque suit le concept de règle d’action alternative de condition-action ou parfois simplement le concept de condition-action. Dans ce type de règle, vous spécifiez d’abord une condition à évaluer, puis une action à déclencher si la condition est remplie (True). Lors de l’utilisation du type de règle Lorsque, vous pouvez utiliser plusieurs opérateurs ET et OU afin de 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 on Object B;
AND
Action 3 on Object C;

Lorsque vous avez un composant à valeurs multiples, comme des boutons radio ou une liste, les options sont récupérées automatiquement et mises à disposition du créateur de la règle lorsque vous créez une règle pour ce composant. Vous n’avez pas besoin de saisir à nouveau les valeurs de l’option.

Par exemple, une liste comporte quatre options : Rouge, Bleu, Vert et Jaune. Lors de la création de la règle, les options (boutons radio) sont automatiquement récupérées et mises à la disposition de l’auteur de la règle comme suit :

Lorsque vous créez une règle Lorsque, vous pouvez déclencher l’action Effacer la valeur de. L’action Effacer la valeur d’efface la valeur de l’objet spécifié. L’option Effacer la valeur de dans l’instruction Lorsque permet de créer des conditions complexes comportant plusieurs champs.

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 Appel un service configuré dans un modèle de données de formulaire. 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 dans tous les modèles de données de formulaire sur votre instance AEM. Lorsque vous choisissez un service de modèle de données de formulaire, des champs supplémentaires permettant de mapper les objets de formulaires avec des paramètres d’entrée et de sortie pour le service spécifié apparaissent. Voir l’exemple de règle pour appeler des services de modèle de données de formulaire.

Outre le service de modèle de données de formulaire, vous pouvez spécifier une URL WSDL directe pour appeler un service Web. Cependant, un service de modèle de données de formulaire présente de nombreux avantages et l’approche recommandée pour appeler un service.

Pour plus d’informations à propos de la configuration des services dans le modèle de données de formulaire, voir Intégration des données AEM Forms.

Définir la valeur de Calcule et définit la valeur de l’objet spécifié. Vous pouvez définir cette valeur par une chaîne, la valeur d’un autre objet, la valeur calculée avec une expression ou 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 sélectionnez l’option Service web, elle affiche tous les services configurés dans tous les modèles de données de formulaire de votre instance AEM. Lorsque vous choisissez un service de modèle de données de formulaire, des champs supplémentaires permettant de mapper les objets de formulaires avec des paramètres d’entrée et de sortie pour le service spécifié apparaissent.

Pour plus d’informations à propos de la configuration des services dans le modèle de données de formulaire, voir Intégration des données AEM Forms.

Définir la propriété Définit la valeur d’une propriété de l’objet spécifié.

Effacer la valeur de  : efface la valeur de l’objet spécifié.

Définir la cible d’action: définit la cible d’action sur l’objet spécifié.

Enregistrer le formulaire  : enregistre le formulaire.

Envoyer les formulaires  : envoie le formulaire.

Réinitialiser le formulaire  : réinitialise le formulaire.

Valider le formulaire  : valide le formulaire.

Ajouter une instance  : ajoute une instance de la ligne de panneau ou de tableau répétable spécifiée.

Supprimer une instance  : supprime une instance de la ligne de panneau ou de tableau répétable spécifiée.

Définir la valeur de set-value-of

Le type de règle Définir la valeur de permet de définir la valeur d’un objet de formulaire selon que la condition spécifiée est remplie ou non. La valeur peut être définie sur la valeur d’un autre objet, d’une chaîne littérale, la valeur dérivée d’une expression ou d’une fonction mathématique, la valeur d’une propriété d’un autre objet ou la sortie d’un service de modèle de données de formulaire. De même, vous pouvez vérifier la condition d’un composant, d’une chaîne, d’une propriété ou les valeurs dérivées d’une fonction ou d’une expression mathématique.

Notez que le type de règle Définir la valeur de n’est pas disponible pour tous les objets de formulaire, tels que les panneaux et les boutons de la barre d’outils. Une règle Définir la valeur de standard possède la structure suivante :

Définir la valeur d’Objet A sur :

(chaîne ABC) OU
(propriété d’objet X de 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 TRUE ;

L’exemple suivant prend la valeur du champ dependentid comme valeur d’entée et définit la valeur du champ Relation comme valeur de sortie de l’argument Relation du service de modèle de données de formulaire getDependent.

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 permet de créer une règle pour afficher ou masquer un objet de formulaire selon qu’une condition est remplie ou non. Le type de règle Afficher déclenche également l’action Masquer au cas où la condition ne serait pas remplie ou renverrait False.

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

Show Object A;

When:

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

Else:

Hide Object A;

Masquer hide

De la même manière que pour le type de règle Afficher, vous pouvez utiliser le type de règle Masquer pour afficher ou masquer un objet de formulaire selon qu’une condition est remplie ou non. Le type de règle Masquer déclenche également l’action Afficher au cas où la condition ne serait pas remplie ou renverrait False.

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;

Activer enable

Le type de règle Activer permet d’activer ou de désactiver un objet de formulaire selon qu’une condition est remplie ou non. Le type de règle Activer déclenche également l’action Désactiver au cas où la condition ne serait pas remplie ou renverrait False.

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;

Désactiver disable

De la même manière que le type de règle Activer, le type de règle Désactiver permet d’activer ou de désactiver un objet de formulaire selon qu’une condition est remplie ou non. Le type de règle Désactiver déclenche également l’action Activer au cas où la condition ne serait pas remplie ou renverrait False.

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;

Valider validate

Le type de règle Valider valide la valeur d’un champ à l’aide d’une expression. Par exemple, vous pouvez créer une expression pour vérifier que la zone de texte permettant de spécifier le nom ne contient pas de caractères spéciaux ni de nombres.

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

Validate Object A;

Using:

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

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

L’éditeur de règles offre une interface utilisateur exhaustive et néanmoins simple, qui permet de créer et de gérer des règles. Vous pouvez lancer l’interface utilisateur de l’éditeur de règles depuis un formulaire adaptatif en mode création.

Pour lancer l’interface utilisateur de l’éditeur de règles :

Examinons en détail chaque composant de l’interface utilisateur de l’éditeur de règles.

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

Affiche le titre de l’objet de formulaire adaptatif par lequel vous avez lancé l’éditeur de règles et le type de règle actuellement sélectionné. Dans l’exemple ci-dessus, l’éditeur de règles est lancé depuis l’objet d’un formulaire adaptatif intitulé Salary et le type de règle sélectionné est Lorsque.

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. Il affiche le titre et le type des objets. Lors de la création d’une règle, vous pouvez faire glisser-déposer les objets de formulaire dans l’éditeur de règles. Lorsque vous créez ou modifiez une règle en faisant glisser et en déposant un objet ou une fonction dans un espace réservé, cet espace prend automatiquement le type de valeur approprié.

Les objets de formulaire contenant une ou plusieurs règles valides appliquées sont désignés par un point vert. Si l’une des règles appliquées à un objet de formulaire n’est pas valide, l’objet de formulaire est marqué d’un point jaune.

L’onglet Fonctions comporte un jeu de fonctions intégrées, comme Somme de, Minimum de, Maximum de, Moyenne de, Nombre de et Valider le formulaire. Vous pouvez utiliser ces fonctions pour calculer des valeurs dans les panneaux et les lignes de tableau répétables et pour les instructions d’action et de condition lors de la création de règles. Cependant, vous pouvez créer des fonctions personnalisées.

Dans l’arborescence de gauche des objets de formulaire, vous pouvez appuyer sur les objets de formulaire pour afficher les règles appliquées à chacun des objets. Vous pouvez non seulement parcourir les règles des différents objets de formulaire mais également copier-coller des règles entre les objets du formulaire. Pour plus d’informations, voir Règles de copier-coller.

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

Le bouton Basculer, lorsqu’il est sélectionné, permet de basculer entre le volet des objets de formulaire et celui des fonctions.

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

Lorsque l’interface utilisateur de l’éditeur de règles est en mode éditeur visuel, l’éditeur de règles visuel est la zone dans laquelle vous créez des règles. Il vous permet de sélectionner un type de règle et de définir en conséquence des conditions et des actions. Lors de la définition de conditions et d’actions dans une règle, vous pouvez faire glisser et déposer des objets et des fonctions de formulaire à partir du volet Objets de formulaire et fonctions.

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

E. Sélecteur d’éditeurs de code visuel e-visual-code-editors-switcher

Les utilisateurs du groupe forms-power-users peuvent accéder à l’éditeur de code. Pour les autres utilisateurs, l’éditeur de code n’est pas disponible. Si vous disposez des droits, vous pouvez passer du mode éditeur visuel en mode éditeur de code et inversement, à l’aide d’un sélecteur situé au-dessus de l’éditeur de règles. Lorsque vous lancez l’éditeur de règles pour la première fois, il s’ouvre en mode Éditeur visuel. Vous pouvez créer des règles en mode éditeur visuel ou passer en mode éditeur de code pour écrire un script de règle. Notez toutefois que si vous modifiez une règle ou créez une règle dans l’éditeur de code, vous ne pouvez pas revenir à l’éditeur visuel pour cette règle à moins que vous n’ayez désactivé l’éditeur de code.

AEM Forms effectue le suivi du mode d’éditeur de règles que vous avez utilisé en dernier pour écrire une règle. Lorsque vous lancez l’éditeur de règles la prochaine fois, il s’ouvre dans ce mode. Cependant, vous pouvez également configurer un mode par défaut pour ouvrir l’éditeur de règles dans le mode spécifié. Pour ce faire :

F. Boutons Terminé et Annuler f-done-and-cancel-buttons

Le bouton Terminé permet d’enregistrer une règle. Vous pouvez enregistrer une règle incomplète. Toutefois, les variables incomplètes ne sont pas valides et ne s’exécutent pas. Les règles enregistrées sur un objet de formulaire sont répertoriées lorsque vous lancez l’éditeur de règles la prochaine fois à partir du même objet de formulaire. Vous pouvez gérer des règles existantes dans cette vue. Pour plus d’informations, voir Gestion des règles.

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

Règles d’écriture write-rules

Vous pouvez créer des règles à l’aide de l’éditeur visuel de règles ou de l’éditeur de code. Lorsque vous lancez l’éditeur de règles pour la première fois, il s’ouvre en mode Éditeur visuel. Vous pouvez passer en mode Éditeur de code et créer des règles. Notez toutefois que si vous écrivez ou modifiez une règle dans l’éditeur de code, vous ne pouvez pas passer à l’éditeur visuel pour cette règle à moins que vous n’ayez désactivé l’éditeur de code. Lorsque vous lancez l’éditeur de règles la prochaine fois, il s’ouvre dans le mode que vous avez utilisé en dernier pour créer une règle.

Commençons par découvrir comment écrire des règles à l’aide de l’éditeur visuel.

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

Examinons comment créer une règle dans l’éditeur visuel en utilisant l’exemple de formulaire suivant.

La section Conditions de prêt de l’exemple de formulaire de demande de prêt exige que les demandeurs spécifient leur état civil, leur salaire et, s’ils sont mariés, le salaire de leur conjoint. Selon les entrées de l’utilisateur, la règle calcule le montant d’éligibilité de prêt et s’affiche dans le champ Éligibilité de prêt . Appliquez les règles suivantes pour mettre en oeuvre le scénario :

Pour créer des règles, procédez comme suit :

Utilisation de l’éditeur de code using-code-editor

Les utilisateurs ajoutés au groupe forms-power-users peuvent utiliser l’éditeur de code. L’éditeur de règles génère automatiquement le code JavaScript pour toute règle que vous créez à l’aide de l’éditeur visuel. Vous pouvez passer de l’éditeur visuel à l’éditeur de code pour afficher le code généré. Cependant, si vous modifiez le code de règle dans l’éditeur de code, vous ne pouvez pas revenir à l’éditeur visuel. Si vous préférez écrire des règles dans l’éditeur de code plutôt que dans l’éditeur visuel, vous pouvez à nouveau créer des règles dans l’éditeur de code. Le sélecteur des éditeurs de code visuel vous permet de basculer entre les deux modes.

L’éditeur de code JavaScript est le langage d’expression des formulaires adaptatifs. Toutes les expressions sont des expressions JavaScript valides et utilisent des API de modèle de script de formulaires adaptatifs. Ces expressions renvoient des valeurs de certains types. Pour obtenir la liste complète des classes de formulaires adaptatifs, des événements, des objets et des API publiques, voir Référence de l’API de la bibliothèque JavaScript pour les formulaires adaptatifs.

Pour plus d’informations sur les instructions pour la création de règles dans l’éditeur de code, voir Expressions de formulaire adaptatif.

Lors de l’écriture de code JavaScript dans l’éditeur de règles, les repères visuels suivants vous aident à comprendre la structure et la syntaxe :

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

Outre les fonctions prêtes à l’emploi telles que Somme de, répertoriées sous Fonctions Output, vous pouvez créer des fonctions personnalisées dont vous avez fréquemment besoin. 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 :

Pour plus d’informations, voir usejsdoc.org.

Balises jsdoc prises en charge :

Ajout d’une fonction personnalisée

Par exemple, vous souhaitez ajouter une fonction personnalisée qui calcule la surface d’un carré. La longueur du côté est la saisie de l’utilisateur à 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 de 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.

Effectuez les étapes suivantes pour créer une bibliothèque cliente et l’ajouter dans le référentiel CRX.

Une fois que vous avez ajouté votre bibliothèque client dans le référentiel CRX, utilisez-la dans votre formulaire adaptatif. Cela vous permet d’utiliser votre fonction personnalisée comme règle dans votre formulaire. Procédez comme suit 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 de la liste de variables, si elle est associée. Vous pouvez utiliser l’expression de fonction pour chaque fonction déclarée.

Déclaration de fonction en tant qu’objet

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

Gestion des règles manage-rules

Les règles existantes sur un objet de formulaire sont répertoriées lorsque vous appuyez sur l’objet et sur . Vous pouvez afficher le titre et un aperçu du résumé de la règle. En outre, 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 les règles et de supprimer des règles.

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

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

Vous pouvez copier-coller une règle d’un champ vers d’autres champs similaires pour gagner du temps.

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

Expressions imbriquées nestedexpressions

L’éditeur de règles vous permet d’utiliser plusieurs opérateurs ET et OU pour créer des règles imbriquées. Vous pouvez mélanger plusieurs opérateurs ET et OU dans des règles.

Voici un exemple de règle imbriquée qui affiche un message concernant l’éligibilité pour un droit de garde lorsque les conditions nécessaires sont remplies à l’intention de l’utilisateur.

Vous pouvez également faire glisser et déposer des conditions dans une règle pour la modifier. Appuyez et passez le curseur sur la poignée ( ) avant une condition. Une fois le pointeur affiché sous forme de main comme illustré ci-dessous, faites glisser la condition et déposez-la n’importe où dans la règle. La structure de la règle change.

Conditions d’expression de date dateexpression

L’éditeur de règles permet d’utiliser des comparaisons de dates afin de créer des conditions.

Voici un exemple de condition qui contient un objet de texte statique si le prêt hypothécaire sur la maison est déjà utilisé, ce que l’utilisateur indique en remplissant le champ de date.

Lorsque la date du prêt immobilier tel que renseigné par l’utilisateur figure dans le passé, le formulaire adaptatif affiche une note sur le calcul des revenus. La règle ci-dessous compare la date indiquée par l’utilisateur à la date actuelle et si la date indiquée par l’utilisateur est antérieure à la date actuelle, le formulaire affiche le message texte (appelé « Revenu »).

Lorsque la date remplie est antérieure à la date actuelle, le formulaire affiche le message texte (Revenu), comme suit :

Conditions de comparaison des nombres number-comparison-conditions

L’éditeur de règles permet de créer des conditions qui comparent deux nombres.

Voici un exemple de condition qui contient un objet de texte statique si le demandeur habite à son adresse actuelle depuis moins de 36 mois.

Lorsque l’utilisateur indique qu’il habite à son adresse résidentielle actuelle depuis moins de 36 mois, le formulaire affiche une notification indiquant qu’un justificatif de domicile supplémentaire peut être demandé.

Impact de l’éditeur de règles sur les scripts existants impact-of-rule-editor-on-existing-scripts

Dans les versions d’AEM Forms antérieures à la version 6.1 d’AEM Feature Pack 1, les auteurs et les développeurs de formulaires écrivaient des expressions dans l’onglet Scripts de la boîte de dialogue Modifier le composant pour ajouter un comportement dynamique aux formulaires adaptatifs. L’onglet Scripts est maintenant remplacé par l’éditeur de règles.

Tous les scripts ou expressions que vous devez avoir écrits dans l’onglet Scripts sont disponibles dans l’éditeur de règles. Alors que vous ne pouvez pas les afficher ou les modifier dans l’éditeur visuel, vous pouvez modifier les scripts dans l’éditeur de code si vous appartenez au groupe des utilisateurs avancés de formulaires.

Exemples de règles example

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

Imaginons un service Web GetInterestRates prenant le montant du prêt, la durée et la cote de solvabilité du demandeur comme valeurs d’entrée et renvoyant un plan de prêt incluant le montant des mensualités et le taux d’intérêt. Créez un modèle de données de formulaire en utilisant le service Web comme source de données. Ajoutez des objets de modèle de données et un service get au modèle de formulaire. Le service s’affiche sur l’onglet Services du modèle de données de formulaire. Créez ensuite un formulaire adaptatif qui comprend des champs issus d’objets de modèle de données pour capturer les entrées utilisateur pour le montant du prêt, la durée et la note de crédit. Ajoutez un bouton qui déclenche le service Web pour récupérer les détails du plan. La sortie est renseignée dans les champs appropriés.

La règle suivante indique comment configurer l’action du service Invoke pour réaliser l’exemple de scénario.

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

Dans un formulaire de demande de prêt, vous voulez savoir si le demandeur de prêt est un client existant ou non. En fonction des informations fournies par l’utilisateur, le champ ID de client doit s’afficher ou se masquer. Vous souhaitez également définir le focus sur le champ ID de client si l’utilisateur est un client existant. Le formulaire de demande de prêt est composé des éléments suivants :

Lorsque vous entrez une règle Lorsque sur le bouton radio pour implémenter ce comportement, la règle s’affiche comme suit dans l’éditeur de règles visuel.

Dans l’exemple de règle, l’instruction de la section Lorsque est la condition qui, lorsqu’elle renvoie True, exécute les actions spécifiées dans la section Then.

La règle s’affiche comme suit dans l’éditeur de code.

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

Dans un formulaire de bon de commande, vous disposez du tableau suivant, dans lequel les utilisateurs rempliront leurs commandes. Dans ce tableau :

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

Maintenant, vous souhaitez ajouter des quantités spécifiées dans la colonne Quantité de produit pour tous les produits et afficher la somme dans la cellule Quantité totale. Pour ce faire, vous pouvez écrire une règle Définir la valeur de dans la cellule Quantité totale , comme illustré ci-dessous.

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

Dans le formulaire de bon de commande décrit dans l’exemple précédent, vous souhaitez empêcher l’utilisateur de commander plus d’une quantité d’un produit dont le prix est supérieur à 10 000. Pour ce faire, vous pouvez écrire une règle Valider comme illustré ci-dessous.