mantis中文用户手册

mantis 缺陷管理系统 用户手册1用户手册大纲1 引言1.1 编写目的系统使用、实施者。1.2 背景Mantis 缺陷管理系统。1.3 定义无。1.4 参考资料系统详细需求说明书 系统概要设计说明书 。2 用途2.1 功能mantis 缺陷管理系统是一个基于 LAMP 架构技术的缺陷跟踪系统，以 Web操作的形式提供项目管理及缺陷跟踪服务。在实用性上完全可以满足各种类型项目的管理及跟踪1、登录和注销2、项目管理3、用户管理4、权限设置5、个性化设置6、问题提交、查询和处理2.2 性能2.2.1 精度无。mantis 缺陷管理系统 用户手册22.2.2 时间特性无。2.2.3 灵活性无。2.3 安全保密无。3 运行环境3.1 硬设备无特殊要求。3.2 支持软件LAMP：linux 、apache2.x、mysql5.x、php5.x 以上。客户端建议使用 IE6 以上浏览器3.3 数据结构无4 使用说明4.1 安装与初始化上传到服务器 php 运行环境的目录下，保证案例目录代码为 nobody 所有，并且 nobody 可以读写在 IE 浏览器输入安装 URL install.php 即可完成安装。mantis 缺陷管理系统 用户手册3填写好对应信息以后点击安装按钮即可完成安装。管理员 administrator 初始化密码是 root。4.3 功能说明4.3.1 系统简述 缺陷管理平台 Mantis mnts（螳螂），也叫做 MantisBT，全称Mantis Bug Tracker,Mantis 是一个缺陷跟踪系统，以 Web 操作的形式提供项目管理及缺陷跟踪服务。Mantis 可以帮助所有开发人员完成系统需求缺陷的有效管理，对于 bug 问题的状态变化将通过 mail 的形式由系统自动通知相关人员。且可以自动生成统计报表和自动导出成 doc 或 excel 格式的文件。Mantis 是基mantis 缺陷管理系统 用户手册4于 mysql+php 的服务，可以通过备份 mysql 数据库实现资源的备份与还原。具有极高的安全可靠性。4.3.2 登陆方式打开 IE 窗口，在地址栏里键入： 00/mantis/login_page.php ，便可显示系统的登录页面（图表 1） ，在图表 1 中，用户根据正确的输入自己的帐号 （即用户名）及密码后，即可成功登录。图表 14.3.3 系统中的角色在 Mantis 系统中，分别有几种角色：管理员、经理、开发人员、修改人员、报告人员、 查看人员。每个角色所具备的权限不一样，权限的从大到小依次排列是：管理员经理开发人员修改人员报告人员查看人员。4.3.4 管理员 管理员是管理整个系统运作的工作人员，他不仅是整个系统的操作流程中权限最高的工 作人员，而且可以对项目进行创建和管理，人员帐号的创建和管理等等，以下篇章将详细介管理员登录到系统之后，可以进入自己的主页面（具体登录操作及当前页面的操作参照登陆方式） ，再根据工作要求，相应选择mantis 缺陷管理系统 用户手册5页面上方的菜单栏进入相应的页面。4.3.5 首页点击菜单栏中的“首页”项进入自己的主页面（如图表 2 所示）图表 2在主页面中你可以看到以下信息： 1. 存在指派给登录用户且还未解决的 Bug 数目，点击该数目超链接，就会进入列表，直接对这些 Bug 单进行操作；2. 存在由登录用户报告且还未解决的 Bug 数目；3. 最近一次登录该系统的时间；登录进入后在该页面中的操作主要有 3 个：1. 切换项目：点击页面右上角的下拉式菜单来切换所选项目；2. 跳转到该 Bug 编号：根据 Bug 编号可以进行查询，直接进入该 Bug 的详细信息页面，进行相应操作；3. 转向其它操作页面：点击主页面上方的菜单栏，便可进入相应的操作页面，如图表 3图表 34.3.6 我的视图 点击菜单栏中的“我的视图”项，管理员将会看到以下页面，如图表 4 所示。从页面上看，mantis 缺陷管理系统 用户手册6图表 4bug 根据其以下工作状态分类成几个表格显示，符合这些工作状态的 bug 都一一的罗列：1. 分派给我的（未解决）：是指 Bug 已经报告，指定由“我”来进行跟进的 Bug 列表；2. 未分派的：是指 Bug 已经报告，但还没有指定由那个项目组成员进行跟进的 Bug 列表；3. 我报告的：在这里将会显示由你报告的 Bug 列表；4. 已解决的：指 Bug 已经得到解决，Bug 的状态为已经解决；5. 最近修改的：这一栏显示那些 Bug 报告最近被项目组成员修改了；6. 我监视的：指你正在监视那些 Bug，在 Bug 报告中，你被选为监视人。在该状态表格下，而且 Bug 编号是对应其详细信息的超链接，可以根据工作要求直接点击进入进行相应操作。此外在页面下部出 一个标识 Bug 流程状态的颜色条，如图表 5，这样在实际操作中对于不同流程状态的 Bug 就能很好的区分开，下面主要描述 Bug 状态：1. 新建：就是由报告员提交问题时没有选择分派对象时，Bug 的默认状态便是新建；mantis 缺陷管理系统 用户手册72. 反馈：开发人员认为此 bug 不需要修改，就将其反馈，测试人员和开发人员讨论评估后，决定是否将其关闭；3. 认可：经理认为报告员提交的问题是个 Bug，对这个 Bug 表示认可；4. 已确认：开发人员确认存在此 bug，并准备修改，将其设为已确认；5. 已分派：当经理看到，原状态为“新建”的问题单，就会将其分派给某个开发人员；6. 继续跟踪：被反馈的 bug，在没有商定之前，暂定为“继续跟踪” ；7. 已解决：被分派的开发人员已经进行了修改，测试人员可以进行验证测试, 确认Bug 已经解决；8. 已关闭：确认 Bug 已解决，将其关闭。图表 54.3.7 查看问题点击“查看问题”项，即可进入查看与项目相关的 Bug 页面，如图表 6：mantis 缺陷管理系统 用户手册8图表 6从页面可以对过滤器进行管理操作，可以点击标题根据其属性对数据进行排列图表 6 看出，页面上部相当于一个过滤器，页面下部是根据过滤器显示Bug 的数据列表。如果管理员没有对给予的参数进行设置，那么默认就是没有对数据进行过滤，则页面下部则显示所有 Bug 数据。此外还可以在搜索框里输入 Bug 编号直接查询，那么在页面下部就会显示出查询结果，就此详细说明一下过滤器的功能：1. 创建过滤器：在对参数进行设置完成后，可对当前的过滤设置进行保存，如图表 7 所示，填入相应内容后即可保存下来。如果标记为公有，则其他工作人员（除了查看人员）都能共享这个过滤器。同理，管理员也可以在过滤器列表共享经理创建的公有过滤器。图表 7mantis 缺陷管理系统 用户手册92. 重复设置提示：在保存一个过滤器的时候，如果系统发现之前保存过相同设置的过滤器，就会出现重复提示，以免造成不必要的资源浪费。如图表 8 所示： 图表 83. 管理过滤器：管理员可以对自己创建的过滤器进行操作，还可以删除或修改经理创建并标识为公有的过滤器。在显示的 Bug 列表里可以看到，页面下部的表格头部显示查看 Bug 的当前数量，并且在旁边提供了“打印报告”和“CSV 导出”功能链接，以下数据列表的 Bug 信息列属性显示（从左到右）：复选框、修改图标、优先级 （会以 图形代表无、低、中、高、加急、特急的优先状态） 、Bug 编号、Bug 注释数目、Bug 所属的项目和组别、Bug 的严重性、Bug 当前状态、最后更新、Bug 摘要，在此表格 还可以进行如下操作：1. 打印报告：如图表 9 所示，将所有的 bug 显示出来，在页面列出了需要导出打印的 bug 列表，可以根据需要通过复选框选中需要打印 的 bug，还可点击“打印选项”选择打印输出的项，在选择完毕后，根据需要点击图标，bug 数据便相应的导出到该类型的文件里，实现打印输出的需求。mantis 缺陷管理系统 用户手册10图表 92. CSV 导出：点击功能链接，则出现如图表 10 所示页面，提示将一个以当前问题所属的项目名称命名的 CSV 文件下载存储到本地。下载完成后，可以运行 EXCEL 打开该文件，直接查看导出的 bug 信息。图表 103. 点击 Bug 编号，可以进行排列，并出现 或 代表是按升序或降序排列；4. 在 bug 列表中，可以在每行的 bug 显示中，有一个修改图形 ，可以点击这个图形进入这个 bug 的修改信息页面。注意：是否能出现这个图形也和权限有关系；5. 点击 bug 编号可以直接进入其详细信息页面；6. 点击注释数目可以直接进入对应 bug 的详细信息页面，并将页面焦点定mantis 缺陷管理系统 用户手册11位在 bug 注释信息；7. 可以通过选中 bug 列表的复选框 ，也可以选中“全选”的复选框，然后选择下拉列表的操作命令，然后点击确定按钮，则可以对这些 bug 进行相应操作， 图表 11如上图表 11 所示，这里具体说明一下这些命令的操作：1) 移动：弹出选择项目页面，如图表 12 所示。可以把选中的 bug 从当前项目转移到你所选择的项目里，可以选择存在的任意项目；图表 122) 复制：弹出选择项目页面，如图表 13 所示，可以把选中的 bug 从当前项目复制到别的项目里；mantis 缺陷管理系统 用户手册12图表 133) 指派：可以把选中的 bug 直接分派给指定的工作人员，如图表14 所示：图表 144) 关闭：当被选中的 bug 已经确认已解决，或确认不是 bug，管理员可以直接采用这个命令将 bug 状态为关闭；5) 删除：当被选中的 bug 是垃圾数据，在整理数据的时候可以直接进行删除；6) 解决：如果 bug 确认已经解决，则选中将其状态置为“解决” 。但是如果 bug 当前状态为“已解决”或以上状态，则不能进行此项操作；7) 更新优先级： 用这项操作，可以更改选中 bug 的优先级；8) 更新状态：使用这项操作，可以更新选中 bug 的流程状态；9) 更新视图状态： 用这项操作，可以将选中的 bug 重新 置为公共或私有状态。这里需要注意的是：对于这些命令的选择和当前用户的权限有关系，如果不能进行 该命令的操作，系统会出 “你无权执行这项操作”提示性语句。而对于管理员来说，具有完全的权限。4.3.8 提交问题点击菜单栏中的“提交问题”项，如果开始没有制定项目的情况下，则首mantis 缺陷管理系统 用户手册13先进入项目选择页面， 如图表 15 所示。在选择工作项目后，其下有一个“设为默认值”的选项，如果在选择项目的时候，同时选中这个选项，则下次在同等情况下，就不会再进入项目选择页面而是直接进入默认的项目提交问题页面。进入提交问题页面，可以看到一个提交 bug 的表单，根据具体情况填写后提交即。在表单右上角提供一个叫“或填写”的功能，里面提供了比较详细的填写项，这样，如果对于比较复杂的 Bug 来说也是十分必要的，在提交报告是请注意，带*号的填写项 是必填项，页面还提供文件上传功能，只要是低于 5M 的文件都允许上传，支持 doc、xls、txt、exe 等格式的文件，这样在报告 bug 的时候，可以上传相关的文件，为 bug 的解决提供更多的信息。全部填写完毕之后就可以点击“提交报告” ，之后系统会提示用户操作成功，再返回我的视图中查看就可以看到新提交 Bug。图表 154.3.9 变更日志点击菜单栏中的“变更日志”项，是已经修改好了问题的日志，需要给项目添加版本号，并且在添加/解决问题时都指定了相应的版本号，才会显示。4.3.10 路线图点击菜单栏中的“路线图”项，如果开始没有制定项目的情况下，则首先进入项目选择页面，如果指定了默认值，则直接进入默认项目的路线图，其实项目的路线图就相当于一个 Bug 的日志信息，如图表 16 所示，页面列出了该项目下已解决的 bug 编号、所属组别、bug 摘要以及该项目产品的版本号变化，点击 bug 编号还可进入其详细信息页面。mantis 缺陷管理系统 用户手册14图表 164.3.11 统计报表点击菜单栏中的“统计报表”项，即可出现一个所有 Bug 单的综合报表，页面还提供了“打印报告” 、 “统计报表” 、 “先进摘要”功能链接，如图表 17 所示。在这个综合报表中，按照 bug 报告详细资料中的项目，将所有的报告按照不同的分类进行了统计。这个统计报表有助于管理员及经理很好的掌握 bug 报告处理的进度，而且很容易就能把没有解决的问题与该问题的负责人、监视人联系起来，提高了工作效率。在这个页面中，还提供了更多按不同要求分类的统计图表，如：按状态统计、按优先级统计、按严重性统计、按项目分类统计和按完成度统计。分别点击这五项，即可得到相应的统计图，则进入将刚才显示的数据图形化的一个报表页面，如图表 18 所示。更便于查阅和对比。如果有需要，也可以点击页面上方的打印报告，即可将当前页的图表导出打印出来。图表 17mantis 缺陷管理系统 用户手册15图表 184.3.12 管理 点击菜单栏中的“管理”项，即可进入管理页面，如图表 19 所示，管理页面包含了：用户管理、项目管理、自定义字段管理等部分。 1. 用户管理为点击“管理”进入的当前默认页面；1 新帐号：显示一周之内添加进该项目的新用户；2 从未登录：显示目前存在的用户却至今从未登陆过的用户，对此用户可以点击“清理帐号”功能链接进行清理；3 管理帐号：在这里可以进行添加新用户和更新已有用户的操作，点击“创建新账号” ，就可以添加新的用户，并指定其工作身份；点击现有帐号名称，就可以对当前帐号的资料进行更新，更新之后点击“更新设置” ，系统就接受更新信息了。2. 点击项目管理，即可查看当前的所有项目，如图表 20 所示，1) 点击“创建新项目”项，进入新项目创建页面，如图表 21 所示，填写好项目资料之后点击添加项目项，新的项目就添加到系统中了。注：上传文件存放路径如果不指定，则为默认系统路径；2) 点击现有项目列表的项目名称，就可以看到该项目的具体情况列表，mantis 缺陷管理系统 用户手册16列表中包括各个项目的名称、状态、查看状态、以及说明列属性。如图表 22 所示。在这个页面上可以进行以下操作：a) 编辑项目：在这里经理可以对项目的名称、状态、查看状态、上传文件的存放路径以及说明等内容进行更新；删除项目：点击删除按钮，即可将当前项目从库里删除；b) 增加分类：填入类别名称，点击增加分类便可在当前项目里增加类别；编辑分类：点击编辑，进入类别编辑页面，还可以将当前的类别分配给指定的工作人员，这样会在该项目下报告一个新bug 的时候，直接就指定给该工作人员处理；删除分类：点击删除，即可删除当前的分类；c) 版本：在这里可以对已有的项目版本进行更新或者删除，也可以添加新的版本；d) 自定义字段：在这里可以从已存在的自定义字段中选择出需要的添加到该项目中的自定义字段中，也可以删除已添加的自定义字段，自定义字段添加入项目后，在“提交问题”单中会显示为必填字段；e) 添加用户至项目：将与项目有关的用户添加进来；f) 管理帐号：对该项目中所有的相关人员的帐号进行管理，可以删去那些在项目中不需要的帐号；3. 自定义字段管理是用于在提交问题的时候，系统给予的填写项不满足实际需求，这样可以自行在这个功能页面里定义自己需要的字段，以便能更好的描述 bug 的情况。而且在过滤器里也会增加这个字段的属性，可以根据其进行数据过滤，点击功能链接进入该页面即可新建自定义字段、修改已有的自定义字段，如图表 23 所示。mantis 缺陷管理系统 用户手册17图表 19 图表 20图表 21 mantis 缺陷管理系统 用户手册18图表 22图表 234.3.13 个人资料点击菜单栏中的“个人资料”项，即进入了帐户管理页面，如图表 24 所示。该页面包含了个人资料” ， “更改个人 置” ， “管理平台配置”功能操作，当前默认页面为个人资料编辑页面。1. 个人资料：点击“个人资料”页面进入的默认编辑账号页面，管理员可以在此修改密码、Email、真实姓名等等帐户信息；2. 更改个人设置：点击进入如图表 25 所示页面，可对页面相关项进行重新设置3. 管理平台设置：点击进入如图表 26 所示页面。在此可以增加平台设置，也可以对现有的平台数据进行编辑或删除，这样，在自己“提交问题”的时候， “或填写”位置就可以直接选用对应的平台数据而不需求自行输入，节省工作时间。注：管理平台配置的内容只限于个人采用；mantis 缺陷管理系统 用户手册19图表 24 图表 25mantis 缺陷管理系统 用户手册20图表 264.3.14 注销点击菜单栏中的“注销”项，即可退出登录，返回至初始登录页面。4.3.15 经理是整个软件开发过程中的较为重要的管理人员，经理在该系统下的使用权限比起管理员来说稍微低一些，由于以上已经详细说明了各个菜单功能的使用，则在此处主要说明经理在本系统所能用的功能与管理员有什么不同。4.3.16 操作区别对于以上提及的 10 个菜单功能，经理在用的时候和管理员基本相同，就是有以下几 个差异点。 1. 只能对自己的过滤器进行操作，对于管理员为共有的过滤器只能使用而不能进行 操作。 2. 对于“查看问题”的时候，可以通过复选框对某条 bug 进行命令操作，经理级别工作人员不能执行“删除”操作，系统会提示：“你无权执行该项操作” ；3. 在“管理”功能中，不能对用户进行管理，包括新建，删除用户等，也不能新建项目，只能管理现有项目的信息；4.3.17 开发人员开发人员，就是负责整个软件开发的工作人员。 用 bug 跟踪管理系统，能够帮助开发人员及时地发现和解决软件缺陷。在使用该系统中，开发人员的mantis 缺陷管理系统 用户手册21权限比起经理要稍低一些，从开始登录进入系统就能看出来，其主菜单栏的功能也少了一些，比起经理和管理员的菜单栏，少了“统计报表” 、 “管理”这 2个功能.4.3.18 操作区别由于以上已经详细说明了各个菜单功能的作用，这里主要说明开发人员在本系统所能使用的功能与管理员有什么不同。1. 开发人员只能设置私有的过滤器，可以共享管理员和经理创建而且属性设置为公有的过滤器；2. 对于“查看问题”的时候，可以通过复选框对某条 bug 进行命令操作，开发人员不能执行“删除”操作，系统会提示：“你无权执行该项操作” ；4.3.19 修改人员 修改人员，就是负责修改问题的工作人员。修改人员的主菜单和开发人员一样，但是在该系统的使用权限还是稍比开发人员低一些，以下来具体说明一下功能操作区别。4.3.20 操作区别主要的操作区别如下：1. 不能创建过滤器，但是可以使用其他工作人员创建并将属性设为公有的过滤器；2. 对于“查看问题”的时候，可以通过复选框对某条 bug 进行命令操作，修改人员只能用“复制” ， “更新优先级” ， “更新状态” ， “更新视图状态” ，对于其他的命令操作则无权执行；3. 在“我的视图”页面，没有“分派给我的（未解决） ”状态的 bug 数据列表，因为对于修改人员来说，不能将 bug 直接指派给他。因此相应的在页面上没有该类数据的显示。4.3.21 报告人员报告人员，就是专门负责提交问题报告的工作人员。报告人员的主菜单也和开发人员、修改人员一样，但是在该系统的使用权限还是稍比修改人员低一mantis 缺陷管理系统 用户手册22些，以下来具体说明一下功能操作区别。4.3.22 操作区别主要的操作区别如下：1.也不能创建过滤器，但是可以使用其他工作人员创建并将属性设为公有的过滤器；2.对于“查看问题”的时候，对 bug 数据列表不能进行任何命令操作，图里不显示复选框和优先级状态；3.在“我的视图”页面，没有“分派给我的（未解决） ”状态的 bug 数据列表，因为对于报告人员来说，也不能将 bug 直接指派给他，因此相应的在页面上没有该类数据的显示；4.3.23 查看人员查看人员，顾名思义就是只具有查看权限的工作人员，在该系统中处于最低权限的人其功能主菜单也减少了一些。比起开发人员、修改人员、报告人员的主菜单功能，查看人员少了“提交问题”的功能，以下具体说明一下其功能操作区别。4.3.24 操作区别因为查看人员为最低权限的工作人员，因此对于该系统的操作功能基本没有使用权限（除了“个人资料”的功能） ，只能查看各个项目的 bug 流程以及具体情况。4.3.25 分派给我的工作以上主要是说明各个角色的工作人员在使用该系统的功能和所具备的权限，以下说明一下工作人员登录到该系统后该如何进行对分派给我的工作进行操作。当工作人员登录到系统，在进入“我的视图” ，点击“分派给我的（未解决）”的 bug 数据列表的 bug 编号链接，则进入如图 27 所示的页面，根据各种情况分成 7 个数据块显示。mantis 缺陷管理系统 用户手册23图表 274.3.26 查看问题详细资料进入指派的问题单页面里，上面第一个数据块显示的就是问题的详细资料，在这数据表格可以进行如下操作：1. 跳转到注释：点击此链接，则直接跳转到该页面的注释数据；2. 问题提醒：点击此链接，则可以对某个工作人员发送提醒，直接在该工作人员的监视问题的视图里生成，并在该问题的注释里也增加一条记录。注意：这个功能除了查看人员之外，其他工作人员都可以用；3. 问题历史：点击此链接，则直接跳转到该页面的问题历史数据；4. 打印：点击此链接，则直接在网页上生成这个 Bug 的详细数据，可以通过 IE 提供的打印功能进行打印；5. 修改问题：如果对问题的信息需要修改，则点击“编辑”按钮，进入“正在更新问题信息”根据实际情况进行修改，然后点击更新信息按钮完成，如果不需要修改了，可以点击“返回到问题”回到问题详情页面。需要注意的是：修改问题的功能只有管理员，经理，开发人员以及修改人员能修改；6. 指派给：这个功能可以把当前的问题直接指派给选定的工作人员。注意：指派功能只有管理员、经理、开发人员以及修改人员能指派，而且只有管理员才能指派给自身；7. 将状态改为：这个功能可以把当前的问题流程状态直接修改。注意：修改状态功能有管理员、经理、开发人员可以用；8. 监视问题：这个功能可以把当前这个问题设置为所监视的问题范围之内。mantis 缺陷