Mantis使用说明

Mantis是一个缺陷跟踪系统，以Web操作的形式提供项目管理及缺陷跟踪服务。
Mantis可以帮助所有开发人员完成系统需求缺陷的有效管理，对于bug问题的状态变化将通过mail的形式由系统自动通知相关人员。且可以自动生成统计报表和自动导出成doc或excel格式的文件。
Mantis是基于mysql+php的服务，可以通过备份mysql数据库实现资源的备份与还原。具有极高的安全可靠性。
本说明适用于mantis1.1版，关于1.1版的英文说明可以参照http://www.mantisbt.org/
转载请注明出处：http://blog.csdn.net/charisma_fox/archive/2008/09/08/2898694.aspx

1        操作指南
*************************************************
以下设置针对所有用户
1.1    “新用户登录”
目前本系统的访问地址为：http://192.168.1.222:8080/mantis/
用户可以通过首页显示的“注册一个新帐号 ”进行新用户注册。为方便辨识和记忆，用户名命名规则同公司邮箱（例如周婷用户名为zhout），注册之后，注册邮箱会收到系统的邮件提示。根据提示进行帐号激活，用户需要在激活页设置密码，否则以后将无法登录。
如忘记密码或者需要重置密码，可以通过“忘记密码？”进行密码重置。或者联系管理员再次激活。如果遇到帐号无法激活的情况请及时与我联系，email：fox@****.com
1.2         “我的视图”页
登录之后首先进入“我的视图”页，这里显示5类问题：
l         指定给我的：
需要由登录者处理的问题
l         未指定的：
已经报告但尚未分配到开发人员的问题
l         由我报告的
由登录者本人报告的问题
l         已解决的
l         最近修改
l         我正在监视的
用户可以选择需要关注的问题进行监视
注：页面右上角有一个切换项目的下拉菜单，可以选择查看本人需要关注的某个项目的问题。

1.3       “查看问题”页
此页上面一部分为查询条件组合，用户可以指定查找问题的条件，点击某项之后将出现下拉菜单供用户选择；下面一部分为所有问题列表，列出了问题的摘要信息，点击问题之后将出现“查看问题详细资料”页。
l        “查看问题详细资料”
各项不详细解释了。其中最下面一行按钮可以对问题进行操作。由于权限的设置不同，各级别用户可使用的按钮个数不同。
Ø         “修改问题”
修改问题的各项基本属性，并添加注释。
Ø         “分派”
将问题分派给某个开发人员来处理，分派之后系统将自动向被分派人发送邮件通知，被分派人打开mantis之后将在“我的视图”页看到被分派的问题。
Ø         “将状态改为”
这里是对问题状态的定性，分为6个层次，具体使用方法见“Bug跟踪流程”。
Ø         “监视问题”
点击此按钮后用户就可以对该问题进行监视，也就是说只要该问题有改动，系统就会自动发邮件通知到本人。在“我的视图”页也可以体现出来。
Ø       “创建子项问题”
可以创建该问题的子项问题。
Ø         “移动问题”
可以将该问题移动到别的项目中（需要相应的权限）。
Ø         “删除问题”
删除无用的问题，已处理完毕的问题建议不必删除，关闭即可，以保留问题记录。
l         “关系”
可以指定问题之间的关联关系，具体关联方式见下拉菜单。
l         “上传文件”
可以上传与问题相关的文件，大小暂时限制为5M。
l         “问题历史”
此项为问题处理的历史记录。

1.3.1    修改问题状态
这是mantis比较重要的一个功能，问题的每次改动都要发生状态的改变，以此来标记问题的处理情况。
1.4         “报告问题”页
l        “分类”是在创建项目时指定的，比如USBOSS后台可以分类为“计费”和“帐务”，以方便问题的定位。如果项目创建时未分类则此项为空。
l         “查看状态”中的两个选项“公共”和“私有”决定此问题所有人都可见还是只有本项目组的成员可见。
选择高级报告后还可以选择具体的平台设置和产品版本等参数。
新报告的问题状态默认为新建。
1.5         “修改日志”页
这里显示项目的更新日志
1.6         “使用说明”页
这里可以链接到mantis的官方网站，里面有详细的使用帮助，英文的。
1.7         “个人帐号”页
l         个人帐号
设置个人信息，包括密码、邮件、姓名。
l         更改个人设置
设置邮件通知的紧急程度级别等，可根据个人需要和喜好来设置接收邮件通知的级别。
l         管理平台配置
配置平台，包括硬件平台，操作系统，版本等信息。

*************************************************
以上设置针对所有用户
*************************************************
以下设置只针对权限为“经理”的用户

1.8         “管理”页（经理级用户）
1.8.1      项目管理
l         编辑项目
设置项目的基本属性，上传文件路径不需要设置，因为目前采用数据库的方式存储文件。
l         子项目
将现有项目添加到本项目的子项目中（必须有相应的权限）。
l         分类
上面已提到过，为了查找问题的方便而设置的问题类别，可根据项目情况设置。
l         版本
设置项目的版本号。
l         添加用户至项目
添加参与本项目的人员，并设置人员权限，注意这里的权限与用户本身的权限不同，需要单独指定。目前指定测试组的成员为“测试人员”，其他程序员都指定为“开发人员”，如果项目查看状态为私有，则只有在这里添加了的人员才可以访问本项目的问题。通过最下面一行的按钮可以快速地从别的项目导入人员，或将本项目的人员导出到别的项目。
l         管理帐号
查看人员列表，删除人员。如果需要修改人员权限，可以先删除然后重新添加。
1.8.2        管理配置
这里可以查看各用户级别的权限设置，但不能修改，不详述。

