AEM Taggning Framework

Senast uppdaterad: 5 februari 2025
  • Gäller:
  • Experience Manager as a Cloud Service

Skapat för:

  • Administratör
  • Utvecklare

Taggning gör att innehållet kan kategoriseras och struktureras. Taggar kan klassificeras med ett namnutrymme och en taxonomi. Mer information om hur du använder taggar:

  • Mer information om hur du taggar innehåll som innehållsförfattare finns i Använda taggar.
  • Se Administrera taggar för administratörens perspektiv om hur du skapar och hanterar taggar, och i vilka innehållstaggar har tillämpats.

Den här artikeln fokuserar på det underliggande ramverket som stöder taggning i AEM och hur det används som utvecklare.

Introduktion

Så här taggar du innehåll och använder infrastrukturen för AEM taggar:

cq:Tag Node Type

Deklarationen för en tagg hämtas i databasen i en nod av typen cq:Tag.

  • En tagg kan vara ett enkelt ord (till exempel sky) eller representera en hierarkisk taxonomi (till exempel fruit/apple, vilket betyder både den generiska frukten och det mer specifika äpplet).
  • Taggar identifieras av en unik TagID.
  • En tagg har valfri metainformation, t.ex. en titel, lokaliserade titlar och en beskrivning. Titeln ska visas i användargränssnitt i stället för i TagID, om det finns någon.

Ramverket för taggning begränsar också författare och besökare till att endast använda specifika, fördefinierade taggar.

Märkordsegenskaper

  • Nodtypen är cq:Tag.
  • Nodnamnet är en komponent i TagID.
  • TagID innehåller alltid ett namnutrymme.
  • Egenskapen jcr:title (den titel som ska visas i användargränssnittet) är valfri.
  • Egenskapen jcr:description är valfri.
  • När de innehåller underordnade noder kallas det en behållartagg.
  • Taggen lagras i databasen under en bassökväg som kallas taxonomirotnod.

TaggID

En TagID identifierar en sökväg som tolkas till en taggnod i databasen.

Vanligtvis är TagID en förkortning TagID som börjar med namnutrymmet eller så kan det vara en absolut TagID som börjar med taxonomirotnoden.

Om innehållet är taggat och inte finns ännu, läggs egenskapen cq:tags till i innehållsnoden och TagID läggs till i egenskapens String-arrayvärde.

TagID består av ett namnutrymme följt av det lokala TagID. Behållartaggar har undertaggar som representerar en hierarkisk ordning i taxonomin. Undertaggar kan användas för att referera till taggar som är samma som alla lokala TagID. Du kan till exempel tagga innehåll med fruit, även om det är en behållartagg med undertaggar, till exempel fruit/apple och fruit/banana.

Taxonomirotnod

Taxonomirotnoden är grundsökvägen för alla taggar i databasen. Taxonomirotnoden får inte vara en nod av typen cq:Tag.

I AEM är bassökvägen /content/cq:tags och rotnoden är av typen cq:Folder.

Namnutrymme för tagg

Med namnutrymmen kan du gruppera saker. Det vanligaste är att ha ett namnutrymme per plats (till exempel public kontra internal) eller per större program (till exempel Sites eller Assets), men namnutrymmen kan användas för olika andra behov. Namnutrymmen används i användargränssnittet för att endast visa deluppsättningen med taggar (d.v.s. taggar för ett visst namnutrymme) som kan användas för det aktuella innehållet.

Taggens namnområde är den första nivån i taxonomiunderträdet, som är noden direkt under taxonomirotnoden. Ett namnområde är en nod av typen cq:Tag vars överordnade nod inte är en cq:Tag-nodtyp.

Alla taggar har ett namnutrymme. Om inget namnutrymme anges tilldelas taggen standardnamnutrymmet, som är TagID default, d.v.s. /content/cq:tags/default. Titeln är som standard Standard Tags.

Behållartaggar

En behållartagg är en nod av typen cq:Tag som innehåller valfritt antal och valfri typ av underordnade noder, vilket gör det möjligt att förbättra taggmodellen med anpassade metadata.

Dessutom fungerar behållartaggar (eller supertaggar) i en taxonomi som delsummering av alla undertaggar. Innehåll som taggats med fruit/apple betraktas till exempel också som taggat med fruit. Det innebär att om du söker efter innehåll som är taggat med fruit så hittas även innehållet som är taggat med fruit/apple.