Fragments de formulaire adaptatif adaptive-form-fragments

Version
Lien de l’article
AEM as a Cloud Service
Cliquez ici
AEM 6.5
Cet article

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.

Bien que chaque formulaire soit conçu pour un rôle spécifique, certains segments sont communs à la plupart des formulaires, comme les informations personnelles telles que le nom et l’adresse, les informations relatives à la famille et aux revenus. Les développeurs et développeuses de formulaires doivent créer ces segments communs chaque fois qu’un nouveau formulaire est créé.

Les formulaires adaptatifs incluent un mécanisme pratique pour créer un segment de formulaire, comme un panneau ou un groupe de champs, une seule fois et le réutiliser dans des formulaires adaptatifs. Ces segments réutilisables et autonomes s’appellent des fragments de formulaire adaptatif.

NOTE
Vous pouvez facilement personnaliser votre expérience de fragment pour les utilisateurs et utilisatrices qui utilisent la boîte de dialogue de configuration et la boîte de dialogue de conception d’un composant Fragment de formulaire.

Création d’un fragment create-a-fragment

Vous pouvez créer un fragment de formulaire adaptatif à partir de zéro ou enregistrer un panneau dans un formulaire adaptatif existant en tant que fragment.

Création d’un fragment à partir de zéro create-fragment-from-scratch

  1. Connectez-vous à l’instance d’auteur d’AEM Forms à l’adresse https://[nom_hôte]:[port]/aem/forms.html.

  2. Cliquez sur Créer > Fragment de formulaire adaptatif.

  3. Indiquez le titre, le nom, la description et les balises du fragment.

    note note
    NOTE
    Assurez-vous de spécifier un nom unique pour le fragment. S’il existe un autre fragment portant le même nom, la création du fragment échoue.
  4. Cliquez pour ouvrir l’onglet Modèle de formulaire, puis dans le menu déroulant Choisir parmi, sélectionnez l’un des modèles de fragment suivants :

    • Aucun  : indique que le fragment doit être créé de zéro sans utiliser de modèle de formulaire.

      note note
      NOTE
      Dans les formulaires adaptatifs basés sur les composants principaux, vous pouvez utiliser plusieurs fois un fragment de formulaire unique dans un formulaire. Il prend en charge les fragments de formulaire basés sur des schémas et sans modèle.
    • Modèle de formulaire  : indique que le fragment doit être créé à l’aide d’un modèle XDP chargé dans AEM Forms. Sélectionnez le modèle XDP correspondant en tant que modèle de formulaire pour le fragment.

    Création d’un formulaire adaptatif avec le modèle de formulaire comme modèle

    Les sous-formulaires marqués comme fragments dans le modèle de formulaire sélectionné sont également affichés. Vous pouvez sélectionner un sous-formulaire comme fragment de formulaire adaptatif dans la liste déroulante.

    Sélection de sous-formulaires à partir d’un modèle de formulaire spécifié

    En outre, vous pouvez créer un fragment de formulaire adaptatif en utilisant les sous-formulaires qui ne sont pas marqués comme des fragments dans le modèle de formulaire en spécifiant l’expression SOM du sous-formulaire dans la liste déroulante.

    • Schéma XML  : indique de créer un fragment à partir d’un schéma XML téléchargé dans l’AEM Forms. Vous pouvez charger ou sélectionner l’un des schémas XML comme modèle de formulaire pour le fragment.

    Création d’un fragment de formulaire adaptatif basé sur un schéma XML comme modèle

    Vous pouvez également créer un fragment de formulaire adaptatif en choisissant un type complexe présent dans le schéma sélectionné dans la liste déroulante.

    Sélection d’un type complexe dans le modèle de schéma XML spécifié

  5. Cliquez sur Créer puis sur Ouvrir pour ouvrir le fragment, avec un modèle par défaut, en mode d’édition.

En mode d’édition, vous pouvez faire glisser tout composant de formulaire adaptatif depuis le panneau latéral AEM sur le fragment. Pour plus d’informations sur les composants des formulaires adaptatifs, consultez la section Introduction à la création de formulaires adaptatifs.

En outre, si vous avez sélectionné un modèle de schéma XML ou de formulaire XDP comme modèle de formulaire pour votre fragment, un nouvel onglet affichant la hiérarchie des modèles de formulaire apparaît dans l’outil de recherche de contenu. Il vous permet de faire glisser des éléments du modèle de formulaire sur le fragment. Les éléments de modèle de formulaire ajoutés sont convertis en composants de formulaire tout en conservant les propriétés d’origine du modèle XDP ou XSD associé.

