通过

按数值字段进行查询

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

了解如何在 Azure Boards 和 Azure DevOps 中按数值字段（例如工作量、计划估计、情景点或时间跟踪字段）进行查询。

常见数值字段用于跟踪需求的努力，以及任务的预估、剩余和已完成工作。 使用查询列出你关心的工作项，然后创建显示工作项计数或数值字段总和的图表。

先决条件

类别 要求
访问级别 - 若要查看和运行共享查询：项目成员。
- 添加并保存共享查询：至少具有基本访问权限。
权限 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。

注意

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

类别 要求
访问级别 - 若要查看和运行共享查询：项目成员。
- 要添加和保存共享查询，您需要至少拥有 基本 访问权限。
权限 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。

使用运算符和宏

引用数值字段的子句支持以下运算符：

  • =、<>、>、<、>=、<=
  • =[Field]、<>[Field]、>[Field]、<[Field]、>=[Field]、<=[Field]
  • In、Not In
  • Was Ever

开发基于图表的查询

生成用于馈送图表的查询的提示：

  • 仅将图表添加到平面列表查询。
  • 引用查询筛选器或通过列选项显示的字段。
  • 在添加或修改图表之前保存查询。
  • 若要对子句进行分组，请选择它们并使用 group-clauses 图标;若要取消分组，请选择分组子句。

有关详细信息，请参阅 使用查询编辑器列出和管理查询、 图表以及 添加或修改字段。

使用筛选器

下表显示了用于查询的有用筛选器。

筛选出

包括这些查询子句

用户故事或故障

Work Item Type In User Story,Bug

任务或 bug

Work Item Type In Task,Bug

活动或已关闭的项

State In Active,Closed

“需求”类别中的项

Work Item Type In Group Microsoft.RequirementCategory

未估算的用户故事

Story Points <> (leave Value field blank)

查询工作项的计数

运行这些查询时，所有查询都会返回匹配项的计数。 以下示例显示了一个平面列表查询方法，用于筛选处于任何状态下的缺陷。

显示查询处于任何状态的 bug 且包含工作项计数摘要的屏幕截图。

图表还包括一个用于显示工作项计数的数值选择。

查询每个开发人员的错误计数

创建一个活动的 bugs 查询，在列中包括“分配给”和“状态”，然后添加一个显示工作分配和状态的数据透视图表。

显示“配置图表”对话框的屏幕截图，该对话框配置为按“分配到”和“状态”进行透视。

按“状态”和“区域”的查询错误计数

使用相同的平面列表查询，包括区域路径作为列，并添加按州和区域分组的数据透视图。

显示配置为按状态和区域路径透视的“配置图表”对话框的屏幕截图。

查询未定义的字段值

使用“equals”运算符 = 查找具有未定义（空白）字段值的工作项，并将值留空。 例如，此子句查找其“故事点”字段为空的用户故事。

显示“故事点”值为空的筛选器的屏幕截图。

若要查找字段不为空的项目，请使用“not”运算符 <> 并将值留空。

查询工作量或故事点

将故事点分配给敏捷过程中的用户故事或 bug。 在 Scrum 过程中为产品积压工作项和缺陷分配工作量。 有关详细信息，请参阅 基本、 敏捷、 Scrum 或 CMMI。

查询故事点及其状态的汇总

创建一个查询，用于筛选用户情景，并向列添加故事点和状态。

显示包含“故事点”和“状态”列的已打开故事的“查询编辑器”平面列表的屏幕截图。

然后添加一个堆积条形图，对故事点进行求和。

这是一个显示“配置图表”对话框的屏幕截图，适用于将故事点求和的堆积条形图。

有关累积流图的信息，请参阅 累积流。

查询迭代用户情景的燃尽图

创建一个查询，以筛选处于“活动”或“关闭”状态的用户故事，并在列中包含故事点。

显示处于“活动”或“已关闭”状态的用户故事的查询编辑器的平面列表屏幕截图。

然后添加一个堆积面积趋势图，以汇总故事点。

显示“配置图表”对话框的屏幕截图，该对话框显示一个趋势图，并对“故事点”进行求和。

查询剩余工作和已完成工作

根据你的流程，项目可以在任务或错误中包括以下字段：

进程 可用字段
敏捷 初始估计、剩余工作、已完成的工作
Scrum 剩余工作
CMMI 初始估计、剩余工作、已完成的工作

每个开发人员的剩余工作总量

如果估计任务和 bug 的剩余工时，请获取包含使用 In 运算符的查询的汇总，并包括任务和 Bug，以包含作为任务跟踪的 bug。

针对冲刺任务和 bug 的查询结果的屏幕截图。

将剩余工时添加为列，保存，然后添加数据透视图以显示每个开发人员剩余工时的总和。

