Azure Boards 和 Azure DevOps 中的数值字段查询

  • 项目

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

如何实现确定每个开发人员在团队中完成多少工作？ 是否有办法总结迭代的工作或故事点？

最常见的数值字段跟踪“要求”类别或“任务”类别中项的估计、剩余和已完成工时的工作。 使用查询可以列出感兴趣的工作项，然后定义显示工作项计数或数值字段总和的图表。

支持的运算符和宏

指定数值字段的查询子句可以使用下面列出的运算符。

  • = , <> , > , < , >= , <=
  • =[Field]， [Field]， ><>[Field]， <[Field]， >=[Field]， <=[Field]
  • In、Not in
  • 曾是

开发基于图表的查询的提示

  • 只能为平面列表查询添加图表
  • 图表选项引用通过列选项显示的查询筛选器或字段
  • 在添加或修改图表之前保存对查询所做的更改。
  • 若要对一个或多个子句进行分组，请选择它们，然后选择 “组查询子句”图标 组子句图标。 若要取消分组，请选择分组子句。

有关创建查询和基于图表的查询的更多详细信息，请参阅 使用查询编辑器列出和管理查询 和 图表。 如果要添加自定义字段来跟踪并生成其他数值的总和，请参阅 “添加或修改字段”。

有用的筛选器

筛选

包括这些查询子句

用户情景或 bug

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。

查询 bug 任何状态、工作项计数摘要

此外，所有图表都包含一个值选择，旨在显示图表中工作项的计数。

每个开发人员的 bug 计数

创建活动 bug 查询并修改列选项以显示“已分配的”和“状态”。 然后，添加显示工作分配和状态的数据透视图。

“配置图表”对话框，按分配的透视表和状态

按开发人员、面积图、数据透视图配置图表、bug 计数

按州和区域统计的 bug 计数

使用对上一部分所示的 bug 进行筛选的平面列表查询，可以根据区域显示计数。 修改列选项以显示区域路径。 然后，添加显示状态和区域路径的数据透视图。

配置图表对话框，按状态和区域透视

按区域、状态、数据透视图配置图表、bug 计数

未定义的字段值查询

可以使用等于运算符 (=) 并将字段的值留空来查找具有未定义的字段值的工作项。 例如，以下筛选器将列出“用户故事”字段为空的所有工作项。

基于空白条目进行筛选

若要根据非空白字段列出工作项，请使用 not 运算符 () <> 并将值留空。

工作量或故事点查询和图表

在敏捷过程中工作时，可以将故事点分配给用户情景或 bug。 或者，在 Scrum 过程中工作时，努力产品积压工作项和 bug。 有关详细信息，请参阅 基本、 敏捷、 Scrum 或 CMMI 工作项类型和工作流文章。

故事点及其状态的总和

创建一个查询，用于筛选用户故事作为工作项类型，并修改列选项以显示故事点和状态。

查询编辑器，平面列表，打开的故事

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

配置图表对话框、堆积条形图、故事点的总和

配置图表、每个迭代的故事点总和、堆积条形图。

有关系统定义的累积流关系图的信息，请参阅 累积流。

为迭代烧毁用户情景的图表

创建一个查询，用于筛选用户情景作为工作项类型和处于“活动”或“已关闭”状态。 修改列选项以显示故事点。

查询编辑器、平面列表、用户情景 - 活动或已关闭

然后，添加一个堆积面积趋势图，用于对故事点求和。

配置图表对话框、趋势、故事点的总和

配置图表，每个迭代的故事点总和，堆积条形图

剩余和已完成的工作查询和图表

根据项目引用的过程，可以将以下字段分配给任务或 bug。

流程 可用字段
敏捷 原始估计值、剩余工时、已完成工时
Scrum 剩余工作
CMMI 原始估计值、剩余工时、已完成工时

每个开发人员剩余工时的总和

如果遵循 Scrum 做法并估算任务和 bug 的剩余工时，可以使用以下查询和图表汇总每个开发人员剩余的工作量。 通过使用 In 运算符并包括 Task 和 Bug，可以包含作为任务跟踪的任何 bug。

查询用于冲刺的任务和 bug

将剩余工时作为列选项添加到查询并保存。 若要查看剩余工时的总和，请添加数据透视图，如下所示。

配置图表对话框、透视表、每个开发人员剩余工时的总和

按开发人员、面积图、数据透视图配置图表、剩余工时的总和

有关系统定义的冲刺烧毁图表的信息，请参阅 Sprint 烧毁。

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

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

字段名称

说明

工作项类型

活动 1、2

完成任务所需的活动类型。若要详细了解如何使用此字段，请参阅 容量规划。 允许值包括：

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

“活动”字段在 Activity ProcessConfiguration 文件中分配。3

引用名称=Microsoft.VSTS.Common.Activity， 数据类型=String

