Synchronisation de formulaires adaptatifs avec des modèles de formulaires XFA synchronizing-adaptive-forms-with-xfa-form-templates

Adobe recommande d’utiliser les composants principauxde capture de données modernes et extensibles pour créer de nouveaux formulaires adaptatifsou ajouter des formulaires adaptatifs à des pages AEM Sites. Ces composants représentent une avancée significative dans la création de formulaires adaptatifs, ce qui garantit des expériences utilisateur impressionnantes. Cet article décrit l’ancienne approche de la création de formulaires adaptatifs à l’aide de composants de base.

Présentation introduction

Vous pouvez créer un formulaire adaptatif basé sur un modèle de formulaire XFA (fichier *.XDP). Cette réutilisation vous permet de conserver vos investissements dans les formulaires XFA existants. Pour plus d’informations sur l’utilisation d’un modèle de formulaire XFA pour créer un formulaire adaptatif, consultez la section Créer un formulaire adaptatif basé sur un modèle.

Vous pouvez réutiliser des champs du fichier XDP dans votre formulaire adaptatif. Ces champs sont appelés champs liés. Les propriétés des champs liés (comme les scripts, les libellés et le format d’affichage) sont copiées à partir du fichier XDP. Vous pouvez également choisir de remplacer la valeur de certaines de ces propriétés.

AEM Forms permet de conserver les champs des formulaires adaptatifs synchronisés avec les modifications apportées ultérieurement aux champs correspondants du fichier XDP. Cet article explique comment activer cette synchronisation.

Dans l’environnement de création d’AEM Forms, vous pouvez faire glisser des champs d’un formulaire XFA (à gauche) jusqu’à un formulaire adaptatif (à droite).

Conditions préalables prerequisites

Pour utiliser les informations fournies dans cet article, il est recommandé de disposer de connaissances dans les domaines suivants :

Pour utiliser les ressources fournies pour l’exemple de cet article, téléchargez l’exemple de package, comme expliqué dans la section suivante, voir Exemple de package.

Exemple de package sample-package

Cet article utilise un exemple pour montrer comment synchroniser le formulaire adaptatif avec un modèle de formulaire XFA mis à jour. Les ressources utilisées dans l’exemple sont disponibles dans un package qui peut être téléchargé à partir de la section Téléchargements de cet article.

Une fois le package chargé, vous pouvez afficher ces ressources dans l’interface utilisateur AEM Forms.

Installez le package à l’aide du gestionnaire de packages : https://<server>:<port>/crx/packmgr/index.jsp

Le package contient les ressources suivantes :

Ajout de contenu au formulaire adaptatif add-content-to-adaptive-form-br

Détection des modifications dans le fichier XDP detecting-changes-in-xdp-file

Dès qu’une modification est apportée à un fichier XDP ou un fragment, l’interface utilisateur d’AEM Forms marque tous les formulaires adaptatifs qui sont basés sur le fichier XDP ou le fragment.

Après la mise à jour d’un fichier XDP, vous devez le télécharger à nouveau dans l’interface utilisateur d’AEM Forms pour que les modifications soient marquées.

À titre d’exemple, vous allez mettre à jour le fichier sample-form.xdp en procédant comme suit :

Lorsqu’un fichier XDP est mis à jour, une icône dans l’éditeur apparaît, lorsque vous modifiez les formulaires adaptatifs basés sur celui-ci. Cette icône indique que les formulaires adaptatifs ne sont pas synchronisés avec le fichier XDP. Dans l’illustration suivante, examinez l’icône en regard de la barre latérale.

Synchronisation des formulaires adaptatifs avec le fichier XDP le plus récent synchronizing-adaptive-forms-with-the-latest-xdp-file

Lorsqu’un formulaire adaptatif qui n’est pas synchronisé avec le fichier XDP est ouvert en vue de sa création, le message suivant s’affiche :Schema/Form Template for the Adaptive Form has been updated. Click Here pour le baser sur la nouvelle version.

Lorsque vous cliquez sur le message, les champs du formulaire adaptatif sont synchronisés avec les champs correspondants du fichier XDP.

Pour l’exemple utilisé dans cet article, ouvrez le fichier sample-xfa-af en mode création. Le message s’affiche dans la partie inférieure du formulaire adaptatif.

Mise à jour des propriétés updating-the-properties

Toutes les propriétés qui ont été copiées du fichier XDP dans le formulaire adaptatif sont mises à jour, à l’exception des propriétés qui ont été explicitement remplacées dans le formulaire adaptatif (dans la boîte de dialogue Composant) par l’auteur ou l’autrice. La liste des propriétés qui ont été mises à jour est disponible dans les journaux du serveur.

Pour mettre à jour les propriétés dans l’exemple de formulaire adaptatif, cliquez sur le lien (intitulé "Click Here") du message. Le titre de TextField1 change de Text Field en My Text Field.

Ajout de nouveaux champs du fichier XDP au formulaire adaptatif adding-new-fields-from-xdp-file-to-adaptive-form-nbsp

Les champs qui sont ultérieurement ajoutés au fichier XDP d’origine apparaissent dans l’onglet Hiérarchie du formulaire. Vous pouvez les faire glisser jusqu’au formulaire adaptatif.

Il n’est pas nécessaire de cliquer sur le lien du message d’erreur pour mettre à jour les champs dans l’onglet Hiérarchie du formulaire.

Champs supprimés du fichier XDP deleted-fields-in-xdp-file

Si un champ qui a été copié dans un formulaire adaptatif est supprimé d’un fichier XDP, un message d’erreur s’affiche en mode création indiquant que le champ n’existe pas dans le fichier XDP. Dans ce cas, supprimez manuellement le champ du formulaire adaptatif ou effacez la propriété bindRef dans la boîte de dialogue Composant.

Les étapes suivantes illustrent ce flux d’utilisation des ressources dans l’exemple utilisé dans cet article :

Le champ qui a été supprimé est également signalé par une icône pour indiquer une erreur dans le champ.

Téléchargements downloads

Package de contenu pour l’exemple dans cet article

Obtenir le fichier