TFS 2018自定义字段不显示、新工作项表单选项缺失问题求助
解决TFS 2018自定义Agile模板Web布局不生效的问题
首先咱们先戳破核心问题:你修改的是WebLayout(新工作项表单的布局),但如果没启用新表单,TFS会默认沿用旧的<Form>节点布局——这就是为啥你移除Description后还能看到、新字段也不显示的根本原因。下面分步骤给你解决:
1. 先确认TFS版本,找到新表单的启用入口
TFS 2018的新工作项表单是从Update 2版本开始正式提供可视化配置入口的,如果你用的是RTM或Update 1版本,确实找不到那个开关:
- 如果你是Update 2及以上版本:
- 登录TFS Web界面,进入集合设置(Collection Settings)
- 切换到Processes选项卡,找到你基于Agile改的自定义过程
- 点击过程名称右侧的三个点(...),选择Settings
- 在弹出的面板里就能看到“Enable the new work item form”的开关,直接开启即可
- 如果你是RTM/Update 1版本:
这个版本的新表单还在预览阶段,没有可视化配置入口,最稳妥的方式是升级到Update 2及以上版本;如果暂时没法升级,不建议用注册表修改的方式强制开启(风险较高),不如直接修改旧布局节点。
2. 检查布局节点是否对应生效的版本
要确保你改的是当前生效的布局节点:
- 启用新表单后:生效的是
<WebLayout>节点,你需要确认Task工作项的XML里,这个节点下正确添加了新字段(要用字段参考名,不是显示名),并且移除了不需要的标准字段 - 未启用新表单时:生效的是
<Form>节点(旧WinForm风格布局),你得同时修改这个节点,把新字段加到合适的组里,删掉不需要的字段
可以用witadmin命令行工具导出当前项目的Task配置,验证布局是否正确:
witadmin exportwitd /collection:http://你的TFS服务器地址:8080/tfs/你的集合名 /p:你的项目名 /n:Task /f:Task.xml
打开导出的Task.xml,检查对应的布局节点是否包含你的修改——如果没有,说明模板上传时没成功,得重新导出、修改、上传模板。
3. 彻底清理缓存(客户端+服务器)
缓存是布局不更新的常见元凶,要彻底清理:
- 客户端:用浏览器硬刷新(Ctrl+Shift+R),或者直接清除浏览器缓存
- 服务器:
- 停止TFS相关服务(Team Foundation Server Application Pool、Team Foundation Server Job Agent等)
- 删除服务器缓存文件夹:
C:\Program Files\Microsoft Team Foundation Server 2018\Application Tier\Web Services\_tfs_data - 重启TFS服务
4. 验证模板上传和项目创建的正确性
- 上传自定义模板时,确保没有报错,并且在Processes列表里能看到你的自定义过程
- 创建新项目时,一定要选你自定义的过程,别选错默认的Agile模板
- 可以新建一个空白项目测试,避免旧项目的缓存残留影响结果
内容的提问来源于stack exchange,提问作者user240384
相关产品推荐
相关产品推荐

