Visual Studio REST API 迭代和区域 ID

Question

我正在使用 VSO REST API，并且对如何分配迭代和区域 ID 有疑问。具体来说，为什么当我将工作项分配给根Iteration或Area时，当我查询分类节点时没有返回为WIT返回的ID？

例如，假设我在查询 /DefaultCollection/my project/_apis/wit/classificationnodes?$depth=2 时有这个层次结构

• 我的项目：id=1234
  • 区域 1：id=5678
    • 区域 2：id=9012

然后我使用 /DefaultCollection/_apis/wit/workItems/1?$expand=all 查询工作项

如果工作项位于区域 1 或区域 2，则 System.AreaId 字段与预期相同（分别为 5678 和 9012）。但是，如果我将工作项分配给我的项目，则 System.AreaID 是我查询所有分类节点时未包含的某个值。 ID 之间似乎存在某种关系，因为它们是串行的（例如，分类节点查询返回的 ID 是区域的 1232 和迭代的 1233），但我似乎找不到查询的方法获取工作项查询返回的实际 ID。

事实上，当我查询所有分类节点时，不仅为工作项返回的 ID 不存在，如果我将工作项分配给根迭代和区域，则为两个字段返回的 ID 是相同的值不包括在分类节点查询中。

我需要的是一种查看工作项并找出它所属的区域和迭代的方法。我可能可以对返回的路径字段字符串做一些事情，但这似乎容易出错，因为用户可以更改它们。

****编辑**** 以上似乎是 REST API 中的一个错误，但对于遇到这篇文章的任何人来说，有一种方法可以通过路径字符串获取可用的迭代 ID。像这样构建您的 REST 调用：

/DefaultCollection/[项目名称]/_apis/wit/classificationnodes/iterations/Release 1/Sprint 1（等等）

Answer 1

我从来没有用 ID 做过这个。我只使用路径。在分类服务中，您可以很容易地通过路径获取节点。

例如，使用 REST API - 您可以访问此 url 以获取有关特定迭代的数据：

/DefaultCollection/[Project Name]/_apis/wit/classificationnodes/iterations/[Release X]/[Sprint Y]

请注意，尝试访问默认迭代路径（项目名称而不是特定迭代）将返回错误：

/DefaultCollection/[Project Name]/_apis/wit/classificationnodes/iterations/[Project Name]

会给：

{"$id":"1","innerException":null,"message":"VS402485: The node name is not recognized: [Project Name]","typeName":"Microsoft.TeamFoundation.WorkItemTracking.Server.Metadata.WorkItemTrackingTreeNodeNotFoundException, Microsoft.TeamFoundation.WorkItemTracking.Server","typeKey":"WorkItemTrackingTreeNodeNotFoundException","errorCode":0,"eventId":3200}

因此，如果您进行批处理工作，则必须在查询 api 之前对其进行过滤。

Answer 2

标识区域的方法有三种（我发布的所有内容同样适用于迭代）。路径（字符串）、ID（整数）和 Guid。它们中的每一个都以不同的方式使用，并具有不同的分支。

例如重命名一个区域，不会改变它的身份，因此不会更新工作项（工作项中返回的路径是动态的）。

也可以删除并重新创建相同的路径，但它会有不同的 ID。

GUID 主要用于 Excel 报告（例如 SharePoint 门户的父级）

根据您希望事物的反应方式确定要使用的适当元素。

我没有看到你提到的 ID 有任何问题，如果你能创建一个简单的复制品，我很乐意看看。

david(dot)corbin(at)dynconcepts(dot)com