任务、Bug4 (敏捷和 Scrum)

业务价值

捕获与相同类型的其他项比较的产品积压工作项或功能的相对业务价值的主观度量单位。 将分配较高数字的项具有的业务价值视为高于分配较低数字的项。

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

史诗，功能

已完成工作

实施任务所耗用的工作量。 可以小时或天为单位指定工作。 没有与此字段相关的固有时间单位。

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

任务，Bug4

纪律 1， 2

分配给任务的活动或专业类型。 若要详细了解此字段的使用方式，请参阅 容量规划。 允许值包括：

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

“规则”字段在 Activity ProcessConfiguration 文件中分配。3

引用名称=Microsoft.VSTS.Common.Discipline， 数据类型=String

任务，Bug 4 (CMMI)

工作

捕获 Bug 或产品积压工作项的大小的主观度量单位。 如果为某个项目分配更多工作量，则指示实现该项目需要执行更多工作。

此字段 3 还用于计算团队速度和预测。 它在 ProcessConfiguration 文件中分配 Effort 。

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

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

功能、史诗

故事点

捕获用户情景的大小的主观度量单位。 如果为某个用户情景分配多个情景点，则指示实现该用户情景需要执行更多工作。

此字段 3 还用于计算团队速度和预测。 它在 ProcessConfiguration 文件中分配 Effort 。

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

用户情景，Bug 4 (敏捷)

大小

捕获要求的大小的主观度量单位。 大小越大，实现它需要执行的工作就越多。

此字段3 还用于计算团队速度和预测。 它在 ProcessConfiguration 文件中分配 Effort 。

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

要求，Bug 4 (CMMI)

初始估计

完成任务所需的工作量。 可以小时或天为单位指定工作。 没有与此字段相关的固有时间单位。

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

任务、Bug 4 (敏捷和 CMMI)

剩余工作

完成任务剩余的工作量。 可以小时或天为单位指定工作。 没有与此字段相关的固有时间单位。 此字段 3 还用于计算烧毁。 它在 ProcessConfiguration 文件中分配 type="RemainingWork" 。

注意

对于Azure Boards，任务板在与剩余工时的关系中始终显示“h”。 对于 TFS，可以修改剩余工时类型字段的 ProcessConfiguration 文件，以指定天数或其他首选标签的“d”。

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

任务，Bug4

需要审阅

指示任务需要评审。 可以指定 “是 ”或 “否 ” (默认) 。

引用名称=Microsoft.VSTS.CMMI.RequiresReview， 数据类型=String

任务 (CMMI)

需要测试

指示任务需要测试。 可以指定 “是 ”或 “否 ” (默认) 。

引用名称=Microsoft.VSTS.CMMI.RequiresTest， 数据类型=String

任务 (CMMI)

任务类型1

指定要实现的任务类别。 允许值包括：

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

引用名称=Microsoft.VSTS.CMMI.TaskType，数据类型=String

任务，Bug4 (CMMI 进程)

注意

  1. 若要更改菜单选择：对于云服务或继承的过程，请参阅 “添加和管理”字段;对于本地 XML 进程，请参阅 “添加或修改字段”，自定义选取列表。
  2. 活动 (敏捷或 Scrum) 或 Discipline (CMMI 的容量页中显示的值) 反映项目集合实例内所有项目中为字段定义的所有值的联合。 因此，若要限制在冲刺积压工作页上为 Capacity 显示的值，必须在分配给 type="Activity"字段的所有项目中匹配这些值。
  3. 若要仅) 更改 ProcessConfiguration 字段分配 (，请参阅 Process configuration XML 元素参考。
  4. 每个团队都可以配置其敏捷工具，以确定 bug 是否处理得与要求或任务类似。 由于 bug 可以随要求或任务一起出现，因此用于估算要求级别工作量的字段和任务级别包含在工作项窗体中。

有关添加自定义字段的信息，请参阅 自定义工作跟踪体验。

此处介绍了用于计划和跟踪工作的主要工具：

有关使用工作项和查询的详细信息，请参阅：

跨工作项类型汇总数值

汇总提供父工作项下所有子工作项的选择字段的总值。 本机，Azure Boards和 TFS 为任务板上的任务提供剩余工时汇总。 有关其他汇总要求，请参阅以下文章：

“要求”或“任务”类别中显示哪些项？

每个流程下面列出了每个类别的工作项类型的默认分配。

流程 要求类别 任务类别
敏捷 用户情景 任务
Scrum 产品积压工作(backlog)项 任务
CMMI 要求 任务

但是，每个团队都可以确定 Bug 工作项类型是否出现在“要求”或“任务”类别中。 请参阅 积压工作和板上的“显示 bug”。

可以将自定义工作项类型添加到积压工作。 有关详细信息，请参阅 添加或修改工作项类型，将自定义 WIT 添加到积压工作或板。

REST API

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