[AEM_Assets]{class="badge positive" title="S’applique à AEM Assets)."}

Schémas de métadonnées metadata-schemas

Les entreprises disposent d’un modèle de métadonnées qui améliore la découverte, l’utilisation, l’interopérabilité des ressources, etc. L’application correcte des métadonnées est sacro-sainte pour gérer les workflows et les processus pilotés par les métadonnées. Pour respecter la stratégie et les normes de métadonnées à l’échelle de l’entreprise, vous pouvez utiliser des schémas de métadonnées qui aident les utilisateurs et utilisatrices de la gestion des actifs numériques à s’aligner sur celles-ci. Adobe Experience Manager Met à disposition des méthodes simples et flexibles pour créer, gérer et appliquer des schémas de métadonnées.

Dans Adobe Experience Manager Assets, les schémas contiennent des champs spécifiques pour renseigner des informations spécifiques. Il contient également des informations de mise en page pour afficher les champs de métadonnées de manière conviviale. Les propriétés de métadonnées incluent le titre, la description, les types MIME, les balises, etc. Vous pouvez utiliser l’éditeur de formulaires de schéma de métadonnées pour modifier des schémas existants ou ajouter des schémas de métadonnées personnalisés.

Pour afficher et modifier la page des propriétés d’une ressource, procédez comme suit :

Formulaires de schéma de métadonnées default-metadata-schema-forms

Pour afficher la liste des formulaires ou des modèles, dans l’interface Experience Manager, accédez à Outils > Ressources > Schémas de métadonnées.

Experience Manager fournit les modèles de formulaires de schéma de métadonnées suivants.

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

Pour ajouter un formulaire de schéma de métadonnées, procédez comme suit :

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

Vous pouvez modifier un formulaire de schéma de métadonnées existant ou nouvellement ajouté. Le formulaire de schéma de métadonnées comprend des onglets et des é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. Les onglets et les éléments de formulaire dérivés du parent sont à l’état verrouillé. Vous ne pouvez pas les modifier au niveau des enfants.

Autorisations requises pour modifier les schémas de métadonnées Permissions-required-to-edit-metadata-schemas

La création ou la modification de schémas de métadonnées personnalisés, par exemple en tant que rôle de bibliothécaire de la gestion des ressources numériques non administrateur, nécessite plus qu’un accès en écriture au nœud de schéma lui-même.

L’octroi de l’accès en écriture uniquement au nœud metadataschema sans la lecture récursive associée sur /conf entraîne l’échec de l’affichage correct de l’éditeur de schémas pour les non-administrateurs. La même dépendance en lecture /conf sous-jacente affecte également la recherche de ressources ou le parcours pour les utilisateurs en lecture seule. Si un groupe dispose d’un accès en lecture complet à /content/dam, mais pas à /conf/global/settings/dam/adminui-extension/metadataschema, l’interface utilisateur d’Assets ne peut pas résoudre le schéma de métadonnées nécessaire au rendu des résultats et renvoie une NullPointerException, bloquant entièrement la recherche.

Composants de l’onglet Créer le formulaire components-within-the-build-form-tab

L’onglet Créer le formulaire répertorie les éléments de formulaire que vous utilisez dans votre formulaire de schéma. L’onglet Paramètres contient les attributs de chaque élément sélectionné dans l’onglet Créer le formulaire. Le tableau suivant répertorie les éléments de formulaire disponibles dans l’onglet Créer le formulaire :

Modification du composant de métadonnées edit-the-metadata-component

Pour modifier les propriétés d’un composant de métadonnées dans le formulaire, cliquez sur le composant et modifiez l’ensemble ou un sous-ensemble des propriétés suivantes dans l’onglet Paramètres. Il est recommandé de ne mapper qu’un champ à une propriété donnée dans le schéma de métadonnées. Sinon, le dernier champ ajouté mappé à la propriété est sélectionné par le système.

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

Associer à la propriété : cette propriété spécifie le chemin ou le nom relatif du nœud de la ressource où elle est enregistrée dans le référentiel CRX. Elle commence par ./ pour indiquer que le chemin d’accès se situe sous le nœud de la ressource.

