（继承进程）添加和管理字段

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

可以通过添加自定义字段或修改 继承字段的特定属性，自定义工作跟踪系统。 例如，可以添加自定义字段来捕获其他数据或更改继承字段的工作项窗体中显示的标签。

若要查看为组织定义的所有字段，包括系统和继承的字段，请参阅 “查看工作项字段和属性”。

添加自定义字段后，可以使用它创建 查询、 图表或 Analytics 视图和 Power BI 报表 来跟踪和分析相关数据。

先决条件

有关定制 Azure Boards 以符合特定业务需求的指南，请参阅 配置和自定义 Azure Boards。

类别	要求
权限	- 若要创建、删除或编辑进程，需要成为项目集合管理员 组的成员，或具备特定集合级别的权限：创建进程、删除进程、编辑进程，或 对组织 中设为“允许”的字段进行删除 。 有关详细信息，请参阅 自定义继承的进程。 - 若要更新版块：必须是团队管理员或是项目管理员组的成员。
访问	- 即使你拥有 基本 访问权限或较低访问权限，如果有人授予你权限，你仍然可以更改进程。 - 若要更新和更改现有工作项的类型：必须是项目的成员。
项目进程模型	- 为包含该项目的项目集合提供 继承过程模型。 - 若要将数据迁移到 Azure DevOps Services，请使用 Team Foundation Server 数据库导入服务。
知识	- 熟悉 自定义和处理模型。

打开组织流程设置

