Ajout, suppression ou modification des métadonnées d’un formulaire adaptatif

Dernière mise à jour : 2023-12-12

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

Les métadonnées permettent de catégoriser et d’organiser plus facilement les ressources. Les utilisateurs peuvent ainsi retrouver aisément une ressource spécifique.

Par défaut, AEM Forms fournit un ensemble défini de métadonnées pour chaque type de ressource. En plus des métadonnées par défaut, vous pouvez ajouter des métadonnées personnalisées à chaque type de ressources. AEM Forms permet également de créer, de gérer et d’échanger efficacement toutes ces métadonnées pour vos formulaires.

Métadonnées dans AEM Forms

Dans AEM Forms, la liste des propriétés de métadonnées associées à une ressource dépend du type de cette dernière. En outre, si vous ajoutez une propriété de métadonnées personnalisée, celle-ci est ajoutée pour toutes les ressources du même type.

Types de ressources

Les types de ressources suivants sont pris en charge dans AEM Forms :

  • Modèles de formulaire (formulaires XFA)
  • Formulaires PDF
  • Document (PDF plats)
  • Formulaires adaptatifs
  • Modèle de données de formulaire
  • XFS

Liste exhaustive de métadonnées

Vous trouverez ci-dessous une liste exhaustive des propriétés de métadonnées prises en charge dans AEM Forms :

Nom de la propriété Type de ressource Description
Titre Tous sauf la ressource Nom d’affichage de la ressource.
Description Tous sauf la ressource Description. L’utilisateur ou utilisatrice peut spécifier cette valeur.
Type Tous

Valeur en lecture seule spécifiant le type de ressource. Elle peut avoir l’une des valeurs suivantes :

  • Modèle de formulaire
  • Formulaire PDF, formulaire PDF (Acroform) ou formulaire PDF (signé)
  • Document, document (signé)
  • Formulaire adaptatif
  • Modèle de données de formulaire
  • Ressource
Créé Tous Valeur en lecture seule indiquant la date de création de la ressource.
Date de la dernière modification Tous Valeur en lecture seule indiquant l’heure de la dernière modification de la ressource.
Création Tous sauf la ressource

Valeur en lecture seule qui est automatiquement calculée en fonction du type de formulaire.

  • PDF/Modèle de formulaire/Document – extrait du fichier binaire téléchargé.
  • Formulaire adaptatif – utilisateur connecté au moment de la création du formulaire.
État Tous sauf la ressource

Valeur en lecture seule qui définit l’un des états suivants d’un formulaire :

  • Aucune valeur : si un formulaire n’a jamais été publié.
  • Publié : lorsqu’un formulaire est publié.
  • Modifié : lorsqu’un formulaire a été modifié après avoir été publié une fois.
Date de dernière publication Tous sauf la ressource Valeur en lecture seule indiquant la date de dernière publication du formulaire.
Heure d’activation/de désactivation de la publication Tous sauf la ressource

Heure à laquelle la publication/l’annulation de publication automatique du formulaire est planifiée. L’utilisateur ou utilisatrice définit cette valeur lors de la modification des métadonnées.

  • L’heure d’activation et de désactivation de la publication doit être postérieure à la date actuelle.
  • La date d’annulation de la publication doit être antérieure à celle de la publication.
Envoyer l’URL

Modèle de formulaire

Formulaire PDF

Pour configurer une URL spécifiée par l’utilisateur ou utilisatrice afin d’envoyer des données de formulaire à un servlet.

L’URL d’envoi peut être configurée à l’aide de l’une des méthodes suivantes, citées par ordre de priorité :

  • Spécifiez une URL d’envoi directement dans un modèle de formulaire à l’aide du bouton Envoyer via HTTP lors de la création d’un formulaire XFA dans AEM Forms Designer.
  • Dans l’interface utilisateur AEM Forms, sélectionnez un formulaire et spécifiez une URL d’envoi lors de la modification des propriétés de métadonnées.
Profil de rendu de HTML Modèle de formulaire Profil de rendu de HTML utilisé lors du rendu d’un modèle de formulaire au format HTML.
Format de rendu

Modèle de formulaire

Formulaire adaptatif

Cette option permet à l’utilisateur ou utilisatrice de spécifier le format de rendu du formulaire lors de la publication des formulaires :

  • HTML
  • PDF
  • Les deux

Cette option sert à limiter uniquement le format de rendu des formulaires sur le portail de formulaires où ils sont visibles par l’utilisateur.

