Mantis-缺陷管理系统使用手册

Mantis 使用手册Mantis使用手册目录1.系统简述 .42.登陆方式 .43.系统中的角色.53.1.管理员 .53.1.1.首页 .53.1.2.我的视图 .63.1.3.查看问题 .73.1.4.报告问题 .113.1.5.修改日志 .123.1.6.统计报表 .123.1.7.管理 .133.1.8.个人账号 .223.1.9.注销 .243.2.经理.243.2.1.操作区别 .243.3.开发人员 .253.3.1.操作区别 .253.4.修改人员 .253.4.1.操作区别 .253.5.报告人员 .263.5.1.操作区别 .263.6.查看人员 .263.6.1.操作区别 .264.分派给我的工作 .264.1.查看问题详细资料 .274.2.关系.284.3.上传文件 .294.4.正在监视该问题的用户 .294.5.问题注释 .29第 2 页Mantis 使用手册4.6.添加问题注释294.7.问题历史29第 3 页Mantis 使用手册1. 系统简述缺陷管理平台Mantis 是一个开源的缺陷跟踪系统，以 Web操作的形式提供项目管理及缺陷跟踪服务。Mantis 可以帮助所有开发人员完成系统需求缺陷的有效管理，对于bug问题的状态变化将通过mail 的形式由系统自动通知相关人员。且可以自动生成统计报表和自动导出成doc 或 excel 格式的文件。Mantis 是基于 mysql+php 的服务具有极高的安全可靠性。2. 登陆方式打开 IE 窗口，在地址栏里键入：，便可显示系统的登录页面（图表1），注册，有两种方式注册新用户：1） 由管理员添加新用户（参见管理员操作说明）；2） 使用 Email 注册。进入登录页面后，点击【注册一个新帐号】，输入帐号和Email 地址，提交注册，系统会将初始密码发送到Email 中；用户正确的输入自己的帐号（即用户名）及密码后，即可成功登录。图表 1第 4 页Mantis 使用手册3. 系统中的角色在 Mantis 系统中，分别有几种角色：管理员、经理、开发人员、修改人员、报告人员、 查看人员。每个角色所具备的权限不一样，权限的从大到小依次排列是：管理员经理开发人员修改人员报告人员查看人员。3.1. 管理员管理员是管理整个系统运作中权限最高的工作人员，可以对项目进行创建和管理，人员帐号的创建和管理等等，以下篇章将详细介管理员登录到系统之后，进入自己的主页面的一些操作。首页点击菜单栏中的“首页”项进入自己的主页面（如图表2 所示）图表 2在主页面中你可以看到以下信息：1. 存在指派给登录用户且还未解决的Bug 数目，点击该数目超链接，就会进入列表，直接对这些 Bug 单进行操作；2.存在由登录用户报告且还未解决的Bug 数目；3. 最近一次登录该系统的时间；登录进入后在该页面中的操作主要有3 个：1. 切换项目：点击页面右上角的下拉式菜单来切换所选项目；2.跳转到该Bug 编号：根据Bug 编号可以进行查询，直接进入该Bug 的详细信息页面，进行相应操作；3. 转向其它操作页面：点击主页面上方的菜单栏，便可进入相应的操作页面，如第 5 页Mantis 使用手册图表 3图表 3我的视图点击菜单栏中的“我的视图”项，管理员将会看到以下页面，如图表4 所示。图表 4从页面上看， bug 根据其以下工作状态分类成几个表格显示，符合这些工作状态的bug 都一一的罗列：1.未分派的：是指 Bug 已经报告，但还没有指定由那个项目组成员进行跟进的Bug 列表；2.由我报告的：在这里将会显示由你报告的Bug 列表；第 6 页Mantis 使用手册3. 已解决的：指 Bug 已经得到解决， Bug 的状态为 已经解决 ；4. 最近修改的：这一栏显示那些Bug 报告最近被项目组成员修改了；5. 我监视的：指你正在监视那些Bug，在 Bug 报告中，你被选为监视人。在该状态表格下，Bug 的编号是对应其详细信息的超链接，可以根据工作要求直接点击进入进行相应操作。此外在页面下部出一个标识Bug 流程状态的颜色条，如图表5，这样在实际操作中对于不同流程状态的Bug 就能很好的区分开，下面主要描述Bug 状态：1.新建：就是由报告人员提交问题后没有被分配给相应的项目时，Bug 的默认状态便是新建；2. 打回： 开发人员认为此 bug 不需要修改， 就将其打回， 测试人员和开发人员讨论评估后，决定是否将其关闭；3. 公认：经理认为报告员提交的问题是个Bug，对这个 Bug 表示认可；4. 已确认：开发人员确认存在此bug，并准备修改，将其设为已确认；5. 已分派： 当经理看到， 原状态为 “新建” 的问题单， 就会将其分派给某个开发人员；6.已解决：被分派的 bug 被开发人员已经进行了修改，测试人员可以进行验证测试,确认 Bug 已经解决；7.已关闭：确认 Bug 已解决，将其关闭。图表 5查看问题点击“查看问题”项，即可进入查看与项目相关的Bug 页面，如图表6：图表 6第 7 页Mantis 使用手册此页面可以对过滤器进行管理操作，从列图表6 看出，页面上部是一个过滤器，页面下部是根据过滤器显示Bug 的数据列表。如果管理员没有对给予的参数进行设置，那么默认就是没有对数据进行过滤，则页面下部则显示所有Bug 数据。此外还可以在搜索框里输入Bug 编号直接查询， 那么在页面下部就会显示出查询结果，就此详细说明一下过滤器的功能：1. 创建过滤器：在对参数进行设置完成后，可对当前的过滤设置进行保存，如图表 7 所示，填入相应内容后即可保存下来。如果标记为公有，则其他工作人员（除了查看人员）都能共享这个过滤器。同理，管理员也可以在过滤器列表共享经理创建的公有过滤器。图表 72. 重复设置提示：在保存一个过滤器的时候，如果系统发现之前保存过相同设置的过滤器，就会出现重复提示，以免造成不必要的资源浪费。如图表8 所示：图表 83. 管理过滤器：管理员可以对自己创建的过滤器进行操作，还可以删除或修改经理创建并标识为公有的过滤器。在显示的 Bug 列表里可以看到， 表格头部显示查看Bug 的当前数量， 并且在旁边提供了 “打印报告”和“ CSV 导出”功能链接，以下数据列表的Bug 信息列属性显示（从左到右）：复选框、修改图标、优先级、Bug 编号、 Bug 注释数目、 Bug 分类（所属的项目和组别）、Bug 的严重性、 Bug 当前状态、最后更新、 Bug 摘要，在此表格还可以进行如下操作：1. 打印报告：如图表 9 所示，将所有的 bug 显示出来，在页面列出了需要导出打印的bug 列表，可以根据需要通过复选框选中需要打印的 bug，还可点击“打印选项”选择打印输出的项，在选择完毕后，根据需要点击图标，bug 数据便相应的导出到第 8 页Mantis 使用手册该类型的文件里，实现打印输出的需求。图表 92.CSV 导出：点击功能链接，则出现如图表10 所示页面，提示将一个以当前问题所属的项目名称命名的CSV 文件下载存储到本地。下载完成后， 可以运行EXCEL打开该文件，直接查看导出的bug 信息。图表103.点击 Bug 编号，可以进行排列，并出现或代表是按升序或降序排列；4.在 bug 列表中，可以在每行的bug 显示中，有一个修改图形，可以点击这个图形进入这个bug 的修改信息页面。注意：是否能出现这个图形也和权限有关系；5. 点击 bug 编号可以直接进入其详细信息页面；6.点击注释数目可以直接进入对应bug 的详细信息页面，并将页面焦点定位在bug 注释信息；7. 可以通过选中 bug 列表的复选框，也可以选中“全选”的复选框，然后选择下拉列表的操作命令，然后点击确定按钮，则可以对这些bug 进行相应操作，第 9 页Mantis 使用手册图表 11如上图表11 所示，这里具体说明一下这些命令的操作：1)移动：弹出选择项目页面，如图表12 所示。可以把选中的bug 从当前项目转移到你所选择的项目里，可以选择存在的任意项目图表 122)复制：弹出选择项目页面，如图表 13 所示，可以把选中的 bug 从当前项目复制到别的项目里图表 133)分派：可以把选中的bug 直接分派给指定的工作人员，如图表14 所示：图表 144)关闭：当被选中的bug 已经确认已解决，或确认不是bug，管理员可以直接采用这个命令将bug 状态为关闭；第10 页Mantis 使用手册5) 删除：当被选中的 bug 是垃圾数据，在整理数据的时候可以直接进行删除；6) 解决：如果 bug 确认已经解决， 则选中将其状态置为 “解决”。但是如果 bug当前状态为“已解决”或以上状态，则不能进行此项操作；7) 更新优先级： 用这项操作，可以更改选中bug 的优先级；8)更新状态：使用这项操作，可以更新选中bug 的流程状态；9)更新类别：使用这项操作，可以更新选中bug 的所属项目组；10) 更新视图状态： 用这项操作， 可以将选中的 bug 重新置为公共或私有状态。这里需要注意的是： 对于这些命令的选择和当前用户的权限有关系， 如果不能进行 该命令的操作，系统会出 “你无权执行这项操作” 提示性语句。 而对于管理员来说，具有完全的权限。报告问题点击菜单栏中的 “报告问题”项，如果开始没有制定项目的情况下，则首先进入项目选择页面，如图表 15 所示。在选择工作项目后，其下有一个“指定预设值”的选项，如果在选择项目的时候， 同时选中这个选项，则下次在同等情况下，就不会再进入项目选择页面而是直接进入默认的项目提交问题页面。进入提交问题页面，可以看到一个提交bug 的表单如图16 所示，根据具体情况填写后提交即。在表单右上角提供一个叫“高级报告”的功能，里面提供了比较详细的填写项，这样，如果对于比较复杂的Bug 来说也是十分必要的，在提交报告时请注意，带* 号的填写项是必填项，页面还提供文件上传功能，只要是低于5M的文件都允许上传，支持doc、 xls、 txt、 exe 等格式的文件，这样在报告bug 的时候，可以上传相关的文件，为bug 的解决提供更多的信息。全部填写完毕之后就可以点击“提交报告”，之后系统会提示用户操作成功，再返回我的视图中查看就可以看到新提交Bug。图表 15第11 页Mantis 使用手册图表 16修改日志点击菜单栏中的“修改日志”项，是已经修改好了问题的日志，需要给项目添加版本号，并且在添加/解决问题时都指定了相应的版本号，才会显示。统计报表点击菜单栏中的“统计报表”项，即可出现一个所有Bug 单的综合报表，页面还提供了“打印报告”功能链接，如图表17 所示。在这个综合报表中，按照bug 报告详细资料中的项目， 将所有的报告按照不同的分类进行了统计。这个统计报表有助于管理员及经理很好的掌握bug 报告处理的进度，而且很容易就能把没有解决的问题与该问题的负责人、第12 页Mantis 使用手册监视人联系起来， 提高了工作效率。 在这个页面中， 还提供了更多按不同要求分类的统计图表如图表 18 所示，如：按状问题态统计、按日期统计、按严重性统计、按项目分类统计和按完成度统计等。 如果有需要， 也可以点击页面上方的打印报告， 即可将当前页的图表导出打印出来。图表17图表18管理点击菜单栏中的“管理”项，即可进入管理页面，管理页面包含了：用户管理、项目管理、自定义字段管理等部分。第13 页Mantis 使用手册图 191.用户管理为点击“管理”进入的当前默认页面如图19 所示，在此列表中可以查看到用户的账号、真实姓名、email 、权限等信息。创建新帐号：点击创建新账号项，进入创建用户账号页面如图20 所示页面，填写账户、姓名、email 等信息后点击创建用户按钮即可创建一个新用户。图 20点击图 19 表格内的账户项中的账户名进入如图21 所示页面，在这里可以对已存在的账户进行修改、删除、密码重置操作。第14 页Mantis 使用手册图 212. 点击项目管理，即可查看当前的所有项目，如图表22 所示，图 221) 点击“创建新项目”项，进入新项目创建页面，如图表23 所示，填写好项目资料之后点击添加项目项，新的项目就添加到系统中了。注：上传文件存放路径如果不指定，则为默认系统路径；图 232) 点击现有项目列表的项目名称， 就可以看到该项目的具体情况列表，列表中包第15 页Mantis 使用手册括各个项目的名称、状态、查看状态、以及说明列属性。如图表24 所示。在这个页面上可以进行以下操作：图 24第16 页Mantis 使用手册a) 编辑项目：在这里经理可以对项目的名称、状态、查看状态、上传文件的存放路径以及说明等内容进行更新；删除项目：点击删除按钮，即可将当前项目从库里删除；b) 增加分类：填入类别名称， 点击增加分类便可在当前项目里增加类别；编辑分类：点击编辑，进入类别编辑页面，还可以将当前的类别分配给指定的工作人员， 这样会在该项目下报告一个新 bug 的时候，直接就指定给该工作人员处理；删除分类：点击删除，即可删除当前的分类；c) 版本：在这里可以对已有的项目版本进行更新或者删除，也可以添加新的版本；d) 自定义字段： 在这里可以从已存在的自定义字段中选择出需要的添加到该项目中的自定义字段中， 也可以删除已添加的自定义字段， 自定义字段添加入项目后，在“提交问题”单中会显示为必填字段；e) 添加用户至项目：将与项目有关的用户添加进来；f) 管理帐号：对该项目中所有的相关人员的帐号进行管理，可以删去那些在项目中不需要的帐号；3. 自定义字段管理是用于在提交问题的时候，系统给予的填写项不满足实际需求，这样可以自行在这个功能页面里定义自己需要的字段，以便能更好的描述bug 的情况。而且在过滤器里也会增加这个字段的属性，可以根据其进行数据过滤，点击功能链接进入该页面即可新建自定义字段、修改已有的自定义字段，如图表 25 所示。图 254.管理全局配置：点击管理全局配置即可出现“添加平台配置” ，“编辑和删除平台配置”页面如图 26 所示，在这里可以对平台进行添加，删除和编辑操作。这样，在报告 bug 的时候，采用“高级报告”的报表就可以自己选用对应的平台数据而不需要自行输入，提高了工作效率。第17 页Mantis 使用手册图 265. 管理配置： 点击 “管理配置” 项进入管理页面， 此界面包含权限报表、 工作流开始、工作流、邮件提醒功能。1） 权限报表：在点击“管理配置”项时默认进入的就是权限报表页面如图27 所示，此页面包含新闻权限、附件权限、过滤器权限，创建项目权限等。在这里可以查看到操作人员的权限。第18 页Mantis 使用手册图 272） 工作流开始：点击“工作流开始”进入页面如图 28 图，在此页面内管理员可以对操作员的权限进行更改。第19 页Mantis 使用手册图 283） 工作流：点击“工作流”项进入界面如图29 所示，此界面管理员可以为操作人员分配修改工作状态的权限。第20 页Mantis 使用手册图 294） 邮件提醒：点击“邮件提醒”进入界面如图30 所示，此界面管理员可以给操作人员分配当bug 工作状态改变时发送邮件提醒的权限。第21 页Mantis 使用手册个人账号点击菜单栏中的“个人账号”项，即进入了帐户管理页面，如图表31 所示。该页面包含了个人账号” ，“更改个人设置” ，“管理平台配置”功能操作，当前默认页面为个人账号页面。1. 个人资料： 点击 “个人资料”页面进入的默认编辑账号页面，管理员可以在此修改密码、 Email 、真实姓名等等帐户信息；第22 页Mantis 使用手册图 312.更改个人设置：点击进入如图表32 所示页面，可对页面相关项进行重新设置图 323.管理平台设置：点击进入如图表33 所示页面。在此可以增加平台设置，也可以对现有的平台数据进行编辑或删除，这样，在自己“提交问题”的时候，“或填写”位置就可以直接选用对应的平台数据而不需求自行输入，节省工作时间。第23 页Mantis 使用手册图 33注销点击菜单栏中的“注销”项，即可退出登录，返回至初始登录页面。3.2. 经理是整个软件开发过程中的较为重要的管理人员，经理在该系统下的使用权限比起管理员来说稍微低一些，由于以上已经详细说明了各个菜单功能的使用，则在此处主要说明经理在本系统所能用的功能与管理员有什么不同。操作区别对于以上提及的10 个菜单功能，经理在用的时候和管理员基本相同，就是有以下几个差异点。1. 只能对自己的过滤器进行操作，对于管理员为共有的过滤器只能使用而不能进行操作。2.对于“查看问题”的时候，可以通过复选框对某条bug 进行命令操作，经理级别工作人员不能执行“删除”操作，系统会提示：“你无权执行该项操作”；3. 在“管理”功能中，不能对用户进行管理，包括新建，删除用户等，也不能新建项第24 页Mantis 使用手册目，只能管理现有项目的信息；3.3. 开发人员开发人员，就是负责整个软件开发的工作人员。用 bug 跟踪管理系统，能够帮助开发人员及时地发现和解决软件缺陷。在使用该系统中， 开发人员的权限比起经理要稍低一些，从开始登录进入系统就能看出来，其主菜单栏的功能也少了一些，比起经理和管理员的菜单栏，少了“统计报表” 、“管理”这2 个功能 .操作区别由于以上已经详细说明了各个菜单功能的作用，这里主要说明开发人员在本系统所能使用的功能与管理员有什么不同。1. 开发人员只能设置私有的过滤器， 可以共享管理员和经理创建而且属性设置为公有的过滤器；2.对于“查看问题”的时候，可以通过复选框对某条bug 进行命令操作，开发人员不能执行“删除”操作，系统会提示：“你无权执行该项操作”；3.4. 修改人员修改人员，就是负责修改问题的工作人员。修改人员的主菜单和开发人员一样，但是在该系统的使用权限还是稍比开发人员低一些，以下来具体说明一下功能操作区别。操作区别主要的操作区别如下：1. 不能创建过滤器，但是可以使用其他工作人员创建并将属性设为公有的过滤器；2.对于“查看问题”的时候，可以通过复选框对某条bug 进行命令操作，修改人员只能用“复制”，“更新优先级” ，“更新状态” ，“更新视图状态” ，对于其他的命令操作则无权执行；3. 在“我的视图”页面，没有“分派给我的（未解决） ”状态的 bug 数据列表，因为对于修改人员来说， 不能将 bug 直接指派给他。 因此相应的在页面上没有该类数据的显示。第25 页Mantis 使用手册3.5. 报告人员报告人员，就是专门负责提交问题报告的工作人员。报告人员的主菜单也和开发人员、修改人员一样， 但是在该系统的使用权限还是稍比修改人员低一些，以下来具体说明一下功能操作区别。操作区别主要的操作区别如下：1. 也不能创建过滤器，但是可以使用其他工作人员创建并将属性设为公有的过滤器；2. 对于“查看问题”的时候，对bug 数据列表不能进行任何命令操作，图里不显示复选框和优先级状态；3. 在“我的视图”页面，没有“分派给我的（未解决）”状态的 bug 数据列表，因为对于报告人员来说，也不能将 bug 直接指派给他，因此相应的在页面上没有该类数据的显示；3.6. 查看人员查看人员， 顾名思义就是只具有查看权限的工作人员，在该系统中处于最低权限的人其功能主菜单也减少了一些。比起开发人员、修改人员、报告人员的主菜单功能，查看人员少了“提交问题”的功能，以下具体说明一下其功能操作区别。操作区别因为查看人员为最低权限的工作人员，因此对于该系统的操作功能基本没有使用权限（除了“个人资料”的功能），只能查看各个项目的bug 流程以及具体情况。4. 分派给我的工作以上主要是说明各个角色的工作人员在使用该系统的功能和所具备的权限，以下说明一下工作人员登录到该系统后该如何进行对分派给我的工作进行操作。当工作人员登录到系统，在进入“我的视图”，点击“分派给我的（未解决）”的bug数据列表的bug 编号链接，则进入如图34 所示的页面， 根据各种情况分成7 个数据块显示。第26 页Mantis 使用手册图表344.1. 查看问题详细资料进入指派的问题单页面里， 上面第一个数据块显示的就是问题的详细资料， 在这数据表格可以进行如下操作：1. 跳转到注释：点击此链接，则直接跳转到该页面的注释数据；2. 问题提醒：点击此链接，则可以对某个工作人员发送提醒，直接在该工作人员的监视问题的视图里生成，并在该问题的注释里也增加一条记录。注意：这个功能除了查看人员之外，其他工作人员都可以用；3. 问题历史：点击此链接，则直接跳转到该页面的问题历史数据；4.打印：点击此链接，则直接在网页上生成这个Bug 的详细数据，可以通过IE 提供的打印功能进行打印；5. 修改问题：如果对问题的信息需要修改，则点击“编辑”按钮，进入“正在更新问题信息” 根据实际情况进行修改， 然后点击更新信息按钮完成， 如果不需要修改了，可以点击“返回到问题”回到问题详情页面。需要注意的是：修改问题的功能只有管理员，经理，开发人员以及修改人员能修改；6. 分派给：这个功能可以把当前的问题直接指派给选定的工作人员。注意：指派功能只有管理员、经理、开发人员以及修改人员能指派，而且只有管理员才能指派给自身；7. 将状态改为：这个功能可以把当前的问题流程状态直接修改。注意：修改状态功能有管理员、经理、开发人员可以用；8. 监视问题：这个功能可以把当前这个问题设置为所监视的问题范围之内。注意：这第27 页Mantis 使用手册个功能除了查看人员之外，其他工作人员都可以用；9.创建子问题：这个功能主要是创建于当前问题相关的问题，点击按钮进入如图表 28 所示。在页面上用红框标注的就是在创建子项后和当前问题的关系。同时在以下说明的“关联”数据中会增加一条记录。注意：创建子项功能只有管理员、经理开发人员以及修改人员才能用；10. 移动问题：点击直接可以将该问题转移到别的项目中去。注意：移动功能只有管理员、经理、开发人员才能用；11. 删除问题：点击直接删除该问题，只有管理员才有这个权限图 354.2. 关系这个数据主要是描述当前问题是否和别的问题有什么关系，如图表35 所示。一共有五种关系： 与该问题关联、 是该问题的子项、 是该问题的父项、 是该问题的重复、 有重复问题，可以根据实际情况选择关联，在此页面可以进行如下操作：1. 添加关联：增加与当前问题有关联性的问题，选择添加“问题类别”，输入问题编号，点击添加即可，注意：只有管理员，经理，开发人员和修改人员才能使用这项功能；2. 查看相关问题：点击关系列表的问题编号链接，直接可以查看该关系问题的详细信息；3. 删除关系：对已经存在的关联数据进行删除操作，注意：只有管理员，经理，开发人员和修改人员才能 用这项功能；对于关联的使用主要体在它们之间的相关性， 如果一个问题的流程状态改变了，可以查看相关问题的当前状态如何，如果不一致，那么尽快的查找问题，以免耽误工作进展。第28 页Mantis 使用手册4.3. 上传文件在报告问题的时候， 可以上传文件， 如果那时候没有上传，可以在此处重新上传。 上传文件则显示在“查看问题详情”的附件属性的表格里。注意：这个功能除了查看人员之外，其他工作人员都可以用。4.4. 正在监视该问题的用户如果当前问题被工作人员列入监视范围内，在此处则显示这些工作人员的帐户。4.5. 问题注释此处显示该问题的所有公共注释，问题提醒发送的信息也作为注释记录陈列在下面。4.6. 添加问题注释在此处可以对当前问题添加注释，添加完毕后直接在之后的“问题注释” 里增加一条记录，注意：这个功能除了查看人员之外，其他工作人员都可以用。4.7. 问题历史此处陈列了当前问题根据时间升序排列的所有历史操作记录，里面记录了操作时间，工作人员，对于字段的操作，以及问题的改变，方便相关人员特别是新接触人员尽快熟悉这个问题的状况。第29 页Mantis 使用手册X第30 页