Hantera taxonomidata managing-taxonomy-data

Lär dig hur du hanterar taxonomidata för att använda taggar med dina AEM med Edge Delivery Services.

Introduktion introduction

Taggning är en viktig funktion som hjälper dig att ordna och hantera dina sidor. Med taggningskonsolen i AEM kan du skapa en omfattande taxonomi med taggar för att ordna sidorna.

Dessa taggar är användbara inte bara för dig och dina författare när du organiserar ditt innehåll, utan kan även vara till för dina läsare. Taggar och deras taxonomi kan användas i komponenter på sidan för att hjälpa läsarna navigera i innehållet.

Universal Editor fungerar bara med ID:n för dina taggar. Genom att skapa en taxonomisida för ditt innehåll visar du beskrivningarna av taggarna på alla språk för den universella redigeraren så att den kan använda den informationen när du återger innehåll.

Skapa en taxonomisida creating

En taxonomi skapas som en annan sida i AEM.

Taxonomisidan skapas. I dialogrutan Slutfört kan du trycka på eller klicka på dialogrutan Klart för att stänga meddelandet eller Öppna för att redigera sidan i sidredigeraren.

Observera det resulterande sidnamnet på taxonomisidan som kan användas i följande steg.

Redigera en taxonomisida editing

Du börjar redigera en taxonomisida precis som andra sidor i AEM.

Sidan som visas i sidredigeraren är skrivskyddad eftersom innehållet i taxonomin genereras automatiskt från de markerade taggarna och namnutrymmena. De fungerar som en typ av filter som automatiskt genererar innehållet i taxonomin. Därför finns det ingen anledning att redigera sidan direkt i redigeraren.

AEM uppdaterar automatiskt innehållet på taxonomisidan när du uppdaterar underliggande taggar och namnutrymmen. Du måste publicera taxonomin igen efter en ändring för att göra ändringarna tillgängliga för dina användare.

Uppdatera paths.json för taxonomipublikation paths-json

Som när hanterar och publicerar tabelldata för din Edge Delivery Services-webbplats måste du uppdatera paths.json-filen för ditt projekt så att dina taxonomidata kan publiceras.

Den här processen behöver bara göras en gång per taxonomisida. När du är klar kan du publicera taxonomin.

Publicera en taxonomi publishing

En taxonomi är inte tillgänglig för Universal Editor eller dina användare förrän den publiceras.

Taxonomisidor publiceras på samma sätt som andra sidor av med hjälp av ikonerna Quick Publish eller Manage Publication i verktygsfältet.

Du måste publicera taxonomisidan igen varje gång du:

Om du skapar en ny taxonomisida måste du först lägga till en mappning till den i paths.json-filen i projektet.

Åtkomst till taxonomiinformation accessing

När taxonomin publicerats kan informationen utnyttjas av den universella redigeraren och göras synlig för användarna.

Du kan komma åt taxonomin som JSON-data på följande adress.

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

Använd <taxonomy-json-name> som du definierade när du mappar taxonomin till paths.json-filen i projektet. Taxonomidata returneras som JSON-data, som i följande exempel.

{
  "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"
}

Dessa JSON-data uppdateras automatiskt när du uppdaterar taxonomin och publicerar den på nytt. Ditt program kan programmässigt komma åt den här informationen för dina användare.

Om du behåller taggar på flera språkkan du komma åt dessa språk genom att skicka ISO2-språkkoden som värdet för en sheet= -parameter.