禅道 给禅道缺陷增加自定义字段供不同的缺陷操作页面使用
- 2020 年 3 月 31 日
- 筆記
给禅道缺陷增加自定义字段供不同的缺陷操作页面使用
by:授客 QQ：1033553122
实践环境
禅道项目管理软件9.2.1 、8.0开源Linux版
需求描述
在禅道创建、修改、查看、关闭缺陷页面添加一个自定义字段—一个单选下拉选框，并针对不同的页面做是否必填校验。
给数据库表zt_bug新增自定义字段
ALTER TABLE `zt_bug` ADD COLUMN source VARCHAR(100) AFTER severity
修改zentaopms/module/bug/lang/zh-cn.php
如下图，新增图示选框Bug字段，即在合适的位置插入以下代码
$lang->bug->source = 'Bug根源';
如下图，在合适的位置插入以下代码
$lang->bug->sourceList['codeerror'] = '产品设计缺陷';
$lang->bug->sourceList['bug'] = '程序编码错误';
说明：这里定义的'产品设计缺陷'和'程序编码错误'用于存放对应字段select下拉选框中的数据，上述'bug'，'productDesign'，创建Bug/编辑Bug并保存后，会被存储到数据库中。
注意：笔者使用的禅道，语言设置的是中文，所以仅修改zh-cn.php，不修改英文en.php和tw.php
修改zentaopms/module/bug/view/create.html.php
如下图，在合适的位置插入以下代码
<tr>
<th><?php echo $lang->bug->source;?></th>
<td>
<?php echo html::select('source', $lang->bug->sourceList, $source, "class='form-control'");?></span>
</td>
</tr>
修改效果
修改zentaopms/module/bug/view/edit.html.php
如下图，在合适的位置插入以下代码
js::set('source' , $bug->source);
如下图，在合适的位置插入以下代码
<tr>
<th><?php echo $lang->bug->source;?></th>
<td><?php echo html::select('source', $lang->bug->sourceList, $bug->source, "class='form-control'");?></td>
</tr>
修改效果
当然，如果希望在编辑页面左侧展示添加的字段，如下图，也可以在合适的位置插入以下代码
<fieldset>
<legend><?php echo $lang->bug->source;?></legend>
<div class='form-group'>
<?php echo html::select('source', $lang->bug->sourceList, $bug->source, "class='form-control'");?>
</div>
</fieldset>
修改效果
修改zentaopms/module/bug/view/view.html.php
如下图，在合适的位置插入以下代码
<tr>
<th><?php echo $lang->bug->source;?></th>
<td><strong><?php echo zget($lang->bug->sourceList, $bug->source, $bug->source);?></strong></td>
</tr>
修改效果
当然，我们如果希望把新增字段放左侧页面展示，如下图，也可以在合适的位置插入以下代码
<fieldset>
<legend><?php echo $lang->bug->source;?></legend>
<div class="content">
<strong><?php echo zget($lang->bug->sourceList, $bug->source, $bug->source);?></strong>
</div>
</fieldset>
修改效果
修改zentaopms/module/bug/view/resolve.html.php
如下图，在合适的位置插入以下代码
<tr>
<th class='w-80px'><?php echo $lang->bug->source;?></th>
<td class='w-p35-f'><?php echo html::select('source', $lang->bug->sourceList,'', "class='form-control' ");?>
<font color='red'>请认真选择Bug根源分类</font></td><td></td>
</tr>
修改效果
修改zentaopms/module/bug/view/close.html.php
如下图，在合适的位置插入以下代码
js::set('source' , $bug->source);
如下图，在合适的位置插入以下代码
<tr>
<th><?php echo $lang->bug->source;?></th>
<td><?php echo html::select('source', $lang->bug->sourceList, $bug->source, "class='form-control'");?><font color='red' "class='form-control'">请确认Bug根源分类是否正确</font></td>
</tr>
修改效果
备注：提示语 “请确认Bug根源分类是否符正确”，改成 “请确认Bug根源分类是否符合实际” 会比较恰当
修改zentaopms/module/bug/config.php
如下图，可以选择创建，编辑，解决Bug时分别定义新增字段是否必填。本例中设置解决Bug时新增source字段必填
修改效果
需要注意的地方
本人实践时，想在关闭页面，把自定义字段也设置为必填，于是参考上面，在合适位置插入下图图示框选部分的代码，结果发现，自定义字段select选框右侧有红色的 * （见下图），但是提交关闭Bug请求时，并没有不为空限制
解决方法，如下，给select选框增加reuqired='true'
<tr>
<th><?php echo $lang->bug->source;?></th>
<td><?php echo html::select('source', $lang->bug->sourceList, $bug->source, "class='form-control' required='true'");?><font color='red' "class='form-control'">请确认Bug根源分类是否正确</font></td>
</tr>
修改效果如下：
如下，找到$config->bug->list->exportFields变量，增加新增的自定义字段名称，解决缺陷导出报表中没有新增字段的问题，如下
如下，找到global $lang，在其下方合适的位置新增搜索字段，即我们自定义的字段，并给字段设置可选搜索项，解决缺陷搜索中没有新增字段问题。
修改效果
修改zentaopms/module/bug/control.php
修改public function export($productID, $orderBy)函数代码，如下，在合适位置增加以下代码，解决导出报表，新增字段列的值不为设置的枚举选项值，而是为索引值问题。
if(isset($bugLang->sourceList[$bug->source])) $bug->source = $bugLang->sourceList[$bug->source];
修改效果
