Configuration et administration des fonctionnalités de métadonnées dans Assets config-metadata

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

Adobe Experience Manager Assets conserve les métadonnées de chaque fichier. Cela permet d’obtenir une catégorisation et une organisation plus simples des ressources, ainsi que d’aider les personnes qui recherchent une ressource spécifique. La possibilité de conserver et de gérer les métadonnées de vos fichiers permet aussi d’organiser et de traiter automatiquement les fichiers en fonction de leurs métadonnées. Adobe Experience Manager Assets permet aux équipes d’administration de configurer et de personnaliser les fonctionnalités de métadonnées afin de modifier l’offre d’Adobe par défaut.

Modifier le schéma de métadonnées metadata-schema

Pour plus d’informations, consultez la section Modification des formulaires de schéma de métadonnées.

Enregistrement d’un espace de noms personnalisé dans Experience Manager registering-a-custom-namespace-within-aem

Vous pouvez ajouter vos propres espaces de noms à Experience Manager. Tout comme il existe des espaces de noms prédéfinis tels que cq, jcr et sling, vous pouvez disposer d’un espace de noms pour le traitement des données XML et des métadonnées de votre référentiel.

  1. Accédez à la page d’administration du type de nœud https://[aem_server]:[port]/crx/explorer/nodetypes/index.jsp.
  2. Pour accéder à la page d’administration des espaces de noms, cliquez sur Espaces de noms en haut de la page.
  3. Pour ajouter un espace de noms, cliquez sur Nouveau en bas de la page.
  4. Spécifiez un espace de noms personnalisé dans la convention des espaces de noms XML. Spécifiez l’identifiant sous la forme d’un URI et d’un préfixe associé à l’ID. Cliquez sur Enregistrer.

Configuration du nombre maximal de paramètres pour la mise à jour des métadonnées en bloc bulk-metadata-update-limit

Pour éviter une situation similaire à un DOS (déni de service), Enterprise Manager limite le nombre de paramètres pris en charge dans une requête Sling. Lors de la mise à jour simultanée de plusieurs fichiers, vous pouvez atteindre le nombre maximal de paramètres et les métadonnées ne sont pas mises à jour pour d’autres fichiers. Enterprise Manager génère l’avertissement suivant dans les journaux :

org.apache.sling.engine.impl.parameters.Util Too many name/value pairs, stopped processing after 10000 entries

Pour modifier le nombre maximal de paramètres, accédez à la console Outils  > Opérations  > Console web, puis changez la valeur de Paramètres POST maximum dans la configuration OSGi de gestion des paramètres de requête Sling Apache.

Profils de métadonnées metadata-profiles

Un profil de métadonnées vous permet d’appliquer des métadonnées par défaut aux ressources d’un dossier. Créez un profil de métadonnées et appliquez-le à un dossier. Toute ressource que vous chargez ultérieurement dans le dossier hérite des métadonnées par défaut que vous avez configurées dans le profil de métadonnées.

Ajout d’un profil de métadonnées adding-a-metadata-profile

  1. Accédez à Outils  > Ressources  > Profils de métadonnées puis cliquez sur Créer.

  2. Saisissez un titre pour le profil, par exemple : Sample Metadata, puis cliquez sur Créer. La page Modifier le formulaire pour le profil de métadonnées s’affiche.

    Modification d’un formulaire de métadonnées

  3. Cliquez sur un composant, puis configurez ses propriétés dans l’onglet Paramètres. Cliquez par exemple sur le composant Description et modifiez ses propriétés.

    Définition d’un composant dans le profil de métadonnées

    Modifiez les propriétés suivantes pour le composant Description  :

    • Libellé du champ  : nom sous lequel s’affiche la propriété des métadonnées. Il est uniquement disponible à titre de référence.

    • Mapper à la propriété  : cette propriété spécifie le chemin ou nom relatif du nœud de la ressource où elle est enregistrée dans le référentiel. La valeur doit toujours commencer par ./ car cela indique que le chemin d’accès se trouve sous le nœud de la ressource.

    Mappage du paramètre de propriété dans le profil de métadonnées

    La valeur que vous spécifiez pour Mapper à la propriété est conservée en tant que propriété sous le nœud de métadonnées de la ressource. Par exemple, si vous spécifiez ./jcr:content/metadata/dc:desc en tant que nom pour Mapper à la propriété, Assets stocke la valeur dc:desc comme nœud de métadonnées de la ressource. Adobe recommande de ne mapper qu’un champ à une propriété donnée dans le schéma de métadonnées. Sinon, le dernier champ ajouté et mappé à la propriété est sélectionné par le système.

    • Valeur par défaut  : utilisez cette propriété pour ajouter une valeur par défaut pour le composant des métadonnées. Par exemple, si vous indiquez « Ma description », cette valeur est affectée à la propriété dc:desc au niveau du nœud de métadonnées de la ressource.

    Définition de la description par défaut dans le profil de métadonnées

    note note
    NOTE
    Si vous ajoutez une valeur par défaut à une nouvelle propriété de métadonnées (qui n’existe pas au niveau du nœud /jcr:content/metadata), la propriété et sa valeur ne s’affichent pas, par défaut, sur la page Propriétés de la ressource. Pour afficher la nouvelle propriété sur la page Propriétés de la ressource, modifiez le formulaire de schéma correspondant.
  4. (Facultatif) Dans l’onglet Créer un formulaire, ajoutez d’autres composants à Modifier le formulaire et configurez leurs propriétés dans l’onglet Paramètres. Les propriétés suivantes sont disponibles dans l’onglet Créer un formulaire  :

