向工作项类型添加扩展和自定义控件(继承进程)

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

本文介绍如何使用扩展向工作项表单添加丰富的功能。 扩展采用四种风格或参与类型。 以下控件显示在所有继承和可自定义的工作项类型 (WIT) 的 Web 窗体布局上:

  • 字段级贡献(自定义控件)
  • 组级参与
  • 页面级贡献

另一方面,第四种类型(操作级参与)显示在 Web 窗体的上下文菜单中。

重要说明

继承过程模型适用于配置为支持模型类型的项目。 如果使用较旧的集合,请检查进程模型兼容性。 如果本地集合配置为使用本地 XML 进程模型,则只能使用该进程模型来自定义工作跟踪体验。 有关详细信息,请参阅 组织级进程自定义

可以通过从 Visual Studio Marketplace Azure DevOps 选项卡安装其扩展来添加所有参与。或者,可以创建自己的自定义控件

例如,可以添加谁最近查看了工作项? 此组级贡献会显示在所示的工作项窗体中。

工作项窗体的屏幕截图,组扩展示例,谁查看了此内容。

先决条件

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

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

若要添加扩展或编辑进程,必须是项目集合管理员组的成员,或者被授予编辑特定进程的明确权限

打开组织流程设置

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

  2. 选择“组织设置”。

    显示可供选择的“组织设置”按钮的屏幕截图。

  3. 选择处理

    显示突出显示的“进程”按钮以供选择的屏幕截图。

  1. 登录到集合 (https://dev.azure.com/{Your_Collection})。

  2. 选择“集合设置”或“管理员设置”。

  3. 选择处理

    显示“集合设置”中突出显示的“进程”按钮的屏幕截图。

注意

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

查看已安装的市场扩展

“设置” 上下文的“ 扩展 ”选项卡上,可以查看已安装的扩展。 可能需要选择“ 刷新 ”以显示新安装的扩展。

“组织设置”中“扩展”页的截图。

若要了解有关扩展的详细信息,请参阅 “安装扩展”。

添加市场扩展

可以 浏览市场 以确定要添加哪些扩展。

  1. 若要向工作项类型添加扩展,请选择继承的进程、WIT,然后选择“获取扩展”。

    进程、WIT、Bug、布局、获取扩展的屏幕截图。

  2. 选择要添加的扩展。 在这里,我们选择“工作项核对清单”。

  3. 选择要向其添加的组织,然后选择“安装”。

    Visual Studio Marketplace 的屏幕截图,安装扩展。

    重要说明

    所安装的扩展将添加到所有进程中的全部 WIT 内。

  4. 返回到进程和 WIT,并验证扩展的位置是否是所需的位置。 在中间列的底部查找它,并将其拖动到窗体上所需的位置。

    缺陷工作项表单中的组扩展的截图。

添加字段级贡献或自定义控件

  1. 如前一节所述,安装自定义控件

  2. 在工作项表单中打开 设置>工作>进程。 有关详细信息,请参阅 “打开组织流程设置”。

  3. (可选)添加要与自定义控件关联的字段。 或者可以指定现有的继承字段或自定义字段。

  4. 选中 WIT 后,选择“添加自定义控件”。

    进程、WIT、Bug、布局、添加自定义控件的屏幕截图。

    注意

    如果未看到“添加自定义控件”选项,则尚未安装字段级扩展。 或者,可能需要刷新浏览器,以便浏览器注册最近安装的任何新扩展。

  5. 从选项菜单中选择所需的自定义控件。

    例如,在这里,我们选择可以与布尔字段关联的切换控件。

    “添加自定义控件”对话框“定义”选项卡的屏幕截图。

  6. 选择“选项”选项卡并填写对话框。 需要指定的选项取决于所选的自定义控件。

    例如,此处我们指定了自定义字段 "优先处理" ,并指明了要在表单上显示的切换标签。

    “自定义控件”对话框的屏幕截图。

  7. (可选)打开“布局”选项卡并指定字段的标签。

    填写任何其他必填字段。 查看扩展说明以获取指导。

  8. 通过打开已修改类型的工作项来验证自定义控件的工作情况。 可能需要刷新浏览器才能查看更改。

    在此,我们展示了此控件在默认情况下如何与复选框一起显示,以及如何与切换控件一起显示。

    带有复选框的布尔值字段

    带有切换控件的布尔值字段

    带有复选框的布尔字段的屏幕截图。

    具有切换控件的布尔字段的屏幕截图。

组级与页面级贡献

添加 组级页面级 贡献时,它们会自动添加到为所有进程定义的所有 WIT,包括继承的和自定义的。 可选择为特定 WIT 将这些贡献从窗体中隐藏,或在窗体内从默认位置对其进行移动。

如果已安装了组或页面贡献,请刷新浏览器,然后打开一个工作项以查看贡献在窗体上的位置。 若要移动或隐藏参与内容,请参阅 自定义工作项类型的 Web 布局

操作级贡献

操作级别 贡献将添加到用于系统进程和继承进程的可继承和可自定义 WIT 的上下文菜单中。 所有动作级别的贡献都添加到所有工作项类型中,不能隐藏或删除,除非卸载或禁用该扩展

例如,下图显示已添加了九个操作级别的贡献,并出现在用户故事的上下文菜单中。

用户故事网页表单、上下文菜单、动作级选项的屏幕截图。

以编程方式添加自定义控件

可以使用以下 REST API 来处理扩展:

注意

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