Générer un document d’enregistrement pour les formulaires adaptatifs

Présentation

Après l’envoi d’un formulaire, vos clients veulent généralement conserver un enregistrement, sous forme imprimée ou en tant que document, des informations qu’ils ont intégrées au formulaire à des fins de référence ultérieure. On parle ici de document d’enregistrement.

Cet article explique comment vous pouvez générer un document d’enregistrement pour les formulaires adaptatifs.

Types de formulaire adaptatif et leurs documents d’enregistrement

Lorsque vous créez un formulaire adaptatif, vous pouvez sélectionner un modèle de formulaire. Vous avez le choix entre :

• Modèles de formulaire Vous permet de sélectionner un modèle XFA pour votre formulaire adaptatif. Lorsque vous sélectionnez un modèle XFA, vous pouvez utiliser le fichier XDP associé pour le document d’enregistrement, comme décrit ci-dessus.

• Schéma XML Vous permet de sélectionner une définition de schéma XML pour votre formulaire adaptatif. Lorsque vous sélectionnez un schéma XML pour votre formulaire adaptatif, vous pouvez :

  • Associer un modèle XFA pour créer un document d’enregistrement. Assurez-vous que ce modèle XFA associé utilise le même schéma XML que votre formulaire adaptatif.
  • Générer automatiquement le document d’enregistrement

• Aucun Vous permet de créer un formulaire adaptatif sans modèle de formulaire. Le document d’enregistrement est généré automatiquement pour votre formulaire adaptatif.

Lorsque vous sélectionnez un modèle de formulaire, configurez le document d’enregistrement à l’aide des options disponibles sous Configuration du modèle de Document d’enregistrement. Voir Configuration du modèle de Document d'enregistrement.

Document d’enregistrement automatiquement généré

Un document d’enregistrement permet aux clients de conserver une copie du formulaire envoyé en vue de son impression. Lorsque vous générez automatiquement un document d’enregistrement, chaque fois que vous modifiez votre formulaire, son document d’enregistrement est immédiatement mis à jour. Par exemple, imaginons que vous supprimez le champ relatif à l’âge pour les clients qui sélectionnent Etats-Unis comme leur pays. Lorsque ces clients génèrent un document d’enregistrement, le champ relatif à l’âge ne leur est pas accessible.

Le document d’enregistrement généré automatiquement présente les avantages suivants :

• Il prend en charge la liaison de données.
• Elle masque automatiquement les champs marqués comme exclus du document d’enregistrement au moment de l’envoi. Aucune opération supplémentaire n’est requise.
• Cela permet de gagner du temps lors de la conception d’un modèle de document d’enregistrement.
• Il vous permet de tester des styles et des aspects différents à l’aide de divers modèles de base et de sélectionner les meilleurs style et aspect pour le document d’enregistrement. L’utilisation de styles est facultative. Si vous ne spécifiez aucun style, les styles du système sont définis comme valeur par défaut.
• De cette façon, toute modification appliquée au formulaire se répercute immédiatement dans le document d’enregistrement.

Composants de génération automatique de document d’enregistrement

Pour générer un document d’enregistrement pour les formulaires adaptatifs, vous avez besoin des composants suivants :

Formulaire adaptatifFormulaire adaptatif pour lequel vous souhaitez générer un document d’enregistrement.

Modèle de base (recommandé)Modèle XFA (fichier XDP) créé dans AEM Designer. Le modèle de base permet de spécifier les informations de style et de marque pour le modèle de document d’enregistrement.

Voir Modèle de base d'un document d'enregistrement

Document du modèle d’enregistrementModèle XFA (fichier XDP) généré à partir d’un formulaire adaptatif.

Voir Configuration du modèle de Document d'enregistrement.

Données du formulaireInformations renseignées par un utilisateur dans le formulaire adaptatif. Il fusionne avec le modèle document d’enregistrement pour générer le document d’enregistrement.

Mappage des éléments du formulaire adaptatif

Les sections suivantes décrivent l’apparence des éléments du formulaire adaptatif dans un document d’enregistrement.

