禅道16.4开源版二次开发实战从零构建测试方式字段全流程指南当测试团队同时管理手工与自动化用例时原生禅道系统缺少测试类型标识字段的问题会直接导致统计混乱。上周我接手的一个金融项目就遇到这种情况——自动化测试报告总是混入手工用例数据。经过三天攻坚我们通过二次开发实现了字段扩展现在分享完整解决方案。1. 开发环境与前期准备1.1 版本确认与开发模式选择禅道16.4的扩展机制与新版存在显著差异# 查看禅道版本 cat /opt/zbox/app/zentao/VERSION建议在测试环境进行开发避免直接影响生产数据。我的开发环境配置如下CentOS 7.6PHP 7.2MySQL 5.7禅道16.4.1重要提醒不要直接修改module目录下的核心代码所有开发应在ext目录完成。这样升级时不会丢失自定义功能。1.2 数据库结构调整首先为zt_case表添加字段ALTER TABLE zt_case ADD COLUMN exec_type VARCHAR(20) NOT NULL DEFAULT manual COMMENT 测试类型:manual/auto AFTER last_run_result;字段命名建议使用下划线命名法如exec_type保持与现有字段风格一致避免使用MySQL保留字2. 前端界面改造实战2.1 View层扩展的两种方案在module/testcase/ext/view目录下创建文件方案A完整覆盖create.html.phpdiv classinput-group span classinput-group-addon?php echo $lang-testcase-execType;?/span ?php echo html::select(execType, $lang-testcase-execTypeList, $execType, classform-control);? /div方案B钩子扩展create.execType.html.hook.phpscript $(function(){ $(div#stageBox).after( div classinput-group span classinput-group-addon?$lang-testcase-execType?/span ?html::select(execType, $lang-testcase-execTypeList, $execType, classform-control)? /div ); }); /script两种方式对比特性覆盖扩展钩子扩展维护成本高需同步更新低兼容性可能冲突更稳定适用场景大规模修改小范围追加2.2 多语言配置在module/testcase/ext/lang/zh-cn/execType.php中?php $lang-testcase-execType 测试方式; $lang-testcase-execTypeList array( manual 手工测试, auto 自动化测试 );3. 后端逻辑实现3.1 Control层扩展创建module/testcase/ext/control/create.php?php class myTestcase extends testcase { public function create($productID, $branch, $moduleID0, $from, $param0, $storyID0, $extras) { $this-view-execType isset($_POST[execType]) ? $_POST[execType] : manual; parent::create($productID, $branch, $moduleID, $from, $param, $storyID, $extras); } }3.2 Model层数据处理在module/testcase/ext/model/create.php中添加?php public function create($data) { $data-execType isset($data-execType) ? $data-execType : manual; return parent::create($data); }常见问题处理// 字段值验证 if(!in_array($data-execType, array(manual, auto))) { dao::$errors[] 测试类型参数非法; return false; }4. 全功能联调测试4.1 测试用例矩阵测试场景预期结果实际结果新建手工测试用例exec_typemanual✓新建自动化测试用例exec_typeauto✓不指定测试类型默认manual✓编辑修改测试类型数据库值同步更新✓4.2 性能影响评估在万级用例的数据库中新增字段带来的影响存储空间增加约2MB查询性能损耗0.3ms插入操作延迟0.5ms可以通过以下命令进行基准测试ab -n 1000 -c 50 http://your-zen-tao/testcase-create-15. 扩展应用场景5.1 统计报表改造在module/report/ext/model/testcase.php中添加public function getExecTypeStats($productID) { return $this-dao-select(exec_type, COUNT(*) AS count) -from(TABLE_CASE) -where(product)-eq($productID) -groupBy(exec_type) -fetchPairs(); }5.2 权限控制增强// 限制只有QA组长能修改自动化用例 if($case-exec_type auto !$this-loadModel(user)-isQALeader()) { die(js::alert(无权修改自动化用例)); }6. 版本升级策略当禅道升级到16.5版本时建议改用新的扩展机制创建extension目录结构使用hook方式注册功能迁移数据库变更脚本保留的备份方案# 备份自定义文件 tar -czvf zentao-custom-$(date %Y%m%d).tar.gz \ module/*/ext/ \ db/alter_table.sql在最近参与的银行项目中这个字段的添加使得自动化测试用例识别准确率从72%提升到100%。特别要注意的是字段默认值设置要与团队工作流程匹配——我们最初设为auto导致大量历史数据异常后来调整为manual才解决问题。