在 Azure Boards 和 Azure DevOps 中运行语义工作项搜索

  • 项目

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

可以使用快捷筛选器或指定关键字或短语来查找工作项。 还可以使用特定的字段/字段值、赋值或日期修改，或使用 Equals、Contains 和 Not 运算符。 搜索不区分大小写。 如果要执行以下任务，请使用语义搜索：

  • 使用特定工作项的 ID 或关键字查找特定工作项
  • 以快速、灵活的方式在所有项目中查找一个或多个工作项
  • 在所有工作项字段中运行全文搜索
  • 查看分配给特定团队成员的工作项
  • 搜索特定工作项字段以快速缩小工作项列表
  • 确定哪些关键字支持托管搜索

使用工作项搜索扩展配置服务器实例时，可以从 Web 门户运行强大的语义搜索，以便Azure DevOps Services或本地部署。

提示

如果已配置语义搜索，你会注意到搜索框将移动到蓝色栏中，如下图所示。

“搜索工作项”文本框

启动工作项的语义搜索

借助语义搜索，可以搜索：

  • 跨一个或多个项目
  • 使用自由文本跨所有工作项字段
  • 针对特定工作项字段

自由文本搜索可跨所有工作项字段（包括自定义字段）轻松搜索，从而启用更自然的搜索。 搜索结果显示在代码片段视图中，其中突出显示了找到的搜索匹配项。 语义搜索还与工作项跟踪集成，提供熟悉的控件，用于查看、编辑、注释和共享工作项表单中的信息。

  1. 选择任何 Boards 页面，在搜索框中输入关键字或短语，然后按 Enter 或选择 “开始搜索”图标。

    “工作项搜索”框

  2. 搜索结果显示在代码片段视图中，其中找到的匹配项以粗体显示。

    搜索结果

    此搜索是一种全文搜索，它使用简单搜索字符串来搜索单词或短语。 工作项搜索与搜索词的派生形式匹配;例如，搜索“更新”还会查找单词“updated”和“update”的实例。 搜索 不 区分大小写。

  3. 选择要在右侧窗口中显示的工作项的代码片段。

    按 CtrlEnter 或按住 Ctrl + 并单击“开始搜索图标”图标，在搜索框中打开新浏览器选项卡中的搜索结果。 在 Google Chrome 中，按 Ctrl + Shift + Enter 将焦点切换到新的浏览器选项卡。

  1. 在搜索框中，选中文本是否显示 “搜索工作项”。 如果没有，请使用选择器将其选中。

    标题栏中的工作项搜索文本框

  2. 在文本框中输入搜索字符串，然后按 Enter (或选择 “开始搜索”图标 图标，) 开始搜索。

  3. 搜索结果显示在代码片段视图中，其中找到的匹配项以粗体显示。

    搜索结果

    此搜索是一种全文搜索，它使用简单搜索字符串来搜索单词或短语。 工作项搜索与搜索词的派生形式匹配;例如，搜索“更新”还会查找单词“updated”和“update”的实例。 搜索 不 区分大小写。

  4. 选择要在右侧窗口中显示的工作项的代码片段。

    按 CtrlEnter 或按住 Ctrl + 并单击“开始搜索图标”图标，在搜索框中打开新浏览器选项卡中的搜索结果。 在 Google Chrome 中，按 Ctrl + Shift + Enter 将焦点切换到新的浏览器选项卡。

选择 “新建导航 ”以获取指导。 Azure DevOps Server 2019 不支持以前的导航。

微调语义搜索结果

  1. 通过指定要搜索的字段来微调搜索。 输入 a: 和用户名，用于搜索分配给该用户的所有项。

    从标题栏中搜索

    可以使用的快速筛选器包括：

    • a: 分配给 ：
    • c:的创建者：
    • s: for State
    • t: for Work 项类型

  2. 开始在工作项中键入字段的名称;例如，键入 ta。

    键入时快速筛选器

    下拉列表显示与用户输入匹配的工作项字段名称建议，并帮助用户更快地完成搜索。 例如，搜索（例如 tags:Critical 查找标记为“关键”的所有工作项）。

  3. 添加更多筛选器以进一步缩小搜索范围，并在必要时使用布尔运算符组合字词。 例如， a: Chris t: Bug s: Active 查找分配给名为“Chris”的用户的所有活动 bug。

  4. 通过使用结果页面顶部的下拉列表选择器列表，将搜索范围缩小到特定类型和状态。

  1. 通过指定要搜索的字段来微调搜索。 输入 a: 和用户名，用于搜索分配给该用户的所有项。

    标题栏搜索

    可以使用的快速筛选器包括：

    • a: 分配给 ：
    • c:的创建者：
    • s: for State
    • t: for Work 项类型

  2. 开始在工作项中键入字段的名称;例如，键入 ta。

    键入时快速筛选器

    下拉列表显示与用户输入匹配的工作项字段名称建议，并帮助用户更快地完成搜索。 例如，搜索（例如 tags:Critical 查找标记为“关键”的所有工作项）。

  3. 添加更多筛选器以进一步缩小搜索范围，并在必要时使用布尔运算符组合字词。 例如， a: Chris t: Bug s: Active 查找分配给名为“Chris”的用户的所有活动 bug。

  4. 通过使用结果页面顶部的下拉列表选择器列表，将搜索范围缩小到特定类型和状态。

