将自定义域添加到工作项类型(继承过程)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

添加自定义字段以支持与现有字段集不一起的跟踪数据要求。 例如,可以添加自定义字段来跟踪客户票证编号。 有关为组织定义的所有字段的列表(包括为系统和继承的进程定义的所有字段),请参阅 “查看工作项字段和属性”。 有关使用系统流程定义的每个字段的说明,请参阅工作项字段索引

重要

本文适用于 Azure DevOps Services 和 Azure DevOps Server 2019 及更高版本。 若要自定义针对 TFS 2018 或更早版本的集合定义的任何项目,请参阅 本地 XML 进程模型

重要

只能对配置为支持继承过程模型的项目集合上定义的项目使用继承过程模型。 如果本地集合配置为使用本地 XML 进程模型,则只能使用该进程模型来自定义工作跟踪体验。 若要了解详细信息,请参阅 自定义工作跟踪、为项目集合选择流程模型

若要自定义针对 TFS 2018 或更早版本的集合定义的任何项目,请参阅 本地 XML 进程模型

若要详细了解可以自定义的内容,请参阅 关于进程自定义和继承的进程

提示

若要自定义单个项目,请始终首先 创建继承的进程并将项目更新到该进程。 然后,对继承过程所做的所有自定义都会自动显示你迁移的项目。

先决条件

在自定义流程之前,建议查看配置和自定义Azure Boards,其中提供了有关如何自定义Azure Boards以满足业务需求的指导。 有关不同积压工作和板的说明,请参阅 积压工作、板、任务板和计划支持的任务

打开设置>过程

通过“组织设置>流程”创建、管理流程并对其进行自定义。

  1. 选择 Azure DevOps 徽标以打开 “项目”。 然后选择 “组织设置”。

    Open Projects>Organization settings.

  2. 然后选择“ 处理”。

    Then, choose Process.

    重要

    如果未看到 “进程”,则使用的是 TFS-2018 或更早版本。 不支持 “进程 ”页。 必须使用 本地 XML 进程模型支持的功能。

通过“集合设置过程”>创建、管理进程并对其进行自定义。

  1. 选择 Azure DevOps 徽标以打开 “项目”。 选择要自定义其进程的项目集合,然后选择 “集合设置”。

    Open Projects>Organization settings

  2. 然后选择“ 处理”。

    Then, choose Process.

通过管理员设置> Process 创建、管理和自定义进程。

  1. 选择 Azure DevOps 徽标以打开 “项目”。 然后选择“管理员设置”。

    Open Project>Organization settings.

  2. 然后选择“ 处理”。

    Then, choose Process.

创建继承的进程

第一步是创建可以自定义的继承过程。 默认系统进程被锁定,无法自定义。

  1. 在“ 进程页中, 打开将用于创建继承进程的进程的上下文菜单,然后选择“ 创建继承的进程”。 选择用于创建要自定义的项目的相同系统流程(敏捷、基本、ScrumCMMI)。

    在这里,我们从敏捷系统进程创建继承的进程。

    Context menu, Choose Create inherited process, Azure DevOps.

    Context menu, Choose Create inherited process, Azure DevOps Server 2020.

    Context menu, Choose Create inherited process, Azure DevOps Server 2019.

    重要

    如果未看到“ 创建继承的进程 ”菜单选项,则所选的集合将设置为使用本地 XML 进程模型。 可以导入和导出进程模板,并使用本地 XML 进程模型支持的功能。

  2. 输入进程的名称和描述(可选)。 进程名称必须唯一且不超过 128 个字符。 有关其他限制,请参阅 创建和管理继承进程、进程名称限制。 根据需要,可以添加说明。

    Create inherited process dialog

添加字段