Enregistrement du panneau en tant que fragment save-panel-as-a-fragment

  1. Ouvrez un formulaire adaptatif qui contient le panneau que vous voulez enregistrer en tant que fragment de formulaire adaptatif.

  2. Dans la barre d’outils du panneau, cliquez sur Enregistrer en tant que fragment. La boîte de dialogue Enregistrer en tant que fragment s’ouvre.

    note note
    NOTE
    Si le panneau que vous enregistrez en tant que fragment contient le panneau enfant, le fragment obtenu les inclut.
  3. Dans la boîte de dialogue de création de fragment, spécifiez les informations suivantes :

    • Nom  : nom du fragment. La valeur par défaut est le nom de l’élément du panneau. Ce champ est obligatoire.

      note note
      NOTE
      Assurez-vous de spécifier un nom unique pour le fragment. S’il existe un autre fragment portant le même nom, la création du fragment échoue.
    • Titre  : titre du fragment. La valeur par défaut est le titre du panneau.

    • Description  : description du fragment.

    • Balises  : métadonnées de balises de fragment.

    • Tracé de destination  : chemin d’accès au référentiel où le fragment est enregistré. Si vous ne spécifiez pas de chemin d’accès, un nœud portant le même nom que celui du fragment est créé à côté du nœud contenant le formulaire adaptatif. Le fragment est enregistré dans ce nœud.

    • Modèle de formulaire  : selon le modèle de formulaire pour le formulaire adaptatif, ce champ affiche le schéma XML,modèle de formulaire ou aucun. Ce champ n’est pas modifiable.

    • Racine du modèle de fragment  : s’affiche uniquement dans les formulaires adaptatifs XSD. Cette action spécifie la racine du modèle de fragment. Vous pouvez choisir / ou le type complexe de schéma XSD dans la liste déroulante. Vous ne pouvez réutiliser le fragment dans un autre formulaire adaptatif que si vous avez sélectionné le type complexe sous forme de fragment racine du modèle.
      Si vous choisissez / comme racine du modèle de fragment, l’arborescence complète de schéma XSD depuis la racine est visible dans l’onglet de modèle de données de formulaire adaptatif. Pour une racine de modèle de fragment de type complexe, seuls les descendants du type complexe sélectionné sont visibles dans l’onglet du modèle de données de formulaire adaptatif. Si vous créez un fragment et choisissez un type complexe comme Racine du modèle de fragment, vous pouvez l’utiliser partout où ce type complexe est utilisé, que ce soit dans le même formulaire ou dans plusieurs formulaires.

    • Référence de schéma XSD  : s’affiche uniquement dans les formulaires adaptatifs XSD. Il indique l’emplacement du schéma XML.

    • Référence XDP  : s’affiche uniquement dans les formulaires adaptatifs basés sur XDP. Il indique l’emplacement du modèle de formulaire XDP.

    save-fragment

    Boîte de dialogue Enregistrer sous forme de fragment

  4. Cliquez sur OK.

    Le panneau est enregistré à l’emplacement spécifié ou à l’emplacement par défaut dans le référentiel. Dans le formulaire adaptatif, le panneau est remplacé par un instantané du fragment. Comme illustré ci-dessous, le panneau Informations générales et ses panneaux enfants, Informations personnelles et Adresse, sont enregistrés en tant que fragment.

    Pour modifier le fragment, cliquez sur Modifier la ressource dans la barre d’outils du panneau. Le fragment s’ouvre dans un nouvel onglet ou une nouvelle fenêtre en mode d’édition.

    Modification d’un fragment

Utilisation des fragments working-with-fragments

Configurer l’aspect du fragment configure-fragment-appearance

Tout fragment que vous insérez dans les formulaires adaptatifs s’affiche en image d’espace réservé. L’espace réservé affiche les titres jusqu’à un maximum de dix panneaux enfants dans le fragment. Vous pouvez configurer AEM Forms de manière à afficher le fragment complet à la place de l’image d’espace réservé.

Effectuez les étapes suivantes pour afficher les fragments complets dans les formulaires :

  1. Accédez à la page de configuration de la console web AEM à l’adresse https:[hôte]:[port]/system/console/configMgr.

  2. Recherchez et sélectionnez Configuration du canal web du formulaire adaptatif et de la communication interactive pour l’ouvrir en mode d’édition.

  3. Décochez la case Activer l’espace réservé à la place du fragment pour afficher les fragments complets plutôt que l’image d’espace réservé.

Insérer un fragment dans un formulaire adaptatif insert-a-fragment-in-an-adaptive-form

