通过

查询工作项历史记录和讨论字段

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

工作项的历史记录记录了是谁创建了该项、进行了哪些更改以及为什么会发生更改。 此信息支持可跟踪性和审核。 将条目添加到“历史记录”字段时，请包含足够的详细信息，以帮助下一个所有者了解上下文和后续步骤。

Note

没有单独的 “讨论” 字段。 若要查找在“讨论”区域中添加的注释，请筛选 “历史记录 ”字段， “讨论”框中输入的所有文本将追加到“历史记录” 中。

Prerequisites

Category Requirements
访问级别 - 查看和运行共享查询： 项目成员。
- 添加和保存共享查询：至少需要 基本 访问权限。
Permissions “Contribute”权限设置为“允许”，以便将查询添加到目标文件夹。 默认情况下， 参与者 组没有此权限。

Note

具有公共项目 利益干系人 访问权限的用户可以完全访问查询功能，就像具有 基本 访问权限的用户一样。 有关详细信息，请参阅 利益相关者访问快速参考指南。

Category Requirements
访问级别 - 查看和运行共享查询： 项目成员。
- 添加和保存共享查询：至少 基本 访问权限。
Permissions “Contribute”权限设置为“允许”，以便将查询添加到目标文件夹。 默认情况下， 参与者 组没有此权限。

支持的运算符和宏

  • 支持的运算符：

    • 包含单词
    • 不包含单词

  • 搜索方法：

    • 确切短语：找到确切的单词序列。
    • 通配符 （*）：仅在部分单词或短语末尾使用。

  • 支持全文搜索的服务中，历史记录字段已编入全文搜索索引。 （Azure DevOps Services 默认公开工作项搜索;本地 Azure DevOps Server 要求安装和配置搜索/报告功能。

查询工作项的历史记录

可以使用 Web 门户或团队资源管理器查看工作项的历史记录，或基于“历史记录”字段搜索工作项。 搜索“历史记录”字段仅返回在该字段中记录的内容的项目，不包括对其他字段所做的结构化更改。

显示“查询编辑器”搜索“历史记录”字段的屏幕截图。

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

使用查询编辑器将历史记录字段包含在查询子句中。

  • 可查询内容：在讨论区域（历史记录）中输入的注释。
  • 不可查询的内容：修订元数据（如“字段 X 已从 A 更改为 B”）无法通过历史记录字段进行查询。
  • 替代搜索方法：若要在富文本字段中搜索字词（说明、步骤、讨论），请使用工作项搜索（请参阅链接指南）。
  • 按更改日期进行筛选：按更改或特定日期范围筛选工作项。

筛选条件

包括这些查询子句

历史记录中包含“可重现”的项目

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 > @Today - 30 And Closed Date <= @Today

我有关联的项目

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

使用查询编辑器的提示

  • 按日期范围限制范围以提高性能并返回相关结果。
  • 使用完整单词或确切短语：
    • 部分字词可能不会返回匹配项。 例如，“可重现的行为”匹配，但“repro”可能不匹配。
    • 在字词或短语的末尾使用通配符，例如 repro*。
  • 请注意停用词：在全文索引中，常见词可能会被忽略。 请参阅有关停用词配置的链接指南。
  • 运行并验证查询：
    • 在查询编辑器工具栏中选择运行图标以测试查询。
    • 如果结果缺失，请调整搜索条件并重新运行。

查看工作项的历史记录

每次保存工作项时，条目都会追加到“历史记录”字段。 若要查看历史记录，请打开工作项，然后选择“历史记录”选项卡（或某些工作项类型的详细信息）。

确切的历史记录详细信息因客户端和版本而异。

显示 Web 门户中“工作项表单历史”选项卡的屏幕截图。

状态更改历史记录图首先显示;选择“全部显示”以查看完整的状态更改时间线。

显示 Web 门户中的状态更改历史记录图的屏幕截图。

选择一个条目以查看所做的更改的详细信息。

显示 Web 门户中所选历史记录条目的详细信息的屏幕截图。

筛选历史视图

“历史记录”选项卡记录对工作项的所有更改，以提供完整的可跟踪性。 使用筛选来查找修订，可以根据更新项目的人或哪个字段发生更改。

Note

切换筛选器功能需要“新建板中心”功能（默认启用）。 请参阅链接指南来管理预览功能。

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

显示按人员筛选历史记录视图的屏幕截图。

若要查看对特定字段的更新，请从“字段”菜单中选择字段。

显示通过“分配给”字段筛选历史记录视图的屏幕截图。

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

使用这些字段筛选查询和生成报表。 当项在状态之间移动时，某些字段会更新;其他人在修改项目时进行更新。 一些字段不会显示在工作项表单上，但会跟踪这些显示的工作项类型（WIT）。

字段名称

Description

工作项类型

更改者

最近修改工作项的团队成员的名称。
Reference name=System.ChangedBy, Data type=String

All

更改日期

修改工作项的日期和时间。
Reference name=System.ChangedDate, Data type=DateTime

All

关闭日期 1

关闭工作项的日期和时间。
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

All

创建日期

创建工作项的日期和时间。
Reference name=System.CreatedDate, Data type=DateTime

All

History

创建后追加的更改记录。 每个修订都指示发生更改的人员、时间及更改了哪些字段。

Note

历史记录查询返回“讨论”或“说明”字段包含搜索词的项目。 不能使用“历史记录”字段来查询对其他字段进行的结构化更改。

支持索引服务的情况下，History字段以及Description、Steps to Repro和Title字段会被编入索引以进行全文搜索。
Reference name=System.History, Data type=History

All

已解决日期 1

工作项移动到“已解决”状态的日期和时间。
Reference name=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime

bug（敏捷、CMMI）

Rev

历史修订的工作项被分配了一个修订号。

Note

工作项修订限制为 10,000 适用于通过 Azure DevOps Services 的 REST API 进行的更新;门户更新不受影响。 （验证 Azure DevOps REST API 文档中的当前限制。） Reference name=System.Rev, Data type=Integer

All

修订日期

修改工作项的日期和时间。
Reference name=System.RevisedDate, Data type=DateTime

All

状态更改日期

状态字段值更改的日期和时间。
Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

All

测试套件审核

跟踪修改测试套件时执行的作（例如添加测试或更改配置）。 可通过“历史记录”选项卡或查询查看。
Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText

测试套件

水印

系统管理的不可编辑字段，随着对工作项的更改而递增。
Reference name=System.Watermark, Data type=Integer

All

表说明

1 这些字段必须包含在 WIT 定义的工作流 （WORKFLOW） 节中。 例如，若要自动设置“已解决日期”，

<FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
  <SERVERDEFAULT from="clock" />
</FIELD>
  • Last updated on