*************************************************
以上设置只针对权限为“经理”的用户
*************************************************
以下设置只针对权限为 “管理员”的用户

1.9         “统计报表”页（管理员级用户）

查看按各种方式统计的所有Bug报表。
1.10     “管理”页（管理员级用户）
1.10.1    用户管理
创建、修改、删除帐号，重设帐号密码，给用户分配项目等。
1.10.2    项目管理
除了“经理”级人员的功能之外，还可以创建、删除项目，创建子项目等。
1.10.3    自定义字段管理
可以为报告问题添加必要的自定义字段，可以是时间类型，字符串类型，数字类型等。
1.10.4    管理全局配置
添加、编辑、删除平台配置
1.10.5    管理配置
包括权限报表、工作流开始、工作流、邮件提醒四项，可根据实际需要灵活配置，不详述。
 
*************************************************
以上设置只针对权限为 “管理员”的用户

2         其他重要设置
2.1         添加时间型自定义字段
添加其他的字段比较容易，添加类似于时间字段，“管理→自定义字段配置”
填写“新自定义字段”的名称，例如：“发布时间”。单击“新建自定义字段”按钮

类型，选择时间型。

在这个版本中，时间型被显示为“@8@”我们可以修改lang语言文件来修复。

$s_custom_field_type_enum_string = '0:字符串,1:数值,2:浮点数,3:枚举类型,4:电子邮件,5:选择框,6:列表,7:多选列表,8:日期型';

2.2         汉化
Mantis支持多国语言，但有的时候汉化的文件跟不上版本的变更，需要我们自己来添加一些汉化的字段。下面介绍如何进行汉化。
汉化是通过一个文件完成的
打开这个文件D:\mantis\lang\strings_chinese_simplified.txt
汉化其实很简单，下面是我对1.1.2版本的添加的一些汉化的字段。
#$s_severity_enum_string           = '10:新特性,20:微不足道,30:文字错误,40:不合理或别扭,50:次要错误,60:严重错误,70:系统崩溃,80:系统死锁';
$s_severity_enum_string           = '10:新需求,20:A类错误,30:B类错误,40:C类错误';
$s_actiongroup_menu_update_product_build = '更新产品版本';
$s_actiongroup_menu_attach_tags = '附加 Tags';
$s_actiongroup_error_issue_is_readonly = '该问题只读';
$s_excel_export = 'Excel 导出';
$s_copy_versions_from = '从该项目复制版本';
$s_copy_versions_to = '复制版本到该项目';
$s_reauthenticate_title = '权限认证';
$s_reauthenticate_message = '访问安全加密页面，需要通过权限认证才能访问。';

# Tagging
$s_tags = 'Tags';
$s_tag_details = 'Tag 细节: %s';
$s_tag_id = 'Tag号';
$s_tag_name = '名称';
$s_tag_creator = '创建者';
$s_tag_created = '创建时间';
$s_tag_updated = '最后更新';
$s_tag_description = 'Tag 描述';
$s_tag_statistics = '使用统计';
$s_tag_update = '更新Tag: %s';
$s_tag_update_return = '返回Tag';
$s_tag_update_button = '更新Tag';
$s_tag_delete_button = '删除Tag';
$s_tag_delete_message = '确定要删除这个tag吗？';
$s_tag_existing = '已有的 tags';
$s_tag_none_attached = '没有相关的tags';
$s_tag_attach = '添加';
$s_tag_attach_long = '附加 Tags';
$s_tag_attach_failed = 'Tag 添加失败.';
$s_tag_detach = 'Detach \'%s\'';
$s_tag_separate_by = "(使用 '%s'分隔)";
$s_tag_invalid_name = '无效 tag 名称.';
把上面的文字，贴在strings_chinese_simplified.txt文件的末尾，保存即可。
如果还有一些文字没有完成汉化，可以查看页面的源文件，找到该字段的值，在strings_english.txt里面查找，将字段的值完整copy出来，添加到strings_chinese_simplified.txt文件中，并编辑相应的中文即可。

2.3         修改严重性等级
在config_defaults_inc.php文件中查找Mantis Enum Strings
就能看到系统中定义的一些级别都可以在这里找到，在此仅介绍严重性等级。
$g_severity_enum_string这个字段就是严重性等级的字段，可以按照需要在后面的值中进行删减，比如我只需要4类，就如下修改：
$g_severity_enum_string              = '10:feature,20:trivial,30:text,40:tweak';
或者把上面的这行直接添加到config_inc.php这个文件中即可。
因为Mantis的配置文件，是根据config_defaults_inc.php设置的，但凡是在config_inc.php这个文件中进行声明的，都将依据config_inc.php为准。
3         Mantis 缺陷跟踪流程