Les fragments de formulaire adaptatif créés apparaissent dans l’onglet Fragments de formulaire adaptatif de l’outil de recherche de contenu AEM. Pour insérer un fragment de formulaire adaptatif dans un formulaire adaptatif :

  1. Ouvrez le formulaire adaptatif, en mode d’édition, dans lequel vous souhaitez insérer un fragment de formulaire adaptatif.

  2. Cliquez sur Actifs assets-browser dans la barre latérale. Dans le navigateur d’actifs, sélectionnez Fragments de formulaire adaptatif dans la liste déroulante.

    Vous pouvez également choisir d’afficher tous les fragments de formulaire adaptatif ou de les filtrer en fonction du modèle de formulaire : modèle de formulaire, schéma XML ou de base.

  3. Faites glisser un fragment de formulaire adaptatif sur le formulaire adaptatif.

    note note
    NOTE
    Le fragment de formulaire adaptatif ne peut pas être créé au sein même du formulaire adaptatif. De plus, vous ne pouvez pas utiliser un fragment basé sur XSD dans un formulaire adaptatif basé sur JSON et inversement.

Le fragment de formulaire adaptatif est inséré par référence dans le formulaire adaptatif et synchronisé avec le fragment autonome du formulaire adaptatif. Cela signifie que lorsque vous mettez à jour le fragment de formulaire adaptatif, les modifications sont répercutées dans tous les formulaires adaptatifs où le fragment est utilisé.

Incorporer un fragment dans un formulaire adaptatif embed-a-fragment-in-adaptive-form

Vous pouvez choisir d’incorporer un fragment de formulaire adaptatif dans un formulaire adaptatif en cliquant sur le bouton  Inclure la ressource : <<Nom du fragment> dans la barre d’outils du panneau du fragment ajouté, comme illustré dans l’exemple ci-dessous.

Inclusion d’un fragment dans un formulaire adaptatif

NOTE
Le fragment inclus n’est plus lié au fragment autonome. Vous pouvez modifier les composants dans le fragment inclus à partir du formulaire adaptatif.

Utilisation de fragments dans les fragments using-fragments-within-fragments

Vous pouvez créer des fragments de formulaire adaptatif imbriqués, ce qui signifie que vous pouvez faire glisser un fragment dans un autre fragment, et avoir une structure de fragment imbriqué.

Modification des fragments change-fragments

Vous pouvez remplacer ou modifier un fragment de formulaire adaptatif par un autre fragment à l’aide de la propriété Sélectionner propriété de ressource du fragment dans la boîte de dialogue Modifier le composant, pour un panneau de fragment de formulaire adaptatif.

Générer un document d’enregistrement pour les formulaires adaptatifs generate-DOR-for-fragments

Le document d’enregistrement (DOR) vous permet de conserver les informations de vos formulaires au format d’impression ou de document. Par conséquent, il vous permet de suivre les informations relatives à vos clientes et clients à tout moment ultérieurement et vous pouvez également utiliser le document d’enregistrement pour archiver ensemble les formulaires et le contenu au format PDF. Découvrez comment générer un document d’enregistrement pour les fragments de formulaire adaptatif.

Utiliser un fragment de formulaire plusieurs fois dans un formulaire adaptatif using-form-fragment-mutiple-times-in-af

Vous pouvez utiliser plusieurs fois un fragment de formulaire basé sur un schéma dans un formulaire adaptatif pour enregistrer les données de manière unique pour chaque champ de fragment de formulaire. Par exemple, vous pouvez utiliser un fragment de formulaire d’adresse pour collecter les détails des adresses pour les adresses permanentes, les communications et les adresses actives présentes dans un formulaire de demande de prêt.

Utiliser plusieurs fragments dans un formulaire adaptatif

NOTE
  • Si vous utilisez plusieurs fois des fragments de formulaire sans modèle dans un formulaire adaptatif, la synchronisation des données entre les champs des fragments se produit. Le problème de synchronisation des données ne se produit pas dans les fragments de formulaire basés sur des composants principaux, où vous pouvez utiliser un fragment à plusieurs reprises, basé sur un schéma ou sans modèle dans un formulaire.

Correspondance automatique des fragments pour la liaison de données auto-mapping-of-fragments-for-data-binding

Lorsque vous créez un fragment de formulaire adaptatif à partir d’un modèle de formulaire XFA ou d’un type XSD complexe, et que vous le faites glisser dans un formulaire adaptatif, le fragment XFA ou le type XSD complexe est automatiquement remplacé par le fragment de formulaire adaptatif correspondant dont la racine de modèle de fragment est mappée au fragment XFA ou un type XSD complexe.

Vous pouvez modifier la ressource de fragment et ses liaisons dans la boîte de dialogue Modifier le composant.

NOTE
Vous pouvez également faire glisser un fragment de formulaire adaptatif lié depuis la bibliothèque des fragments de formulaire adaptatif dans l’outil de recherche de contenu AEM et fournir la référence correcte de liaison depuis la boîte de dialogue Modifier le composant du panneau du fragment de formulaire adaptatif.

Gérer les fragments manage-fragments

