AEM Taggningsramverk aem-tagging-framework

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:

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

Introduktion introduction

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

Taggar : cq:Tag Node Type tags-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 fruit och den mer specifika apple).

Taggar identifieras av ett unikt 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.

Med taggningsramverket kan du även begränsa möjligheten för författare och besökare att endast använda specifika, fördefinierade taggar.

Märkordsegenskaper tag-characteristics

Eftersom taggar bara är JCR-noder måste nodnamnen följa namnkonventionen JCR.

TaggID tagid

Ett TagID identifierar en sökväg som löses till en taggnod i databasen.

TagID är vanligtvis ett kort TagID som börjar med namnutrymmet eller så kan det vara ett absolut TagID med början från taxonomirotnoden.

Om innehållet är taggat och inte finns ännu, läggs egenskapen [cq:tags](#tagged-content-cq-tags-property) till i innehållsnoden och TagID läggs till i egenskapens String-arrayvärde.

TagID består av ett namnområde följt av det lokala TagID:t. 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 taxonomy-root-node

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 tag-namespace

Med namnutrymmen kan du gruppera saker. Det vanligaste användningsfallet är ett namnutrymme per webbplats (till exempel public, internal och portal) eller per större program (till exempel WCM, Assets, Communities). Men namnutrymmen kan användas för olika 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 med titeln Standard Tags, d.v.s. /content/cq:tags/default.

Behållartaggar container-tags

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 undertaggar till alla undertaggar. Innehåll som är taggat med fruit/apple anses till exempel även vara 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.

Lösa tagg-ID:n resolving-tagids

Om TagID innehåller ett kolon (:) separerar kolon namnutrymmet från taggen eller subtaxonomin, som avgränsas ytterligare med snedstreck (/). Om TagID inte har ett kolon används standardnamnutrymmet.

Standardplatsen och den enda platsen för taggar är under /content/cq:tags.

Tagg som refererar till icke-befintliga sökvägar eller sökvägar som inte pekar på en cq:Tag-nod betraktas som ogiltiga och ignoreras.

I följande tabell visas några exempel på tagg-ID:n, deras element och hur tagg-ID:t tolkas till en absolut sökväg i databasen:

Lokalisering av taggtitel localization-of-tag-title

När taggen innehåller den valfria titelsträngen ( jcr:title) går det att lokalisera titeln för visning genom att lägga till egenskapen jcr:title.<locale>.

Mer information finns i följande dokument:

Åtkomstkontroll access-control

Taggar finns som noder i databasen under taxonomirotnoden. Du kan skapa taggar i ett givet namnutrymme genom att ange lämpliga åtkomstkontrollistor i databasen, så att författare och besökare kan neka eller neka åtkomst.

Om du dessutom nekar läsbehörighet för vissa taggar eller namnutrymmen kan du använda taggar för visst innehåll.

Ett typiskt exempel är:

Taggbart innehåll : cq:Taggable Mixin taggable-content-cq-taggable-mixin

För att programutvecklare ska kunna bifoga taggning till en innehållstyp måste nodens registrering (CND) innehålla cq:Taggable mixin eller cq:OwnerTaggable mixin.

cq:OwnerTaggable-blandningen, som ärver från cq:Taggable, är avsedd att indikera att innehållet kan klassificeras av ägaren/författaren. I AEM är det bara ett attribut för noden cq:PageContent. cq:OwnerTaggable-blandningen krävs inte av taggningsramverket.

Nodtypsnotation (CND) node-type-notation-cnd

Det finns nodtypsdefinitioner i databasen som CND-filer. CND-notationen definieras som en del av JCR-dokumentationen här.

De viktigaste definitionerna för nodtyperna i AEM är följande:

[cq:Tag] > mix:title, nt:base
    orderable
    - * (undefined) multiple
    - * (undefined)
    + * (nt:base) = cq:Tag version

[cq:Taggable]
    mixin
    - cq:tags (string) multiple

[cq:OwnerTaggable] > cq:Taggable
    mixin

Taggat innehåll: egenskapen cq:tags tagged-content-cq-tags-property

Egenskapen cq:tags är en String-matris som används för att lagra ett eller flera TagID:n när de tillämpas på innehåll av författare eller webbplatsbesökare. Egenskapen har bara betydelse när den läggs till i en nod som har definierats med [cq:Taggable](#taggable-content-cq-taggable-mixin)-mixinen.

Flytta och sammanfoga taggar moving-and-merging-tags

Nedan följer en beskrivning av effekterna i databasen när du flyttar eller sammanfogar taggar med taggningskonsolen:

Taggmigrering tags-migration

Sedan Adobe Experience Manager 6.4 lagras taggar under /content/cq:tags medan tidigare versioner lagrar taggar under /etc/tags.

När du uppgraderar ett AEM från en version som är tidigare än 6.4 måste taggar migreras till /content/cq:tags. Mer information finns i Omstrukturering av gemensamma databaser i AEM 6.5.