Balises Tous sauf la ressource Étiquettes associées au formulaire pour faciliter la recherche.
Références

Formulaire adaptatif

Modèle de formulaire

Ressource

Liste des ressources (autres formulaires ou ressources) auxquelles ce formulaire est associé. Ces ressources peuvent appartenir à deux catégories :

  • Fait référence : ressources auxquelles le formulaire actuel fait référence.
  • Référencée par : ressources qui font référence à la ressource actuelle.

Ces ressources sont affichées sous forme de liens et leurs métadonnées sont accessibles en cliquant dessus.

Sélection du modèle de formulaire (XDP/XSD) Formulaire adaptatif

Indique quel modèle de formulaire est utilisé lors de la création du formulaire adaptatif. Cette propriété peut avoir les valeurs suivantes :

  • Modèle de données de formulaire
  • Schéma : un code XML du schéma JSON
  • Aucune
Un modèle de formulaire sélectionné peut être mis à jour, mais pas supprimé.

Affichage des métadonnées de formulaire

Les ressources ont des valeurs de propriété existantes, qui peuvent être affichées en mode lecture seule. Ces métadonnées sont générées au moment du chargement ou de la création du formulaire.

  1. Accédez à l’emplacement de la ressource pour laquelle vous souhaitez afficher les métadonnées.

  2. Ouvrez la page de propriétés à l’aide de l’une des méthodes suivantes :

    • Cliquez sur l’icône Propriétés Propriétés dans les actions rapides.

      REMARQUE

      Les actions rapides sont les éléments d’action qui s’affichent sur une vignette lorsque vous pointez dessus.

    • Sélectionnez le formulaire, puis cliquez sur l’icône Propriétés Propriétés qui s’affiche dans la barre d’outils.

    • Accédez à la page des détails du formulaire en cliquant sur la vignette de celui-ci lorsque vous n’êtes pas en mode de sélection. Cliquez ensuite sur l’icône représentant un œil Propriétés en haut à droite, puis sur Propriétés dans la liste en dessous.

  3. La page de propriétés qui s’ouvre affiche un schéma contenant uniquement les propriétés de métadonnées comportant des valeurs.

    La section du contenu est divisée en deux parties :

    • Le panneau de gauche contient une vignette du formulaire.
    • Le panneau de droite contient les propriétés de métadonnées en mode lecture seule, réparties dans différents onglets.

Ajout/mise à jour de valeurs de métadonnées de formulaire

Vous pouvez modifier les valeurs des propriétés de métadonnées existantes ou ajouter de nouvelles valeurs à un champ de propriété de métadonnées existant (par exemple, lorsqu’un champ de métadonnées est vide).

Mise à jour de la vignette du formulaire

Dans la page de propriétés, le panneau de gauche affiche la vignette du formulaire. Par défaut, la vignette affichée est celle qui a été générée au moment de la création du formulaire (formulaire adaptatif) ou du téléchargement du formulaire.

Pour tous les types de formulaires, vous avez la possibilité de télécharger une image en cliquant sur Télécharger l’image et en accédant à un fichier image dans le répertoire local. L’image sélectionnée remplace la vignette par défaut.

Pour les formulaires adaptatifs, les utilisateurs ont également la possibilité de générer une vignette en tant qu’instantané de l’aperçu du formulaire adaptatif actuel. Comme AEM Forms prend également en charge la création de formulaires adaptatifs, l’aperçu d’un formulaire adaptatif peut être modifié chaque fois que vous changez ce dernier. Cette possibilité de générer une vignette permet d’obtenir une vignette mise à jour du formulaire adaptatif selon l’état de l’aperçu actuel. Cliquez sur Générer l’aperçu pour effectuer cette action.

REMARQUE
  • Utilisez une image carrée pour la vignette. Lorsque vous utilisez une image qui n’est pas carrée et affichez la miniature dans une vue Liste, la miniature apparaît tronquée.
  • Une fois qu’une nouvelle image est téléchargée ou générée, la vignette est remplacée par celle-ci et l’image précédente ne peut pas être rétablie.

Ajout de métadonnées personnalisées

Outre les métadonnées prêtes à l’emploi, AEM Forms prend en charge de nouvelles métadonnées personnalisées.