Champs

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	Date/Heure	true
Liste déroulante	Liste déroulante	true
Signature tactile	Signature tactile	true
Champ numérique	Champ numérique	true
Champ de mot de passe	Champ Mot de passe	false
Bouton radio	Bouton radio	true
Zone de texte	Champ de texte	true
Bouton Réinitialiser	Bouton Réinitialiser	false
Bouton Envoyer	Bouton Envoyer par messagerie Bouton Envoyer via HTTP	false
Conditions d’utilisation		true
Pièce jointe		false	Non disponible dans le modèle document d’enregistrement. Disponible uniquement dans le document d'enregistrement par le biais de pièces jointes.

Conteneurs

Composant de formulaire adaptatif	Composant XFA correspondant	Remarques
Panneau	Sous-formulaire	Le panneau répétable se mappe au sous-formulaire répétable.

Composants statiques

Composant de formulaire adaptatif	Composant XFA correspondant	Remarques
Image	Image	Les composants TextDraw et Image, qu’ils soient liés ou non, apparaissent toujours dans le document d’enregistrement d’un formulaire adaptatif XSD, sauf si ils sont exclus à l’aide des paramètres de document d’enregistrement.
Text (Texte)	Text (Texte)

Tables

Composants tabulaires des formulaires adaptatifs (en-tête, pied de page et lignes) associés aux composants XFA correspondants. Vous pouvez mapper des panneaux répétables aux tableaux dans un document d’enregistrement.

Modèle de base d’un document d’enregistrement

Le modèle de base fournit les informations relatives au style et à l’aspect du document d’enregistrement. Vous pouvez ainsi personnaliser l’aspect par défaut du document d’enregistrement généré automatiquement. Imaginons que vous souhaitez ajouter le logo de votre entreprise dans l’en-tête et les informations relatives au droit d’auteur dans le pied de page du document d’enregistrement. Le gabarit du modèle de base est utilisé comme gabarit de modèle de document d’enregistrement. Le gabarit peut comporter des informations telles que 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 du modèle de base pour la génération automatique du document d’enregistrement. L’utilisation d’un modèle de base vous permet de modifier les propriétés par défaut des champs.

Respectez les conventions relatives aux modèles de base lorsque vous créez un modèle de base.

Conventions relatives aux modèles 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 inclure des informations telles que le logo de l’entreprise et le texte de droit d’auteur. Le premier gabarit du modèle de base est copié et utilisé comme gabarit pour le document d’enregistrement, qui contient l’en-tête, le pied de page, le numéro de page ou toute autre information qui doit apparaître sur toutes les pages du document d’enregistrement. Si vous utilisez un modèle de base qui n’est pas conforme aux conventions relatives aux modèles de base, le premier gabarit du modèle de base est toujours utilisé dans le modèle de document d’enregistrement. Il vous est fortement recommandé de créer votre modèle de base en fonction des conventions correspondantes et de l’utiliser pour la génération automatique du document d’enregistrement.

Conventions relatives aux gabarits

• Dans le modèle de base, vous devez nommer le sous-formulaire racine AF_METATEMPLATE et le gabarit AF_MASTERPAGE.

• Le gabarit portant le nom AF_MASTERPAGE situé sous le sous-formulaire racine AF_METATEMPLATE est préféré pour extraire les informations d’en-tête, de pied de page et de mise en forme.

• En l’absence de gabarit AF_MASTERPAGE, le premier gabarit présent dans le modèle de base est utilisé.

Conventions relatives au 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 de nom AF_<name of field in all caps>_XFO. Par exemple, le nom du champ de la case à cocher doit être AF_CHECKBOX_XFO.

Pour créer un modèle de base, procédez comme suit dans AEM Designer.

1. Cliquez sur Fichier > Nouveau.

2. Sélectionnez l’option Basé sur un modèle.

3. Choisissez la catégorie Formulaires - Document d’enregistrement.

4. Sélectionnez Modèle de base de DE.

5. Cliquez sur Suivant et renseignez les informations requises.

6. (Facultatif) Modifiez le style et l’aspect que vous souhaitez appliquer aux champs du document d’enregistrement.

7. Enregistrez le formulaire.

Vous pouvez désormais utiliser le formulaire enregistré comme modèle de base de document d’enregistrement.
Ne modifiez ou ne supprimez aucun script du modèle de base.

Modification du modèle de base

