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

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

工作项的历史记录会告诉你谁打开了该项目、更改了哪些内容以及原因。 此信息可帮助你跟踪项随时间变化的方式。 在历史记录字段中输入信息时,请尽可能多地提供信息,以帮助下一个工作项所有者了解所发生的情况及其必须执行的操作。

注意

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

支持的运算符和宏

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

当全文搜索可用时,“ 历史记录 ”字段会自动为全文搜索编制索引。 请参阅Full-Text和部分单词搜索

查询工作项的历史记录

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

查询编辑器基于“历史记录”字段中包含的单词搜索项的屏幕截图。

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

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

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

筛选

包括这些查询子句


“历史记录”字段包含“可重现”一词的项

History Contains Words reproducible

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

History Does Not Contain Words beta

包含短语“堆栈跟踪”且已关闭但已重新激活的项

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

Items I've been associated with

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


有关使用查询编辑器的提示

  • 键入在要查找的工作项的 “历史记录 ”字段中指定的完整单词或短语。
  • 输入你要搜索的单词的全文。 “ 历史记录 ”字段已为全文搜索编制索引。 如果只输入部分单词,则查询不会返回包含完整单词的工作项。 例如,如果 “历史记录 ”字段包含 可重现行为的 短语,并且搜索 重现,则找不到工作项。 但是,如果搜索可 重现的完整单词,将找到工作项。 还可以使用通配符搜索字符串,例如 repro*
  • 查询编辑器忽略Full-Text 搜索的“配置和管理非索引字”和“非索引字表”中定义的常用字词或非索引字。
  • 在查询编辑器工具栏上,选择 “运行查询 ”或 “运行查询”,早期版本 图标并确认查询返回预期结果。
  • 如果未收到预期结果,请调整输入的单词或短语,然后再次运行查询。

查看工作项的历史记录

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

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

“工作项”窗体的屏幕截图,Web 门户,“选择历史记录”选项卡。

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

“工作项”窗体、Web 门户、状态更改历史记录图的屏幕截图, (Web 门户仅) 。

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

“工作项”窗体、“历史记录”选项卡、Web 门户、“详细信息”的屏幕截图。

筛选历史记录视图

历史记录 ”选项卡旨在跟踪对工作项所做的所有更改,以支持完全可跟踪性。 结果的长修订历史记录可能导致难以理解何时发生特定字段的更改。 若要快速查找针对特定字段或按特定人员进行的修订,请筛选历史记录视图。

注意

切换筛选器功能要求启用“新建板中心预览”功能。 若要启用此功能,请参阅 “管理”或“启用功能”。

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

“工作项”窗体的屏幕截图,“历史记录”选项卡,Web 门户,已启用历史记录筛选器。

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

“工作项”窗体的屏幕截图,“历史记录”选项卡,按谁进行了更新。

若要查看对一个或多个字段所做的更新,请从 “字段” 菜单中选择字段。

“工作项”窗体的屏幕截图,“历史记录”选项卡,筛选对“已分配”字段所做的更改。

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

可以使用以下字段筛选查询和创建报表。 其中几个字段使用信息填充,因为工作项从一个状态向另一个状态进行。 修改工作项时,其他字段会更新。 某些字段不会显示在工作项窗体上,但会针对列出的 WIT 进行跟踪。

字段名称

说明

工作项类型


更改者

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

引用名称=System.ChangedBy,数据类型=String

全部

更改日期

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

引用名称=System.ChangedDate, 数据类型=DateTime

全部

关闭日期 1

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

全部

创建日期

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

引用名称=System.CreatedDate, 数据类型=DateTime

全部

历史记录

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

注意

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

无法向历史记录字段添加带格式的文本。 保存工作项后,无法更改历史记录。
字段History以及TitleDescriptionSteps to Repro字段会自动为全文搜索编制索引,如查询字段、运算符和宏中所述。

引用名称=System.History,数据类型=History

全部

已解决日期 1

将工作项移动到“已解决”状态的日期和时间。

引用名称=Microsoft.VSTS.Common.ResolvedDate, 数据类型=DateTime

Bug (Agile、CMMI)

审阅

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

注意

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

引用名称=System.Rev,数据类型=Integer

全部

状态更改日期

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

引用名称=Microsoft.VSTS.Common.StateChangeDate, 数据类型=DateTime

全部

测试套件审核

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

测试套件

水印

系统管理的字段 (不可编辑的) ,该字段随对工作项所做的更改而递增。
引用名称=System.Watermark,数据类型=Integer

全部

注意

  1. 要为 WIT 定义这些字段,必须在 WIT 定义的部分中包括 WORKFLOW 这些字段。 例如,在转换到 Resolved 状态时,此语法包含在定义中 FIELDS

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

REST API

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