### 从 Web 门户

无法从Azure DevOps Services进行即兴搜索。 仅 语义搜索。

Web 门户 (搜索框快捷菜单)

从 Visual Studio 团队资源管理器

打开 上下文菜单图标 上下文菜单并选择一个选项。

搜索框菜单（团队资源管理器）

使用搜索框查找工作项（团队资源管理器）

使用搜索文本框查找工作项

可以合并快捷方式并在搜索框内使用搜索运算符。

使用 “搜索框清除”图标 (团队资源管理器) “清除 ”按钮从搜索框中删除内容。 若要从 Visual Studio 中将上下文切换到搜索框，请输入 Ctrl+”。

基于关键字或短语查找项

键入到搜索框中的关键字或短语返回工作项列表，其中包含 “说明”、“ 重现步骤”或 “标题 ”字段中的关键字或短语。 将每个短语放入引号内。

在 “搜索工作项 ”框中，键入一个关键字或短语，该关键字或短语显示在感兴趣的工作项的 “标题”、“ 说明”或“ 重现步骤 ”字段中。

将多个关键字放入引号内。

例如，若要在 “标题 ”或“ 说明 ”字段中查找具有指定关键字的工作项：

  • 对于关键字“重复”，请输入 重复。
  • 对于短语“入门”，请输入“入门”。
  • 对于短语“入门”或关键字“feature”，请输入功能“入门”。
筛选包含以下关键字或短语的项： 键入以下字符串：
重复 duplication
入门 "Getting Started"
功能和入门 feature "Getting Started"

可以对任何文本字段中包含的关键字或短语运行部分或完全匹配查询。 或者，可以通过筛选全文搜索索引中包含的关键字和短语来运行全文搜索查询。 Team Foundation 会自动为所有长文本字段编制索引，其数据类型为 PlainText 和 HTML ，以及用于全文搜索的 标题 字段。

基于特定字段和字段值查找项

若要基于包含在其他文本字符串字段内的关键字或短语来查找工作项，请指定该字段的友好名称或引用名称。 将每个短语放入引号内。 通过将鼠标悬停在工作项窗体内的字段上，可确定该字段的友好名称。 若要确定常用字段的引用名称或查找窗体上未列出的字段，请参阅 “工作项”字段索引。

筛选符合以下条件的项目： 键入以下字符串：
包含一个附加的文件。 System.AttachedFileCount=1
剪切用户情景。 T:Story Reason=Cut
或
T="User Story" System.Reason=Cut
解决者：Peter。 "Resolved By":Peter
或
Microsoft.VSTS.Common.ResolvedBy:Peter
今天修改。 "Changed Date"=@Today
于昨天作为测试活动创建。 "Created Date"=@Today-1 Activity=Test

注意

某些字段（如 历史记录 和 说明）不支持部分单词文本搜索。 例如，如果 “历史记录 ”字段包含短语 reproducible behavior ，则找不到搜索 History:repro 工作项。 但是，如果搜索完整的字符串 History:reproducible ，将找到工作项。

使用 @Me 或 @Today 宏

@Me宏将扩展到任何工作项搜索中当前用户的全名。 @Me宏特别适用于创建可以与其他用户共享的搜索，并且可以通过减少必须键入的字符数来简化工作，以指定自己的用户名。 有关所有宏的说明，请参阅 查询字段、运算符和宏、查询宏或变量。

筛选

键入以下字符串

当前已分配给你

A=@Me

由你创建

C=@Me

昨天已解决

Resolved Date=@Today-1

修改了七天前

System.ChangedDate=@Today-7

昨天在电话保存器团队下创建

Created Date=@Today-1 And Area Path=FabrikamFiber\Phone Saver

使用 Equals、Contains 和 Not 运算符

使用以下搜索运算符指定搜索条件：

= (EQUALS) 搜索文本的完全匹配项。
： (CONTAINS) 搜索文本的部分匹配项。
- (不) 排除包含特定文本的工作项。 NOT 运算符只能与字段名称一起使用。

以下示例显示如何在创建搜索字符串时使用运算符。

筛选符合以下条件的项目： 键入以下字符串：
分配给 Peter 但未激活。 A:Peter -S=Active
其中“活动”字段不是 Development。 - Activity=Development
解决者：Peter。 "Resolved By":Peter
在标题或说明中包含关键字 triage ，不会分配给你，也不会关闭。 triage -A=@me -S=Closed
分配给你且标题中不包含关键字 bugbash 的活动 bug。 S=Active T=bug A=@Me -Title:bugbash

问题解答

问：搜索框是否支持小于/大于运算符？

答: 不是。 搜索框无法识别比较运算符，例如大于 () > 或小于 () < 。 它会将具有这些运算符的查询转换为搜索短语。