在 Azure Boards 中查询工作项历史记录和讨论字段

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

工作项的历史记录会显示工作项的打开者、更改的内容以及原因。 此信息有助于跟踪工作项在一段时间内的变化情况。 在“历史记录”字段中输入信息时，请提供尽可能多的信息，帮助下一个工作项所有者了解发生了什么以及他们需要执行的操作。

注意

没有“讨论”工作项字段。 若要查询在“讨论”区域中输入了注释的工作项，需要对“历史记录”字段进行筛选。 “讨论”文本框中输入的文本的完整内容将添加到“历史记录”字段。

支持的运算符和宏

指定“历史记录”字段的查询子句可以使用“包含字词”和“不包含字词”运算符。 搜索精确短语或使用通配符 *。 只能在部分单词或短语的末尾使用通配符。

当全文搜索可用时，“历史记录”字段将自动编制索引以进行全文搜索。 请参阅全文搜索和部分字词搜索

查询工作项的历史记录

可以使用 Web 门户或团队资源管理器查看工作项的历史记录，或者根据“历史记录”字段的内容查找工作项。 对“历史记录”字段的内容运行搜索时，它仅返回在该字段中记录了更改的工作项。 也就是说，它不会登记对其他字段中的文本所做的更改。

浏览器

Visual Studio

连接到 GitHub 或第三方 Git 存储库时，查询编辑器不可用。 此外，在以下情况下，它在 Visual Studio 2019 中不可用：

• 如果已设置为使用默认登录页体验，如 Visual Studio 2019 中的设置工作项体验中所述。
• 如果已设置为使用新的 Git 工具，如 Visual Studio 中的 Git 体验中所述。

根据“历史记录”字段的内容列出工作项

需要使用查询编辑器将“历史记录”字段添加到查询子句。 输入到“讨论”区域的注释是可供查询的。 更改历史记录条目（例如更改了哪些字段）是不可查询的。 若要根据输入到“讨论”区域、“说明”字段或其他富文本字段中的字词快速查找工作项，请考虑使用工作项搜索。

可以按工作项的更改日期或按特定时间段筛选工作项。 你可以限制查询范围，使之只返回符合指定日期范围的结果，从而帮助提高查询性能。

筛选目标

包括这些查询子句

---

“历史记录”字段中包含字词“reproducible”的项

History Contains Words reproducible

“历史记录”字段中不包含字词“beta”的项

History Does Not Contain Words beta

包含短语“stack traces”且已关闭但已重新激活的项

History Contains Words stack traces And State Was Ever Closed
And State <> Closed

在指定的时间段内关闭的项目

State = Done
And Closed Date > 7/1/2015
And Closed Date <= 7/21/2015

已关联的项

History Contains Words MyName
Or Assigned To Was Ever _ @Me

---

使用查询编辑器的提示

• 输入在要查找的工作项的“历史记录”字段中指定的完整字词或短语。
• 输入你要搜索的单词的全文。 为了进行全文搜索，将对“历史记录”字段编制索引。 如果只输入部分字词，查询将不返回包含完整字词的工作项。 例如，如果“历史记录”字段包含短语“reproducible behavior”，搜索“repro”就找不到相应的工作项。 但是，如果搜索完整字词“reproducible"，就可以找到相应的工作项。 也可以使用通配符搜索该字符串，如 repro*。
• 查询编辑器会忽略配置和管理全文搜索的非索引字和非索引字表中定义的常见字或非索引字。
• 在查询编辑器工具栏上，选择 或 图标，并确认查询是否返回预期结果。
• 如果未收到预期结果，请调整输入的字词或短语，然后再次运行查询。

查看工作项的历史记录

每次保存工作项时，都会对“历史记录”字段输入一个条目。 若要查看更改历史记录，请打开现有的工作项，然后选择 或“历史记录”选项卡，或者对于某些工作项类型，请选择“详细信息”选项卡。

显示的历史记录详细信息取决于平台、版本和客户端。

浏览器

状态更改历史记录图会首先显示。 若要查看状态更改的整个历史记录，请选择“全部显示”。

在左窗格中选择一个条目以查看所做更改的详细信息。

Visual Studio

若要仅查看已添加到日志中的注释，请选择“仅讨论”选项卡。若要查看对工作项所做的所有更改，请选择“所有更改”选项卡，然后选择特定日期和时间的“显示所有更改”链接。