显示“配置图表”对话框的屏幕截图，透视表按“分配给”旋转并汇总“剩余工时”。

有关系统定义的冲刺燃尽图表，请参阅 冲刺燃尽图。

用于估计和跟踪工作的字段

下表介绍可以用于跟踪工作的活动性字段和数值字段。 有关日期相关的字段，例如开始日期、完成日期和目标日期，请参阅 按日期或当前迭代进行查询。

字段名称

描述

工作项类型

活动 1、2

完成任务所需的活动。 有关容量规划，请参阅 容量规划。 允许的值包括：

  • 部署
  • 设计
  • 开发
  • 文档
  • 要求
  • 测试

活动字段映射到 ProcessConfiguration 文件中的 Activity。3

引用名称=Microsoft.VSTS.Common.Activity，数据类型=字符串

任务、Bug4（敏捷和 Scrum）

业务价值

产品积压工作项或功能的相对业务价值的主观度量值。 较高的数字表示较高的相对值。

引用名称=Microsoft.VSTS.Common.BusinessValue，数据类型=整数

长篇故事、功能

已完成工作

实现任务所耗用的工作量。 可以记录工时或天数;不会强制实施固有的时间单位。

引用名称=Microsoft.VSTS.Scheduling.CompletedWork，数据类型=Double

任务，错误4

专业 1、2

分配给任务的学科。 请参阅 容量规划。 允许的值包括：

  • 分析
  • 开发
  • 测试
  • 用户培训
  • 用户体验

“规则”字段映射到 Activity ProcessConfiguration 文件中。3

引用名称=Microsoft.VSTS.Common.Discipline，数据类型=字符串

任务、bug 4 (CMMI)

工作

Bug 或产品积压工作项大小的主观度量值。 使用“Effort（努力）”来计算团队速度和预测；它在 ProcessConfiguration 文件中映射到 Effort。

引用名称=Microsoft.VSTS.Scheduling.Effort，数据类型=Double

产品积压工作项、Bug 4 (Scrum)

功能、长篇故事

故事点

用户故事规模的主观度量标准。 故事点有助于提高团队速度和预测，并映射到 Effort ProcessConfiguration 文件中。

引用名称=Microsoft.VSTS.Scheduling.StoryPoints，数据类型=Double

用户故事、Bug 4（敏捷）

大小

需求大小的主观度量。 大小影响速度，并映射到 Effort ProcessConfiguration 文件中。

引用名称=Microsoft.VSTS.Scheduling.Size，数据类型=Double

需求、Bug 4 (CMMI)

初始估计

估计完成任务的初始工时量。 以小时或天表示;不会强制实施固有单位。

引用名称=Microsoft.VSTS.Scheduling.OriginalEstimate，数据类型=Double

任务、Bug 4（敏捷和 CMMI）

剩余工作

完成任务剩余的工作量。 记录以小时或天为单位；没有强制性的固有单位。 剩余工时还有助于在 ProcessConfiguration 文件中进行烧毁和映射 RemainingWork 。

注意

对于 Azure Boards，任务板用“h”（小时）表示剩余工时。 对于本地 XML 进程配置，可以修改 ProcessConfiguration 文件以更改标签（例如，“d”天数）。

引用名称=Microsoft.VSTS.Scheduling.RemainingWork，数据类型=Double

任务，错误4

需要审阅

表示任务需要审阅。 允许的值： 是 或 否 （默认值）。

引用名称=Microsoft.VSTS.CMMI.RequiresReview，数据类型=字符串

任务 (CMMI)

需要测试

指示需要测试的任务。 允许的值： 是 或 否 （默认值）。

引用名称=Microsoft.VSTS.CMMI.RequiresTest，数据类型=字符串

任务 (CMMI)

任务类型1

指定任务类型。 允许的值包括：

  • 纠正措施
  • 缓解措施
  • 已计划

引用名称=Microsoft.VSTS.CMMI.TaskType，数据类型=字符串

任务、Bug4（CMMI 流程）

注意

  1. 若要更改选取列表值：对于云服务或继承的过程，请参阅 “添加和管理”字段;对于本地 XML 进程 ，请使用“添加或修改字段”，自定义选取列表。
  2. “容量”页显示整个项目集合中为该字段定义的所有值的联合。 若要限制“容量”页面上显示的值，请确保这些值与共享字段 type="Activity" 的所有团队一致。
  3. 若要更改 ProcessConfiguration 字段分配（仅本地），请参阅流程配置 XML 元素参考。
  4. 每个团队都会配置 bug 的行为是否类似于要求或任务。 由于 bug 可能在这两个级别中任一处出现，因此用于在两个级别估算工作量的字段都包含在工作项表单中。

后续步骤

自定义工作跟踪体验

相关内容

REST API

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