Un outil (l’éditeur de schéma de métadonnées) est proposé pour définir le schéma de la mise en page des métadonnées, c’est-à-dire la mise en page des élément de la page de propriétés d’un formulaire. L’éditeur de schéma de métadonnées permet d’ajouter ou de modifier un schéma personnalisé pour vos ressources.

AEM Forms expose les schémas de métadonnées des types de formulaires pris en charge dans cet outil. Vous pouvez ainsi accéder à ces schémas et utiliser les fonctionnalités de l’éditeur de schéma de métadonnées pour ajouter des propriétés personnalisées.

  1. Accédez à Outils > Ressources > Schémas de métadonnées.

  2. Cliquez sur formulaires dans les formulaires de schéma répertoriés.

  3. Dans la liste qui s’affiche, cliquez sur le type de ressource auquel vous souhaitez ajouter des métadonnées personnalisées.

    REMARQUE

    Ces schémas contiennent des propriétés de métadonnées prêtes à l’emploi qui ne doivent pas être modifiées (en cochant des cases ou en cliquant sur Modifier dans la barre d’outils) pour éviter tout problème fonctionnel.

  4. Lorsque vous cliquez sur n’importe quel type de ressource, une liste contenant l’option extendedmetadata s’affiche. Modifiez ce schéma.

  5. Cochez la case en regard de l’option extendedmetadata, puis cliquez sur l’icône Modifier qui s’affiche dans la barre d’outils.

  6. AEM Forms ouvre l’éditeur de schéma de métadonnées/le créateur de formulaires du type de ressource sélectionné (dans ce cas présent, du formulaire adaptatif).

    Éditeur de métadonnées

    1. Le panneau de gauche contient des sections à onglets où se trouvent les champs. Le panneau de droite affiche tous les composants d’IU disponibles et les propriétés du champ sélectionné dans le panneau de gauche.

    2. La section verrouillée n’est pas modifiable et contient les champs de toutes les propriétés de métadonnées prêtes à l’emploi.

    3. Vous pouvez ajouter d’autres onglets en cliquant sur le symbole +.

    4. Vous pouvez ajouter un champ personnalisé de type souhaité en faisant glisser le composant de champ de la section Créateur de formulaires jusqu’à la page de schéma.

    5. Les caractéristiques de ce champ peuvent être affichées sous la section Paramètres en cliquant dessus.

Ajout d’une propriété de métadonnées personnalisée dans l’éditeur de schéma

  1. Accédez à l’onglet (nouveau ou existant) auquel vous souhaitez ajouter la propriété personnalisée.

  2. Faites glisser un composant du type souhaité de la section Créer le formulaire du panneau de gauche jusqu’à l’emplacement souhaité.

    REMARQUE

    Vous ne pouvez pas déplacer les sections verrouillées. Vous pouvez toutefois placer votre composant dans un des espaces vides.

  3. Cliquez sur un composant que vous venez de déplacer. Dans l’onglet Paramètres qui s’affiche dans le panneau de droite, renseignez les champs suivants :

    1. Indiquez un libellé de champ à utiliser comme nom d’affichage au-dessus du champ placé dans le schéma (par exemple : Service)

    2. Sous le champ Associer à la propriété, vous pouvez voir une valeur préremplie ./jcr:content/metadata/default'. Remplacez « default » par le nom de propriété de votre choix, qui sera utilisé pour stocker la propriété dans le référentiel crx (par exemple, './jcr:content/metadata/department')

      REMARQUE

      Ne modifiez pas le préfixe './jcr:content/metadata/' car il définit le chemin d’accès où la propriété est stockée.

      En outre, le nom de la propriété doit être unique pour éviter d’écrire des valeurs pour plusieurs propriétés au même emplacement dans le référentiel. Il est donc recommandé de modifier la valeur « default ».

    3. Remplissez les autres paramètres en fonction des besoins. Sélectionnez par exemple l’option Obligatoire si vous souhaitez que le champ soit obligatoire.

    4. Pour supprimer un champ que vous avez ajouté, sélectionnez-le, puis cliquez sur l’icône Supprimer.

  4. Si nécessaire, suivez les étapes 1 à 3 pour ajouter une autre propriété.

  5. Cliquez sur Enregistrer après avoir effectué toutes les modifications.

    Vous venez d’ajouter une propriété de métadonnées personnalisée.

Tous les formulaires adaptatifs d’AEM Forms contiennent maintenant cette autre propriété de métadonnées. Vous pouvez la modifier dans la page de propriétés.

Voir également

Sur cette page