高级搜索参考

使用这些搜索参数和运算符来创建精准的搜索查询。

精确匹配

作为通用指导原则，仅对字符串字段使用双引号。对于数值字段、日期字段和布尔值字段，应避免使用双引号。双引号有两个主要用途：

1. 搜索包含空格的词语：当搜索多个单词或短语（且顺序至关重要）时，使用双引号。

   示例：

   • owner="Doe John" 可查找所有者为 John Doe 的条目。为实现“将‘Doe, John’匹配为条目所有者”这一目的，逗号、句点或冒号等字符会被忽略。
   • ITEM_DETAILS:DESC_CHANGE="Scratch on aluminum" 可查找字段值中包含该精确短语的条目。

2. 搜索精确单词：使用双引号可仅查找完整的单词。

   示例：

   • red 匹配“predator”（部分匹配）
   • "red" 匹配“blue red wheel”，但不匹配“predator”

部分匹配无需使用星号。当未使用双引号时，搜索工具会自动使用通配符。

条件运算符

使用括号结合条件运算符 (AND/OR) 来创建复杂查询。例如，要查找满足以下条件的条目：选择列表中的选项与字符串“Medium”匹配，或者在“条目和 BOM 表”或“变更单”工作空间中包含“test”一词，可以使用以下搜索查询：(ITEM_DETAILS:PRIORITY=Medium OR test) AND (workspaceId=9 OR workspaceId=8)

关系运算符

对数值字段和日期字段使用关系运算符（大于、小于、等于等）。例如，使用以下搜索查询查找在 2019 年 1 月创建的包含字词“test”的条目：test AND createdOn>=2019-01-01 AND createdOn<=2019-01-31

跨工作空间搜索

将搜索限定在特定工作空间。由于条目不能属于多个工作空间，因此在工作空间 ID 之间使用 OR 而非 AND。例如，使用以下搜索查询在工作空间 9 或 26 中查找由 John 拥有的条目：ownerName=John AND (workspaceId=9 OR workspaceId=26)

排序

默认情况下，搜索结果按相关性（分数）排序。当前用户界面不支持自定义排序，但 API 支持按以下字段排序：

• 分数（相关性，在记录信息中不可见）- 默认设置
• 上次修改时间
• 创建时间
• 条目描述符

结果可以按升序 (asc) 或降序 (desc) 排列。例如，使用以下搜索查询在工作空间 9 中查找字词“testing”，并返回所有修订版：

• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=score asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=lastModifiedOn desc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=createdOn asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=itemDescriptor desc

提示

• 默认情况下，搜索仅从受修订版控制的工作空间中返回最新版本。在 API 调用中使用 &revision=2 来获取所有条目，然后使用 isLatestVersion 和 isWorkingVersion 字段进行过滤。

• 所有条件运算符 (AND/OR) 均必须以大写形式键入。

• 使用日期范围搜索特定年份或月份。

• 以大写或小写形式键入布尔值。

• 系统会在所有已建立索引的标签页中进行搜索。截至 2019 年 2 月，以下内容已建立搜索索引：条目详细信息（不含分类数据）和附件（仅包含文件标题和文件名）。

• 若搜索查询中的空格未用双引号包裹，则空格会充当 OR 运算符。

• 在搜索查询中不允许使用以下字符：

  • `
  • (
  • )
  • :
  • <
  • >
  • =
  • \
  • /
  • ]
  • [
  • {
  • }