標籤AEM框架

標籤允許對內容進行分類和組織。 標籤可以按命名空間和分類進行分類。 有關使用標籤的詳細資訊：

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

本文重點介紹支援標籤的底層框架AEM，以及如何將其作為開發者加以利用。

簡介

要標籤內容並利用「標籤」AEM基礎架構：

• 標籤必須作為類型的節點存在 cq:Tag 下 分類根節點。
• 標籤內容節點的 NodeType 必須包括 cq:Taggable 混音。
• 的 TagID 添加到內容節點的 cq:tags 屬性並解析為類型的節點 cq:Tag。

cq：標籤節點類型

標籤的聲明將捕獲在類型節點的儲存庫中 cq:Tag.

• 標籤可以是簡單單詞(例如， sky)或表示分層分類(例如 fruit/apple即普通水果和更具體的蘋果)。
• 標籤由唯一 TagID。
• 標籤具有可選的元資訊，例如標題、本地化標題和說明。 標題應顯示在用戶介面中，而不是 TagID，當存在時。

標籤框架還允許限製作者和站點訪問者僅使用特定的預定義標籤。

標籤特性

• 節點類型為 cq:Tag。
• 節點名稱是 TagID。
• 的 TagID 始終包括 命名空間。
• 的 jcr:title 屬性（要在UI中顯示的標題）是可選的。
• 的 jcr:description 屬性是可選的。
• 包含子節點時，稱為 容器標籤。
• 標籤儲存在儲存庫中名為 分類根節點。

標記 ID

A TagID 標識解析為儲存庫中標籤節點的路徑。

通常， TagID 是速記 TagID 從命名空間開始，或者它可以是絕對的 TagID 從 分類根節點。

當內容被標籤時，如果內容尚不存在， cq:tags 屬性將添加到內容節點， TagID 添加到 String 陣列值。

的 TagID 由 命名空間 接著是當地人 TagID。 容器標籤 具有表示分類中分層順序的子標籤。 子標籤可用於引用與任何本地標籤相同的標籤 TagID。 例如，用 fruit 允許，即使它是帶有子標籤的容器標籤，如 fruit/apple 和 fruit/banana。

分類根節點

分類根節點是儲存庫中所有標籤的基本路徑。 分類根節點必須 不 是一種類型的節點 cq:Tag。

在AEM中，基本路徑為 /content/cq:tags 根節點的類型 cq:Folder。

標籤命名空間

命名空間允許對內容進行分組。 最典型的使用情形是每個站點（例如，公共與內部）或每個較大的應用程式（例如，站點或資產）都有一個命名空間，但命名空間可用於各種其他需要。 在用戶介面中使用命名空間只顯示適用於當前內容的標籤子集（即特定命名空間的標籤）。

標籤的命名空間是分類子樹中的第一級，即緊靠在 分類根節點。 命名空間是類型的節點 cq:Tag 其父母不是 cq:Tag 節點類型。

所有標籤都具有命名空間。 如果未指定命名空間，則將標籤分配給預設命名空間， TagID default，即 /content/cq:tags/default。 標題預設為 Standard Tags在這種情況下。

容器標籤

容器標籤是類型的節點 cq:Tag 包含任意數量和類型的子節點，這使用自定義元資料增強標籤模型成為可能。

此外，分類中的容器標籤（或超標籤）是所有子標籤的子總和：例如，標籤為 fruit/apple 被視為帶有 fruit 也就是，搜索僅使用 fruit 還會找到標有 fruit/apple。

解析標籤ID

如果標籤ID包含冒號(:)，冒號將命名空間與標籤或子分類分開，然後用正常斜槓分開(/)。 如果標籤ID沒有冒號，則預設命名空間為默示命名空間。

標籤的標準和唯一位置低於 /content/cq:tags。

引用不指向的非現有路徑或路徑的標籤 cq:Tag 節點被視為無效且被忽略。

下表顯示了一些示例 TagIDs，它們的元素，以及 TagID 解析為儲存庫中的絕對路徑：

標籤標題的本地化

當標籤包含可選標題字串時 jcr:title，可以通過添加屬性來本地化顯示標題 jcr:title.<locale>。

有關詳細資訊，請參閱：

