azure-devops - 用于游泳的 Azure DevOps REST API

Question

我正在尝试将 Servicenow 与 Azure Devops Board 集成，以使用 REST API 在工作项上创建/更新等

我成功地在工作项上创建和更新了很多东西

我找不到告诉工作项落入特定泳道的 API

如果您查看我附上的图片，它有一个默认泳道(测试)和自定义泳道...所以 H 有一个 api 可以将它从“ToDo”移动到“Doing”，但是如果您注意到那里多个“正在做”，因为有不同的泳道，所以任何人都可以帮助解决这个问题，或者告诉工作项目落入特定泳道的 API

我做了一些研究并找到了“System.BoardLane”我确实在发布和补丁中使用了它

错误:

{
    "$id": "1",
    "customProperties": {
        "ReferenceName": null
    },
    "innerException": null,
    "message": "TF401326: Invalid field status 'ReadOnly' for field 'System.BoardLane'.",
    "typeName": "Microsoft.TeamFoundation.WorkItemTracking.Server.WorkItemFieldInvalidException, Microsoft.TeamFoundation.WorkItemTracking.Server",
    "typeKey": "WorkItemFieldInvalidException",
    "errorCode": 600171,
    "eventId": 3200
}

然后我使用操作“op”:“移动”

错误:

{
    "$id": "1",
    "innerException": null,
    "message": "Move/Copy is not implemented.",
    "typeName": "Microsoft.VisualStudio.Services.WebApi.Patch.PatchOperationFailedException, Microsoft.VisualStudio.Services.WebApi",
    "typeKey": "PatchOperationFailedException",
    "errorCode": 0,
    "eventId": 3000
}

Answer 1

Azure DevOps REST APIs FOR SWIMLANE

事实上，您非常接近正确答案。

您遇到的第一个错误:TF401326: Invalid field status 'ReadOnly' for field 'System.BoardLane'已表明如果您想通过更新 System.BoardLane 来修改 SwimLane通过 API 字段，我们不允许这样做，因为它只读。

(对于那些 fields ，不仅 System.BoardLane 是只读的，而且 System.BoardColumn 也是只读的)

这是设计好的。

---

为了更新SwimLane ，在这里您需要通过 API 更新扩展字段而不是系统字段。

• 第一步:

调用 Get - Boards获取董事会信息的API。在其响应主体中，扩展字段 名称将显示在fields -> rowField 下。

示例:

GET https://dev.azure.com/{org name}/{project name}/{team name}/_apis/work/boards/Stories?api-version=5.1

这些扩展字段的引用名称 将包含一个GUID，它对于板是唯一的(例如 WEF_6623ED31B8E04C778FB1129D3239B1A7_Kanban.Lane )。

• 第二步:

调用 Update - Work Items API，使用您在上面获得的字段名称作为路径(例如 /fields/WEF_6623ED31B8E04C778FB1129D3239B1A7_Kanban.Lane )并输入车道值作为您要将项目移动到的行的名称:

示例:

PATCH https://dev.azure.com/{org name}/{project name}/_apis/wit/workitems/{WIT id}?api-version=5.1

请求正文:

[
  {
    "op": "add",
    "path": "/fields/WEF_6623ED31B8E04C778FB1129D3239B1A7_Kanban.Lane",
    "from": null,
    "value": "Lane for product team"
  }
]

Lane for product team是泳道之一。

现在，您会看到工作项移到了您指定的相应 channel 中。

---

注意: 扩展字段的 GUID 对于面板是唯一的。不同的板有不同的扩展字段 GUID 值。