Gérer des données taxonomiques managing-taxonomy-data

Découvrez comment gérer les données de taxonomie pour utiliser des balises avec votre AEM avec des sites Edge Delivery Services.

Présentation introduction

Le balisage est une fonctionnalité importante qui vous aide à organiser et gérer vos pages. La console de balisage dans AEM vous permet de créer une taxonomie riche de balises pour organiser vos pages.

Ces balises s’avèrent utiles non seulement pour vous et vos auteurs dans l’organisation de votre contenu, mais également pour vos lecteurs. Les balises et leur taxonomie peuvent être utilisées dans les composants de la page pour aider vos lecteurs à parcourir votre contenu.

L’éditeur universel fonctionne uniquement avec les identifiants de vos balises. En créant une page de taxonomie pour votre contenu, vous exposez les descriptions de ces balises dans toutes les langues à l’éditeur universel afin qu’il puisse utiliser ces informations lors du rendu du contenu.

Créer une page de taxonomie creating

Une taxonomie est créée comme toute autre page dans AEM.

La page de taxonomie est créée. Dans la boîte de dialogue Succès, vous pouvez appuyer ou cliquer sur la boîte de dialogue Terminé pour ignorer le message ou sur Ouvrir pour modifier la page dans l’ Éditeur de page.

Prenez note du nom de page obtenu de la page de taxonomie à utiliser dans les étapes suivantes.

Modification d’une page de taxonomie editing

Vous commencez à modifier une page de taxonomie comme toute autre page dans AEM.

La page affichée dans l’éditeur de page est en lecture seule, car le contenu de la taxonomie est généré automatiquement à partir des balises et espaces de noms sélectionnés. Ils agissent comme une sorte de filtre pour générer automatiquement le contenu de la taxonomie. Il n’y a donc aucune raison de modifier directement la page dans l’éditeur.

AEM met automatiquement à jour le contenu de la page de taxonomie lorsque vous mettez à jour les balises et les espaces de noms sous-jacents. Cependant, vous devez republier la taxonomie après toute modification pour que ces modifications soient disponibles pour vos utilisateurs.

Mise à jour de paths.json pour la publication de taxonomie paths-json

Comme lorsque vous gérez et publiez des données tabulaires pour votre site de Edge Delivery Services,vous devez mettre à jour votre fichier paths.json de votre projet pour permettre la publication de vos données de taxonomie.

Ce processus ne doit être effectué qu’une seule fois par page de taxonomie. Une fois cette opération terminée, vous pouvez publier votre taxonomie.

Publier une taxonomie publishing

Une taxonomie n’est pas disponible pour l’éditeur universel ou vos utilisateurs tant qu’elle n’a pas été publiée.

Les pages de taxonomie sont publiées comme n'importe quelle autre page par à l'aide des icônes Quick Publish ou Gérer la publication de la barre d'outils.

Vous devez republier votre page de taxonomie à chaque fois que vous :

Si vous créez une page de taxonomie, vous devez d'abord y ajouter un mappage au fichier paths.json de votre projet.

Accès aux informations sur la taxonomie accessing

Une fois votre taxonomie publiée, ses informations peuvent être exploitées par l’éditeur universel et rendues visibles par vos utilisateurs.

Vous pouvez accéder à la taxonomie en tant que données JSON à l’adresse suivante.

https://<branch>--<repository>--<owner>.hlx.page/<taxonomy-json-name>.json

Utilisez le <taxonomy-json-name> que vous avez défini lors du mappage de votre taxonomie au fichier paths.json de votre projet. Les données de taxonomie sont renvoyées sous forme de données JSON, comme dans l’exemple suivant.

{
  "total": 3,
  "offset": 0,
  "limit": 3,
  "data": [
    {
      "tag": "default:",
      "title": "Standard Tags"
    },
    {
      "tag": "do-not-translate",
      "title": "Do Not Translate"
    },
    {
      "tag": "translate",
      "title": "Translate"
    }
  ],
  ":type": "sheet"
}

Ces données JSON sont automatiquement mises à jour lorsque vous mettez à jour la taxonomie et que vous la republiez. Votre application peut accéder à ces informations par programmation pour vos utilisateurs.

Si vous conservez des balises dans plusieurs langues, vous pouvez accéder à ces langues en transmettant le code de langue ISO2 comme valeur d’un paramètre sheet=.