文件AEM 6.5使用手冊

AEM 標記框架 aem-tagging-framework

Last update: Thu Aug 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

標籤可讓內容分類並整理。 標籤可以依名稱空間和分類法來分類。 如需使用標籤的詳細資訊：

  • 如需將內容標籤為內容作者的相關資訊，請參閱檔案使用標籤。
  • 如需管理員建立和管理標籤以及已套用至哪些內容標籤的觀點，請參閱檔案管理標籤。

本文主要介紹在AEM中支援標籤的基本架構，以及如何作為開發人員使用它。

簡介 introduction

若要標籤內容及使用AEM標籤基礎架構：

  • 標籤必須存在為🔗分類根節點下型別[cq:Tag](#tags-cq-tag-node-type)的節點。

  • 標籤的內容節點的NodeType必須包含cq:Taggable mixin。

  • TagID已新增至內容節點的cq:tags屬性，並解析為型別 [cq:Tag](#tags-cq-tag-node-type)的節點。

標籤：cq：Tag節點型別 tags-cq-tag-node-type

在型別cq:Tag的節點中的儲存庫中擷取標籤的宣告。

標籤可以是簡單字詞（例如，sky），或代表階層式分類法（例如，fruit/apple，表示泛型fruit和更具體的apple）。

標籤由唯一的TagID識別。

標籤具有可選的中繼資訊，例如標題、當地語系化的標題和說明。 出現時，標題應顯示在使用者介面中，而非TagID。

標籤架構也提供限製作者和網站訪客僅使用特定、預先定義標籤的功能。

標籤特性 tag-characteristics

由於標籤只是JCR節點，因此節點名稱必須遵守JCR命名慣例。

標記 ID tagid

TagID會識別解析為存放庫中的標籤節點的路徑。

通常，TagID是以名稱空間開頭的簡寫TagID，或是從分類根節點開頭的絕對TagID。

標籤內容時，如果內容尚不存在，[cq:tags](#tagged-content-cq-tags-property)屬性會新增至內容節點，而TagID會新增至屬性的String陣列值。

TagID包含名稱空間，後面接著本機TagID。 容器標籤的子標籤代表分類法中的階層順序。 子標籤可用於參照與任何本機TagID相同的標籤。 例如，允許使用fruit標籤內容，即使它是具有子標籤的容器標籤，例如fruit/apple和fruit/banana。

分類根節點 taxonomy-root-node

分類根節點是存放庫中所有標籤的基本路徑。 分類根節點不能是型別cq:Tag的節點。

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

標籤名稱空間 tag-namespace

名稱空間可讓您將專案分組。 最典型的使用案例是每個網站的名稱空間（例如公用、內部和入口網站）或大型應用程式(例如WCM、Assets、Communities)。 但名稱空間可用於各種其他需求。 在使用者介面中使用名稱空間，以僅顯示適用於目前內容的標籤子集（即特定名稱空間的標籤）。

標籤的名稱空間是分類子樹狀結構中的第一個層級，它是分類根節點正下方的節點。 名稱空間是型別cq:Tag的節點，其父系不是cq:Tag節點型別。

所有標籤都有名稱空間。 如果未指定名稱空間，則會將標籤指派給預設名稱空間，也就是標題為Standard Tags的TagID default，也就是/content/cq:tags/default。

容器標籤 container-tags

容器標籤是型別cq:Tag的節點，包含任何數目和型別的子節點，因此可以使用自訂中繼資料增強標籤模型。

此外，分類法中的容器標籤（或超級標籤）可作為所有子標籤的包含。 例如，以fruit/apple標籤的內容也被視為以fruit標籤。 也就是說，搜尋以fruit標籤的內容也會找到以fruit/apple標籤的內容。

解析TagID resolving-tagids

如果TagID包含冒號(:)，冒號會將名稱空間與標籤或子分類分開，再以斜線(/)分隔。 如果TagID沒有冒號，則會隱含預設名稱空間。

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

參照不存在的路徑或不指向cq:Tag節點的路徑的標籤會被視為無效並被忽略。

下表顯示一些TagID範例、其元素，以及TagID如何解析為存放庫中的絕對路徑：

標記 ID
命名空間
本機ID
容器標籤
分葉標籤
存放庫絕對標籤路徑
dam:fruit/apple/braeburn
dam
fruit/apple/braeburn
fruit、apple
braeburn
/content/cq:tags/dam/fruit/apple/braeburn
color/red
default
color/red
color
red
/content/cq:tags/default/color/red
sky
default
sky
無
sky
/content/cq:tags/default/sky
dam:
dam
無
無
無，名稱空間
/content/cq:tags/dam
/content/cq:tags/category/car
category
car
car
car
/content/cq:tags/category/car

標籤標題本地化 localization-of-tag-title

當標籤包含選擇性標題字串( jcr:title)時，可以新增屬性jcr:title.<locale>來本地化顯示的標題。

如需詳細資訊，請參閱下列檔案：

存取控制 access-control

標籤在分類根節點下的儲存庫中作為節點存在。 若要允許或拒絕作者和網站訪客在指定的名稱空間中建立標籤，可在存放庫中設定適當的ACL。

此外，拒絕某些標籤或名稱空間的讀取許可權會控制將標籤套用至特定內容的能力。

典型做法包括：

  • 允許tag-administrators群組/角色對所有名稱空間的寫入存取權（在/content/cq:tags下新增/修改）。 此群組隨附AEM立即可用。
  • 允許使用者/作者讀取他們應可讀取的所有名稱空間（幾乎全部）。
  • 允許使用者/作者寫入存取那些標籤應該可由使用者/作者自由定義的名稱空間（在/content/cq:tags/some_namespace下新增節點）

可標籤的內容：cq：Taggable Mixin taggable-content-cq-taggable-mixin

若要讓應用程式開發人員將標籤附加至內容型別，節點的註冊(CND)必須包含cq:Taggable mixin或cq:OwnerTaggable mixin。

繼承自cq:Taggable的cq:OwnerTaggable mixin旨在表示內容可由擁有者/作者分類。 在AEM中，它只是cq:PageContent節點的屬性。 標籤架構不需要cq:OwnerTaggable mixin。

NOTE
建議僅在彙總內容專案的頂層節點（或其jcr:content節點）上啟用標籤。 例如：
  • jcr:content節點屬於包含cq:Taggable mixin之cq:PageContent型別的頁面(cq:Page)
  • Assets ( cq:Asset)，其中jcr:content/metadata節點一律有cq:Taggable mixin

節點型別標籤法(CND) node-type-notation-cnd

節點型別定義以CND檔案的形式存在於存放庫中。 CND標籤法定義為Jackrabbit檔案的一部分。

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：tags屬性 tagged-content-cq-tags-property

cq:tags屬性是String陣列，用來儲存一或多個TagID （當作者或網站訪客套用至內容時）。 屬性只有在新增至使用[cq:Taggable](#taggable-content-cq-taggable-mixin) mixin定義的節點時才有意義。

NOTE
若要使用AEM標籤功能，自訂開發的應用程式不應定義cq:tags以外的標籤屬性。

移動和合併標籤 moving-and-merging-tags

以下是使用標籤主控台移動或合併標籤時，儲存庫中的效果說明：

  • 將標籤A移動或合併到/content/cq:tags下的標籤B中時：

    • 標籤A未刪除並取得cq:movedTo屬性。
    • 標籤B已建立（如果有移動）並取得cq:backlinks屬性。

  • cq:movedTo指向標籤B。

    • 此屬性表示標籤A已移動或合併到標籤B中。移動標籤B會相應地更新此屬性。 因此標籤A會隱藏，並僅保留在存放庫中，以解析指向標籤A的內容節點中的標籤ID。標籤記憶體回收行程會移除標籤A，如此一來，內容節點便不再指向這些標籤。

    • cq:movedTo屬性的特殊值為nirvana。 它會在標籤刪除時套用，但無法從存放庫移除，因為必須保留具有cq:movedTo的子標籤。

    note note
    NOTE
    只有在符合下列任一條件時，cq:movedTo屬性才會新增至移動或合併的標籤：
    1. 標籤用於內容中（表示它有參考）或
    2. 標籤具有已移動的子系。

  • cq:backlinks會將參照保持在另一個方向。 也就是說，它會保留所有已移至標籤B或與標籤B合併的標籤清單。若要在移動/合併/刪除標籤B時或啟用標籤B時保持cq:movedTo屬性為最新狀態（在此情況下，也必須啟用其所有反向連結標籤），這通常為必要專案。

    note note
    NOTE
    只有在符合下列任一條件時，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。

NOTE
標籤的移動與標籤的移轉不同。

標籤移轉 tags-migration

自Adobe Experience Manager 6.4起，標籤會儲存在/content/cq:tags下，而舊版儲存在/etc/tags下。

從6.4之前的版本升級AEM系統時，必須將標籤移轉至/content/cq:tags。 如需詳細資訊，請參閱AEM 6.5中的一般存放庫重組。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2