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 la création d’un formulaire adaptatif, Créez 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).
Pour utiliser les informations fournies dans cet article, il est recommandé de disposer de connaissances dans les domaines suivants :
XFA (XML Forms Architecture)
Pour utiliser les ressources fournies pour l’exemple de l’article, téléchargez l’exemple de package, comme expliqué dans la section suivante, Exemple de 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 module qui peut être téléchargé à partir de la section Téléchargements de cet article.
Une fois le module téléchargé, 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 module contient les ressources suivantes :
sample-form.xdp
: modèle de formulaire XFA utilisé comme exemple.
sample-xfa-af
: formulaire adaptatif basé sur le fichier sample-form.xdp. Ce formulaire adaptatif ne contient toutefois aucun champ. Dans l’étape suivante, vous allez ajouter du contenu à ce formulaire adaptatif.
dans les étapes précédentes, nous avons remplacé une propriété d’un champ dans le fichier XDP. Cette propriété ne sera donc pas synchronisée si la propriété correspondante du fichier XDP est modifiée ultérieurement.
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 :
Accédez à https://<server>:<port>/projects.html.
Entrez vos informations d’identification si vous y êtes invité.
Cliquez sur l’onglet Formulaires à gauche.
Téléchargez le fichier sample-form.xdp
sur votre ordinateur local. Le fichier XDP est téléchargé en tant que fichier .zip
, qui peut être extrait à l’aide de n’importe quel utilitaire de décompression de fichier.
Ouvrez le fichier sample-form.xdp
et remplacez le titre du champ TextField1 de Text Field par My Text Field.
Téléchargez à nouveau le fichier sample-form.xdp
dans l’interface utilisateur d’AEM Forms.
Si un fichier XDP est mis à jour, vous voyez une icône dans l’éditeur, 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.
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 la rebaser 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.
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. 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"
) dans le message. Le titre de TextField1 change de Text Field en My Text Field.
Le libellé AF Numeric Field n’a pas été modifié car vous avez remplacé cette propriété dans la boîte de dialogue des propriétés du composant, comme décrit dans Ajouter le contenu aux formulaires adaptatifs.
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.
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 :
Mettez à jour le fichier sample-form.xdp
et supprimez NumericField1.
Téléchargez le fichier sample-form.xdp
dans l’interface utilisateur d’AEM Forms.
Ouvrez le formulaire adaptatif sample-xfa-af
en vue de sa création. Le message d’erreur suivant s’affiche : Le schéma/modèle de formulaire pour le formulaire adaptatif a été mis à jour. Click Here
pour la rebaser sur la nouvelle version.
Cliquez sur le lien (intitulé " Click Here
") dans le message. Un message d’erreur s’affiche indiquant que le champ n’existe plus dans le fichier XDP.
Le champ qui a été supprimé est également signalé par une icône pour indiquer une erreur dans le champ.
Les champs du formulaire adaptatif ayant une liaison incorrecte (une valeur bindRef
incorrecte dans la boîte de dialogue Modifier) sont également considérés comme des champs supprimés. Si l’auteur ne corrige pas ces erreurs et publie le formulaire adaptatif, le champ est traité comme un champ de formulaire adaptatif non lié normal et est inclus dans la section unbinded du fichier XML de sortie.
Module de contenu pour l’exemple dans cet article