Jeu de formulaires dans AEM Forms form-set-in-aem-forms

Présentation overview

Vos clientes et clients doivent souvent envoyer plusieurs formulaires pour solliciter un service ou une prestation. Cela implique de trouver tous les formulaires pertinents, de les remplir, de les envoyer et de les suivre séparément. En outre, vos clientes et clients doivent remplir plusieurs fois les mêmes informations dans les différents formulaires. L’ensemble du processus devient laborieux et sujet aux erreurs s’il implique un grand nombre de formulaires. La fonction de jeu de formulaires d’AEM Forms peut aider à simplifier l’expérience utilisateur lors de scenarii de ce type.

Un jeu de formulaires est un ensemble de formulaires HTML5 regroupés et présentés aux utilisateurs finaux et utilisatrices finales sous la forme d’un jeu unique de formulaires. Lorsque les utilisateurs finaux et les utilisatrices finales commencent à remplir un jeu de formulaires, le passage d’un formulaire à un autre est simple. À la fin, tous les formulaires peuvent être envoyés en un seul clic.

AEM Forms fournit aux auteurs et autrices de formulaires une interface utilisateur intuitive pour créer, configurer et gérer des jeux de formulaires. En tant qu’auteur ou autrice, vous pouvez classer les formulaires dans une séquence particulière que les utilisateurs finaux et les utilisatrices finales doivent suivre. Vous pouvez également appliquer des conditions ou des expressions d’éligibilité sur des formulaires individuels pour contrôler leur visibilité en fonction des entrées de l’utilisateur ou de l’utilisatrice. Par exemple, vous pouvez configurer le formulaire avec les détails du conjoint ou de la conjointe pour qu’il s’affiche uniquement lorsque l’état civil indique Marié(e).

En outre, vous pouvez configurer des champs communs dans différents formulaires pour partager des liaisons de données communes. Grâce à des liaisons de données appropriées, les utilisateurs finaux ou les utilisatrices finales ne devront remplir les informations communes qu’une seule fois. Elles seront automatiquement renseignées dans les formulaires suivants.

Les jeux de formulaires sont également pris en charge dans l’application AEM Forms, ce qui permet à vos collaborateurs et collaboratrices sur le terrain de prendre un jeu de formulaires hors ligne, de rendre visite aux clients ou aux clientes, d’entrer des données et de se synchroniser ultérieurement avec le serveur AEM Forms pour envoyer des données de formulaires aux processus métier.

Création et gestion de jeux de formulaires creating-and-managing-form-set

Vous pouvez associer plusieurs XDP ou modèles de formulaire, créés via Designer, dans un jeu de formulaires. Des jeux de formulaires peuvent ensuite être utilisés pour rendre de manière sélective les XDP en fonction des valeurs saisies par les utilisateurs dans les formulaires initiaux et leurs profils.

Utilisez l’interface utilisateur d’AEM Forms pour gérer tous vos formulaires, vos jeux de formulaires et vos ressources associés.

Créer un jeu de formulaires create-a-form-set

Pour créer un jeu de formulaire, procédez ainsi :

Gérer un jeu de formulaires managing-a-form-set

Une fois qu’un jeu de formulaires est créé, vous pouvez effectuer les actions suivantes sur ce jeu :

Modifier un jeu de formulaires edit-a-form-set

Pour modifier un jeu de formulaires, procédez comme suit :

Jeu de formulaires dans Process Management form-set-in-process-management

Une fois que vous avez créé un jeu de formulaires à l’aide de l’interface utilisateur de la gestion d’AEM Forms, vous pouvez utiliser le jeu de formulaires dans une activité Point de départ ou Affectation de tâches à l’aide de Workbench.

Utilisation du jeu de formulaires dans Tâche ou Point de départ using-form-set-in-task-or-start-point

Expressions d’éligibilité eligibility-expressions