• 不同語言的標籤， 描述了API作為開發人員的使用
• 以不同語言管理標籤，描述了以管理員身份使用標籤控制台

存取控制

標籤作為節點存在於 分類根節點。 允許或拒絕作者和站點訪問者在給定命名空間中建立標籤可以通過在儲存庫中設定適當的ACL來實現。

拒絕某些標籤或命名空間的讀取權限將控制將標籤應用於特定內容的能力。

典型做法包括：

• 允許 tag-administrators 組/角色寫入訪問所有命名空間（在下添加/修改） /content/cq:tags)。 這組AEM帶有現成功能。
• 允許用戶/作者讀取對應可讀取的所有命名空間（大多為所有命名空間）的訪問權限。
• 允許用戶/作者對用戶/作者可自由定義標籤的命名空間進行寫入訪問(add_node 在 /content/cq:tags/some_namespace)

可聚集內容：cq：可聚集混合

為了讓應用程式開發人員將標籤附加到內容類型，節點的註冊(CND)必須包括 cq:Taggable 混合或 cq:OwnerTaggable 混音。

的 cq:OwnerTaggable mixin，它繼承自 cq:Taggable，意在表示內容可以由所有者/作者分類。 在AEM中，它只是 cq:PageContent 的下界。 的 cq:OwnerTaggable 標籤框架不需要mixin。

節點類型表示法(CND)

節點類型定義作為CND檔案存在於儲存庫中。 CND表示法定義為 JCR文檔。。

包含在中的節點類型的基本AEM定義如下：

[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

cq：標籤屬性

的 cq:tags 屬性 String 用於儲存一個或多個 TagID當作者或站點訪問者將它們應用於內容時。 僅當添加到使用 cq:Taggable 混音。

移動和合併標籤

以下是使用「標籤」控制台移動或合併標籤時儲存庫中效果的說明。

當標籤A被移動或合併到標籤B下時 /content/cq:tags:

• 未刪除標籤A並接收 cq:movedTo 屬性。

  • cq:movedTo 指向標籤B。

  • 此屬性表示標籤A已被移動或合併到標籤B中。

  • 移動標籤B將相應更新此屬性。

  • 因此標籤A被隱藏，並且僅被保存在儲存庫中以解析指向標籤A的內容節點中的標籤ID。

  • 標籤垃圾收集器會刪除標籤A等標籤，不再再將內容節點指向它們。

  • 的特殊值 cq:movedTo 屬性 nirvana，在刪除標籤時應用，但無法從儲存庫中刪除，因為存在帶有子標籤的 cq:movedTo 必須保留。

    注意

    的 cq:movedTo 僅當滿足以下任一條件時，才會將屬性添加到已移動或合併的標籤：

    1. 標籤用於內容（意味著它有引用）。 或
    2. 標籤包含已移動的子項。

• 建立標籤B（在移動時）並接收 cq:backlinks 屬性。

  • cq:backlinks 將引用保持在另一個方向，即保留已移動到標籤B或與標籤B合併的所有標籤的清單。

  • 這大部分是為了 cq:movedTo 屬性，當標籤B被移動/合併/刪除或標籤B被激活時，其所有後連結標籤也必須被激活。

    注意

    的 cq:backlinks 僅當滿足以下任一條件時，才會將屬性添加到已移動或合併的標籤：

    1. 標籤用於內容（意味著它有引用）。 或
    2. 標籤包含已移動的子項。

讀取 cq:tags 內容節點的屬性涉及以下解析：

1. 如果下面沒有匹配項 /content/cq:tags，不返回標籤。
2. 如果標籤具有 cq:movedTo 屬性集，引用的標籤ID後跟。
   • 只要後續標籤具有 cq:movedTo 屬性。
3. 如果跟隨的標籤沒有 cq:movedTo 屬性，標籤將被讀取。

要在移動或合併標籤時發佈更改， cq:Tag 必須複製節點及其所有回鏈。 在標籤管理控制台中激活標籤時，將自動執行此操作。

以後對頁面的更新 cq:tags 屬性自動清除舊引用。 觸發此觸發是因為通過API解析移動的標籤返回目標標籤，從而提供目標標籤ID。

Business.Adobe.com資源