Azure DevOps Server 2019自定义XML流程模板在流程页不可见如何处理

问题根因 #

升级后仅绑定到单个项目的自定义XML流程不会默认同步到全局流程库，因此流程页面仅能看到系统内置的基础XML模板和继承流程，看不到正在使用的自定义模板。

操作步骤 #

• 第一步：获取自定义流程模板文件
  打开具备管理员权限的Visual Studio开发者命令提示符，执行以下命令导出当前正在使用自定义模板的项目对应的完整流程包：

witadmin exportprocess /collection:http://你的Azure DevOps集合地址 /p:你的项目名称 /f:"本地保存路径/CustomTemplate.zip"

• 第二步：将自定义模板导入全局流程库
  执行导入命令将导出的自定义流程包注册到集合的全局流程库中：

witadmin importprocess /collection:http://你的Azure DevOps集合地址 /f:"本地保存路径/CustomTemplate.zip"

• 第三步：验证可见性
  刷新Azure DevOps的流程管理页面，即可在XML流程分类下看到刚导入的自定义模板，直接点击即可触发迁移到继承流程的操作。

注意事项 #

• 所有操作执行前必须先对Azure DevOps集合数据库做完整备份，避免操作失误导致数据损坏
• 执行witadmin命令的账号必须具备集合管理员权限，否则会触发权限报错
• 若导入后仍看不到模板，可查看流程页面的「隐藏流程」分组，部分自定义模板导入后默认处于隐藏状态，修改可见性即可显示
• 迁移前需检查自定义XML中是否存在不符合继承流程规范的配置（如命名冲突的自定义字段、不兼容的状态流转规则），提前修正避免迁移失败

内容的提问来源于stack exchange，提问作者Nico