Les expressions d’éligibilité dans un jeu de formulaires sont utilisées pour définir et contrôler dynamiquement les formulaires affichés à l’utilisateur. Par exemple, pour afficher un formulaire donné uniquement si l’utilisateur appartient à une tranche d’âge particulière. Spécifiez et modifiez une expression d’éligibilité à l’aide de Forms Manager.

Une expression d’éligibilité peut être n’importe quelle instruction JavaScript valide renvoyant une valeur booléenne. La dernière instruction du fragment de code JavaScript est traitée comme une valeur booléenne qui détermine l’éligibilité du formulaire en fonction du traitement effectué dans le reste (lignes précédentes) du fragment de code JavaScript. Si la valeur de l’expression est vraie, le formulaire est éligible pour être affiché à l’utilisateur. Ces formulaires sont appelés formulaires éligibles.

Outre les fonctions JavaScript standard, le jeu de formulaires expose également la valeur fs.valueOf de l’API qui permet d’accéder à la valeur d’un champ d’un formulaire dans un jeu de formulaires. Utilisez cette API pour accéder à la valeur d’un champ de formulaire dans un jeu de formulaires. La syntaxe de l’API est fs.valueOf (formUid, fieldSOM), où :

Exemples examples

Utilisation valide de l’API :

fs.valueOf("form1", "xfa.form.form1.subform1.field1")

Utilisation non valide de l’API :

var formUid = "form1";
 var fieldSOM = "xfa.form.form1.subform1.field1"; fs.valueOf(formUid, fieldSOM);

Préremplissage XML du jeu de formulaires prefill-xml-for-form-set

Un jeu de formulaires est un ensemble de formulaires HTML5 multiples dont les schémas sont communs ou différents. Le jeu de formulaires prend en charge le préremplissage des champs du formulaire à l’aide d’un fichier XML. Vous pouvez associer un fichier XML à un jeu de formulaires. Ainsi, lorsque vous ouvrez un formulaire dans le jeu, certains champs du formulaire sont pré-remplis.

Le fichier XML de pré-remplissage est spécifié à l’aide du paramètre dataRef de l’URL du jeu de formulaires. Le paramètre dataRef indique le chemin d’accès absolu du fichier XML de données qui est fusionné avec le jeu de formulaires.

Par exemple, vous avez trois formulaires (formulaire 1, formulaire 2 et formulaire 3) dans le jeu de formulaires dont la structure est la suivante :

form1

champ champformulaire1

formulaire2

champ champformulaire2

formulaire3

champ champformulaire3

Chaque formulaire présente un champ nommé communément « champ » et un champ nommé de manière unique « form<i>Field ».

Vous pouvez préremplir ce jeu de formulaires à l’aide d’un XML dont la structure est la suivante :

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <field>common field value</field>
 <form1field>value1</form1field>
 <form2field>value2</form2field>
 <form3field>value3</form3field>
</formSetRootTag>

L’extrait de code XML ci-dessus indique que le code XML de préremplissage du jeu de formulaires est une union des extraits de code XML prérempli des formulaires individuels. Si certains champs dans les différents formulaires présentent une hiérarchie de données/un schéma similaires entre eux, les champs sont préremplis avec les mêmes valeurs. Dans cet exemple, chacun des trois formulaires est prérempli avec la même valeur pour le champ commun « champ ». Il s'agit d’un moyen facile de transférer des données d’un formulaire à un autre. Cette opération peut également être réalisée en liant les champs à la même référence de schéma ou de données. Si vous souhaitez isoler les données du jeu de formulaires en fonction du schéma des formulaires. Cette opération peut être réalisée en spécifiant l’attribut « racine de données » du formulaire pendant la création du jeu de formulaires (la valeur par défaut est « / », qui mappe à la balise racine du jeu de formulaires).

Dans l’exemple précédent, si vous spécifiez les racines de données : « /formulaire1 », « /formulaire2 », et « /formulaire3 » respectivement pour les trois formulaires, vous devez utiliser un code XML de préremplissage présentant la structure suivante :

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <form1>
  <field>field value1</field>
  <form1field>value1</form1field>
 </form1>
 <form2>
  <field>field value2</field>
  <form2field>value2</form2field>
 </form2>
 <form3>
  <field>field value3</field>
  <form3field>value3</form3field>
 </form3>
