Adobe recommande d’utiliser la capture de données moderne et extensible. Composants principaux pour création d’un Forms adaptatif ou Ajout de Forms adaptatif à des pages AEM Sites. Ces composants représentent une avancée significative dans la création de Forms adaptatif, ce qui garantit des expériences utilisateur impressionnantes. Cet article décrit l’approche plus ancienne de la création de Forms adaptatif à l’aide de composants de base.
Version | Lien de l’article |
---|---|
AEM 6.5 | Cliquez ici |
AEM as a Cloud Service | Cet article |
Lorsqu’un formulaire est rempli ou envoyé, vous pouvez conserver un enregistrement du formulaire, au format imprimé ou au format de document. Ici, il s’agit d’un document d’enregistrement (DOR). Il s’agit d’une copie imprimable du formulaire envoyé. Vous pouvez également vous reporter au document d’enregistrement pour les informations que les clients ont remplies à une date ultérieure ou utiliser le document d’enregistrement pour archiver ensemble les formulaires et le contenu au format PDF.
Pour créer un document d’enregistrement, un modèle basé sur XFA ou Acrobat est fusionné avec les données collectées via un formulaire adaptatif. Vous pouvez générer un document d’enregistrement automatiquement ou à la demande.
L’option à la demande vous permet de spécifier un modèle XFA ou Acrobat personnalisé pour donner une apparence personnalisée à votre document d’enregistrement.
Vous pouvez :
Avant de commencer à apprendre et à préparer les ressources requises pour un document d’enregistrement :
Modèle de base : un modèle XFA (fichier XDP) créé dans Forms Designer ou un formulaire Acrobat Form (AcroForm). Le modèle de base, également appelé métamodèle, est utilisé pour spécifier les informations de style et de marque pour un document d’enregistrement. Chargez votre modèle XFA (fichier XDP) sur votre instance AEM Forms au préalable.
Formulaire adaptatif : le formulaire adaptatif pour lequel le document d’enregistrement doit être généré.
Chargez votre modèle XFA (fichier XDP) vers votre instance AEM Forms. Suivez les étapes suivantes pour configurer un formulaire adaptatif afin d’utiliser un modèle XFA (fichier XDP) comme modèle de document d’enregistrement :
Votre formulaire adaptatif est maintenant configuré pour utiliser un fichier XDP comme modèle de document d’enregistrement. Les étapes suivantes consistent à lier les composants de formulaire adaptatif aux champs de modèle correspondants.
Chargez votre PDF Adobe Acrobat (Acroform) sur votre instance AEM Forms. Suivez les étapes suivantes pour configurer un formulaire adaptatif afin d’utiliser Adobe Acrobat PDF (acroform) comme modèle de document d’enregistrement :
Votre formulaire adaptatif est maintenant configuré pour utiliser un Acroform comme modèle de document d’enregistrement. Les étapes suivantes consistent à lier les composants de formulaire adaptatif aux champs de modèle correspondants.
Lorsqu’un formulaire adaptatif est configuré pour générer automatiquement un document d’enregistrement, chaque fois qu’un formulaire est modifié, son document d’enregistrement est mis à jour immédiatement. Par exemple, si un champ est supprimé d’un formulaire adaptatif existant, le champ correspondant est également supprimé et n’est pas visible dans le document d’enregistrement. La génération automatique d’un document d’enregistrement présente de nombreux autres avantages. :
Suivez les étapes suivantes pour configurer un formulaire adaptatif afin de générer automatiquement un document d’enregistrement :
Liez les champs de formulaire adaptatif aux champs de modèle pour afficher les données de formulaire capturées dans le champ de document d’enregistrement correspondant. Pour lier les composants de formulaire adaptatif aux champs de modèle de document d’enregistrement correspondants :
Ouvrez le formulaire adaptatif, configuré pour utiliser un modèle de formulaire personnalisé, pour le modifier.
Sélectionnez un composant de formulaire adaptatif et cliquez sur l’icône Configurer . Il ouvre le navigateur des propriétés.
Dans le navigateur des propriétés, recherchez et sélectionnez un champ.
Cliquez sur Enregistrer.
Vous pouvez utiliser l’action de soumission de workflow Experience Manager Envoyer un e-mail conjointement avec l’étape Document d’enregistrement et autres actions de soumission pour recevoir un document d’enregistrement.
Les formulaires adaptatifs et les documents correspondants des modèles d’enregistrement peuvent évoluer au fil du temps. Vous pouvez choisir d’ajouter, de supprimer ou de modifier des champs sur un formulaire adaptatif ou un modèle de document d’enregistrement.
Lorsque vous apportez des modifications à un modèle de document d’enregistrement et chargez le modèle de document d’enregistrement modifié vers AEM Forms, l’éditeur de formulaires adaptatifs détecte automatiquement les liaisons modifiées et vous informe sur les composants de formulaire adaptatif qui nécessitent de nouvelles liaisons. Il vous permet d’effectuer des mises à jour incrémentielles sur un modèle de document d’enregistrement.
Par exemple, une organisation, We.Retail, possède un modèle de document d’enregistrement basé sur AcroForm, we-retail-facture.pdf. Le modèle ressemble à ce qui suit :
Après avoir utilisé le modèle pendant un certain temps, l’entreprise décide de renommer le champ invoice-number
en champ bill-number
et de capturer l’adresse électronique des acheteurs. Un développeur met à jour le nom du champ invoice-number
et ajoute un champ d’e-mail au modèle. Il crée également une version du modèle appelée we-retail-facture-v2.pdf.
Le développeur charge et applique le modèle mis à jour au formulaire adaptatif. Le formulaire adaptatif détecte et affiche automatiquement la liste des champs où la liaison a changé.
Le développeur de formulaires associe les champs de formulaires adaptatifs au modèle de document d’enregistrement correspondant.
Désormais, lorsque le formulaire adaptatif est envoyé, un document d’enregistrement mis à jour est créé.
Gardez en tête les considérations et les limitations suivantes lorsque vous utilisez un document d’enregistrement pour les formulaires adaptatifs.
Le tableau suivant décrit les composants de formulaire adaptatif et les composants XFA correspondants, et s’ils apparaissent dans un document d’enregistrement.
Composant de formulaire adaptatif | Composant XFA correspondant | Inclus par défaut dans le modèle de document d’enregistrement ? | Remarques |
---|---|---|---|
Bouton | Bouton | false | |
Case à cocher | Case à cocher | true | |
Sélecteur de date | Champ Date/Heure | true | |
Liste déroulante | Liste déroulante | true | |
Signature tactile | Signature tactile | true | |
Zone numérique | Champ numérique | true | |
Zone de mot de passe | Champ Mot de passe | false | |
Bouton radio | Bouton radio | true | |
Zone de texte | Champ de texte | true | |
Bouton de réinitialisation | Bouton de réinitialisation | false | |
Bouton Envoyer | Bouton Envoyer par e-mail Bouton Envoyer via HTTP |
false | |
Termes et conditions | true | ||
Pièce jointe | false | Non disponible dans le modèle de document d’enregistrement. Disponible uniquement dans le document d’enregistrement par pièces jointes. |
Composant de formulaire adaptatif | Composant XFA correspondant | Remarques |
---|---|---|
Panneau |
Sous-formulaire |
Le panneau répétable est mappé à un sous-formulaire répétable. |
Composant de formulaire adaptatif | Composant XFA correspondant | Remarques |
---|---|---|
Image | Image | Qu’ils soient liés ou non, les composants TextDraw et Image s’affichent toujours dans le document d’enregistrement concernant un formulaire adaptatif basé sur XSD, sauf si cela est exclu dans les paramètres de document d’enregistrement. |
Texte | Texte |
Composants tabulaires des formulaires adaptatifs, comme l’en-tête, le pied de page et les lignes associés aux composants XFA correspondants. Vous pouvez mapper des panneaux répétables aux tableaux dans un document d’enregistrement.
Le modèle de base fournit les informations de style et d’aspect du document d’enregistrement. Il vous permet de personnaliser l’aspect par défaut du document d’enregistrement généré automatiquement. Par exemple, vous pouvez utiliser des modèles de base pour ajouter le logo de votre entreprise dans l’en-tête et les informations sur le droit d’auteur dans le pied de page du document d’enregistrement.
Le gabarit de page du modèle de base est utilisé comme gabarit de modèle de document d’enregistrement. Le gabarit de page peut comporter des informations comme l’en-tête, le pied et le numéro de page, que vous pouvez appliquer au document d’enregistrement. Vous pouvez appliquer ces informations au document d’enregistrement à l’aide d’un modèle de base pour générer automatiquement un document d’enregistrement. L’utilisation d’un modèle de base permet de modifier les propriétés par défaut des champs.
Respectez toujours les conventions relatives aux modèles de base lorsque vous créez un modèle de base.
Un modèle de base sert à définir l’en-tête, le pied de page, le style et l’aspect d’un document d’enregistrement. L’en-tête et le pied de page peuvent comporter des informations, comme le logo de l’entreprise et la mention de droit d’auteur. Le premier gabarit de page du modèle de base est copié et utilisé comme gabarit de page du document d’enregistrement. Il contient l’en-tête, le pied de page, le numéro de page et toute autre information devant figurer sur toutes les pages du document d’enregistrement. Même si vous utilisez un modèle de base non conforme aux conventions en matière de modèles de base, le premier gabarit de page du modèle de base est utilisé dans le modèle de document d’enregistrement. Il est vivement recommandé de créer votre modèle de base en fonction des conventions correspondantes et de l’utiliser pour générer automatiquement un document d’enregistrement.
Conventions en matière de gabarits de page
Dans le modèle de base, vous devriez nommer le sous-formulaire racine AF_METATEMPLATE
et le gabarit de page AF_MASTERPAGE
.
Le gabarit de page « AF_MASTERPAGE
» et situé sous le sous-formulaire racine AF_METATEMPLATE
est privilégié pour extraire les informations sur l’en-tête, le pied de page et le style.
En l’absence de gabarit de page AF_MASTERPAGE
, le premier gabarit de page présent dans le modèle de base est utilisé.
Conventions an matière de style des champs
Pour appliquer un style aux champs du document d’enregistrement, le modèle de base fournit les champs situés dans le sous-formulaire AF_FIELDSSUBFORM
sous le sous-formulaire racine AF_METATEMPLATE
.
Les propriétés de ces champs sont appliquées aux champs du document d’enregistrement. Ces champs doivent respecter la convention d’affectation des noms de AF_<name of field in all caps>_XFO
. Par exemple, le champ contenant une case à cocher doit être nommé AF_CHECKBOX_XFO
.
Pour créer un modèle de base, procédez comme suit dans Forms Designer.
Cliquez sur Fichier > Nouveau.
Sélectionnez l’option Basé sur un modèle.
Sélectionnez la catégorie Forms - Document d’enregistrement.
Sélectionnez Modèle de base de DE.
Cliquez sur Suivant et renseignez les informations nécessaires.
(Facultatif) Modifiez le style et l’aspect à appliquer aux champs du document d’enregistrement.
Enregistrez le formulaire.
Vous pouvez maintenant utiliser le formulaire enregistré comme modèle de base de document d’enregistrement. Ne modifiez ou ne supprimez aucun des scripts du modèle de base.
Modification du modèle de base
Respectez rigoureusement les conventions et instructions mentionnées ci-dessus pour concevoir un modèle de base.
Lors de la génération d’un document d’enregistrement, vous pouvez modifier les informations d’identité graphique pour le document d’enregistrement sous l’onglet Document d’enregistrement. L’onglet Document d’enregistrement inclut des options telles que le logo, l’apparence, la mise en page, l’en-tête et le pied de page, la clause de non-responsabilité et si vous souhaitez inclure des options de case à cocher et de bouton radio désélectionnées.
Pour localiser les informations de branding que vous saisissez dans l’onglet Document d’enregistrement, assurez-vous que le paramètre régional du navigateur est défini correctement. Pour personnaliser les informations d’identité graphique du document d’enregistrement, suivez les étapes suivantes :
Sélectionnez un panneau (panneau racine) dans le document d’enregistrement, puis appuyez sur .
Appuyez sur . L’onglet Document d’enregistrement s’affiche.
Sélectionnez le modèle par défaut ou un modèle personnalisé pour le rendu du document d’enregistrement. Si vous sélectionnez le modèle par défaut, une vignette d’aperçu du document d’enregistrement s’affiche sous la liste déroulante Modèle.
Si vous sélectionnez un modèle par défaut ou un modèle personnalisé, une partie ou la totalité des propriétés suivantes s’affichent sous l’onglet Document d’enregistrement. Spécifiez les propriétés mentionnées ci-dessous pour définir l’apparence du document d’enregistrement :
Propriétés de base :
Propriétés des champs de formulaire :
Propriétés du gabarit de page :
Si vous utilisez un modèle de formulaire adaptatif créé avec une version de Designer antérieure à la version 6.3, pour que les propriétés Couleur d’accentuation et Famille de polices fonctionnent, assurez-vous de la présence des éléments suivants dans votre modèle de formulaire adaptatif sous le sous-formulaire racine :
<proto>
<font typeface="Arial"/>
<fill>
<color value="4,166,203"/>
</fill>
<edge>
<color value="4,166,203"/>
</edge>
</proto>
Pour enregistrer les modifications d’identité graphique, appuyez sur Terminé.
Vous pouvez configurer le modèle Document d’enregistrement directement à partir de l’éditeur de formulaire adaptatif ou de l’éditeur de modèle de formulaire adaptatif.
Effectuez les étapes suivantes à partir de l’instance d’auteur de l’éditeur de formulaire adaptatif :
Sélectionnez le composant Conteneur de formulaires adaptatifs (racine).
Cliquez sur l’ pour ouvrir les Propriétés du conteneur de formulaires adaptatifs.
Ouvrez l’onglet Modèle de document d’enregistrement et sélectionnez l’une des options suivantes :
Aucun : lorsque cette option est sélectionnée, aucun modèle de document d’enregistrement n’est créé pour votre formulaire adaptatif.
Associer un modèle de formulaire comme modèle de document d’enregistrement : lorsque cette option est sélectionnée, le formulaire XFA est utilisé comme modèle de document d’enregistrement.
Générer un document d’enregistrement : lorsque cette option est sélectionnée, le modèle de document d’enregistrement est généré automatiquement pour votre formulaire adaptatif.
Appuyez sur pour enregistrer les propriétés.
Lorsque le modèle de document d’enregistrement est créé à l’aide d’un éditeur de modèle de formulaire adaptatif, seules deux options sont disponibles sous l’onglet Modèle de document d’enregistrement : Aucun et Générer un document d’enregistrement.
Votre formulaire adaptatif peut être étendu, avec plusieurs champs de formulaire. Vous ne pouvez pas enregistrer un document d’enregistrement comme copie exacte du formulaire adaptatif. Vous pouvez maintenant choisir une mise en page de tableau ou de colonne pour enregistrer un ou plusieurs panneaux de formulaires adaptatifs dans le document d’enregistrement PDF.
Avant de générer un document d’enregistrement, dans les paramètres d’un panneau, sélectionnez Tableau ou Colonne pour Mise en page du document d’enregistrement pour ce panneau. Les champs du panneau sont organisés en conséquence dans le document d’enregistrement.
Champs dans un panneau rendu dans une mise en page Tableau dans le document d’enregistrement
Champs dans un panneau rendu dans une mise en page Colonne dans le document d’enregistrement
Les paramètres d’un document d’enregistrement permettent de sélectionner les options à inclure dans le document d’enregistrement. Par exemple, une banque accepte le nom, l’âge, le numéro de sécurité sociale et le numéro de téléphone dans un formulaire. Le formulaire génère un numéro de compte bancaire et les détails de la banque. Vous pouvez choisir de n’afficher que le nom, le numéro de sécurité sociale, le compte bancaire et les informations bancaires dans le document d’enregistrement.
Les paramètres du composant Document d’enregistrement sont disponible sous ses propriétés. Pour accéder aux propriétés d’un composant, sélectionnez le composant et cliquez sur dans le recouvrement. Les propriétés sont répertoriées dans la barre latérale. Vous y trouvez les paramètres suivants.
Paramètres sur le terrain
Exclure du document d’enregistrement : la définition de cette propriété sur true exclut le champ du document d’enregistrement. Il s’agit d’une propriété pouvant faire l’objet d’un script appelée « excludeFromDoR
». Son comportement dépend de la propriété au niveau du formulaire Exclure des champs du document d’enregistrement (DE) s’il est masqué.
Afficher le panneau sous forme de tableau : la définition de cette propriété affiche le panneau sous forme de tableau dans le document d’enregistrement s’il comporte moins de 6 champs. Applicable au panneau uniquement.
Exclure le titre du document d’enregistrement : la définition de la propriété exclut le titre du panneau/tableau du document d’enregistrement. Applicable au panneau et à la table uniquement.
Exclure la description du document d’enregistrement : la définition de la propriété exclut la description du panneau/tableau du document d’enregistrement. Applicable au panneau et à la table uniquement.
Paramètres des niveaux de formulaires
Un fichier XCI permet de définir différentes propriétés d’un document. Forms as a Cloud Service comporte un fichier XCI maître. Vous pouvez utiliser un fichier XCI personnalisé pour remplacer une ou plusieurs propriétés par défaut spécifiées dans le fichier XCI maître. Par exemple, vous pouvez choisir d’incorporer une police dans un document ou d’activer la propriété balisée pour tous les documents. Le tableau suivant indique les options XCI :
Option XCI | Description |
---|---|
config/present/pdf/creator | Identifie le créateur du document à l’aide de l’entrée Créateur du dictionnaire d’informations sur le document. Pour plus d’informations sur ce dictionnaire, consultez le guide de référence PDF. |
config/present/pdf/producer | Identifie le producteur du document à l’aide de l’entrée Producteur du dictionnaire d’informations sur le document. Pour plus d’informations sur ce dictionnaire, consultez le guide de référence PDF. |
config/present/layout | Contrôle si la sortie est un panneau unique ou si elle est paginée. |
config/present/pdf/compression/level | Indique le degré de compression à utiliser lors de la génération d’un document PDF. |
config/present/pdf/fontInfo/embed | Contrôle l’incorporation des polices dans le document de sortie. |
config/present/pdf/scriptModel | Contrôle si des informations spécifiques à XFA sont incluses dans le document PDF de sortie. |
config/present/common/data/adjustData | Contrôle si l’application XFA ajuste les données après la fusion. |
config/present/pdf/renderPolicy | Contrôle si la génération du contenu de la page est effectuée sur le serveur ou différée au client. |
config/present/common/locale | Spécifie le paramètre régional par défaut utilisé dans le document de sortie. |
config/present/destination | Lorsque contenu par un élément présent, indique le format de sortie. Lorsqu’il est contenu par un élément openAction, spécifie l’action à effectuer lors de l’ouverture du document dans un client interactif. |
config/present/output/type | Spécifie le type de compression à appliquer à un fichier ou le type de sortie à produire. |
config/present/common/temp/uri | Spécifie l’URI du formulaire. |
config/present/common/template/base | Fournit un emplacement de base pour les URI dans le design de formulaire. Lorsque cet élément est absent ou vide, l’emplacement du design de formulaire est utilisé comme base. |
config/present/common/log/to | Contrôle l’emplacement dans lequel les données du journal ou les données de sortie sont écrites. |
config/present/output/to | Contrôle l’emplacement dans lequel les données du journal ou les données de sortie sont écrites. |
config/present/script/currentPage | Indique la page initiale à l’ouverture du document. |
config/present/script/exclude | Informe Forms as a Cloud Service des événements à ignorer. |
config/present/pdf/linearized | Contrôle si le document PDF de sortie est linéarisé. |
config/present/script/runScripts | Contrôle l’ensemble de scripts que Forms as a Cloud Service exécute. |
config/present/pdf/tagged | Contrôle l’inclusion de balises dans le document PDF de sortie. Les balises, dans le contexte d’un PDF, sont des informations supplémentaires incluses dans un document afin d’exposer la structure logique du document. Les balises aident à l’accessibilité et au reformatage. Par exemple, un numéro de page peut être balisé en tant qu’artefact afin qu’un lecteur d’écran ne l’indique pas au milieu du texte. Bien que les balises rendent un document plus utile, elles augmentent également sa taille et le temps de traitement pour le créer. |
config/present/pdf/fontInfo/alwaysEmbed | Spécifie une police incorporée dans le document de sortie. |
config/present/pdf/fontInfo/neverEmbed | Spécifie une police qui ne doit jamais être incorporée dans le document de sortie. |
config/present/pdf/pdfa/part | Spécifie le numéro de version de la spécification PDF/A à laquelle le document est conforme. |
config/present/pdf/pdfa/amd | Spécifie le niveau de modification de la spécification PDF/A. |
config/present/pdf/pdfa/conformance | Spécifie le niveau de conformité avec la spécification PDF/A. |
config/present/pdf/version | Spécifie la version du document PDF à générer |
config/present/pdf/version/map | Spécifie les polices de secours pour le document. |
Ajoutez le fichier XCI personnalisé à votre projet de développement.
Spécifiez les propriété intégrée suivantes :
{
"xciFilePath": "[path of XCI file]"
}
Par exemple,
{
"xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
}
Déployez le projet dans votre environnement Cloud Service.