Bygga in märkord i AEM building-tagging-into-aem-applications

I det här dokumentet beskrivs användningen av

som interagerar med

Mer information om taggning:

Översikt över taggnings-API overview-of-the-tagging-api

Implementeringen av taggningsramverket i AEM tillåter hantering av taggar och tagginnehåll med JCR-API:t. TagManager ser till att taggar som anges som värden i strängmatrisegenskapen cq:tags inte dupliceras, den tar bort TagID som pekar på taggar som inte finns och uppdaterar TagID för taggar som flyttas eller sammanfogas. TagManager använder en JCR-observationslyssnare som återställer felaktiga ändringar. Huvudklasserna finns i paketet com.day.cq.ta:

Hämta en JCR-baserad TagManager getting-a-jcr-based-tagmanager

Om du vill hämta en TagManager-instans måste du ha en JCR Session och anropa getTagManager(Session):

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

I det typiska Sling-sammanhanget kan du även anpassa dig till en TagManager från ResourceResolver:

TagManager tagManager = resourceResolver.adaptTo(TagManager.class);

Hämta ett taggobjekt retrieving-a-tag-object

En Tag kan hämtas via TagManager genom att antingen matcha en befintlig tagg eller skapa en:

Tag tag = tagManager.resolve("my/tag"); // for existing tags

Tag tag = tagManager.createTag("my/tag"); // for new tags

För den JCR-baserade implementeringen, som mappar Tags till JCR Nodes, kan du direkt använda Sling adaptTo-mekanismen om du har resursen (till exempel /content/cq:tags/default/my/tag):

Tag tag = resource.adaptTo(Tag.class);

En tagg kan bara konverteras från en resurs (inte en nod), men en tagg kan konverteras till både en nod och en resurs:

Node node = tag.adaptTo(Node.class);
Resource node = tag.adaptTo(Resource.class);

Hämta och ställa in taggar getting-and-setting-tags

// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);

// Setting tags to a Resource:
tagManager.setTags(resource, tags);

Söker efter taggar searching-for-tags

// Searching for the Resource objects that are tagged with the tag object:
Iterator<Resource> it = tag.find();

// Retrieving the usage count of the tag object:
long count = tag.getCount();

// Searching for the Resource objects that are tagged with the tagID String:
 RangeIterator<Resource> it = tagManager.find(tagID);

Ta bort taggar deleting-tags

tagManager.deleteTag(tag);

Replikerar taggar replicating-tags

Det går att använda replikeringstjänsten (Replicator) med taggar eftersom taggar är av typen nt:hierarchyNode:

replicator.replicate(session, replicationActionType, tagPath);

Taggskräpinsamlaren the-tag-garbage-collector

Taggskräpinsamlaren är en bakgrundstjänst som rensar de dolda och oanvända taggarna. Dolda och oanvända taggar är taggar under /content/cq:tags som har en cq:movedTo-egenskap och inte används på en innehållsnod. De har ett antal nollor. Genom att använda den här lat borttagningsprocessen behöver inte innehållsnoden (det vill säga egenskapen cq:tags) uppdateras som en del av flyttnings- eller sammanfogningsåtgärden. Referenserna i egenskapen cq:tags uppdateras automatiskt när egenskapen cq:tags uppdateras, till exempel via dialogrutan för sidegenskaper.

Taggskräpinsamlaren körs som standard en gång om dagen. Detta kan konfigureras på:

http://<host>:<port>/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

Märkordssökning och tagglista tag-search-and-tag-listing

Sökningen efter taggar och tagglistan fungerar enligt följande:

Taggar på olika språk tags-in-different-languages

En tagg title kan definieras på olika språk. Sedan läggs en språkkänslig egenskap till i taggnoden. Den här egenskapen har formatet jcr:title.<locale>, till exempel jcr:title.fr för den franska översättningen. <locale> måste vara en ISO-språksträng med gemener och använda understreck (_) i stället för bindestreck/tankstreck (-), till exempel: de_ch.

När taggen Djur läggs till på sidan Produkter läggs värdet stockphotography:animals till i egenskapen cq:tags för noden /content/wknd/en/products/jcr:content. Översättningen refereras från taggnoden.

API:t på serversidan har lokaliserade title-relaterade metoder:

I AEM kan språket hämtas antingen från sidspråket eller från användarspråket.

För taggning beror lokaliseringen på sammanhanget eftersom taggen titles kan visas på sidspråket, på användarspråket eller på något annat språk.

Lägga till ett nytt språk i dialogrutan Redigera tagg adding-a-new-language-to-the-edit-tag-dialog

I följande procedur beskrivs hur du lägger till ett nytt språk (till exempel finska) i dialogrutan Taggredigering:

Finska är nu tillgängligt i taggdialogrutan för sidegenskaperna och i dialogrutan Redigera tagg när du redigerar en tagg i konsolen Taggning.