Métadonnées en bloc

Par défaut, les métadonnées sont gérées au niveau de la page. Voir Création et publication de contenu pour plus d’informations.

Dans certains cas, il est utile d’appliquer en masse des métadonnées à un site web. Cas d’utilisation courants :

Si vous souhaitez créer des métadonnées pour plusieurs pages à la fois, créez un classeur Excel ou un classeur Google Sheets dans le dossier racine de votre site web dans SharePoint ou Google Drive.

Le classeur ne doit comporter qu’une seule feuille de calcul et au moins deux colonnes, comme dans l’image suivante.

La colonne intitulée URL contient le modèle d’URL des pages qui doivent obtenir une entrée de métadonnées spécifique.

Le * de caractère générique (astérisque) peut être utilisé comme préfixe ou suffixe, ce qui permet des correspondances flexibles sur le nom du chemin d’accès à l’URL. Les exemples typiques incluent le /docs/** ou le **/docs/**.

Remarque : la feuille de métadonnées est évaluée de haut en bas. Les métadonnées à l’échelle du site définies sur ** doivent être définies avant des entrées plus spécifiques.

Pour chaque propriété de métadonnées, créez une colonne dans la feuille de calcul et nommez-la à l’aide de la propriété que vous souhaitez affecter. Par exemple, template, theme ou robots.

Les métadonnées au niveau de la page ajoutées via un bloc de métadonnées sont prioritaires sur les métadonnées en bloc. Voir les documents Création et publication de contenu et Métadonnées (bloc) pour plus d’informations.

Pour supprimer explicitement des métadonnées, un "" peut être utilisé comme valeur. Cette action supprime l’élément ou définit l’attribut correspondant à "" pour un chemin d’accès particulier.

Exemple :

URL          Canonical
/**          ""

Par défaut, l’exemple ci-dessus supprime le <link rel="canonical"> de toutes les pages, sauf s’il existe un remplacement spécifique, par exemple à partir d’un bloc de métadonnées de page.

Remarque : vous devez prévisualiser/publier la feuille de métadonnées pour que les modifications soient répercutées sur votre page.

Conseil : la mise à jour d’Excel dans SharePoint peut être lente. Si vous ne voyez pas vos modifications répercutées dans l’aperçu ou la publication, actualisez de manière irréversible (cliquez dans la barre d’URL et actualisez) le document Excel dans votre navigateur et l’aperçu doivent fonctionner comme prévu.

Métadonnées mappées au dossier

Si le site comporte le mappage dossier configuré, les fichiers de métadonnées de ce dossier s’appliqueront à toutes les pages pour ce mappage. Par exemple, si /templates/ est mappé à un dossier sur /templates/default, les métadonnées dans /templates/default/metadata.xlsx seront appliquées à toutes les pages sous /templates/ si le modèle d’URL correspond.

Date de la dernière modification

Les modifications apportées aux métadonnées mappées à un dossier ne sont pas reflétées dans l’en-tête de réponse HTTP last-modified des pages de la portée mappée. Par défaut, la date de la dernière modification du document par défaut est utilisée. Si vous comptez sur la mise à jour de cette valeur d’en-tête en fonction des modifications des métadonnées, ce qui peut être souhaitable à des fins d’optimisation du moteur de recherche ou d’optimisation du moteur de recherche, vous pouvez l’influencer en ajoutant une colonne last-modified explicite. Cela vous permet de définir la chaîne de date ou l’horodatage de votre choix pour certaines lignes uniquement, tout en laissant les autres inchangées. Nous vous recommandons le format de date ISO pour vous assurer qu’il est lisible par l’utilisateur et qu’il respecte le fuseau horaire.

Exemple :

URL         Last-modified
/products/product1  2024-11-21T00:00:00Z
/products/product2  2024-11-20T00:00:00Z
/products/product3  2024-11-19T00:00:00Z

* Remarque : l’en-tête de réponse HTTP last-modified réel est calculé en fonction des temps de modification des ressources contribuant à la réponse :

L’heure de modification la plus récente de ces ressources sera utilisée. Cela signifie que la valeur d’last-modified fournie peut ne pas être la valeur d’en-tête finale si, par exemple, la head.html est plus jeune.

Métadonnées supplémentaires

Lorsque des métadonnées sont gérées par plusieurs équipes, il n’est pas pratique de les conserver toutes dans les mêmes fichiers de métadonnées. La prise en charge multi-métadonnées est possible en configurant tous les fichiers de métadonnées qui doivent être pris en compte dans le fichier /.helix/config.xlsx :

L’ordre des entrées dans la liste détermine l’ordre dans lequel les données sont appliquées. L’ordre final des métadonnées est le suivant :

S’il n’existe metadata configuré dans le /.helix/config.xlsx :

s’il n’existe aucun ordre configuré :

Notez que les propriétés de métadonnées individuelles sont remplacées, mais jamais supprimées. Par exemple, si la /metadata.json définit une propriété title, la même propriété dans /metadata-2nd.json remplacera la valeur, mais uniquement si elle n’est pas vide.