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

  • 项目

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

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

  • 附件文件计数
  • (讨论) 批注计数
  • 外部链接计数
  • 超链接计数
  • 链接注释
  • 相关链接计数
  • 远程链接计数
  • 附件文件计数
  • (讨论) 批注计数
  • 外部链接计数
  • 超链接计数
  • 链接注释
  • 相关链接计数

有关其中每个字段的说明，请参阅 本文后面提供的表。

支持的运算符和宏

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

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

可以按链接类型、链接计数或附件计数筛选工作项。

筛选

包括这些查询子句

带有附件的项目

Attached File Count >= 1

具有两个或多个超链接的项目

Hyperlink Count >= 2

包含外部链接的项目、指向工作项以外的对象的链接

External Link Count >= 1

包含三到七个相关链接的项目

Related Link Count >= 3 And Related Link Count <= 7

包含远程链接的项目

Remote Link Count > 0

列出树视图中的分层项

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

注意

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

在此处，可以添加查询子句或更改链接工作项的筛选器选项。

筛选

包括这些查询子句

仅查看工作项 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 项目下定义的工作项的工作项。

  • 指定仅返回具有匹配链接的返回项，并且返回所选链接类型会导致查询仅返回基于前置项和后续链接类型链接的工作项。

列出孤立用户案例

如果通常按功能组织用户故事，则可以通过打开产品积压工作、启用 “家长打开 视图”选项来快速查找孤立的用户情景，然后向下滚动到列出 “未父母的故事 ” (敏捷) 或 未父母积压工作项 (Scrum) 的部分。

列出孤立故事或积压工作项

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

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

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

字段名称

说明

工作项类型

附件文件计数

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

注意

对于Azure Boards (云服务) ，最多可以向工作项添加 100 个附件。 尝试在保存工作项时添加更多结果时出现错误消息。

全部

注释计数

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

注意

适用于 TFS 2017，其中包含支持 “讨论 ”部分和更高版本的新工作项窗体。

全部

**外部链接计数**

从工作项到不是工作项的项目的链接数。 例如拉取请求、提交、更改集或其他链接类型。
Reference Name=System.ExternalLinkCount， Data type=Integer

全部

**超链接计数**

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

Reference Name=System.HyperLinkCount， Data type=Integer

全部

链接注释

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

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

全部

链接说明

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

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

全部

**Parent**

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

注意

可以通过指定父工作项 ID 将 Parent 字段添加为列或在查询子句中指定该字段。
Reference Name=System.Parent， Data type=Integer

全部

**Parent**

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

注意

父字段可从 Azure DevOps Server 2020 及更高版本获取。 不能在查询子句中指定此字段。
Reference Name=System.Parent， Data type=Integer

全部

**相关链接计数**

为使用工作链接类型的工作项定义的链接数，例如父子、前置任务和相关。 有关完整列表，请参阅 链接类型引用。
Reference Name=System.RelatedLinkCount， Data type=Integer

全部

**远程链接计数**

仅适用于Azure DevOps Services。 从工作项到另一个组织中定义的工作项的链接数。 组织必须由同一 Azure Active Directory 管理。 支持的链接类型包括“使用发件人”、“生成的 For”和“远程相关”。 若要了解详细信息，请参阅 “添加工作项链接”、“链接到远程工作项”。
引用名称=System.RemoteLinkCount， 数据类型=Integer

全部

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

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

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

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