將標籤構建到應AEM用程式中

為了以寫程式方式處理自定義應用程式中的標籤或擴展AEM標籤，本文檔介紹了

• 標籤API

與

• 標籤框架

有關標籤的相關資訊：

• 請參閱 使用標籤 中。
• 有關建立和管理標籤以及已應用哪些內容標籤的管理員視角，請參閱管理標籤。

標籤API概述

執行 標籤框架 允AEM許使用JCR API管理標籤和標籤內容。 TagManager 確保標籤在 cq:tags 字串陣列屬性不重複，它將刪除 TagID指向非現有標籤和更新 TagID用於移動或合併的標籤。 TagManager 使用JCR觀察偵聽器來還原任何不正確的更改。 主類位於 com.day.cq.ta 包：

• JcrTagManagerFactory — 返回基於JCR的 TagManager。 它是Tagging API的參考實現。
• TagManager — 允許按路徑和名稱解析和建立標籤。
• Tag — 定義標籤對象。

獲取基於JCR的TagManager

檢索 TagManager 實例，您需要一個JCR Session 打給 getTagManager(Session):

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

在典型的Sling上下文中，您還可以適應 TagManager 從 ResourceResolver:

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

檢索標籤對象

A Tag 可以通過 TagManager，通過解析現有標籤或建立新標籤：

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

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

用於基於JCR的實現，該 Tags 到JCR Nodes你可以直接用斯林 adaptTo 機制。 /content/cq:tags/default/my/tag):

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

當標籤只能被轉換時 從 資源（不是節點），可以轉換標籤 至 節點和資源：

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

獲取和設定標籤

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

// Setting tags to a Resource:
tagManager.setTags(resource, 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);

刪除標籤

tagManager.deleteTag(tag);

複製標籤

可以使用複製服務(Replicator)，因為標籤屬於類型 nt:hierarchyNode:

replicator.replicate(session, replicationActionType, tagPath);

標籤垃圾收集器

標籤垃圾回收器是一種後台服務，用於清除隱藏且未使用的標籤。 隱藏標籤和未使用標籤為下面的標籤 /content/cq:tags 有 cq:movedTo 屬性，且未在內容節點上使用。 他們的數為零。 通過使用此延遲刪除過程，內容節點(即 cq:tags 屬性)不必作為移動或合併操作的一部分進行更新。 中的引用 cq:tags 屬性在 cq:tags 屬性將更新，例如通過頁面屬性對話框。

預設情況下，標籤垃圾收集器每天運行一次。 可以在以下位置配置此項：

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

標籤搜索和標籤清單

搜索標籤和標籤清單工作如下：

• 搜索 TagID 搜索具有該屬性的標籤 cq:movedTo 設定為 TagID 然後穿過 cq:movedTo TagIDs
• 搜索標籤標題僅搜索沒有標籤的標籤 cq:movedTo 屬性。

不同語言中的標籤

標籤 title 可以用不同的語言定義。 然後，將語言敏感屬性添加到標籤節點。 此屬性的格式 jcr:title.<locale>，例如 jcr:title.fr 翻譯成法文。 <locale> 必須是ISO區域設定字串並使用下划線(_)而不是連字元/短划線(-)，例如： de_ch。

例如， 動物 標籤已添加到 產品 頁，該值 stockphotography:animals 添加到屬性 cq:tags 的 /content/wknd/en/products/jcr:content。 從標籤節點引用轉換。

伺服器端API已本地化 title — 相關方法：

• com.day.cq.tagging.Tag
  • getLocalizedTitle(Locale locale)
  • getLocalizedTitlePaths()
  • getLocalizedTitles()
  • getTitle(Locale locale)
  • getTitlePath(Locale locale)
• com.day.cq.tagging.TagManager
  • canCreateTagByTitle(String tagTitlePath, Locale locale)
  • createTagByTitle(String tagTitlePath, Locale locale)
  • resolveByTitle(String tagTitlePath, Locale locale)

在中AEM，語言可以從頁面語言或用戶語言獲得。

對於標籤，本地化取決於上下文作為標籤 titles 可以以頁面語言、用戶語言或任何其他語言顯示。

向「編輯標籤」對話框添加新語言

以下過程介紹如何向 標籤編輯 對話框：

1. 在 克爾克斯德，編輯多值屬性 languages 的 /content/cq:tags。
2. 添加 fi_fi，表示芬蘭語言環境並保存更改。

芬蘭語現在可在頁面屬性的標籤對話框中使用， 編輯標籤 編輯標籤時 標籤 控制台。