搜索要点

概述

搜索功能是AEM Communities的一项基本功能。 除了AEM平台搜索功能外，AEM Communities还提供UGC搜索API，用于搜索用户生成的内容(UGC)。 UGC具有唯一的属性，因为它是与其他AEM内容和用户数据分开输入和存储的。

对于Communities，通常搜索的两项内容有：

  • 社区成员发布的内容

    • 使用AEM Communities的UGC搜索API

  • 用户和用户组（用户数据）

    • 使用AEM平台搜索功能

文档的此部分内容对于正在创建可创建或管理UGC的自定义组件的开发人员非常感兴趣。

安全和阴影节点

对于自定义组件，必须使用SocialResourceUtilities方法。 创建和搜索UGC的实用程序方法将建立所需的卷影节点，并确保成员拥有该请求的正确权限。

未通过SRP实用程序管理的是与审核相关的属性。

有关用于访问UGC和ACL卷影节点的实用工具方法的信息，请参阅SRP和UGC Essentials。

UGC搜索API

UGC公共存储由各种存储资源提供程序(SRP)之一提供，每个存储资源提供程序可能具有不同的本机查询语言。 因此，无论选择何种SRP，自定义代码都应使用UGC API包(com.adobe.cq.social.ugc.api)中的方法，该方法将调用适用于所选SRP的查询语言。

ASRP搜索

对于ASRP,UGC存储在Adobe云中。 虽然UGC在CRX中不可见，但moderation可在创作和发布环境中使用。 使用UGC搜索API对ASRP的作用与对其他SRP的作用相同。

当前不存在用于管理ASRP搜索的工具。

创建可搜索的自定义属性时，必须遵循命名要求。

MSRP搜索

对于MSRP,UGC存储在配置为使用Solr进行搜索的MongoDB中。 UGC在CRX中将不可见，但moderation可在创作和发布环境中使用。

关于MSRP和Solr:

  • AEM平台的嵌入式解决程序不用于MSRP
  • 如果为AEM平台使用远程解决程序，则可以与MSRP共享该解决方案，但它们应使用不同的集合
  • Solr可配置为标准搜索或多语言搜索(MLS)
  • 有关配置详细信息，请参阅MSRP的Solr配置

自定义搜索功能应使用UGC搜索API。

创建可搜索的自定义属性时，必须遵循命名要求。

JSRP搜索

对于JSRP,UGC存储在Oak中，并且仅在输入UGC的AEM创作或发布实例的存储库中可见。

由于UGC通常在发布环境中输入，因此对于多发布者生产系统，必须配置发布群集，而不是发布场，以便从所有发布者中都可以看到输入的内容。

对于JSRP，在发布环境中输入的UGC在创作环境中将不可见。 因此，所有审核任务都在发布环境中进行。

自定义搜索功能应使用UGC搜索API。

Oak索引

虽然不会为AEM平台搜索自动创建Oak索引，但从AEM 6.2开始，已为AEM Communities添加了索引，以提高性能，并在显示UGC搜索结果时支持分页。

如果自定义属性正在使用且搜索速度缓慢，则需要为自定义属性创建其他索引，以提高其性能。 要保持可移植性，请在创建可搜索的自定义属性时遵循命名要求。

要修改现有索引或创建自定义索引，请参阅Oak查询和索引。

Oak索引管理器可从ACS AEM Commons中获取。 它提供：

  • 现有索引的视图
  • 启动重新索引的功能

要查看CRXDE Lite中的现有Oak索引，位置为：

  • /oak:index/socialLucene

chlimage_1-235

索引搜索属性

默认搜索属性

以下是用于各种社区功能的一些可搜索属性：

属性 数据类型
isPratked 布尔型
isSpam 布尔型
读取 布尔型
影响 布尔型
附件 布尔型
情绪 长整型
已标记 布尔型
已添加 日期
modifiedDate 日期
状态 String
userIdentifier 字符串
回复 长整型
jcr:title 字符串
jcr:description 字符串
sling:resourceType 字符串
allowThreadedReply 布尔型
isDraft 布尔型
publishDate 日期
publishJobId 字符串
已回复 布尔型
已应答的 布尔型
标记 字符串
cq:Tag 字符串
author_display_name 字符串
location_t 字符串
parentPath 字符串
parentTitle 字符串

自定义属性的命名

添加自定义属性时，为了对使用UGC搜索API创建的排序和搜索显示这些属性，必需才能向属性名称添加后缀。

后缀适用于使用架构的查询语言：

  • 它会将资产标识为可搜索
  • 它标识数据类型

Solr是使用模式的查询语言的一个示例。

后缀 数据类型
_b 布尔型
_dt 日历
_d 双精度型
_tl 长整型
_s 字符串
_t 文本

注释:

  • 文本是带有标记的字符串， 而字符串则不是。使用​Text​进行模糊（更类似于此）搜索。

  • 对于多值类型，请在后缀中添加“s”，例如：

    • viewDate_dt:单日期属性
    • viewDates_dts:日期属性列表

筛选器

包含注释系统的组件支持在其端点之外添加筛选器参数。

AND和OR逻辑的过滤器语法如下所示（在对URL进行编码之前显示）：

  • 要指定OR，请使用一个带逗号分隔值的过滤器参数：

    • filter=name eq 'Jennifer',name eq 'Jen'

  • 要指定AND，请使用多个筛选器参数：

    • filter = name eq 'Jackson'&filter=message eq 'testing'

搜索组件的默认实施使用此语法，如社区组件指南中打开“搜索结果”页面的URL中所示。 要进行实验，请浏览至http://localhost:4503/content/community-components/en/search.html。

过滤器运算符包括：

EQ 等于
NE 不等于
LT 小于
LTE 小于或等于
GE 大于
GET 大于或等于
LIKE 模糊匹配

URL应务必引用社区组件（资源），而不是放置组件的页面：

  • 正确：论坛组件
    • /content/community-components/en/forum/jcr:content/content/forum.social.json
  • 错误：论坛页面
    • /content/community-components/en/forum.social.json

SRP工具

有一个Adobe Marketing Cloud GitHub项目，其中包含：

AEM Communities SRP工具

此存储库包含用于管理SRP中数据的工具。

当前，有一个Servlet提供从任何SRP中删除所有UGC的功能。

例如，要删除ASRP中的所有UGC，请执行以下操作：

curl -X POST http://localhost:4502/services/social/srp/cleanup?path=/content/usergenerated/asi/cloud -uadmin:admin

疑难解答

Solr查询

要帮助解决Solr查询问题，请为

com.adobe.cq.social.srp.impl.SocialSolrConnector。

实际的Solr查询将显示在调试日志中的URL编码：

要解决的查询是：sort=timestamp+desc&bl=en&pl=en&start=0&rows=10 &q=%2Btitle_t:(hello)+%2Bprovider_id:\/content/usergenerated/asi/mongo/content/+%2Bresource_type_s:&df=provider_id&trf=verbatim&fq={!cost%3D100}report_suite:mongo

q参数的值是查询。 解码URL编码后，查询可以传递到Solr Admin Query工具，以便进一步调试。

在此页面上