Composant
Propriétés
En-tête de section
Libellé de champ, Description
Texte d’une seule ligne
Libellé de champ,
Associer à la propriété,
Valeur par défaut
Texte à plusieurs valeurs
Libellé de champ,
Associer à la propriété,
Valeur par défaut
Nombre
Libellé de champ,
Associer à la propriété,
Valeur par défaut
Date
Libellé de champ,
Associer à la propriété,
Valeur par défaut
Balises standard
Libellé de champ,
Associer à la propriété,
Valeur par défaut,
Description
  1. Cliquez sur Terminé. Le profil de métadonnées est ajouté à la liste des profils de la page Profils de métadonnées.

    Profil de métadonnées ajouté à la page Profils de métadonnées

Copie d’un profil de métadonnées copying-a-metadata-profile

  1. Sélectionnez un profil de métadonnées sur la page Profils de métadonnées pour en faire une copie.

    Copie d’un profil de métadonnées

  2. Cliquez sur Copier dans la barre d’outils.

  3. Dans la boîte de dialogue Copier le profil de métadonnées, saisissez le nom de la nouvelle copie du profil de métadonnées.

  4. Cliquez sur Copier. La copie du profil de métadonnées apparaît dans la liste des profils de la page Profils de métadonnées.

    Une copie du profil de métadonnées ajouté à la page Profils de métadonnées

Suppression d’un profil de métadonnées deleting-a-metadata-profile

  1. Dans la page Profils de métadonnées, sélectionnez un profil à supprimer.

  2. Cliquez sur Supprimer les profils de métadonnées dans la barre d’outils.

  3. Dans la boîte de dialogue, cliquez sur Supprimer pour confirmer l’opération de suppression. Le profil de métadonnées est supprimé de la liste.

Schéma de métadonnées d’un dossier folder-metadata-schema

Adobe Experience Manager Assets vous permet de créer des schémas de métadonnées pour des dossiers de ressources. Ces schémas définissent la disposition et les métadonnées affichées dans les pages de propriétés des dossiers.

Ajout d’un formulaire de schéma de métadonnées de dossier add-a-folder-metadata-schema-form

Utilisez l’éditeur Formulaires de schéma de métadonnées de dossier pour créer et modifier des schémas de métadonnées pour les dossiers.

  1. Dans l’interface Experience Manager, accédez à Outils  > Ressources  > Schémas de métadonnées de dossiers.
  2. Sur la page Formulaires de schéma de métadonnées de dossiers, cliquez sur Créer.
  3. Indiquez un nom pour le formulaire, puis cliquez sur Créer. Le nouveau formulaire de schéma est répertorié dans la page Formulaires de schéma.

Modification des formulaires de schéma de métadonnées de dossier edit-folder-metadata-schema-forms

Vous pouvez modifier un formulaire de schéma de métadonnées existant ou nouvellement ajouté, qui comprend les éléments suivants :

  • Onglets
  • Éléments de formulaire dans des onglets.