• Si vous n’appliquez aucun style aux champs du modèle de base, il est recommandé de les supprimer afin que toutes les mises à niveau du modèle de base soient automatiquement reportées.
• Lors de la modification du modèle de base, ne supprimez, n’ajoutez ou ne modifiez pas les scripts.

Configuration du modèle de document d’enregistrement

Configurez le modèle de document d’enregistrement de votre formulaire pour permettre à vos clients de télécharger une copie imprimable du formulaire envoyé. Un fichier XDP sert de modèle de document d’enregistrement. Le document d’enregistrement téléchargé par les clients est formaté en fonction de la mise en page spécifiée dans le fichier XDP.

Effectuez les étapes suivantes pour configurer un document d’enregistrement pour les formulaires adaptatifs :

1. Dans l’instance d’auteur AEM, cliquez sur formulaires > Formulaires et documents.

2. Sélectionnez un formulaire, puis cliquez sur Afficher les propriétés.

3. Dans la fenêtre Propriétés, appuyez sur Modèle de formulaire.
   Vous pouvez également sélectionner un modèle de formulaire lorsque vous créez un formulaire.

   REMARQUE

   Dans l’onglet Modèle de formulaire, veillez à sélectionner **Schéma ** ou Aucun dans la liste déroulante Sélectionner dans. Le document d’enregistrement n’est pas pris en charge pour les formulaires XFA ou les formulaires adaptatifs avec modèle de formulaire comme modèle de formulaire.

4. Dans la section Configuration du modèle de document d’enregistrement de l’onglet Modèle de formulaire, sélectionnez l’une des options suivantes :

   ​​AucunSélectionnez cette option si vous ne souhaitez pas configurer le document d’enregistrement pour le formulaire.

   Associer un modèle de formulaire en tant que modèle de Document d'enregistrement Sélectionnez cette option si vous disposez d'un fichier XDP que vous souhaitez utiliser comme modèle pour le document d'enregistrement. Lorsque vous sélectionnez cette option, tous les fichiers XDP disponibles dans le référentiel AEM Forms s’affichent. Sélectionnez le fichier approprié.

   Le fichier XDP sélectionné est associé au formulaire adaptatif.

   Générer un Document d' enregistrementSélectionnez cette option pour utiliser un fichier XDP comme modèle de base pour définir le style et l'aspect du document d'enregistrement. Lorsque vous sélectionnez cette option, tous les fichiers XDP disponibles dans le référentiel AEM Forms s’affichent. Sélectionnez le fichier approprié.

   REMARQUE

   Assurez-vous que le schéma utilisé pour créer le formulaire adaptatif et le schéma (schéma de données) du formulaire XFA sont identiques si :

   • Votre formulaire adaptatif est basé sur un schéma
   • Vous utilisez Associer le modèle de formulaire comme option de modèle de Document d’enregistrement pour le document d’enregistrement

5. Cliquez sur Terminé.

Personnaliser les informations d’identité graphique d’un document d’enregistrement

Lors de la génération d’un document d’enregistrement, vous pouvez modifier les informations d’identité graphique pour le document d’enregistrement dans 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 d’identité graphique que vous saisissez dans l’onglet Document d’enregistrement, vous devez vous assurer que le paramètre régional du navigateur est défini correctement. Pour personnaliser les informations d’identité graphique du document d’enregistrement, procédez comme suit :

1. Sélectionnez un panneau (panneau racine) dans le document d’enregistrement, puis appuyez sur .

2. Appuyez sur . L’onglet Document d’enregistrement apparaît.

3. 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 apparaît sous la liste déroulante Modèle.

   

   Si vous choisissez de sélectionner un modèle personnalisé, sélectionnez un fichier XDP sur votre serveur AEM Forms. Si vous souhaitez utiliser un modèle qui n’est pas sur votre serveur AEM Forms, vous devez au préalable télécharger le fichier XDP sur votre serveur AEM Forms.

