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

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

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

注意

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

支持的运算符和宏

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

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

查询工作项的历史记录

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

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

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

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

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

筛选

包括这些查询子句


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

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

我已关联的项目

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


使用查询编辑器的提示

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

查看工作项的历史记录

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

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

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

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

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

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

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

筛选历史记录视图

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

注意

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

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

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

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

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

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

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

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

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

字段名称

说明

工作项类型


更改者

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

Reference name=System.ChangedBy, Data type=String

All

更改日期

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

Reference name=System.ChangedDate, Data type=DateTime

All

关闭日期 1

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

All

创建日期

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

Reference name=System.CreatedDate, Data type=DateTime

All

历史记录

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

注意

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

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

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

All

解决日期 1

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

引用名称=Microsoft。VSTS。Common.ResolvedDate, Data type=DateTime

Bug (敏捷、CMMI)

审阅

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

注意

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

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

All

修订日期

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

Reference name=System.RevisedDate, Data type=DateTime

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

状态更改日期

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

引用名称=Microsoft。VSTS。Common.StateChangeDate, Data type=DateTime

All

测试套件审核

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

测试套件

水印

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

All

注意

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

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

REST API

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