筛选历史记录视图

“历史记录”选项卡旨在跟踪对工作项所做的所有更改，以支持完全可跟踪性。 由此产生的较长修订历史记录可能使人难以理解特定字段何时发生更改。 若要快速查找对特定字段所做的修订或由特定人员所做的修订，可以筛选历史记录视图。

注意

“切换筛选器”功能需要启用“新的面板中心”预览功能。 若要启用此功能，请参阅管理或启用功能。

通过选择 “切换筛选器”启用筛选器功能。

若要按特定人员查看更新，请从“更新者”菜单中选择相关人员的姓名。

若要查看对一个或多个字段进行的更新，请从“字段”菜单中选择相关字段。

支持历史记录、审核和修订跟踪的字段

可以使用以下字段筛选查询并创建报告。 当工作项从一种状态变为另一种状态时，其中一些字段将填充信息。 修改工作项时，其他字段也会更新。 有些字段不会显示在工作项窗体上，但会针对列出的 WIT 进行跟踪。

字段名称

说明

工作项类型

---

更改者

最近修改工作项的团队成员的名称。

引用名称=System.ChangedBy，数据类型=字符串

全部

更改日期

修改工作项时的日期和时间。

引用名称=System.ChangedDate，数据类型=日期/时间

全部

关闭日期 ¹

关闭工作项的日期和时间。
引用名称=Microsoft.VSTS.Common.ClosedDate，数据类型=日期/时间

全部

创建日期

创建工作项的日期和时间。

引用名称=System.CreatedDate，数据类型=日期/时间

全部

历史记录

创建工作项后对其所做的更改记录。 每次更新工作项时，信息都会追加到历史记录中，该历史记录可指定更改日期、执行更改的人员和所更改的字段。

注意

历史记录字段查询会返回其“讨论”注释或“说明”字段包含与输入的关键字匹配的字词的工作项。 不能使用“历史记录”字段查询对其他字段所做的更改。

也不能向历史记录字段中添加带格式文本。 保存工作项后，便无法更改历史记录。
History 字段以及 Description、Steps to Repro 和 Title 字段将自动编制索引以进行全文搜索，如查询字段、运算符和宏中所述。

引用名称=System.History，数据类型=历史记录

全部

解决日期 ¹

工作项变为“已解决”状态的日期和时间。

引用名称=Microsoft.VSTS.Common.ResolvedDate，数据类型=日期/时间

bug（敏捷、CMMI）

审阅

为工作项的历史记录修订分配的编号。

注意

对于通过 Azure DevOps Services 的 REST API 进行的更新，工作项修订限制为 10,000。 此限制值用于限制来自 REST API 的更新，但是，来自 Web 门户的更新不受影响。

引用名称=System.Rev，数据类型=整数

全部

修订日期

修订或修改工作项时的日期和时间。

引用名称=System.RevisedDate，数据类型=日期/时间

共享参数、共享步骤、测试用例

状态更改日期

“状态”字段的值变更的日期和时间。

引用名称=Microsoft.VSTS.Common.StateChangeDate，数据类型=日期/时间

全部

测试套件审核

跟踪修改测试套件时所执行的其他操作，例如，向测试套件添加测试或更改配置。 此字段可通过“历史记录”选项卡或通过单独的查询来查看。 有合并的历史记录视图，包括对工作项字段所执行的更改以及相关项目（例如测试点和配置）所引发的更改。
引用名称=Microsoft.VSTS.TCM.TestSuiteAudit，数据类型=纯文本

测试套件

水印

系统管理的字段（不可编辑）内容随着对工作项所做的更改而递增。
引用名称=System.Watermark，数据类型=整数

全部

注意

1. 若要为 WIT 定义这些字段，必须将其包含在 WIT 定义的 WORKFLOW 部分中。 例如，在转换为“已解决”状态时，此语法包含在 FIELDS 定义中：

   <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">  
      <SERVERDEFAULT from="clock" />  
   </FIELD>  
   

相关文章

• 查询编辑器
• 查询字段、运算符和宏
• 按日期或当前迭代进行查询

REST API

若要以编程方式与查询交互，请参阅以下 REST API 资源之一：

• Azure DevOps Services REST API 参考
• 查询
• 工作项查询语言
• 使用查询以编程方式提取工作项