在引用某种概念或事物时,组织通常会采用独特的术语或多种引用方式。建议您定义同义词以建立等效术语,从而帮助用户在搜索时找到相关项。
如需定义同义词,您可以使用 _dictionaryEntry
已知架构将项编入索引。
_dictionaryEntry
类型的项可以具有以下属性:
属性 | 类型 | 说明 | 是否必需? |
---|---|---|---|
_term |
string | 需要定义的术语。推荐值是不带连字符的字词或不带标点符号的短语。 | 必需 |
_synonym |
string (repeated) | 需要包含在与 _term 中定义的字符串匹配的查询中的替代术语。 |
必需 |
_onlyApplicableForAttachedSearchApplications |
boolean | 可让您按数据源和搜索应用对同义词进行分组。如需了解详情,请参阅定义特定于数据源的同义词。 | 可选 |
如果用户在查询中包含 _term
属性的值,则有效查询将变为“字词 OR 同义词”。例如,如果字词 "scifi" 使用同义词 "science fiction" 定义,则包含字词 "scifi" 的查询将匹配包含 "scifi" 或 "science fiction." 的项
同义词只能单向应用。如果是针对 "science fiction," 的查询,则 Cloud Search 不会向查询应用任何同义词。该查询仅匹配包含 "science fiction." 且包含 "scifi" 的项。
如需让这两个术语可以互换,请分别定义每个术语:
期限 | 同义词 |
---|---|
scifi | science fiction |
science fiction | scifi |
在查询处理期间,系统会在应用同义词之前移除连字符和其他标点符号。用户查询 "sci-fi" 与 _term
"sci fi." 匹配。如需为用户可能用连字符连接的术语创建同义词,请首先将 _term
标准化以使用空格代替连字符。
继续上面的示例,以下用户查询定义将 "sci-fi," "sci fi," "scifi," 和 "science fiction" 视为可互换:
期限 | 同义词 |
---|---|
scifi | science fiction, sci fi |
sci fi | science fiction, scifi |
science fiction | scifi, sci fi |
默认情况下,任何数据源中的同义词都适用于整个网域。 具体而言,无论数据源是什么,都会在搜索应用中针对所有搜索应用同义词。如果您需要特定于数据源的同义词,请参阅定义特定于数据源的同义词。
使用 Cloud Search SDK 定义全局同义词
您可以使用 Content Connector SDK 定义术语及其同义词。有关构建连接器的说明,请参阅创建内容连接器。
以下代码段展示了如何根据 CSV 文件记录构建表示术语和同义词的 RepositoryDoc
:
定义同义词时,请注意以下事项:
- 同义词条目必须在网域范围内公开。在上述示例中,这是通过将 ACL 设置为
DOMAIN_PUBLIC_ACL
来实现的。 - 不应为配置文件定义以下属性,因为它们会覆盖您代码中的网域公开设置:
defaultAcl.mode=FALLBACK
defaultAcl.public=true
定义搜索应用专用同义词
默认情况下,同义词会应用于所有搜索应用中的所有数据源。
但是,假设您的组织有单独的工程团队和销售团队,并且您希望为每个团队提供不同的搜索体验,包括特定于职位的同义词。在这种情况下,您可以创建一个搜索应用,该应用具有特定于工程的数据源和同义词,而另一个搜索应用具有特定于销售的数据源和同义词。为了实现这一目标,请使用 _onlyApplicableForAttachedSearchApplications=true
将特定数据源中的每个同义词编入索引。此设置对同义词进行了限制,使其仅适用于包含特定数据源的搜索应用。
例如,将以下代码行添加到上一个代码示例可确保编入索引的同义词是特定于数据源的:
structuredData.put("_onlyApplicableForAttachedSearchApplications", true);