AEM Tagging Framework

要标记内容并利用AEM标记基础结构，请执行以下操作：

• 标记必须作为分类根节点下的cq:Tag类型的节点存在

• 标记内容节点的NodeType必须包含cq:Taggable mixin

• TagID将添加到内容节点的cq:tags属性中，并解析为cq:Tag类型的节点

标记：cq：标记节点类型

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

标记可以是一个简单的词（如sky）或表示分层分类（如果/苹果，即通用水果和更具体的苹果）。

标记由唯一的标记ID标识。

标记具有可选的元信息，如标题、本地化标题和描述。 标题应在用户界面中显示，而不是TagID（如果存在）。

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

标记特征

• 节点类型为cq:Tag

• 节点名称是TagID的组件

• TagID始终包含namespace

• 可选jcr:title属性（要在UI中显示的标题）

• 可选jcr:description属性

• 包含子节点时，称为容器标记

• 存储在名为分类根节点的基本路径下的存储库中

标记 ID

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

通常，TagID是以命名空间开头的简写TagID，也可以是从分类根节点开始的绝对TagID。

标记内容后，如果内容尚不存在，则会将cq:tags属性添加到内容节点，并将TagID添加到属性的字符串数组值。

TagID由namespace和本地TagID组成。 容器 标记子标记，表示分类中的分层顺序。子标记可用于引用与任何本地TagID相同的标记。 例如，允许使用“fruit”标记内容，即使它是带有子标记的容器标记，例如“fruit/apple”和“fruit/banana”。

分类根节点

分类根节点是存储库中所有标记的基本路径。 分类根节点必须​不​是 cq :Tag类型的节点。

在AEM中，基本路径为/content/ cq :tags，根节点类型为 cq :Folder。

标记命名空间

命名空间允许对事件进行分组。 最典型的用例是为每个（网站）（例如公共、内部和门户）或每个较大的应用程序（例如WCM、Assets、Communities）提供命名空间，但命名空间可用于各种其他需求。 命名空间用于用户界面，以仅显示适用于当前内容的标记（即特定命名空间的标记）子集。

标记的命名空间是分类子树中的第一级，即紧靠分类根节点下的节点。 命名空间是cq:Tag类型的节点，其父节点不是cq:Tag节点类型。

所有标记都具有命名空间。 如果未指定命名空间，则会将标记分配给默认的命名空间，即TagID default（标题为Standard Tags),，即/content/cq:tags/default.）

容器标记

容器标记是cq:Tag类型的节点，包含任意数量的子节点和类型的子节点，这使得可以使用自定义元数据增强标记模型。

此外，分类中的容器标记（或超级标记）用作所有子标记的子总和：例如，用水果/苹果标记的内容也被视为用水果标记，即搜索仅用水果标记的内容也会找到用水果/苹果标记的内容。

解析TagID

如果标记ID包含冒号“：”，则冒号将命名空间与标记或子分类分隔开，然后用正斜杠“/”进行分隔。 如果标记ID没有冒号，则表示默认的命名空间。

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

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

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

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

标记标题的本地化

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

有关更多详细信息，请参阅

• 不同语言的标记 — 描述API的使用
• 管理不同语言的标记 — 描述了标记控制台的使用

访问控制

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

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

典型做法包括：

• 允许tag-administrators组/角色对所有命名空间进行写访问（在/content/cq:tags下添加/修改）。 此组附带现成的AEM。

• 允许用户/作者读取所有应可读取的命名空间（大部分）的读取权限。

• 允许用户/作者对用户/作者应可自由定义标记的命名空间进行写入访问（/content/cq:tags/some_namespace下的add_node）

可标记内容：cq：可标记的混合

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

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