Vous pouvez associer ou configurer ces éléments de formulaire dans un champ au sein d’un nœud de métadonnées dans le référentiel CRX. Vous pouvez ajouter des onglets ou des éléments de formulaire au formulaire de schéma de métadonnées.

  1. Sur la page Formulaires de schéma, sélectionnez le formulaire que vous avez créé, puis sélectionnez l’option Modifier dans la barre d’outils.

  2. Sur la page Éditeur de schéma de métadonnées de dossier, cliquez sur + pour ajouter un onglet au formulaire. Pour renommer l’onglet, cliquez sur le nom par défaut, puis indiquez le nouveau nom sous Paramètres.

    custom_tab

    Pour ajouter d’autres onglets, cliquez sur +. Pour en supprimer, cliquez sur X sur un onglet.

  3. Dans l’onglet actif, ajoutez un ou plusieurs composants de l’onglet Créer le formulaire.

    adding_components

    Si vous créez plusieurs onglets, cliquez sur un onglet spécifique pour ajouter des composants.

  4. Pour configurer un composant, sélectionnez-le et modifiez ses propriétés dans l’onglet Paramètres.

    Si nécessaire, supprimez un composant de l’onglet Paramètres.

    configure_properties

  5. Pour enregistrer les modifications, sélectionnez Enregistrer dans la barre d’outils.

Composants de création de formulaires components-to-build-forms

L’onglet Créer le formulaire répertorie les éléments de formulaire que vous utilisez dans votre formulaire de schéma de métadonnées de dossier. L’onglet Paramètres contient les attributs de chaque élément sélectionné dans l’onglet Créer le formulaire. Voici la liste des éléments de formulaire disponibles dans l’onglet Créer le formulaire  :

Nom du composant
Description
En-tête de section
Permet d’ajouter un en-tête de section pour une liste de composants communs.
Une seule ligne de texte
Permet d’ajouter une propriété de texte d’une seule ligne. Elle est stockée sous la forme d’une chaîne.
Texte à plusieurs valeurs
Permet d’ajouter une propriété de texte à plusieurs valeurs. Il est stocké sous la forme d’une table de chaînes.
Nombre
Permet d’ajouter un composant de nombre.
Date
Permet d’ajouter un composant de date.
Liste déroulante
Permet d’ajouter une liste déroulante.
Balises standard
Permet d’ajouter une balise.
Champ masqué
Permet d’ajouter un champ masqué. Il est envoyé en tant que paramètre POST lorsque la ressource est enregistrée.

Modification d’éléments de formulaire editing-form-items

Pour modifier les propriétés d’éléments de formulaire, cliquez sur le composant et modifiez l’ensemble ou un sous-ensemble des propriétés suivantes dans l’onglet Paramètres.

Libellé du champ  : nom de la propriété de métadonnées qui s’affiche sur la page des propriétés du dossier.

Associer à la propriété  : cette propriété spécifie le chemin d’accès relatif du nœud de dossier dans le référentiel CRX où il est enregistré. Elle commence par «  ./  », qui indique que le chemin d’accès se trouve sous le nœud du dossier.

Les valeurs admises pour cette propriété sont les suivantes :

  • ./jcr:content/metadata/dc:title : stocke la valeur dans le nœud de métadonnées du dossier en tant que propriété dc:title.

  • ./jcr:created : affiche la propriété JCR au niveau du nœud du dossier. Si vous configurez ces propriétés dans CRXDE, Adobe recommande de les marquer avec l’état Désactiver la modification, car elles sont protégées. Dans le cas contraire, l’erreur « Asset(s) failed to modify » se produit lorsque vous enregistrez les propriétés de la ressource.

Pour vous assurer que le composant est affiché correctement dans le formulaire de schéma de métadonnées, n’insérez pas d’espace dans le chemin de propriété.

Chemin JSON  : utilisez cette propriété pour indiquer le chemin d’accès au fichier JSON où vous spécifiez des paires clé/valeur pour les options.

Espace réservé  : utilisez cette propriété pour spécifier le texte d’espace réservé approprié concernant la propriété de métadonnées.

Choix  : utilisez cette propriété pour spécifier des choix dans une liste.

Description  : utilisez cette propriété pour ajouter une brève description pour le composant de métadonnées.

Classe  : classe d’objet à laquelle la propriété est associée.

Suppression de formulaires de schéma de métadonnées de dossier delete-folder-metadata-schema-forms