1. 登录组织 (https://dev.azure.com/{yourorganization})。

2. 选择“组织设置”。

   

3. 选择处理。

   

注意

自定义继承的进程时，使用该过程的任何项目都会自动反映自定义项。 为了确保平稳过渡，建议在组织范围内创建一个测试过程和项目来测试自定义项。 有关详细信息，请参阅创建和管理继承的进程。

自定义字段名称

将自定义字段添加到继承的进程时，Azure DevOps 会为其分配一个前缀为 Custom 的引用名称，并从字段名称中删除任何空格。 例如，一个名为 "DevOps Triage" 的字段被分配引用名称 Custom.DevOpsTriage。 不允许在引用名称中使用空格。

添加自定义字段

可以添加字段，并指定它们应显示的组和页面。 添加字段后，可以将其拖放到页面中以调整其在窗体上的位置。 如果计划将多个字段添加到自定义页面或组，请先 创建这些页面或组 ，然后再添加字段。

每个进程最多可以定义 1,024 个字段，包括系统和继承的字段。 只能在窗体的页面内添加字段。 表单中包含“已分配给”、“状态”和“原因”字段的灰色区域无法添加字段。

1. 从所选继承进程的“进程”页中，选择要在其中添加自定义域的工作项类型 (WIT)。

   在以下示例中，我们选择“Bug WIT”。 请注意，使用痕迹导航链接可以导航到“所有进程”和“MyAgile”进程页。

   

   如果“ 新建”字段 和其他选项处于禁用状态，则你没有 编辑该过程所需的权限。

2. 选中 WIT 后，选择“新建”字段。

   

3. 为字段命名，并从支持的数据类型之一中选择字段类型。 根据需要，可以添加说明。

   字段名称在组织内必须是唯一的。 一个进程中的自定义字段不能与其他进程中的字段共享同名。 有关详细信息，请参阅什么是字段？如何使用字段名称？

   在以下示例中，我们添加一个标记为 “客户票证”的整数字段类型。

   

4. （可选）在“ 选项 ”选项卡上，指示字段是否是必需的并指定默认值。 如果留空，则字段保持可选。 创建“ 必需”字段时，用户必须指定一个值来保存工作项。 创建或打开工作项时设置默认值，字段为空。

   

5. （可选）在 “布局 ”选项卡上，可以指定与字段名称不同的窗体标签。 还可以选择字段在窗体上显示的页面和组。

   在以下示例中，我们将“客户票证”字段添加到标记为“客户焦点”的新组。

   

   注意

   虽然可以更改表单标签，但向卡片（板、 任务板）添加字段或基于字段 创建查询 时，必须使用字段名称。

6. 选择 “添加”字段 以完成该过程。 如果未指定布局位置，系统将字段添加到窗体上的第一组字段。

7. 更改完成后，打开自定义类型的工作项以查看更新。

   以下示例显示已成功将“客户票证”字段添加到“状态”组。 如果更改不立即可见，请刷新浏览器以确保更新正确显示。 此步骤可确保新字段正确集成到工作项窗体中，并可供使用。

   

添加选取列表

工作跟踪、进程和项目限制

可以添加一个新字段并定义一个选择列表，或者自定义继承字段的选择列表。

每个组织或集合最多可以定义 2,048 个选取列表。 每个选取列表最多可以包含 2,048 个项目。 选择列表项必须为 256 个或更少的字符。 若要添加依赖选取列表，请参阅 级联列表。

1. 选择 “新建字段”，然后指定选取列表类型（整数或字符串），然后添加要显示在选取列表中的项。 可以添加项目，然后选择 Enter 以添加另一个项目。

   

   若要删除列表中的项，请突出显示该项，然后选择 删除图标。

   若要修改继承字段的选择列表，请选择“编辑”以编辑该字段。 在“定义”选项卡上，可以选择“添加值”。

   

2. （可选）指定 必需值或默认值 ， 然后选择窗体上显示字段的位置。

   

“添加标识”字段

使用基于标识的字段添加类似于“分配对象”字段的字段。 基于标识的字段的工作方式与“已分配给”字段相同，提供搜索和标识选取器函数。 当组织使用 Microsoft Entra ID 或 Active Directory 管理用户时，系统将基于标识的字段与这些目录中定义的名称同步。

选择 “新建”字段，然后选择字段名称、“标识类型”和“说明”。

（可选）指定 必需值或默认值 ， 然后选择窗体上显示字段的位置。

添加富文本 HTML 字段

1. 选择要向其添加字段的 WIT，然后选择 “新建”字段。

2. 选择文本（多行）作为类型。 在这里，我们将字段标记为“客户请求”，以捕获客户对产品功能请求的评论。

   

3. 字段将被添加到所有系统定义的富文本字段的第一列，但在“讨论”控件之前。

   

4. （可选）指定 必需值或默认值 ， 然后选择窗体上显示字段的位置。

添加复选框字段

1. 选择要将字段添加到的 WIT，然后选择“新字段”。

2. 选择布尔值作为类型，并为其提供标签。 在这里，我们将字段标记为“已会审”，以跟踪 bug 的会审状态。

   

3. （可选）选择 “选项”，然后指定字段是否是必需的。

   

4. 默认情况下，字段将添加到第二列中定义的最后一个组。 选择“布局”，然后将字段拖放到窗体上的另一个组。

   注意

   该字段在工作项窗体中显示为复选框。 选中复选框表示 True 值。 如果字段显示在看板或任务板上，则值 True 和 False 显示为文本形式而非复选框。

将现有字段添加到另一个 WIT

现有字段对应于集合中定义的任何继承字段和自定义字段。 将自定义字段添加到一个 WIT 后，可以通过窗体菜单将其添加到其他 WIT。 或者，可以将为一个进程定义的字段添加到另一个进程中的工作项类型。 打开工作项类型并选择现有字段。

若要查找任何系统定义的工作项字段的说明，请参阅工作项字段索引。

在以下示例中，我们将 “客户票证 ”字段添加到“用户情景 WIT”。

（可选）指定 必需值或默认值 ， 然后选择窗体上显示字段的位置。

重新标记字段

不支持重命名字段或更改其类型。 但是，可以从“ 布局 ”选项卡更改工作项窗体上显示的标签。创建查询时，请使用字段名称，而不是标签。

在以下示例中，我们将 “客户票证 ”字段重新标记为 “票证编号”。

修改说明帮助文本

当用户将鼠标悬停在工作项窗体中的字段上时，将显示说明帮助文本。 可以自定义自定义字段和继承字段的帮助文本，但行为因字段类型而异：

• 继承的字段：可为每个工作项类型和过程自定义帮助文本。
• 自定义字段：帮助文本在所有工作项类型和流程中保持一致。

若要修改“说明”帮助文本，请选择要修改的工作项类型，选择字段的“编辑”，然后选择“定义”选项卡。修改后的值仅影响进程中的该字段以及该工作项类型。

在这里，我们修改用户情景的“故事点”字段。

显示、隐藏或删除字段

可以选择在窗体上显示或隐藏任何字段或自定义控件。 如果您想稍后将字段恢复到窗体中，可以选择取消隐藏。这些操作与“删除”选项不同，该选项会从组织中删除该字段。

注意

为继承字段定义的数据，即使隐藏了它，也会保存在数据存储和工作项历史记录中。 可以通过查看工作项的历史记录选项卡来查看记录。

从布局中删除自定义字段时，它会保留在数据存储中，但从历史记录中剥离。 可以从查询结果查看它。 如果将字段添加回窗体，则历史记录将还原。 若要从项目集合中删除自定义域，请参阅 “删除字段”。

隐藏字段或自定义控件

1. 打开字段或控件的上下文菜单，然后选择“从布局中隐藏”。

   

2. 若要向窗体添加隐藏字段或控件，请选择“在布局上显示”。

从窗体中删除自定义字段

1. 从要删除的字段的上下文菜单中选择“删除”。

   

2. 确认要删除该字段。

   

3. 若要添加已删除的自定义字段，请选择“新建字段”，然后选择“使用现有字段”。

将字段还原为预设默认值

您可以放弃所做的对继承字段的更改。 从修改的工作项类型的布局页中，为字段选择还原选项。

删除自定义字段

使用继承过程模型，只能删除自定义字段;无法删除系统默认字段。

删除字段会删除所有关联的数据，包括历史值。 数据清除作业开始前可能存在短暂的延迟。 在此期间，可以尝试使用 字段 - 更新 REST API 还原字段并恢复其数据。 恢复可能完整、部分或失败，具体取决于剩余数据。 删除字段时请谨慎，因为恢复并非总是可能或完成。

注意

此操作无法撤销。 仅删除未使用的字段。 使用 witadmin listfields 命令标识未使用的字段。 有关详细信息，请参阅管理工作项字段 (witadmin)。
如果为您的组织或集合启用了 Analytics，您可以使用以下语法查询 Analytics，以找出自定义字段的使用位置。

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

若要删除自定义字段，请执行以下步骤：

1. 选择 “组织设置>处理>字段>更多操作>删除”。

   

   是“项目集合管理员”组的成员，或被授予显式权限以删除字段。

2. 输入如下例所示的字段名称，然后选择“ 删除工作项”字段进行确认。

   

相关内容

注意

可以使用审核日志和审核功能查看对继承过程所做的更改。 有关详细信息，请参阅访问、导出和筛选审核日志。

• 查看工作项字段和属性
• 添加或修改自定义工作项类型
• 自定义 Web 布局
• 工作跟踪、进程和项目限制