始终将字段添加到现有工作项类型。

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

    在这里,我们选择 Bug WIT。 请注意允许你返回到“所有进程”和“MyAgile 进程”页的痕迹导航链接。

    All Processes-Process-WIT breadcrumb links

    如果“新建”字段和其他选项处于禁用状态,则你没有编辑该过程所需的权限。 请参阅设置工作跟踪的权限和访问权限,自定义继承的流程

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

    Process Work Item Types page, Add a field to a WIT

  3. 为字段命名,并从其中一种受支持的数据类型中选择字段类型。 字段名称必须唯一且不超过 128 个字符。 有关其他限制,请参阅什么是字段?如何使用字段名称? 可以选择添加“说明”。

    注意

    创建后,无法更改字段名称或数据类型。

    在这里,我们添加一个标记为“客户票证”的整数字段。

    Add a field to Bug, choose field type

    可以添加的其他数据类型包括:PicklistIdentityRich-text、HTMLCheckbox

  4. (可选)在 “选项 ”选项卡上,指示字段是否是必需的并指定默认值。 或者将这些留空。

    Add a field to Use story, specify options

    通过使字段“必需”,用户必须指定字段的值才能保存。 创建工作项时以及每次打开工作项且字段为空时,都会设置指定的默认值。

  5. (可选)在“ 布局 ”选项卡上,可以输入与字段名称不同的窗体标签。 此外,还可以选择窗体上显示字段的页面和组。

    在这里,我们将“客户票证”字段添加到标记为“客户焦点”的新组。

    Add a field to Use story, specify layout
  6. 选择 “添加字段 ”以完成添加字段。 如果尚未指定其布局位置,则会将其添加到布局窗体上的第一组字段。

    提示

    添加字段后,可以将其拖放到页面中以在窗体上重新定位它。 如果有多个要添加到自定义页面或组的字段,则可能需要 添加这些元素,然后添加字段。 不能将字段添加到“分配给”、“状态”和“原因”字段所在的窗体中的灰色区域。

验证所做的自定义

建议创建一个测试项目并向其应用自定义继承过程,以验证所做的更改。

  1. 打开“ 所有进程 ”页,然后选择... 要使用的过程的上下文菜单,然后选择“ 新建团队项目”。

    Create a project from the selected process

    Create a project from the selected process

    Create a project from the selected process

  2. 此时会打开“创建新项目”页。 填写表单。

    Create new project form

    Create new project form

    Create new project form

  3. 打开 工作项。 (1) 检查是否已选择正确的项目,然后选择“工作>工时项” (2)

    Open Work>Work Items

  4. 选择自定义的 WIT。 在这里,我们选择了 Bug

    Work, Work Items Page, Add New Work Item, Bug

  5. 验证添加的字段是否显示在窗体上。 请注意, “感叹号”图标指示字段是必需的。

    Bug form, Customer Ticket field added to Customer Focus group

将自定义过程应用于项目

验证自定义项后,现在可以将过程应用到现有项目。

提示

自定义 WIT 时,引用所自定义的继承过程的所有项目都会自动更新以反映已添加的自定义 WIT。 若要查看自定义项,请刷新 Web 浏览器。

  1. 对于项目当前使用的过程,请选择项目数。

    在这里,我们将打开敏捷默认进程的菜单。

    Agile process, Choose number of team projects

  2. 打开 … 要更改的项目的上下文菜单,然后选择 “更改过程 ”选项。

    在这里,我们打开 MyFirstProject1 的菜单。

    Project, Change process

  3. 从“更改项目进程”对话框中,从选项菜单中选择该过程。 然后选择“ 保存”。

    Change process dialog

  1. 打开 … 进程的上下文菜单,然后选择 “更改团队项目...” 。

    在这里,我们将打开 MyAgile 继承进程的菜单。

    Agile process context menu, Choose Change team projects to use MyAgile

  2. 选中要更改的这些项目的检查框,以使用敏捷流程。 系统仅列出那些对当前进程有效的项目。

    在这里,我们选择使用 Fabrikam Fiber A 和 Fabrikam Fiber 项目的敏捷过程。 只有从敏捷流程创建的项目或从 Agile 继承的项目才会显示在“可用项目”列下。

    Change process to an inherited process dialog

  3. 确认要更改的项目正确后,请选择“ 确定”。

问答

问:是否有一些不能使用的字段?

答: 是的,测试用例工作项类型上可用的步骤控件不能用于自定义工作项类型。

接下来尝试此操作

注意

可以通过审核日志查看对继承进程所做的更改。 若要了解详细信息,请参阅 访问、导出和筛选审核日志