WIQL：仅获取迭代中的顶级项目作为特定日期 是什么以及为什么如何

问题描述

是什么以及为什么

我的目标是找出最初计划用于 sprint 的项目、哪些项目添加晚了以及哪些项目晚移出了 sprint

我正在尝试使用 Azure Devops Rest API 在特定时间点查询迭代的所有顶级项目使用以下端点：

Azure DevOps Rest API Documentation - Query By Wiql

---

如何

我的第一个查询返回顶级项目，但遗憾的是只有如果有任何子项。至少我可以使用 asOf，因为 mode(MustContain) 允许它：

SELECT [System.Id],[System.WorkItemType],[System.Title],[System.AssignedTo],[System.State],[System.Tags] 
FROM WorkItemLinks

WHERE (Source.[System.IterationPath] = 'Name of the iteration') 
  AND ([System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward') 
ORDER BY [Microsoft.VSTS.Common.StackRank] asc,[System.CreatedDate] desc

mode(MustContain)
asof '05/05/2021'

我尝试的第二个查询返回所有顶级迭代项，但我不能指定 asOf，因为 mode(Recursive) 禁止它：

SELECT [System.Id],[System.State]
FROM WorkItemLinks

WHERE [Source].[System.IterationPath] = 'Name of the iteration'
AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
ORDER BY [System.Id]

mode(Recursive)

---

问题

如何在特定时间点查询在 Sprint Backlog 中看到的所有顶级迭代项目？

解决方法

通过在过滤 IN GROUP 时使用 [System.WorkItemType]，不再需要查询 WorkItemLinks，这可以解决这两个问题，因为我们可以使用 asOf：>

SELECT [System.Id],[System.WorkItemType],[System.Title],[System.AssignedTo],[System.State],[System.Tags] 
FROM WorkItems 

WHERE [System.IterationPath] = 'Name of the iteration'
AND 
(
    [System.WorkItemType] IN GROUP 'Microsoft.RequirementCategory' OR 
    [System.WorkItemType] IN GROUP 'Microsoft.BugCategory' 
)

ORDER BY [Microsoft.VSTS.Common.StackRank] asc,[System.CreatedDate] desc
ASOF '05/05/2021'