將標籤建置到AEM應用程式中 building-tagging-into-an-aem-application

若要以程式設計方式使用自訂AEM應用程式中的標籤或擴充標籤，本頁會說明如何使用

那個會與

如需關於標籤的相關資訊，請參閱：

標籤API的總覽 overview-of-the-tagging-api

實作 標籤框架 允許在AEM中使用JCR API管理標籤和標籤內容。 TagManager會確保在 cq:tags 字串陣列屬性不會重複，它會移除指向不存在標籤的TagID，並更新已移動或合併標籤的標籤ID。 TagManager會使用JCR觀察監聽器來回覆任何不正確的變更。 主要類別位於 com.day.cq.tagg 封裝：

取得JCR型TagManager getting-a-jcr-based-tagmanager

若要擷取TagManager例項，您必須有JCR Session 並呼叫 getTagManager(Session)：

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

在一般Sling情境下，您也可以調整 TagManager 從 ResourceResolver：

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

擷取標籤物件 retrieving-a-tag-object

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，您可以直接使用Sling 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-and-setting-tags

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

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

搜尋標籤 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);

刪除標記 deleting-tags

tagManager.deleteTag(tag);

複製標籤 replicating-tags

可以使用復寫服務( Replicator)與標籤，因為標籤的型別為 nt:hierarchyNode：

replicator.replicate(session, replicationActionType, tagPath);

在使用者端上標籤 tagging-on-the-client-side

表單Widget CQ.tagging.TagInputField 用於輸入標籤。 它有一個彈出式選單，可供您從現有標籤中選取，包括自動完成和許多其他功能。 其xtype為 tags.

標籤記憶體回收器 the-tag-garbage-collector

標籤記憶體回收行程是一種背景服務，可清除隱藏且未使用的標籤。 隱藏和未使用的標籤是底下的標籤 /content/cq:tags 具有 cq:movedTo 屬性且不會在內容節點上使用 — 它們的計數為零。 透過使用此延遲刪除程式，內容節點(即 cq:tags 屬性)，不必隨著移動或合併作業進行更新。 中的參照 cq:tags 屬性會在 cq:tags 屬性會更新，例如透過頁面屬性對話方塊。

標籤記憶體回收行程預設為每天執行一次。 您可以在下列位置進行設定：

http://localhost:4502/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

標籤搜尋和標籤清單 tag-search-and-tag-listing

搜尋標籤和標籤清單的工作方式如下：

不同語言的標籤 tags-in-different-languages

如管理標籤的檔案一節中所述 管理不同語言的標籤，標籤 title能以不同語言定義。 然後，區分語言的屬性會新增至標籤節點。 此屬性的格式為 jcr:title.<locale>例如， jcr:title.fr 以取得法文翻譯。 此 <locale> 必須為小寫ISO地區設定字串，並使用「_」而非「 — 」，例如： de_ch.

當 動物 標籤已新增至 產品 頁面，值 stockphotography:animals 會新增至屬性 cq:tags /content/geometrixx/en/products/jcr：content節點的 將從標籤節點引用翻譯。

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

在AEM中，可以從頁面語言或使用者語言取得語言：

此 currentPage 和 slingRequest 可在JSP中使用，透過 <cq:definedobjects> 標籤之間。

對於標籤，本地化取決於作為標籤的內容 titles能以頁面語言、使用者語言或任何其他語言顯示。

新增語言至編輯標籤對話方塊 adding-a-new-language-to-the-edit-tag-dialog

下列程式說明如何將語言（芬蘭文）新增至 標籤編輯 對話方塊：

新語言（芬蘭文）現在可以在頁面屬性的標籤對話方塊和 編輯標籤 對話方塊 標籤 主控台。