Vous pouvez supprimer des formulaires de schéma de métadonnées de dossier sur la page Formulaires de schéma de métadonnées de dossier. Pour supprimer un formulaire, sélectionnez-le et cliquez sur l’option de suppression de la barre d’outils.

delete_form

Affectation d’un schéma de métadonnées de dossier assign-a-folder-metadata-schema

Vous pouvez affecter un schéma de métadonnées de dossier à un dossier à partir de la page Formulaires de schéma de métadonnées de dossier ou lors de la création d’un dossier.

Si vous configurez un schéma de métadonnées pour un dossier, le chemin d’accès au formulaire est stocké dans la propriété folderMetadataSchema du nœud de dossier sous ./jcr:content.

Affectation d’un schéma à partir de la page Schéma de métadonnées de dossier assign-to-a-schema-from-the-folder-metadata-schema-page

  1. Dans l’interface Experience Manager, accédez à Outils  > Ressources  > Schémas de métadonnées de dossiers.

  2. Sur la page Formulaires de schéma de métadonnées de dossier, sélectionnez le formulaire à appliquer à un dossier.

  3. Dans la barre d’outils, cliquez sur Appliquer au(x) dossier(s).

  4. Sélectionnez le dossier auquel appliquer le schéma, puis cliquez sur Appliquer. Si un schéma de métadonnées est déjà appliqué au dossier, un message d’avertissement vous informe que vous êtes sur le point de remplacer le schéma existant. Cliquez sur Remplacer.

  5. Ouvrez les propriétés des métadonnées pour le dossier auquel vous avez appliqué le schéma de métadonnées.

    folder_properties

    Pour afficher les champs de métadonnées du dossier, cliquez sur l’onglet Métadonnées du dossier.

    folder_metadata_properties

Affectation d’un schéma lors de la création d’un dossier assign-a-schema-when-creating-a-folder

Vous pouvez attribuer un schéma de métadonnées de dossier lors de la création d’un dossier. Si au moins un schéma de métadonnées de dossier existe dans le système, une liste supplémentaire s’affiche dans la boîte de dialogue Créer un dossier. Vous pouvez sélectionner le schéma souhaité. Par défaut, aucun schéma n’est sélectionné.

  1. Dans l’interface utilisateur Experience Manager Assets, cliquez sur Créer dans la barre d’outils.

  2. Indiquez un titre et un nom de dossier.

  3. Dans la liste Schéma de métadonnées de dossier, sélectionnez le schéma souhaité. Cliquez ensuite sur Créer.

    select_schema

  4. Ouvrez les propriétés des métadonnées pour le dossier auquel vous avez appliqué le schéma de métadonnées.

  5. Pour afficher les champs de métadonnées du dossier, cliquez sur l’onglet Métadonnées du dossier.

Utilisation du schéma de métadonnées de dossier use-the-folder-metadata-schema

Ouvrez les propriétés d’un dossier configuré avec un schéma de métadonnées de dossier. Un onglet Métadonnées de dossier s’affiche sur la page des propriétés du dossier. Pour afficher le formulaire de schéma de métadonnées de dossier, sélectionnez cet onglet.

Saisissez les valeurs de métadonnées dans les différents champs, puis cliquez sur Enregistrer pour les stocker. Les valeurs renseignées sont stockées dans le nœud de dossier du référentiel CRX.

folder_metadata_properties-1

Conseils et restrictions best-practices-limitations

  • Pour importer des métadonnées sur des espaces de noms personnalisés, commencez par enregistrer les espaces de noms.
  • Le sélecteur de propriétés affiche les propriétés utilisées dans les éditeurs de schéma et les formulaires de recherche. Le sélecteur de propriétés ne sélectionne pas les propriétés de métadonnées d’une ressource.
  • Des profils de métadonnées préexistants peuvent exister et dater d’avant la mise à niveau vers Experience Manager 6.5. Après la mise à niveau, si vous appliquez un tel profil dans un dossier Propriétés dans l’onglet Profils de métadonnées, les champs de formulaire de métadonnées ne s’affichent pas. Cependant, si vous appliquez un nouveau profil de métadonnées, les champs de formulaire s’affichent mais ne sont pas disponibles comme prévu. Vous ne rencontrerez pas de perte de fonctionnalités mais si vous souhaitez voir les champs de formulaire (indisponibles), modifiez et enregistrez les profils de métadonnées existants.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2