</formSetRootTag>

Dans un ensemble de formulaires, le code XML a défini un schéma XML avec la syntaxe suivante :

<formset>
 <fs_data>
  <xdp:xdp xmlns:xdp="https://ns.adobe.com/xdp/">
  <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
   <xfa:data>
   <rootElement>
    ... data ....
   </rootElement>
   </xfa:data>
  </xfa:datasets>
  </xdp:xdp>
 </fs_data>
 <fs_draft>
  ... private data...
 </fs_draft>
</formset>

Description des éléments XML de préremplissage prefill-xml-elements-description

Règles de syntaxe pour créer un fichier XML de préremplissage :

JEU DE FORMULAIRES formset

parent elements:

null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: fs_data

Élément racine du XML du jeu de formulaires. Il est conseillé de ne pas utiliser ce mot comme nom de rootSubform d’un formulaire dans le jeu de formulaires.

FS_DATA fs-data

parent elements:

formset

Cardinalité : [1]

submitXML : P

prefillXML : O

children: xdp:xdp/rootElement

La sous-arborescence indique les données des formulaires dans le jeu de formulaires. L’élément est optionnel dans le XML prérempli uniquement si l’élément du jeu de formulaires n’est pas présent.

XDP :XDP xdp-xdp

parent elements: fs_data/null

cardinality: [0,1]

submitXML: O

prefillXML: O

children: xfa:datasets

Cette balise indique le début du XML du formulaire HTML5. Cela est ajouté à l’envoi XML s’il est présent dans le XML prérempli ou s’il n’y a aucun XML prérempli. Cette balise peut être supprimée du XML prérempli.

XFA : DATASETS xfa-datasets

parent elements: xdp:xdp

cardinality: [1]

submitXML: O

prefillXML: O

children: xfa:data

XFA:DATA xfa-data

parent elements: xfa:datasets

cardinality: [1]

submitXML: O

prefillXML: O

children: rootElement

ROOTELEMENT rootelement

parent elements: xfa:datasets/fs_data/null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: controlled by the Forms in Form set

Le rootElement du nom est simplement un espace réservé. Le nom réel est sélectionné dans les formulaires utilisés dans le jeu de formulaires. La sous-arborescence qui débute avec rootElement contient les données des champs et des sous-formulaires à l’intérieur des formulaires dans l’ensemble de formulaires. Des facteurs multiples déterminent la structure du rootElement et de ses enfants.

Dans le code XML prérempli, cette balise est optionnelle, mais si elle est manquante, le code XML entier est ignoré.

NOM DE LA BALISE DE L’ÉLEMENT RACINE

Au cas où il y aurait un élément racine dans le XML prérempli, le nom de cet élément est également présent dans le XML envoyé. S’il n’existe aucun XML prérempli, le nom de l’élément rootElement est le nom du sous-formulaire racine du premier formulaire dans le jeu de formulaires dont la propriété dataRoot est définie sur « / ». En l’absence d’un tel formulaire, le nom de l’élément rootElement est fs_dummy_root, qui est un mot-clé réservé.

Jeu de formulaires dans l’application AEM Forms formset-in-workspace-app

L’application AEM Forms permet aux agentes et agents de terrain de synchroniser leurs périphériques mobiles avec un serveur AEM Forms, puis de travailler sur leurs tâches. L’application est exécutée même lorsque l’appareil est hors ligne et que les données y sont enregistrées en local. À l’aide des fonctions d’annotation comme les photos, les agentes et agents de terrain peuvent fournir des informations précises à intégrer dans des processus métier.

Limites connues - Modèles qui ne sont pas pleinement pris en charge dans le jeu de formulaires known-limitations-patterns-not-fully-supported-in-form-set

Les modèles de données suivants ne sont pas entièrement pris en charge dans le jeu de formulaires :