azure - 如何在通过 Azure DevOps Services 的 REST API 创建错误时查找发行说明字段的 API 端点

Question

我尝试通过 REST API 添加错误，但找不到发行说明字段的路径。

我检查了官方文档中的字段列表，但没有有关发行说明字段的信息 official documentation link

以下应该创建将信息插入发行说明的操作，但路径错误

patchDocument.Add(
                new JsonPatchOperation()
                {
                    Operation = Operation.Add,
                    Path = "/fields/Microsoft.VSTS.Common.ReleaseNotes",
                    Value = "1"
                }
            );

是否有任何非官方文档或某些库，我可以在其中查看字段的所有可用 API 端点的列表？

Answer 1

简短的回答 - 是的! - 你在问题中的链接是那个API。但是，该文档是获取工作项类型操作的 API 引用，其中仅包含一个对可能获得的示例响应进行建模的示例，而不是整体列表。

在开始之前，我假设发行说明是此处的自定义字段，因为我在默认的 Work item field index 中没有看到它。 .

要了解此(自定义)字段的路径可能是什么样子，执行Get Work Item Types会有所帮助。项目范围内的 bug 类型的 API，然后查看响应。这是我得到的，例如:

其中“dependsOn”是我在项目使用的流程中定义的自定义字段。

因此，为了创建错误，我以以下格式向 Create Work Item 提供了请求正文API:

[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "Sample Bug"
  },
  {
    "op": "add",
    "path": "/fields/Custom.dependsOn",
    "value": "Auth"
  }
]

瞧，创建了一个错误。希望这有帮助!