Vous pouvez effectuer plusieurs opérations sur des fragments de formulaire adaptatif depuis l’interface utilisateur d’AEM Forms.

  1. Accédez à https://[hostname]:'port'/aem/forms.html.

  2. Cliquez sur Sélectionner dans la barre d’outils de l’interface utilisateur AEM Forms et sélectionnez un fragment de formulaire adaptatif. La barre d’outils affiche les opérations suivantes que vous pouvez effectuer sur le fragment de formulaire adaptatif sélectionné.

Opération
Description
Ouvrir
Ouvre le fragment de formulaire adaptatif sélectionné en mode d’édition.
Afficher les propriétés
Ouvre le panneau Propriétés. Dans le panneau Propriétés, vous pouvez afficher et modifier les propriétés, générer un aperçu et charger une miniature pour le fragment sélectionné. Pour plus d’informations, consultez la section Gestion des métadonnées.
Copier
Copie le fragment sélectionné. Le bouton Coller s’affiche dans la barre d’outils.
Télécharger
Télécharge le fragment sélectionné.
Aperçu
Fournit des options de prévisualisation du fragment en HTML ou un aperçu personnalisé en fusionnant les données d’un fichier XML avec le fragment. Pour plus d’informations, voir Aperçu d’un formulaire.
Démarrage de la révision/Gestion de la révision
Permet de lancer et de gérer la révision du fragment sélectionné. Pour plus d’informations, voir Créer et gérer des révisions.
Créer un dictionnaire
Génère un dictionnaire pour localiser le fragment sélectionné. Pour plus d’informations, voir Localisation des formulaires adaptatifs.
Publier/Dépublier
Publie/annule la publication du fragment sélectionné.
Supprimer
Supprime le fragment sélectionné.

Localisation du formulaire adaptatif contenant des fragments. localizing-adaptive-form-containing-fragments

Pour localiser un formulaire adaptatif contenant des fragments de formulaire adaptatif, vous devez localiser le fragment et le formulaire séparément. Il s’agit de localiser un fragment une seule fois et de le réutiliser dans plusieurs formulaires adaptatifs.

NOTE
Les touches de localisation dans le fragment n’apparaîtront pas dans le fichier XLIFF d’un formulaire adaptatif.

Points essentiels à respecter lorsque vous utilisez des fragments key-points-to-remember-when-working-with-fragments

  • Assurez-vous que le nom du fragment est unique. La création du fragment échoue si un fragment portant le même nom existe déjà.
  • Dans un formulaire adaptatif basé sur XDP, si vous enregistrez un panneau en tant que fragment contenant une autre partie du fragment XDP, le fragment obtenu est automatiquement lié au fragment XDP enfant. Dans le cas d’un formulaire adaptatif basé sur un schéma XSD, le fragment obtenu sera associé à la racine de schéma.
  • Lorsque vous créez un fragment de formulaire adaptatif, un nœud de fragment est créé, similaire au nœud guideContainer pour un formulaire adaptatif, dans CRXDE Lite.
  • Un fragment dans un formulaire adaptatif qui utilise un modèle de données de formulaire différent n’est pas pris en charge. Par exemple, un fragment basé sur XDP n’est pas pris en charge dans un formulaire adaptatif basé sur XSD et inversement.
  • Les fragments de formulaire adaptatif sont disponibles par l’onglet Fragments de formulaire adaptatif dans l’outil de recherche de contenu AEM.
  • Toute expression, tout script ou tout style d’un fragment de formulaire adaptatif autonome est conservé lorsqu’il est inséré par référence ou inclus dans un formulaire adaptatif.
  • Vous ne pouvez pas modifier un fragment de formulaire adaptatif, inséré par référence, au sein même d’un formulaire adaptatif. Pour le modifier, vous modifiez le fragment de formulaire adaptatif autonome ou vous incorporez le fragment dans le formulaire adaptatif.
  • Lorsque vous publiez un formulaire adaptatif, vous devez publier les fragments de formulaire adaptatif autonomes insérés par référence dans le formulaire adaptatif.
  • Lorsque vous publiez de nouveau un fragment de formulaire adaptatif mis à jour, les modifications sont répercutées dans les instances publiées du formulaire adaptatif dans lequel le fragment est utilisé.
  • Le formulaire adaptatif contenant le composant Vérifier ne prend pas en charge les utilisateurs et utilisatrices anonymes. En outre, il n’est pas recommandé d’utiliser le composant Vérifier dans un fragment de formulaire adaptatif.
  • (Mac uniquement) Pour vous assurer que la fonctionnalité des fragments de formulaire fonctionne parfaitement dans tous les scénarios, ajoutez l’entrée suivante au fichier /private/etc/hosts :
    127.0.0.1 <Host machine> Ordinateur hôte  : ordinateur Apple Mac sur lequel AEM Forms est déployé.

Fragments de référence reference-fragments

Les fragments de formulaires adaptatifs de référence que vous pouvez utiliser pour créer votre formulaire sont disponibles. Pour plus d’informations, voir Fragments de référence.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2