按链接或附件计数查询工作项

  • 项目

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

可以链接工作项以跟踪相关工作和依赖项，并附加文件以与团队共享信息。 然后，可以根据以下一个或多个字段列出工作项：

附件文件计数 |（讨论）批注计数 | 外部链接计数 | 超链接计数 | 链接注释 | 相关链接计数 |远程链接计数

  • 附件文件计数
  • （讨论）注释计数
  • 外部链接计数
  • 超链接计数
  • 链接注释
  • 相关链接计数

有关这些字段的详细信息，请参阅本文后面提供的表。

支持的运算符和宏

指定整数字段的子句可以使用下列运算符。

= , <> , > , < , >= , <= ,
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field],
In, Not In,
Was Ever

列出树视图中的分层项

添加查询并选择“工作项树”以开始查询。 应会看到类似于以下示例的内容：

注意

不能构造显示测试计划、测试套件和测试用例的分层视图的查询。 这些项不会使用“父-子”链接类型链接在一起。 但是，可以创建列出与测试相关的工作项的直接链接查询。 此外，还可以通过“测试计划”页查看层次结构。

筛选器和查询子句的选项

更改链接工作项的筛选器选项，并通过以下选项添加查询子句。

筛选目标

包括这些查询子句

仅包含工作项 645 的子项

添加到顶级工作项的筛选器：
ID = 645

任务或 bug

添加到链接工作项的筛选器：
Work Item Type In Task,Bug

分配给我的团队的项 (Web)

同时添加到顶部和底部筛选器：
Assigned to In Group [Fabrikam Fiber]\Web

分配给我的任务的父项

将筛选器选项更改为“首先匹配已链接的工作项”
添加到链接工作项的筛选器：
Assigned To = @Me

根据链接的依赖项列出项

以下示例演示一个依赖项链接查询，该查询返回对其他团队和项目管理的工作具有依赖项的项。

以下查询查找链接到 Fabrikam 区域路径下的工作项的所有项目和使用“前导活动”和“后续活动”链接类型的项目中的工作项。

查询编辑器、工作项和直接链接、Web 门户的屏幕截图。

  • 选中“跨项目查询”复选框，将列出与筛选条件匹配的所有链接的依赖工作项，无论这些工作项属于哪个项目。
  • 指定“Fabrikam 下的区域路径”子句，仅查找链接到 Fabrikam 项目下定义的工作项的工作项。
  • 指定“仅返回具有匹配链接的项”和“返回选定的链接类型”，仅返回基于“前导活动”和“后续活动”链接类型链接的工作项。

列出孤立用户情景

如果通常按功能组织用户情景，可以通过执行以下步骤快速找到它们。

  1. 打开产品积压工作并打开“父级打开”视图选项。
  2. 向下滚动到列出“没有父级的情景”（敏捷）或“没有父级的积压工作项”(Scrum)的部分。

列出孤立故事或积压工作项的屏幕截图。

或者，可以使用“工作项和直接链接”查询查找无父级积压工作项。 例如，以下查询列出了没有父级链接的 Azure DevOps 团队的活动用户情景。

查询编辑器、工作项和直接链接、Web 门户、无父级用户情景的屏幕截图。

下表描述了与链接和附件关联的字段。 其中大多数字段不显示在工作项窗体内，但会针对所有工作项类型进行跟踪。

附件文件计数

附加到工作项并存储在工作项跟踪数据库中的文件个数。
引用名称=System.AttachedFileCount，数据类型=Integer

注意

对于 Azure Boards（云服务），最多可向一个工作项添加 100 个附件。 在保存工作项时，尝试添加更多附件会导致出现错误消息。

批注计数

添加到工作项的“讨论”部分的注释数。
引用名称=System.CommentCount，数据类型=整数

外部链接计数

从工作项到不是工作项的项目的链接数。 例如，拉取请求、提交、变更集或其他链接类型。
引用名称=System.ExternalLinkCount，数据类型=Integer

超链接计数

为工作项定义的超链接数。

引用名称=System.HyperLinkCount，数据类型=Integer

链接注释

包含来自创建了该链接的团队成员的注释。 你可以将此字段配置为作为工作项窗体上链接列表中的一个列显示。 （查询编辑器中不支持。）

引用名称=System.Links.Comment，数据类型=PlainText

链接描述

包含工作项类型、ID 以及不是该链接目标的工作项标题。 你可以将此字段配置为作为工作项窗体上链接列表中的一个列显示。 （查询编辑器中不支持。）

引用名称=System.Links.Description，数据类型=PlainText

Parent

当作为列选项包含在积压工作或查询结果列表中时，将显示父级工作项的“标题”。 在内部，系统将工作项的“ID”存储在“Integer”字段内。

注意

可以将“父级”字段添加为列，或通过指定级父工作项 ID 在查询子句中进行指定。
引用名称=System.Parent，数据类型=Integer

全部

Parent

当作为列选项包含在积压工作或查询结果列表中时，将显示父级工作项的“标题”。 在内部，系统将工作项的“ID”存储在“Integer”字段内。

注意

Azure DevOps Server 2020 及更高版本中提供了“父级”字段。 不能在查询子句中指定此字段。
引用名称=System.Parent，数据类型=Integer

相关链接计数

为使用某种工作链接类型（例如，父-子、前导活动-后续活动和相关）的工作项定义的链接数。 有关完整列表，请参阅链接类型引用。
引用名称=System.RelatedLinkCount，数据类型=Integer

远程链接计数

仅适用于 Azure DevOps Services。 从一个工作项到另一个组织中定义的多个工作项的链接数。 组织必须由同一 Microsoft Entra ID 管理。 支持的链接类型包括“使用来源”、“生产目的”和“远程相关”。 有关详细信息，请参阅添加指向工作项的链接、链接到远程工作项。
引用名称=System.RemoteLinkCount，数据类型=Integer

可以通过从 Visual Studio Marketplace 的“Azure DevOps”选项卡提供的工作项可视化扩展来查看工作项窗体中的相关工作项和对象。

若要添加链接类型，请参阅管理链接类型 [witadmin]。

在工作项窗体上使用 LinksControl 元素实现支持在工作项之间创建链接的所有选项卡。 此元素控制筛选和限制可链接到的工作项的类型。 它还控制可以创建的链接类型，以及是否可以链接其他项目中的工作项。 若要自定义链接控件和限制，可为工作项类型修改 LinksControlOptions 的定义，请参阅 LinksControlOptions XML 元素。

你可以从链接列表中添加或删除列，也可以自定义默认列和列顺序。 有关详细信息，请参阅 LinksControlOptions XML 元素。