DocumentationAEM 6.4Guide de Forms

Gérer les métadonnées de formulaire manage-form-metadata

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Présentation  overview-nbsp

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.

AEM Forms fournit par défaut 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 vous fournit également les moyens adéquats pour créer, gérer et échanger efficacement toutes ces métadonnées pour vos formulaires.

Si vous êtes développeur ou propriétaire d’un site, vous pouvez personnaliser Forms Portal, l’interface utilisateur d’AEM Forms pour refléter les métadonnées que vous utilisez dans votre entreprise. Pour plus d’informations sur Forms Portal, reportez-vous à la section Présentation de la publication de formulaires sur un portail.

Métadonnées dans AEM Forms  metadata-in-aem-forms-nbsp

Dans AEM Forms, la liste des propriétés de métadonnées associées à une ressource dépend de son type. 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  asset-types-nbsp

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

  • Modèles de formulaire (formulaires XFA)
  • PDF forms
  • Document (PDF plats)
  • Formulaires adaptatifs
  • Ressources
  • XFS

Liste exhaustive des métadonnées extensive-list-of-metadata-nbsp

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 ressource
Nom d’affichage du formulaire.
Description
Tous sauf ressource
Description du formulaire. L’utilisateur peut spécifier cette valeur.
Type
Tous

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

  • Modèle de formulaire
  • Formulaire de PDF, formulaire de PDF (Acroform) ou formulaire de PDF (signé)
  • Document, document (signé)
  • Formulaire adaptatif
  • 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 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 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 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 ressource

Heure à laquelle la publication/l’annulation de publication automatique du formulaire est planifiée. L’utilisateur 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 au-delà de la date actuelle.
  • La date d’annulation de la publication doit être antérieure à celle de la publication.
Submit URL

Modèle de formulaire

PDF form

Pour configurer une URL spécifiée par l’utilisateur 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, répertorié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.
  • Dans Forms Portal, modifiez le composant Search & Lister et spécifiez une URL d’envoi sous l’onglet Lien de formulaire .
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 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 final.

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

Formulaire adaptatif

Modèle de formulaire

Ressource

Liste des actifs (autres formulaires ou ressources) auxquels 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é 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 le modèle de formulaire utilisé lors de la création du formulaire adaptatif. Cette propriété peut avoir les valeurs suivantes :

  • Modèle de formulaire : Un modèle de formulaire est sélectionné parmi ceux qui existent dans le référentiel. Cette valeur peut être mise à jour.
  • Schéma XML : Un fichier XSD est téléchargé. Cette valeur peut être mise à jour.
  • Aucune

Un modèle de formulaire sélectionné peut être mis à jour, mais pas supprimé.

Affichage des métadonnées de formulaire view-form-metadata-nbsp

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 télé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 :

    1. Cliquez sur l’icône Afficher les propriétés e_reviewmode_properties_n à partir des actions rapides.

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

    2. Sélectionnez le formulaire, puis cliquez sur l’icône Afficher les propriétés e_reviewmode_properties_n qui s’affiche dans la barre d’outils.

    3. 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 aem6forms_eye_viewon 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 page Propriétés comporte une barre d’outils contenant deux icônes d’action :

    • Modifier : aem6forms_edit permet de modifier des valeurs de propriété des métadonnées.
    • Afficher : aem6forms_eye_viewon permet d’accéder à la page Détails du formulaire, qui ouvre le formulaire en mode Prévisualisation.

    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 add-update-form-metadata-values-nbsp

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 des valeurs de propriétés de métadonnées update-metadata-property-values

  1. Suivez la procédure décrite dans la section précédente pour ouvrir la page de propriétés dans laquelle peuvent être affichées les métadonnées existantes du formulaire sélectionné.

  2. Dans la barre d’outils, cliquez sur l’icône Modifier  aem6forms_edit pour passer du mode lecture seule à celui de lecture/écriture.

  3. La page de propriétés qui s’affiche contient un schéma comportant un mélange de champs d’entrée modifiables et de texte statique.

  4. Les propriétés affichées sous forme de texte statique sont celles que vous ne pouvez pas modifier.

  5. Vous pouvez accéder à d’autres onglets pour rechercher des champs d’entrée pour les propriétés de métadonnées placées sous ceux-ci.

    Cette page contient une barre d’outils dotée de deux icônes d’action différentes de celles du mode d’affichage :

    • Annuler : aem6forms_close permet d’annuler les modifications apportées jusqu’à présent aux valeurs de propriété des métadonnées.
    • Terminé : aem6forms_check permet d’enregistrer toutes les modifications apportées jusqu’à présent aux valeurs de propriété des métadonnées.

    Ces deux actions redirigent l’utilisateur dans le mode lecture seule de la page de propriétés contenant les valeurs mises à jour.

Mise à jour de la vignette du formulaire  update-the-form-thumbnail-nbsp

Dans la page de propriétés, le panneau de gauche affiche la vignette du formulaire. Par défaut, la miniature affichée est celle 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, une fonctionnalité supplémentaire est fournie, qui permet à l’utilisateur de générer une miniature en tant qu’instantané de l’aperçu actuel du formulaire adaptatif. Comme AEM Forms prend également en charge la création de formulaires adaptatifs, l’aperçu du formulaire adaptatif peut changer chaque fois que vous le modifiez. Cette fonctionnalité de génération de miniature vous permet d’obtenir une nouvelle miniature pour le formulaire adaptatif en fonction de l’état d’aperçu actuel. Cliquez sur Générer l’aperçu pour effectuer cette action.

NOTE
  • 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  add-custom-metadata-nbsp

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 exposent 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.

    note note
    NOTE
    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 aem6forms_edit 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).

    Editeur de schéma de métadonnées pour le type de formulaire adaptatif

Cliquez pour agrandir

  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  add-custom-metadata-property-in-schema-editor-nbsp

  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é.

    note note
    NOTE
    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 qui sera utilisé 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')

      note note
      NOTE
      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 delete-1 .

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

  5. Cliquez sur Terminé lorsque vous avez apporté toutes les modifications.

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

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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da