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

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 (tels que 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 AEM Forms, vous pouvez faire glisser des champs d’un formulaire XFA (à gauche) vers 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

L’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.

Après avoir chargé le module, vous pouvez afficher ces ressources dans l’interface utilisateur d’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 :

Si un fichier XDP est mis à jour, une icône s’affiche dans l’éditeur, lorsque vous modifiez les formulaires adaptatifs en fonction du fichier XDP. Cette icône indique que le formulaire adaptatif n’est pas synchronisé 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 vers le formulaire adaptatif sont mises à jour, à l’exception des propriétés qui ont été explicitement remplacées dans le formulaire adaptatif (à partir de la boîte de dialogue Composant) par l’auteur. 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

Tous les champs qui sont ajoutés ultérieurement au fichier XDP d’origine apparaissent dans l’onglet Hiérarchie du formulaire et vous pouvez les faire glisser vers le 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é précédemment dans un formulaire adaptatif est supprimé d’un fichier XDP, un message d’erreur s’affiche en mode création pour indiquer 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