Mantis中文使用手册.doc

Mantis使用手册Mantis 缺陷管理系统使用说明目录1系统简述42系统中的角色42.1管理员52.1.1我的视图62.1.2查看Issue72.1.3报告Issue112.1.4修改日志142.1.5统计报表142.1.6使用说明172.1.7管理172.1.8编辑公告212.1.9个人账号222.1.10注销232.2经理232.2.1操作区别232.3开发人员242.3.1操作区别242.4修改人员252.4.1操作区别252.5报告人员252.5.1操作区别252.6查看人员262.6.1操作区别263指派给我的工作263.1查看Issue详细资料283.2关系303.3上传文件313.4正在监视这个Issue的用户313.5添加注释313.6Issue注释313.7Issue历史记录324缺陷跟踪流程图321系统简述Mantis是一个开源的Bug管理系统；基于PHP+MySQL，可以运行在Windows/Unix平台上。作为一个bug管理系统，其适用性是否符合实际工作的需要，这是至关重要的。在对Mantis摸索几天后，发现它基本可以满足bug管理日常流程。而且，Mantis是B/S结构的web系统，如果今后有需要，还可以配置到Internet上，实现异地进行Bug管理。2系统中的角色在Mantis系统中，分别有几种角色：管理员、经理、开发人员、修改人员、报告人员、查看人员。每个角色所具备的权限不一样，权限的从大到小依次排列是：管理员经理开发人员修改人员报告人员查看人员。在详细说明每个角色的具体职责之前先来介绍如何进入该系统并进行登录进入。打开IE窗口，在地址栏里键入：8:8008/mantis/login_page.php，便可显示系统的登录界面（如图2-1）： 图2-1 从图中可以看出，用户正确的输入自己的帐号（即用户名）及密码后，即可成功登录，并且点击“登录”按钮进入自己的主页面（如图2-2所示）。选择项目名称，点击按钮便可进入对应项目的界面图2-2在主页面中系统你可以看见以下信息： 存在指派给登录用户且还未解决的Issue数目，点击该数目超链接，就会进入Issue列表，直接对这些Isuue进行操作； 存在由登录用户报告且还未解决的Issue数目； 最后一次登录该系统的时间。 项目公告，当然也可以点击页面下部的“归档公告”也进入公告界面，可以查看更多的公告；登录进入后在该页面中的操作主要有3个： 切换项目：点击界面右上角的下拉式菜单来切换所选项目； 跳转到该Issue编号：根据Issue编号可以进行查询，直接进入该Issue的详细信息界面，进行相应操作；归档公告：点击归档公告，即可查看；转向其它操作界面：点击主界面上方的菜单栏，便可进入相应的操作界面，如图2-3。 图2-3以下篇章详细的说明各个角色用户在该系统中的具体权限和工作职责：2.1管理员管理员是管理整个系统运作的工作人员，他不仅是整个系统的操作流程中权限最高的工作人员，而且可以对项目进行创建和管理，人员帐号的创建和管理等等，以下篇章将详细介绍说明。管理员登录到系统之后，可以进入自己的主界面（具体登录操作及当前页面的操作可见以上篇章），再根据工作要求，相应选择页面上方的菜单栏进入相应的界面。2.1.1我的视图点击“我的视图”菜单，管理员将会看到以下界面，如图2-1-1-1所示。从页面上看，图2-1-1-1bug根据其以下工作状态分类成几个表格显示。符合这些工作状态的bug都一一的罗列a) 指定给我的（尚未解决）；b) 未指定的；c) 由我报告的；d) 已解决的；e) 最近修改的；f) 我正在监视的；在该状态表格下，而且bug的编号是对应其详细信息的超链接，可以根据工作要求直接点击进入进行相应操作。此外在页面下部出现一个标识bug流程状态的颜色条，如图2-1-1-2，这样在实际操作中对于不同流程状态的bug就能很好的区分开。图2-1-1-22.1.2查看Issue点击“查看 Issue”项，即可进入查看所有Issue的界面，如图2-1-2-1。从页面看可以可以点击标题根据其属性对数据进行排列可以对过滤器进行管理操作图2-1-2-1看出，页面上部相当于一个过滤器，页面下部是根据过滤器显示bug的数据列表。如果管理员没有对给予的参数选择设置，那么默认就是没有对数据进行过滤，则页面下部则显示所有bug数据。此外还可以在搜索框里输入bug编号直接查询，那么在页面下部就会出现查询结果。就此详细说明一下过滤器的功能。a) 创建过滤器：在对参数进行设置完成后，可对当前的过滤设置进行保存，如图选择图2-1-2-2所示。填入相应内容后即可保存下来。如果标记为公有，则其图2-1-2-2他工作人员（除了查看人员）都能共享这个过滤器。同理，管理员也可以在过滤器列表共享经理创建的公有过滤器。b) 重复设置提示：在保存一个过滤器的时候，如果系统发现之前保存过相同设置的过滤器，就会出现重复提示，以免造成不必要的资源浪费。如图2-1-2-3所示。图2-1-2-3c) 管理过滤器：管理员可以对自己创建的过滤器进行操作，还可以删除或修改经理创建并标识为公有的过滤器。在显示的bug数据列表里可以看到，页面下部的表格头部显示查看Issue的当前数量，并且在旁边提供了“打印报告”和“CSV导出”功能链接，以下数据列表的bug信息列属性显示（从左到右）：复选框、修改图标、（P）优先级（会以，图形代表特急，加急，高，低优先状态，而对于中和无的状态则不作任何显示）、bug编号、bug注释数目、bug所属的项目和组别、bug的严重性、bug当前状态、最后更新、bug摘要。在此表格还可以进行如下操作：a) 打印报告：点击进入则进入如图2-1-2-4所示，将所有的bug显示出来，图2-1-2-4在页面，列出了需要导出打印的bug列表，可以根据需要通过复选框选中需要打印的bug，还可点击“打印选项”选择打印输出的项，在选择完毕后，根据需要点击图标，bug数据便相应的导出到该类型的文件里，实现打印输出的需求。b) CSV导出：点击功能链接，则出现如图2-1-2-5所示界面，提示将一个一当前图2-1-2-5用户帐户命名的CSV文件下载存储到本地。下载完成后，可以运行EXCEL打开该文件，直接查看导出的bug信息。c) 点击标题栏的列属性，可以进行排列，并出现或代表是按升序或降序排列；d) 可以通过选中bug列表的复选框，也可以选中“全选”的复选框，然后选择下拉列表的操作命令，然后点击确定按钮，则可以对这些bug进行相应操作，见-图2-1-2-4图2-1-2-4。这里具体说明一下这些命令操作： 移动：弹出选择项目界面，如图2-1-2-5。可以把选中的bug从当前项目转移到可以选择其他项目别的项目里。图2-1-2-5复制：弹出选择项目界面，如图2-1-2-6。可以把选中的bug从当前项目复制到别的项目里图2-1-2-6指派：可以把选中的bug直接分派给指定的工作人员，如图2-1-2-7。图2-1-2-7关闭：当被选中的bug已经确认已解决，或确认不是bug，管理员可以直接采用这个命令将bug状态设为关闭。删除：当被选中的bug是垃圾数据，在整理数据的时候可以直接进行删除。解决：如果bug确认已经解决，则选中将其状态置为“解决”。但是如果bug当前状态为“已解决”或以上状态，则不能进行此项操作。更新优先级：使用这项操作，可以更改选中bug的优先级。更新状态：使用这项操作，可以更新选中bug的流程状态。更新视图状态：使用这项操作，可以将选中的bug重新设置为公共或私有状态。这里需要注意的是：对于这些命令的选择和当前用户的权限有关系，如果不能进行该命令的操作，系统会出现“你无权执行这项操作” 提示性语句。而对于管理员来说，他具有完全的权限。e) 在bug列表中，可以在每行的bug显示中，有一个修改图形，可以点击这个图形进入这个bug的修改信息界面。注意：是否能出现这个图形也和权限有关系。f) 点击bug编号可以直接进入其详细信息界面。g) 点击注释数目可以直接进入对应bug的详细信息界面，并将界面焦点定位在bug注释信息。2.1.3报告Issue点击“报告Issue”项，如果开始没有制定项目的情况下，则首先进入项目选择界面，如图2-1-3-1。在选择工作项目后，其下有一个“指定预设值”的选项，如果在选择项目的图2-1-3-1时候，同时选中这个选项，则下次在同等情况下，就不会再进入项目选择界面而是直接进入这个预定设置的项目的报告Issue界面。进入报告Issue界面，可以看到一个提交bug的表图2-1-3-2单，根据具体情况填写后提交即可如图2-1-3-2所示。在表单右上角提供一个叫“高级报告”的功能链接，里面提供了比较详细的填写项，这样，如果对于报告比较复杂的bug来说也是十分必要，点击进入如图2-1-3-3所示，在该图上用红框标注的是相对于简易报告增加的填写项，点击其右上角的简易报告也可返回至其界面。在提交报告是请注意，带*号的填写项是必填项，页面还提供文件上传功能，只要是低于2M的文件都允许上传，支持doc、xls、zip等等格式的文件，这样在报告bug的时候，可以上传相关的文件，为bug的解决提供更多的信息。全部填写完毕之后就可以点击“提交报告”键提交报告，之后系统会提示用户操作成功，再返回我的视图中查看就可以看到新提交的报告。2.1.4修改日志点击“修改日志”项，如果开始没有制定项目的情况下，则首先进入项目选择界面，如图2-1-3-1。如果指定了预设值，则直接进入预设项目的修改日志。修改日志界面如图2-1-4-1图2-1-4-1所示，页面列出了该项目下已解决的bug编号、所属组别、bug摘要以及该项目产品的版本号变化，点击bug编号还可进入其详细信息页面。2.1.5统计报表点击“统计报表”项，即可出现一个所有Issue报告的综合报表，页面还提供了“打印报告”和“图形报表”的功能链接，如图2-1-5-1所示。在这个综合报表中，按照bug报告详细资料中的项目，将所有的报告按照不同的分类进行了统计。这个统计报表有助于管理员及经理很好的掌握bug报告处理的进度，而且很容易的就能把没有解决的问题与该问题的负责人、监视人联系起来，提高了工作效率。在这个界面中，还提供了更多按不同要求分类的统计图表，如：按状态统计、按优先级统计、按严重性统计、按项目分类统计和按完成度统计。分别点击这五项，即可得到相应的统计图。点击“图形报表”，则进入将刚才显示的数图2-1-5-1图2-1-5-2据图形化的一个报表界面，如图2-1-5-2所示。更便于查阅和对比。如果有需要，也可以点击界面上方的打印报告，即可将当前页的图表导出打印出来，打印报告的具体使用请见“查看Issue”的打印报告说明 。2.1.6使用说明点击菜单栏的“使用说明”，进入如图2-1-6-1界面。当前页面默认是项目文档页面，页图2-1-6-1面还提供了“用户文档”和“添加文件”的功能链接，如果这是一个新建项目，之前没有对其添加过文件，则项目文档页面也显示为空，如果采用添加文件功能，为该项目上传文件，则在页面中列表显示，使用时直接点击打开即可，如图2-1-6-2。用户文档的功能链接相当图2-1-6-2于Mantis的一个联机帮助，直接将网页链接到http/:，即可直接链接进入Mantis的网站，在上面使用帮助信息。2.1.7管理点击菜单栏的“管理”项，即可进入管理界面(如图2-1-7-1所示)，管理界面包含了： 图2-1-7-1用户管理、项目管理和自定义字段管理部分。 用户管理为点击“管理”进入的当前默认页面。新帐号：显示一周之内添加进该项目的新用户。从未登录：显示目前存在的用户却至今从未登陆过的用户，对此用户可以点击“清理帐号”功能链接进行清理。管理帐号：在这里可以进行添加新用户和更新已有用户的操作。点击Create New Account，就可以添加新的用户，并指定其工作身份；点击现有帐号名称，就可以对当前帐号的资料进行更新，更新之后点击重置设置，系统就接受更新信息了。 点击项目管理，即可查看当前的所有项目，如图2-1-7-2所示。图2-1-7-2）点击创建新项目项，进入新项目创建界面，如图2-1-7-3所示，填写好项目资料之图2-1-7-3后点击添加项目项，新的项目就添加到系统中了。注：上传文件存放路径如果不指定，则为默认系统路径。）点击现有项目列表的项目名称，就可以看到该项目的具体情况列表，列表中包括各个项目的名称、状态、查看状态、以及说明列属性。如图2-1-7-4所示。在这个界面上可以进行以下操作：A. 编辑项目：在这里经理可以对项目的名称、状态、查看状态、上传文件的存放路径以及说明等内容进行更新。删除项目：点击删除按钮，即可将当前项目从库里删除。B. 增加分类：填入类别名称，点击增加分类便可在当前项目里增加类别。编辑分类：点击编辑，进入类别编辑页面，还可以当前的类别分配给指定的工作人员，这样会在该项目下报告一个新bug的时候，直接就指定给该工作人员处理；删除分类：点击删除，即可删除当前的分类。C. 版本：在这里可以对已有的项目版本进行更新或者删除，也可以添加新的版本。D. 自定义字段：在这里可以从已存在的自定义字段中选择出需要的添加到该项目中图2-1-7-4的自定义字段中。也可以删除已添加的自定义字段。E. 添加用户至项目：将与项目有关的用户添加进来。F. 管理帐号：对该项目中所有的相关人员的帐号进行管理，可以删去那些在项目中不需要的帐号。 自定义字段管理是用于在报告bug的时候，系统给予的填写项不满足实际需求，这 图2-1-7-5样可以自行在这个功能界面里定义自己需要的字段，以便能更好的描述bug的情况。而且在过滤器里也会增加这个字段的属性，可以根据其进行数据过滤。点击功能链接进入该界面即可新建自定义字段、修改已有的自定义字段，如图2-1-7-5所示。 2.1.8编辑公告点击菜单栏的“编辑公告”，即可出现如图2-1-8-1界面。从页面上可以看出，除菜单栏图2-1-8-1外，页面显示分2部分。页面上部可以直接输入相关信息发表公告。页面下部则可以对现有公告进行编辑和删除。当公告发布完毕后，如果状态是公共的，则该项目的工作人员登录后，在其首页直接可以直接浏览到这个公告。注：发表的公告时可分为公共和私有两种状态，对于私有公告，管理员是不能直接浏览，但是可以进行编辑和删除。2.1.9个人账号点击菜单栏的“个人帐号”，即进入了帐户管理界面，如图2-1-9-1所示。该界面包含了图2-1-9-1“个人帐户”，“更改个人设置”，“管理平台配置”功能操作，当前默认界面为个人帐户编辑页面。 个人帐户：为点击“个人帐户”界面进入的默认界面，管理员可以在此修改密码，Email，真实姓名等等帐户信息。 更改个人设置：点击进入如图2-1-9-2所示界面。可对页面相关项进行重新设置。图2-1-9-2 管理平台设置：点击进入如图2-1-9-3所示界面。在此可以增加平台设置，也可以对现有的平台数据进行编辑或删除。这样，在自己报告bug的时候，采用“高级报图2-1-9-3告”的报告报表就可以直接选用对应的平台数据而不需求自行输入，节省工作时间。注：管理平台配置的内容只限于本人采用。2.1.10注销点击菜单栏的“注销”，即可退出登录，返回至初始登录界面。2.2经理经理是整个软件开发过程中的较为重要的管理人员。经理在该系统下的使用权限比起管理员来说稍微低一些，由于以上已经详细说明了各个菜单功能的使用，则在此篇章主要说明经理在本系统所能使用的功能与管理员有什么不同。2.2.1操作区别对于以上提及的10个菜单功能，经理在使用的时候和管理员基本相同，就是有以下几个差异点。1）只能对自己的过滤器进行操作，对于管理员设为共有的过滤器只能使用而不能进行操作。2）对于“查看Issue”的时候，可以通过复选框对某条bug进行命令操作，经理级别的工作人员不能执行“删除”操作，系统会提示：“你无权执行该项操作”。3）在“编辑公告”功能中，只能对自己发表的公告进行操作，而对于管理员发表的3告只能浏览而不能进行操作。4）在“管理”功能中，不能对用户进行管理，包括新建，删除用户等，也不能新建项目，只能管理现有项目的信息。2.3开发人员开发人员，就是负责整个软件开发的工作人员。使用这个bug跟踪管理系统，能够帮助开发人员及时地发现和解决软件缺陷。在使用该系统中，开发人员的权限比起经理要稍低一些，从开始登录进入系统就能看出来，其主菜单栏的功能也少了一些，如图2-3-1。从图上图2-3-1看比起经理和管理员的菜单栏，少了“统计报表”、“管理”和“编辑公告”这3个功能。2.3.1操作区别由于以上已经详细说明了各个菜单功能的使用，则在此篇章主要说明开发人员在本系统所能使用的功能与管理员有什么不同。1）开发人员只能设置私有的过滤器，可以共享管理员和经理创建而且属性设置为公有的过滤器。2）对于“查看Issue”的时候，可以通过复选框对某条bug进行命令操作，开发人员不能执行“删除”操作，系统会提示：“你无权执行该项操作”。2.4修改人员修改人员，就是负责修改Issue的工作人员。修改人员的主菜单和开发人员一样，但是在该系统的使用权限还是稍比开发人员低一些，以下来具体说明一下功能操作区别。2.4.1操作区别1）不能创建过滤器，但是可以使用其他工作人员创建并将属性设为公有的过滤器。2）对于“查看Issue”的时候，可以通过复选框对某条bug进行命令操作，修改人员只能使用“复制”，“更新优先级”，“更新状态”，“更新视图状态”，对于其他的命令操作则无权执行。3）在“我的视图”界面，没有“指定给我的（尚未解决）”状态的bug数据列表，因为对于修改人员来说，不能将bug直接指派给他。因此相应的在界面上没有该类数据的显示。2.5报告人员报告人员，就是专门负责提交bug 报告的工作人员。报告人员的主菜单也和开发人员、修改人员一样，但是在该系统的使用权限还是稍比修改人员低一些，以下来具体说明一下功能操作区别。2.5.1操作区别1）也不能创建过滤器，但是可以使用其他工作人员创建并将属性设为公有的过滤器。2）对于“查看Issue”的时候，对bug数据列表不能进行任何命令操作，如图2-5-1-1所示。图里不显示复选框和命令选项图2-5-1-13）在“我的视图”界面，没有“指定给我的（尚未解决）”状态的bug数据列表，因为对于报告人员来说，也不能将bug直接指派给他。因此相应的在界面上没有该类数据的显示。2.6查看人员查看人员，顾名思义就是只具有查看权限的工作人员。在该系统中处于最低权限的人，其功能主菜单也减少了一些，如图2-6-1所示。比起开发人员、修改人员、报告人员的主菜 图2-6-1单功能，查看人员少了“报告Issue”的功能，以下具体说明一下其功能操作区别。2.6.1操作区别因为查看人员为最低权限的工作人员，因此对于该系统的操作功能基本没有使用权限（除了个人帐户的功能），只能查看各个项目的bug流程以及具体情况。3指派给我的工作以上主要是说明各个角色的工作人员在使用该系统的功能和所具备的权限，以下说明一下工作人员登录到该系统后该如何进行对指派给我的工作进行操作。当工作人员登录到系统，在进入“我的视图”，点击“指派给我的（尚未解决）”的bug数据列表的bug编号链接，则进入如图3-1所示的界面。在此界面，根据各种情况分成7个数据块显示。图3-13.1查看Issue详细资料进入指派任务的Issue界面里，上面第一个数据块显示的就是Issue的详细资料，在这个数据表格可以进行如下操作： 1）跳转到注释：点击此链接，则直接跳转到该页面的注释数据；2）Issue提醒：点击此链接，则可以对某个工作人员发送提醒，直接在该工作人员的监视Issue视图里生成，并在该Issue的注释里也增加一条记录。注意：这个功能除了查看人员之外，其他工作人员都可以使用。3）高级查看：当前默认是“简易”资料的显示，这个简易是相对于报告Issue的时候采用的的简易报告表单的填入项的信息。如果点击“高级查看”，则能查看相对于高级报告提交的Issue信息。4）Issue历史：点击此链接，则直接跳转到该页面的Issue历史数据；5）打印：点击此链接，则直接在网页上生成这个Issue的详细数据，可以通过IE提供的打印功能进行打印。6）修改Issue：如果对Issue的信息需要修改，则点击此按钮，直接进入如图3-1-1所示图3-1-1的页面。根据实际情况进行修改，然后点击更新信息按钮完成。如果需要修改更多的信息，则可以点击“高级更新”进行修改。如果不需要修改了，可以点击“返回Issue”回到前已页面。需要注意的是：修改Issue的功能只有管理员，经理，开发人员以及修改人员能修改。7）指派给：这个功能可以把当前的Issue直接指派给选定的工作人员。注意：指派功能只有管理员，经理，开发人员以及修改人员能指派，而且只有管理员才能指派给自身。8）将状态改为：这个功能可以把当前的Issue流程状态直接修改。注意：修改状态功能只有管理员，经理，开发人员可以使用。9)监视Issue：这个功能可以把当前这个Issue置为所监视的Issue范围之内。注意：这个功能除了查看人员之外，其他工作人员都可以使用。10）创建Issue子项：这个功能主要是创建于当前Issue相关的Issue，点击按钮进入如图3-1-2所示。在页面上用红框标注的就是设定创建子项后和当前Issue的关系。同时图3-1-2在以下说明的“关系”数据中会增加一条记录。注意：创建子项功能只有管理员，经理，开发人员以及修改人员才能使用。11）移动Issue：点击直接可以将该Issue转移到别的项目中去。注意：移动功能只有管理员，经理，开发人员才能使用。12）删除Issue：点击直接删除该Issue，只有管理员才有这个权限。3.2关系这个数据主要是描述当前Issue是否和别的Issue有什么关系，如图3-2-1所示。一共有图3-2-1四种关系：与id关联，依赖于id，阻塞id，id重复，有重复于id，可以根据实际情况选择关系。在此界面可以进行如下操作：1）增加关系：增加与当前Issue有关系的Issue，选择关系，输入Issue编号，点击添加即可完成添加。注意：只有管理员，经理，开发人员和修改人员才能使