Voici des exemples de valeurs valides pour une propriété :

Pour garantir que le composant s’affiche correctement dans le formulaire de schéma de métadonnées, le chemin de la propriété ne doit pas comporter d’espace.

Si vous sélectionnez l’option Obligatoire, vous pouvez rechercher des fichiers dont les métadonnées obligatoires sont manquantes. Dans le panneau Filtres, développez le prédicat Validation des métadonnées et sélectionnez l’option Non valide. Les résultats de la recherche affichent des fichiers dont les métadonnées obligatoires que vous avez configurées via le formulaire de schéma sont manquantes.

Si vous ajoutez le composant Métadonnées contextuelles à un onglet d’un formulaire de schéma, le composant apparaît sous forme de liste sur la page Propriétés des ressources auxquelles ce schéma s’applique. La liste inclut tous les autres onglets, à l’exception de celui auquel vous avez appliqué le composant Métadonnées contextuelles. Actuellement, cette fonctionnalité fournit des fonctions de base pour contrôler l’affichage des métadonnées en fonction du contexte.

Pour afficher un onglet sur la page Propriétés en plus de l’onglet auquel le composant Métadonnées contextuelles est appliqué, sélectionnez-le dans la liste. L’onglet est ajouté à la page Propriétés.

Spécification des propriétés dans le fichier JSON specify-properties-in-json-file

Au lieu de définir les propriétés des options sous l’onglet Paramètres, vous pouvez définir les options d’un fichier JSON en spécifiant les paires clé-valeur correspondantes. Spécifiez le chemin d’accès au fichier JSON dans le champ Chemin d’accès JSON.

Ajout ou suppression d’un onglet dans le formulaire de schéma add-delete-a-tab-in-the-schema-form

L’éditeur de schéma vous permet d’ajouter ou de supprimer un onglet. Le formulaire de schéma par défaut inclut les onglets De base, Avancé, IPTC et Extension IPTC.

Cliquez sur + pour ajouter un onglet à un formulaire de schéma. Par défaut, le nouvel onglet porte le nom Unnamed-1. Vous pouvez modifier le nom à partir de l’onglet Paramètres. Pour supprimer un onglet, cliquez sur X.

Suppression de formulaires de schéma de métadonnées deleting-metadata-schema-forms

Experience Manager vous permet uniquement de supprimer des formulaires de schéma personnalisés. Elle ne permet pas de supprimer les modèles/formulaires de schéma par défaut. Cependant, vous pouvez supprimer toutes les modifications personnalisées dans ces formulaires.

Pour supprimer un formulaire, sélectionnez-le puis cliquez sur l’icône Supprimer.

Formulaires de schéma pour les types MIME schema-forms-for-mime-types

Experience Manager fournit des formulaires par défaut pour plusieurs types MIME prêts à l’emploi. Vous pouvez toutefois ajouter des formulaires personnalisés pour les ressources de plusieurs types MIME.

Ajouter des formulaires pour les types MIME adding-new-forms-for-mime-types

Créez un formulaire doté du type de formulaire approprié. Par exemple, pour ajouter un modèle pour le sous-type image/png, créez le formulaire dans les formulaires « image ». Le titre du formulaire de schéma est le nom du sous-type. Dans ce cas, le titre est png.

Utiliser un modèle de schéma existant pour divers types MIME use-an-existing-schema-template-for-various-mime-types

Vous pouvez utiliser un modèle existant pour un autre type MIME. Par exemple, utilisez le formulaire image/jpeg pour les ressources de type MIME image/png.

Dans ce cas, créez un nœud sous /etc/dam/metadataeditor/mimetypemappings dans le référentiel CRX. Indiquez un nom pour le nœud et définissez les propriétés suivantes :

Assets mappe les types MIME et les formulaires de schéma suivants :

Octroi de l’accès aux schémas de métadonnées grant-access-to-metadata-schemas

