AEM Tagging Framework

标记允许对内容进行分类和组织。 标记可以按命名空间和分类进行分类。 有关使用标记的详细信息:

  • 有关将内容标记为内容作者的信息,请参阅使用标记
  • 有关创建和管理标记以及已应用哪些内容标记的管理员观点,请参阅管理标记。

本文重点介绍支持AEM中标记的底层框架以及如何将其作为开发人员使用。

简介

要标记内容并利用AEM Tagging基础结构:

cq:标记节点类型

标记声明在cq:Tag.类型的节点中的存储库中捕获

  • 标记可以是简单的单词(例如,(例如,sky,表示通用水果和更具体的苹果)。fruit/apple
  • 标记由唯一TagID标识。
  • 标记具有可选的元信息,如标题、本地化标题和说明。 标题应显示在用户界面中,而不是TagID(如果存在)。

标记框架还允许限制作者和站点访客仅使用特定的预定义标记。

标记特性

标记 ID

TagID标识解析到存储库中标记节点的路径。

通常,TagID是以命名空间开头的速记TagID,也可以是从分类根节点开始的绝对TagID

标记内容时,如果内容尚不存在,则cq:tags属性将添加到内容节点,TagID将添加到属性的String数组值。

TagID命名空间和本地TagID组成。 容器 标语子标签,表示分类中的分层顺序。子标签可用于引用与任何本地TagID相同的标签。 例如,允许用fruit标记内容,即使它是具有子标签(如fruit/applefruit/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标记的内容。

解析TagID

如果标记ID包含冒号(:),则冒号将命名空间与标记或子分类分开,然后用正斜杠(/)分开。 如果标记ID没有冒号,则默示默认命名空间。

标记的标准和唯一位置低于/content/cq:tags

引用不指向cq:Tag节点的非现有路径或路径的标记被视为无效并被忽略。

下表显示了一些示例TagIDs、其元素,以及TagID如何解析为存储库中的绝对路径:

TagID 命名空间 本地ID 容器标记 Leaf标签 存储库绝对标记路径
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

标记标题本地化

当标记包含可选的标题字符串jcr:title时,可以通过添加属性jcr:title.<locale>来本地化要显示的标题。

有关详细信息,请参阅:

  • 不同语言的标 签,描述API作为开发人员的使用
  • 管理不同语言的标记,其中描述了以管理员身份使用标记控制台

访问控制

标记作为节点存在于分类根节点下的存储库中。 允许或拒绝作者和站点访客在给定命名空间中创建标记,可以通过在存储库中设置适当的ACL。

拒绝某些标记或命名空间的读取权限将控制将标记应用于特定内容的能力。

典型做法包括:

  • 允许tag-administrators组/角色对所有命名空间进行写入访问(在/content/cq:tags下添加/修改)。 这个组随附AEM即装即用。
  • 允许用户/作者读取应可读的所有命名空间(大多数)。
  • 允许用户/作者对用户/作者可自由定义标记的命名空间进行写入访问(/content/cq:tags/some_namespace下的add_node

可标记内容:cq:Taggable Mixin

为了使应用程序开发人员将标记附加到内容类型,节点的注册(CND)必须包括cq:Taggable混音或cq:OwnerTaggable混音。

继承自cq:Taggablecq:OwnerTaggable混音旨在指示内容可由所有者/作者分类。 在AEM中,它只是cq:PageContent节点的属性。 标记框架不需要cq:OwnerTaggable混音。

注意

建议仅在聚集内容项(或其jcr:content节点)的顶级节点上启用标记。 示例包括:

  • 页(cq:Page),其中jcr:content节点类型为cq:PageContent,其中包括cq:Taggable混音。
  • 资产(cq:Asset),其中jcr:content/metadata节点始终具有cq:Taggable混音。

节点类型表示法(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:tags属性

cq:tags属性是String数组,当作者或站点访客将TagID应用于内容时,它们用于存储一个或多个<a2/>。 仅当添加到使用cq:Taggable mixin定义的节点时,该属性才有意义。

注意

要利用AEM标记功能,自定义开发的应用程序不应定义cq:tags以外的标记属性。

移动和合并标记

以下是使用标记控制台移动或合并标记时存储库中效果的说明。

当标记A被移动或合并到/content/cq:tags下的标记B中时:

  • 未删除标记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合并的所有标记的列表。

    • 当标记B被移动/合并/删除或标记B被激活时,这通常要求使cq:movedTo属性保持最新,在这种情况下,必须同时激活其所有反向链接标记。

      注意

      仅当满足以下任一条件时,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而触发的。

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now