要标记内容并利用AEM Tagging基础结构:
标记声明在cq:Tag.
类型的节点中的存储库中捕获
标记可以是简单的单词(如sky)或表示分级分类(如果/苹果,即通用水果和更具体的苹果)。
标记由唯一的TagID标识。
标记具有可选的元信息,如标题、本地化标题和说明。 标题应在用户界面中显示,而不是TagID(如果存在)。
标记框架还允许限制作者和站点访客仅使用特定的预定义标记。
节点类型为cq:Tag
节点名称是TagID
的组件
可选jcr:title
属性(要在UI中显示的标题)
可选jcr:description
属性
包含子节点时,称为容器标签
存储在名为分类根节点的基本路径下的存储库中
TagID标识解析到存储库中的标记节点的路径。
通常,TagID是从命名空间开始的短格式TagID,也可以是从分类根节点开始的绝对TagID。
标记内容时,如果内容尚不存在,则cq:tags
属性将添加到内容节点,而TagID将添加到属性的String数组值。
TagID由命名空间和本地TagID组成。 容器 标语子标签,表示分类中的分层顺序。子标记可用于引用与任何本地TagID相同的标记。 例如,允许用“水果”标记内容,即使它是带有子标签的容器标签,如“水果/苹果”和“水果/香蕉”。
分类根节点是存储库中所有标记的基本路径。 分类根节点必须不是类型 cq :Tag
的节点。
在AEM中,基路径为/content/ cq :tags
,根节点的类型为 cq :Folder
。
命名空间允许将事物分组。 最典型的用例是每个(网站)或每个较大的应用程序(如WCM、资产、社区)都有命名空间(例如,公共、内部和门户),但命名空间可用于其他各种需求。 命名空间用于用户界面中,以仅显示适用于当前内容的标记子集(即特定命名空间的标记)。
标记的命名空间是分类子树中的第一级,该子树是紧挨分类根节点的节点。 命名空间是类型cq:Tag
的节点,其父节点不是cq:Tag
节点类型。
所有标记均具有命名空间。 如果未指定命名空间,则标记将分配给默认命名空间,即TagID default
(标题为Standard Tags),
,即/content/cq:tags/default.
)
容器标记是cq:Tag
类型的节点,包含任意数量和类型的子节点,这使得可以使用自定义元数据增强标记模型。
此外,分类中的容器标签(或超级标签)用作所有子标签的子总和:例如,用水果/苹果标记的内容也被视为用水果标记,即搜索仅用水果标记的内容也会找到用水果/苹果标记的内容。
如果标记ID包含冒号“:”,冒号将命名空间与标记或子分类分开,然后用正斜杠“/”分开。 如果标记ID没有冒号,则默示默认命名空间。
标记的标准位置和唯一位置在/content/cq:tags下。
引用不指向cq:Tag节点的非现有路径或路径的标记被视为无效并被忽略。
下表显示了一些示例TagID、其元素,以及TagID如何解析为存储库中的绝对路径:
下表显示了一些示例TagID、其元素,以及TagID如何解析为存储库中的绝对路径:
下表显示了一些示例TagID、其元素,以及TagID如何解析为存储库中的绝对路径:
标记 ID |
命名空间 | 本地ID | 容器标签 | Leaf标签 | 存储库 绝对标记路径 |
dam:fruit/apple/braeburn | 坝 | 水果/苹果/布雷本 | 水果,苹果 | braburn | /content/cq:tags/dam/fruit/apple/braeburn |
color/red | 默认 | color/red | 颜色 | 红 | /content/cq:tags/default/color/red |
天空 | 默认 | 天空 | (无) | 天空 | /content/cq:tags/default/sky |
dam: | 坝 | (无) | (无) | (无,命名空间) | /content/cq:tags/dam |
/content/cq:tags/类别/car | 类别 | 汽车 | 汽车 | 汽车 | /content/cq:tags/类别/car |
当标记包含可选标题字符串(jcr:title
)时,可以通过添加属性jcr:title.<locale>
来本地化要显示的标题。
有关详细信息,请参阅
标记作为节点存在于分类根节点下的存储库中。 允许或拒绝作者和站点访客在给定命名空间中创建标记,可以通过在存储库中设置适当的ACL。
此外,拒绝某些标记或命名空间的读取权限将控制将标记应用于特定内容的能力。
典型做法包括:
允许tag-administrators
组/角色对所有命名空间进行写入访问(在/content/cq:tags
下添加/修改)。 这个组随附AEM即装即用。
允许用户/作者读取应可读的所有命名空间(大多数)。
允许用户/作者对用户/作者可自由定义标记的命名空间进行写入访问(/content/cq:tags/some_namespace
下的add_node)
为了使应用程序开发人员将标记附加到内容类型,节点的注册(CND)必须包括cq:Taggable
混音或cq:OwnerTaggable
混音。
继承自cq:Taggable
的cq:OwnerTaggable
混音旨在指示内容可由所有者/作者分类。 在AEM中,它只是cq:PageContent
节点的属性。 标记框架不需要cq:OwnerTaggable
混音。
建议仅在聚集内容项的顶级节点(或其jcr:content节点)上启用标记。 示例包括:
页面(cq:Page
),其中jcr:content
节点的类型为cq:PageContent
,其中包括cq:Taggable
mixin。
资产(cq:Asset
),其中jcr:content/metadata
节点始终具有cq:Taggable
mixin。
节点类型定义作为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
属性是一个字符串数组,当作者或站点访客将一个或多个TagID应用于内容时,它们用于存储这些TagID。 仅当添加到使用cq:Taggable
mixin定义的节点时,该属性才有意义。
要利用AEM标记功能,自定义开发的应用程序不应定义cq:tags
以外的标记属性。
以下是使用标记控制台移动或合并标记时存储库中效果的说明:
当标记A被移动或合并到/content/cq:tags
下的标记B中时:
cq:movedTo
属性。cq:backlinks
属性。cq:movedTo
指向标记B。
此属性表示标记A已被移动或合并到标记B中。移动标记B将相应地更新此属性。 因此,标记A是隐藏的,它仅保存在存储库中以解析指向标记A的内容节点中的标记ID。标记垃圾收集器会删除标记A等标记,而不再有其他内容节点指向它们。
cq:movedTo
属性的特殊值为nirvana
:在删除标记但无法从存储库中删除该标记时应用该标记,因为必须保留具有cq:movedTo
的子标记。
仅当满足以下任一条件时,cq:movedTo
属性才会添加到已移动或合并的标记:
cq:backlinks
使引用保持在另一个方向,即保留已移动到标记B或与标记B合并的所有标记的列表。这通常要求在移动/合并/删除标记B以及激活标记B时使属性保持最新,在这种情况下,必须同时激活其所有背景标记。 cq:movedTo
仅当满足以下任一条件时,cq:backlinks
属性才会添加到已移动或合并的标记:
读取内容节点的cq:tags
属性涉及以下解决:
如果/content/cq:tags
下没有匹配项,则不返回标记。
如果标记设置了cq:movedTo
属性,则引用的标记ID将随后显示。
只要后面的标签具有cq:movedTo
属性,就重复此步骤。
如果后面的标记没有cq:movedTo
属性,则读取标记。
要在标记被移动或合并时发布更改,必须复制cq:Tag
节点及其所有反向链接:在标记管理控制台中激活标记时,会自动执行此操作。
稍后对页面cq:tags
属性的更新会自动清除“旧”引用。 这是由于通过API解析移动的标记会返回目标标记,从而提供目标标记ID而触发的。
Experience Manager6.4以后的标签存储在/content/cq:tags
下,而之前的标签存储在/etc/tags
下。 但是,在Adobe Experience Manager已从先前版本升级的情况下,标签仍在旧位置/etc/tags
下。 在升级的系统中,需要在/content/cq:tags
下迁移标记。
在标记页面的“页面属性”中,建议使用标记ID(例如geometrixx-outdoors:activity/biking
),而不要使用标记基本路径的硬编码(例如/etc/tags/geometrixx-outdoors/activity/biking
)。
要列表标记,可使用com.day.cq.tagging.servlets.TagListServlet
。
建议将标签管理器API用作资源。
如果升级的AEM实例支持TagManager API
在组件开始,TagManager API会检测它是否是升级的AEM实例。 在升级的系统中,标记存储在/etc/tags
下。
然后,TagManager API以向后兼容模式运行,这意味着API使用/etc/tags
作为基本路径。 否则,将使用新位置/content/cq:tags
。
更新标记位置。
将标记迁移到新位置后,运行以下脚本:
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实例在Clasic UI上运行
经典UI不符合零停机时间要求,并且不支持新的标签基础路径。 如果要使用经典UI,则需要先创建/etc/tags
,然后重新启动cq-tagging
组件。
如果TagManager API支持并在经典UI中运行升级的AEM实例:
使用tagId或新标记位置/content/cq:tags
替换对旧标记基路径/etc/tags
的引用后,可以在CRX中将标记迁移到新位置/content/cq:tags
,然后重新启动组件。
将标记迁移到新位置后,运行上述脚本。