La fonction Schéma de métadonnées est réservée aux administrateurs. Toutefois, les administrateurs peuvent fournir l’accès aux non-administrateurs en modifiant certaines autorisations. Fournissez les autorisations de création, de modification et de suppression des utilisateurs non-administrateurs sur le dossier /conf.

Application de métadonnées spécifiques au dossier applying-folder-specific-metadata

Assets vous permet de définir une variation d’un schéma de métadonnées et de l’appliquer à un dossier spécifique.

Par exemple, vous pouvez définir une variante du schéma de métadonnées par défaut et l’appliquer à un dossier. Lorsque vous appliquez le schéma modifié, il remplace le schéma de métadonnées par défaut d’origine appliqué aux ressources du dossier.

Les métadonnées modifiées définies dans le schéma de métadonnées de la variation seront uniquement appliquées aux ressources chargées dans le dossier auquel est appliqué le schéma. Dans les autres dossiers pour lesquels le schéma d’origine est appliqué, Assets continue à utiliser les métadonnées définies dans le schéma d’origine.

L’héritage des métadonnées par les ressources est basé sur le schéma appliqué au dossier de premier niveau dans la hiérarchie. Le même schéma est appliqué ou hérité par les sous-dossiers. Si un autre schéma est appliqué au niveau du sous-dossier, l’héritage s’arrête.

Définition des métadonnées obligatoires defining-mandatory-metadata

Vous pouvez définir des champs obligatoires au niveau d’un dossier, qui s’appliquent aux ressources chargées dans ce dossier. Si vous chargez des ressources présentant des métadonnées manquantes dans des champs obligatoires précédemment définis, une indication visuelle de métadonnées manquantes apparaît sur les ressources en vue Carte.

Configuration et propriétés du schéma de métadonnées metadata-schema-configuration-and-properties

Ajout et mappage d’un champ de métadonnées personnalisé adding-and-mapping-a-custom-metadata-field

Un cas d’utilisation courant consiste à mapper un champ de texte à une propriété personnalisée, par exemple, ./jcr:content/metadata/cdnLink stocker une référence CDN ou URL externe avec la ressource.

Espaces de noms réservés reserved-namespaces

N’ajoutez pas de propriétés personnalisées sous les espaces de noms réservés d’AEM ou de JCR : dam, cq, granite, sling, jcr, rep, oak, nt. Ils sont utilisés en interne par AEM et le référentiel sous-jacent. Les champs personnalisés ajoutés en dessous sont filtrés ou masqués par les mécanismes internes d’AEM et par les API HTTP de ressources. Il semble donc qu’ils ne puissent pas être enregistrés ou affichés en silence. Utilisez plutôt un espace de noms personnalisé unique, par exemple <yourorg>.cdnLink.

Validation d’un mappage et dépannage lorsque les valeurs ne persistent pas Validating-a-mapping

Si une valeur de métadonnées saisie via l’interface utilisateur ne semble pas persister :

Considérations relatives à la multilangue et à l’intégration Multi-language-and-integration-considerations

Le champ de métadonnées prêt à l’emploi Langue est informatif uniquement par défaut. Il ne dirige pas automatiquement la logique de diffusion ou de routage vers les systèmes en aval. Pour les ressources qui doivent représenter plusieurs langues ou piloter la sélection du canal ou basée sur des paramètres régionaux pour les systèmes en aval (par exemple, Adobe Commerce ou Edge Delivery Services), ajoutez un champ de métadonnées à plusieurs valeurs personnalisé plutôt que de vous fier au champ prêt à l’emploi Langue et exposez-le en tant que facette de recherche ou filtre afin de prendre en charge une sélection fiable par la langue et le canal.

Persistance du déploiement deployment-persistence

Les champs de schéma de métadonnées créés via l’interface utilisateur de l’éditeur de schéma de métadonnées sont stockés dans le référentiel, et non dans le code. Ils ne sont pas affectés par les déploiements de code d’application standard, sauf si le package de déploiement remplace ou supprime explicitement le chemin d’accès au référentiel de ce schéma. Une nouvelle version déployée sur une version précédente ne supprime pas un champ créé par l’interface utilisateur.

Voir également