4. Si vous sélectionnez un modèle par défaut ou un modèle personnalisé, certaines ou toutes les propriétés suivantes apparaissent dans l’onglet Document d’enregistrement. Spécifiez-les en conséquence :

   • Image du logo : vous pouvez choisir d’utiliser l’image du logo à partir du formulaire adaptatif, en choisir une dans le gestionnaire des actifs numériques ou en télécharger une depuis votre ordinateur.
   • Titre du formulaire
   • Texte d’en-tête
   • Libellé de cause de non-responsabilité
   • Clause de non-responsabilité
   • Texte de la clause de non-responsabilité
   • Couleur d’accentuation : la couleur dans laquelle le texte de l’en-tête et les lignes de séparation sont affichées dans le document ou l’enregistrement PDF
   • Famille de polices : la famille de polices du texte dans le document d’enregistrement PDF
   • Pour les composants de case à cocher et de bouton radio, afficher uniquement les valeurs sélectionnées
   • Séparateur pour plusieurs valeurs sélectionnées
   • Inclure les objets de formulaire qui ne sont pas associés à un modèle de données
   • Exclure les champs masqués du document d’enregistrement
   • Masquer la description des panneaux
   REMARQUE

   Si vous utilisez un modèle de formulaire adaptatif créé avec une version de Designer antérieure à 6.3, pour que les propriétés Couleur d’accentuation et Famille de polices fonctionnent, assurez-vous que les éléments suivants sont présents 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>
   

5. Pour enregistrer les modifications d’identité graphique, appuyez sur Terminé.

Mises en page de tableau et de colonne pour les panneaux d’un document d’enregistrement

Votre formulaire adaptatif peut être long avec plusieurs champs de formulaire. Vous ne pouvez pas enregistrer un document d’enregistrement en tant que 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 de tableau dans le document d’enregistrement

Champs dans un panneau rendu dans une mise en page de colonne dans le document d’enregistrement

Paramètres des documents d’enregistrement

Les paramètres de document d’enregistrement vous permettent de choisir les options à inclure dans le document d’enregistrement. Par exemple, une banque accepte les informations suivantes dans un formulaire : nom, âge, numéro de sécurité sociale et numéro de téléphone. Le formulaire génère un numéro de compte bancaire et les informations sur la banque. Vous pouvez choisir de n’afficher que le nom, le numéro de sécurité sociale, le compte bancaire et les informations sur la banque dans le document d’enregistrement.

Le document des paramètres d’enregistrement d’un composant est disponible sous ses propriétés. Pour accéder aux propriétés d’un composant, sélectionnez le composant et cliquez sur dans l’incrustation. 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 la propriété affiche le panneau sous forme de tableau en document d’enregistrement si le panneau 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

• Inclure les champs non liés dans le document d’enregistrement : la définition de la propriété comprend les champs non liés du schéma basé sur le formulaire adaptatif du document d’enregistrement. Par défaut, le paramètre est true.
• Exclure des champs du document d’enregistrement (DE) s’il est masqué : La définition de cette propriété remplace le comportement de la propriété de niveau de champ Exclure du document d’enregistrement lorsque le paramètre est différent de true. Si les champs sont masqués au moment de l’envoi du formulaire, ils seront exclus du document d’enregistrement si la propriété est définie sur true, à condition que la propriété "Exclure du Document d’enregistrement" ne soit pas définie.

Considérations essentielles lors de l’utilisation de documents d’enregistrement

Gardez à l’esprit les points et limitations suivants lorsque vous travaillez sur un document d’enregistrement pour les formulaires adaptatifs.

• Le document des modèles d’enregistrement ne prend pas en charge le texte enrichi. Par conséquent, tout texte enrichi dans le formulaire adaptatif statique ou dans les informations renseignées par l’utilisateur final est remplacé par du texte brut dans le document d’enregistrement.
• Les fragments de document contenus dans un formulaire adaptatif n’apparaissent pas dans le document d’enregistrement. Les fragments de formulaire adaptatif sont toutefois pris en charge.
• La liaison de contenu dans le document de l’enregistrement généré pour le formulaire adaptatif de schéma XML n’est pas prise en charge.
• La version localisée du document d’enregistrement est créée sur demande pour un paramètre régional lorsque l’utilisateur demande le rendu du document d’enregistrement. La localisation du document d’enregistrement est effectuée en même temps que la localisation du formulaire adaptatif. Pour plus d’informations sur la localisation du document d’enregistrement et des formulaires adaptatifs, voir Utilisation de processus de traduction AEM pour la localisation des formulaires adaptatifs et du document d’enregistrement.