AEM 标记框架 aem-tagging-framework

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

标记：cq：标记节点类型 tags-cq-tag-node-type

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

标记可以是一个简单的单词(例如， fruit)或表示分层分类(例如 fruit/apple，这意味着通常都会得到果实，而且苹果的具体程度更高。)

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

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

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

标记特性 tag-characteristics

标记 ID tagid

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

通常， TagID 是以命名空间开头的速记，也可以是从 分类根节点.

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

的 TagID 由a 命名空间 随后是当地人 TagID. 容器标记 具有表示分类中分层顺序的子标记。 子标记可用于引用与任何本地标记相同的标记 TagID. 例如，标记内容时 fruit ，即使它是包含子标记的容器标记，例如 fruit/apple 和 fruit/banana.

分类根节点 taxonomy-root-node

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

在AEM中，基本路径为 /content/cq:tags 根节点是 cq:Folder.

标记命名空间 tag-namespace

命名空间允许进行组操作。 最典型的用例是为每个站点（例如公共、内部和门户）或每个较大的应用程序(例如站点、资产、Forms)提供命名空间，但命名空间可用于满足各种其他需求。 命名空间用于用户界面，以仅显示适用于当前内容的标记（即特定命名空间的标记）子集。

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

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

容器标记 container-tags

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

此外，分类中的容器标记（或超级标记）用作所有子标记的子总和。 例如，标有 fruit/apple 被视为标记为 fruit 也是。 这意味着搜索刚刚带有 fruit 也会找到标记为 fruit/apple.

解析TagID resolving-tagids

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

标记的标准位置和唯一位置如下所示 /content/cq:tags.

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

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

标记标题的本地化 localization-of-tag-title

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

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

访问控制 access-control

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

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

典型的配置包括：

可标记内容：cq：可标记的Mixin taggable-content-cq-taggable-mixin

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

的 cq:OwnerTaggable mixin，继承自 cq:Taggable，旨在指示内容可以由所有者/作者分类。 在AEM中，它只是 cq:PageContent 节点。 的 cq:OwnerTaggable 标记框架不需要mixin。

节点类型表示法(CND) node-type-notation-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属性 tagged-content-cq-tags-property

的 cq:tags 属性是用于存储一个或多个字符串数组 TagID适用于作者或网站访客对内容应用的情况。 仅当添加到通过 cq:Taggable 混合。

移动和合并标记 moving-and-merging-tags

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

标记迁移 tags-migration

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

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

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-------------------------------------"

脚本会获取所有具有 /etc/tags 的值 cq:movedTo/cq:backLinks 属性。 然后，它遍历获取的结果集并解析 cq:movedTo 和 cq:backlinks 属性值 /content/cq:tags 路径(在 /etc/tags 在值中检测)。

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

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