通过

自定义字段

  • 项目

Azure DevOps Services

使用自定义字段可以 存储针对测试运行和/或测试结果的自定义数据 。 对于单个 Azure DevOps 项目，最多可以定义 100 个自定义字段。 项目管理员可以 管理自定义字段集（添加/删除）。

管理自定义字段

可通过两种方式管理自定义字段 - 通过 REST API 或项目管理员可以在选择管道下的“测试管理”时通过项目设置执行此操作。 在该页面上，可以通过单击“ + 添加新 ”按钮来添加新的自定义域。

项目设置的屏幕截图，其中选择了测试管理设置，以及用于添加新的自定义字段（用红色矩形标记）的按钮。

选择“ + 添加新 ”以添加新的自定义域。 每个自定义字段必须具有名称、类型配置，并指示其适用的项目类型。

用于添加新自定义域的对话框的屏幕截图。

自定义字段的名称不能超过 50 个字符（不允许空格、数字和特殊字符），并且必须在项目中是唯一的。 名称不区分大小写，因此不能有一个名为“Test”的自定义字段和另一个名为“test”的自定义字段。 Type 可以是下列类型之一：

  • Bit
  • DateTime
  • int
  • 浮点
  • 字符串
  • Guid

可以编辑现有的自定义字段（只能更改名称）或删除。

注意

删除自定义字段后，不能将其名称用于大约一天。 永久删除已删除的自定义字段的后台进程每天运行一次。

将自定义数据存储到自定义字段中

可以在测试运行/结果创建过程中或在创建测试运行/结果后将自定义数据存储到配置的自定义字段中。 现在可以使用 REST API 完成这两项操作。 将来，我们将允许从测试结果文件中选取自定义数据。 若要获取存储在现有测试运行/结果的自定义字段中的值，必须使用 REST API。 目前，我们不会显示 Azure DevOps UI 上存储的自定义字段和值（我们将在未来添加此功能）。

通过 REST API 创建测试运行和/或结果并想要将自定义数据存储到现有自定义字段时，最佳选择是在测试运行和/或结果创建过程中发送自定义数据。 若要创建测试运行调用 REST API 运行 - 创建 和创建测试结果调用 REST API 结果 - 添加。

如果未通过 REST API 创建测试运行和/或结果，但通过其他方式创建测试运行和/或结果时，必须先找到要为其设置自定义数据（或更新）自定义数据的测试运行或结果的标识，然后调用 REST API 运行 - 测试运行更新和 REST API 结果 - 测试结果的更新 。

若要从之前针对测试运行和/或结果存储的自定义字段中检索自定义数据，必须先找到测试运行或结果的标识。 然后，可以调用 REST API 运行 - 查询 测试运行和 REST API 结果 - 获取 测试结果。

自定义字段的自定义数据在数组中发送或接收。 该数组的每个项都包含两个属性“fieldname”和“value”，可在此处查看该属性的示例。 该值是与为自定义字段配置的类型匹配的类型的对象。 若要了解自定义字段的类型，可能需要使用 提供自定义字段数组的 REST API 。 对于每个字段，可以找到其 ID、名称、类型和范围。 如果知道给定名称的自定义域的类型是什么，则还可以硬编码类型。