节点类型表示法(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属性是一个字符串数组，用于在作者或网站访客将一个或多个TagID应用于内容时，将其存储起来。 仅当添加到通过cq:Taggable mixin定义的节点时，该属性才有意义。

移动和合并标记

以下是使用标记控制台移动或合并标记时存储库中的效果描述：

• 当标记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的子标记。

  注意

  仅当满足以下任一条件时，才会将cq:movedTo属性添加到已移动或合并的标记中：

  1. 标记用于内容（即包含引用）或
  2. 标记包含已移动的子项。

• cq:backlinks 使引用沿另一个方向保持，即保留已移动到标记B或与标记B合并的所有标记的列表。这通常是为了在移动/合并/删除标记B以及激 cq:movedTo活标记B时使属性保持最新所必需的，在这种情况下，还必须激活其所有后台标记。

• 读取内容节点的cq:tags属性涉及以下解决方法：

  1. 如果/content/cq:tags下没有匹配项，则不返回任何标记。

  2. 如果标记设置了cq:movedTo属性，则遵循引用的标记ID。

     只要后跟的标记具有cq:movedTo属性，就会重复此步骤。

  3. 如果后跟的标记没有cq:movedTo属性，则读取该标记。

• 要在移动或合并标记时发布更改，必须复制cq:Tag节点及其所有回链接：当标记在标记管理控制台中激活时，将自动完成此操作。

• 稍后对页面cq:tags属性的更新会自动清理“old”引用。 之所以触发此事件，是因为通过API解析移动的标记会返回目标标记，从而提供目标标记ID。

标记迁移

从Experience Manager6.4开始的标记存储在/content/cq:tags下，而之前的标记存储在/etc/tags下。 但是，如果Adobe Experience Manager已从以前的版本升级，则标记仍位于旧位置/etc/tags下。 在已升级的系统中，需要在/content/cq:tags下迁移标记。

如果升级的AEM实例支持TagManager API

1. 在组件开始时，TagManager API会检测它是否是已升级的AEM实例。 在已升级的系统中，标记存储在/etc/tags下。

2. 然后，TagManager API在向后兼容模式下运行，这意味着API使用/etc/tags作为基本路径。 如果没有，则使用新位置/content/cq:tags。

3. 更新标记位置。

4. 将标记迁移到新位置后，运行以下脚本：

import org.apache.sling.api.resource.*
import javax.jcr.*

ResourceResolverFactory resourceResolverFactory = osgi.getService(ResourceResolverFactory.class);
ResourceResolver resolver = resourceResolverFactory.getAdministrativeResourceResolver(null);
Session session = resolver.adaptTo(Session.class);

def queryManager = session.workspace.queryManager;
def statement = "/jcr:root/content/cq:tags//element(*, cq:Tag)[jcr:contains(@cq:movedTo,\'/etc/tags\') or jcr:contains(@cq:backlinks,\'/etc/tags\')]";
def query = queryManager.createQuery(statement, "xpath");

println "query = ${query.statement}\n";

def tags = query.execute().getNodes();


tags.each { node ->
        def tagPath = node.path;
        println "tag = ${tagPath}";

        if(node.hasProperty("cq:movedTo") && node.getProperty("cq:movedTo").getValue().toString().startsWith("/etc/tags")){

                def movedTo = node.getProperty("cq:movedTo").getValue().toString();

                println "cq:movedTo = ${movedTo} \n";

                movedTo = movedTo.replace("/etc/tags","/content/cq:tags");
                node.setProperty("cq:movedTo",movedTo);
        } else if(node.hasProperty("cq:backlinks")){

               String[] backLinks = node.getProperty("cq:backlinks").getValues();
               int count = 0;

               backLinks.each { value ->
                       if(value.startsWith("/etc/tags")){
                               println "cq:backlinks = ${value}\n";
                               backLinks[count] = value.replace("/etc/tags","/content/cq:tags");
    }
                       count++;
               }

               node.setProperty("cq:backlinks",backLinks);
  }
}
session.save();

println "---------------------------------Success-------------------------------------"

脚本将获取值为cq:movedTo/cq:backLinks的所有/etc/tags的标记。 然后，它遍历获取的结果集，并将cq:movedTo和cq:backlinks属性值解析为/content/cq:tags路径（在值中检测到/etc/tags的情况下）。

如果升级的AEM实例在经典UI上运行

如果AEM实例升级后受TagManager API支持并在经典UI中运行：

1. 使用tagId或新标记位置/content/cq:tags替换对旧标记基本路径/etc/tags的引用后，您可以在CRX中将标记迁移到新位置/content/cq:tags，然后重新启动组件。

2. 将标记迁移到新位置后，运行上述脚本。