本地 XML 进程自定义

Azure DevOps Server 2022 - Azure DevOps Server 2019

本地 XML 流程模型为项目提供对自定义工作跟踪对象和敏捷工具的支持。 使用此模型，可以更新工作项类型、流程配置、类别等的 XML 定义。 还可以更新字段的属性。

自定义工作跟踪体验以支持业务和报告需求。 最常见的自定义包括添加自定义域、修改工作项窗体或添加自定义工作项类型。

注意

有关详细信息，请参阅以下文章：

• 使用积压工作来管理项目
• 配置和自定义Azure Boards
• 使用所选流程创建项目
• 自定义工作跟踪体验
• 创建和管理继承的进程

对于 Azure DevOps Server 2019 及更高版本，可以选择进程模型。 创建项目集合时，需要在本地 XML 进程模型和继承进程模型之间进行选择。 有关详细信息，请参阅 “自定义工作跟踪”，选择项目集合的进程模型。

重要

不支持将项目或集合从托管 XML 迁移到继承的模型，Azure DevOps Server。 它仅适用于 Azure DevOps Services。

若要自定义Azure DevOps Services项目，请参阅关于进程自定义和继承的进程。 本文仅适用于本地部署。

支持的自定义项

使用本地 XML 进程模型时，可以执行以下任务。

区域

自定义支持

字段

• 添加或修改字段
• (TFS 2017.2) (布尔) 字段添加复选框
• 向字段添加规则
• 更改字段标签
• 添加自定义控件字段
• 从窗体中删除字段
• 更改字段属性
• 添加与测试、生成和版本控制集成的字段
• 删除字段

选取列表

• 区域路径
• 迭代路径
• 添加自定义选取列表
• 修改预定义的选取列表
• “状态”或“原因”字段 (自定义工作流)
• (添加用户) 的人员名称字段
• 解决状态和失败类型
• 定义全局列表

工作项类型

• 添加或修改工作项类型
• 更改工作流 (状态、原因、转换)
• 自定义窗体
• 指定 WIT 颜色
• 指定 WIT 图标
• 指定工作流状态颜色

积压工作和进程配置

• 将 WIT 添加到积压工作或板
• 添加项目组合积压工作
• 配置快速添加面板
• 配置默认积压工作列
• 设置任务板项的最大数目
• (Scrum) 设置默认周末
• 设置默认 bug 管理行为
• 设置默认隐藏积压工作
• 进程配置
• 类别

过程模板

• 自定义
• 管理 (上传/下载)
• 维护和升级影响

链接类型

• 添加自定义链接类型
• 删除自定义链接类型
• 停用/激活自定义链接类型

自定义序列

管理本地部署时，使用以下顺序执行大多数自定义。 此序列支持更新 WIT、全局列表、进程配置和类别的 XML 定义。 此序列通过导入各自修改的 XML 定义文件支持单个更新。 建议在存储库中维护 XML 定义文件，以便进行版本控制。

此外，可以使用 witadmin 工具列出对象、重命名 WIT、永久删除 WIT 等。

提示

使用 witadmin，可以 导入和导出定义文件。 可以使用的其他工具包括进程编辑器 (要求你已安装 Visual Studio) 版本。 从 Visual Studio Marketplace 安装进程模板编辑器。

维护和升级影响

在自定义之前，应了解升级应用程序层服务器时自定义项对项目的影响。

升级到本地部署可能会引入新功能，这些功能需要更新用于跟踪工作的对象。 这些对象包括工作项类型、类别和过程配置。 最大程度地减少对 WIT 或进程配置的工作流的更改，有助于最大程度地减少升级部署时必须执行的工作。

若要最大程度地减少升级后需要完成的手动工作量，请了解哪些自定义支持简单的更新路径，哪些不支持。

兼容快速更新

通过以下自定义，可以使用“配置功能向导”自动将新功能所需的任何更改应用到项目。

• 字段：添加自定义字段、自定义选取列表、添加或修改区域和迭代路径、将规则添加到字段
• WIT：添加自定义 WIT、更改窗体布局
• 类别：添加自定义类别
• 敏捷工具：自定义板上的列，自定义快速添加面板
• Office 集成：添加或更改将 Project 字段映射到 TFS 字段的方式

若要了解有关配置功能向导的详细信息，请参阅 在升级后配置功能。

兼容，但可能需要手动更新

配置功能向导要求项目中存在特定的工作项类型、工作流状态和字段。 进行以下自定义时，可能需要修改自定义过程才能运行向导，或者可能需要手动更新项目。

• 字段：更改现有字段的属性，删除进程配置中引用的字段
• WIT：更改工作流
• 敏捷工具：更改为“要求类别”、“任务类别”或“功能类别”定义的 WIT。
• 敏捷工具：更改进程配置中定义的元状态映射。
• 敏捷工具：更改进程配置中为 TypeField 指定的字段。

此外，对 WIT 或工作流所做的更改可能需要更新与流程一起提供的其他项目，例如 Excel 或SQL Server Reporting Services报表。

要避免的自定义

应避免进行以下自定义，因为它们可能会导致数据仓库中的架构冲突，或者在 TFS 升级后更新项目时导致问题。

• 领域：
  • 更改 WIT 定义文件中指定的字段 (字段的友好名称)
  • 更改一个或多个报告属性或 属性以将人员姓名与默认字段的 Active Directory 同步
• WIT：重命名或删除 WIT
• 类别：更改默认类别的名称，或更改默认类别中指定的 WIT

若要了解有关报告属性的详细信息，请参阅 添加或修改工作项字段以支持报告。

建议的做法

• 标识用于自定义支持跟踪需求的 WIT 的最佳选项。 更改跟踪工作项的对象时，应确定这些更改将如何影响现有和未来的项目。
• 将进程和所有 XML 定义文件置于版本控制之下。 请勿部署已定义但尚未存储在储存库中的对象。
• 像测试软件那样测试自定义对象。
• 最大程度减少引入的自定义字段的数目。 最大程度地减少可报告的字段的数目。

将团队区域路径替换为团队字段

项目的默认配置将每个团队与区域路径相关联。 如果你的组织有几个团队通过共同的积压工作 (backlog) 进行工作并跨多个产品区域，则此配置可能不适合你希望组织执行工作的方式。 通过添加自定义字段来表示你组织中的团队，你可以重新配置敏捷计划工具和页面来支持你的团队并将工作分离到团队和区域路径。

使用团队字段而不是区域路径来支持团队 介绍了如何更改默认配置。

相关文章

• 自定义工作
• witAdmin：自定义和管理用于跟踪工作的对象