上一主题: faq下一主题: doSelectKD


搜索

以下参数适用于搜索方法:

参数

类型

描述

SID

整型

标识从登录检索的会话。

问题

字符串

标识要找到其解决方法的问题描述。

resultSize

整型

标识需要检索详细信息的文档数。对于剩余文档,将仅返回其 ID。随后可使用 getDocumentsByIDs() 方法访问这些文档的详细信息。默认值为 10。

propertyList

字符串

标识需要从中检索信息的以逗号分隔的数据库字段列表。无论 propertyList 参数如何设置,总会返回以下字段:

  • id
  • DOC_TYPE_ID

sortBy

字符串

标识需要用于排序结果的数据库字段。不支持多个排序字段。默认值为 RELEVANCE。ID 是次要排序依据时,总是对结果进行排序。有关有效的排序属性,请参阅“faq 方法”。

降序

布尔值

标识可用于以降序排序结果的指示器。

relatedCategories

布尔值

为找到的文档返回所有相关类别列表。

searchType

整型

可执行的搜索类型:

  • 1 = 自然语言搜索 (NLS)
  • 2 = 知识管理 搜索

matchType

整型

表示匹配类型:

  • 0 = OR 类型匹配
  • 1 = AND 类型匹配
  • 2 = 完全匹配

注意:如果为 searchType 参数选择 NLS,则只有 OR 和 AND 这两种 matchType 有效。

searchField

整型

表示要在其中进行搜索的字段的二元组合:

  • 标题 = 1
  • 摘要 = 2
  • 问题 = 4
  • 解决方法 = 8

例如,要搜索所有字段,请指定 15 (1+2+4+8)。要仅在“摘要”和“问题”中搜索,请指定 6 (2+4)。

注意:默认值为搜索“问题”。

如果将 searchType 参数设置为 NLS,则将忽略 searchFields 参数,因为 NLS 搜索只能搜索“问题”字段。

categoryPath

字符串

将搜索结果限定在特定的单个或多个类别中。您需要指定类别的完整 ID 路径并用逗号分隔多个类别。例如,1-3-5,1-4-8 将搜索限定为类别 5 和 8(及其子类别)。

whereClause

字符串

使用此添加自己的“SQL where 子句”过滤搜索结果。

maxDocIds

整型

表示允许返回的最大标识数。例如,如果您指定 resultSize 为 10 且 maxDocIds 为 50,如果数据库中存在 100 个匹配文档,那么将检索到 10 个文档的详细信息并有 40 个文档仅返回 ID。剩下的 50 个根本无法返回。默认值为 100。

描述

搜索问题的解决方案。根据传递的问题检索文档。将返回任何与问题描述或类似描述相匹配的文档。要提高性能,这些方法只可以检索一组用户定义的由 resultSize 参数控制的文档的详细信息。其余文档仅返回其 ID。使用此方法,例如,您可以设置页面调度机制,其中用户可以单击“顶部”、“上一页”、“下一页”和“底部”链接。当需要检索下一组信息时,您可以使用 getDocumentsByIDs() 方法。

返回

<UDSObjectList> 节点包含以下部分:

本章“<UDSObject> 节点描述”部分中的 <UDSObject> 节点。对于此方法找到的前 n 个文档,存在一个具有所有指定属性的 <UDSObject> 节点,其中 n 等于 resultSize 参数。例如,如果 resultSize 参数为 10,maxDocIds 参数为 50,并且方法找到 100 个文档,则在 <Attributes> 部分中存在 10 个具有所有所请求属性的 <UDSObject> 节点及 40 个只具有 ID 属性的 <UDSObject>。如果要检索文档 11-20 的 <UDSObject> 详细信息,您需要调用 getDocumentsByIDs() 方法并将这些 ID 传递给它。

如果将 getRelatedCategories 参数设置为“真”,对于相关类别,<UDSObjectList> 节点将包含在 <Attributes> 部分中。每个 <INDEX_DOC_LINKS> 节点均包括类别的相关 ID,如下例所示:

1-70