bugzilla使用手册(缺陷管理系统使用说明书V1.0版)要点

缺缺 陷陷 管管 理理 系系 统统 使使 用用 说说 明明 书书 作者： 编写日期2011-4-10 部 门 名测试部 审 核 人 文件状态： 草稿 正式发布 正在修改 审核时间 缺陷管理系统使用规范 V1.0 2 文档修改记录文档修改记录 日期日期版本版本变更说明变更说明作者作者 2011-07-15V1.0草稿 缺陷管理系统使用规范 V1.0 3 目录 1序言.4 1.1什么是 Bugzilla.4 1.2为什么使用 Bugzilla.4 2BUGZILLA 基本操作 .5 3BUG 提交过程 .5 4BUG 处理流程 .8 5对于 BUG 的不同处理情况.9 6有关权限说明.10 7查询操作.10 8管理员操作指南.15 缺陷管理系统使用规范 V1.0 4 1序言序言 1.1 什么是什么是 Bugzilla Bugzilla 是 Mozilla 公司向我们提供的一个开源的免费缺陷跟踪工具。作 为一个产品缺陷的记录及跟踪工具，它能够为我们建立一个完善的 Bug 跟踪体 系，包括报告 Bug、查询 Bug 记录并产生报表、处理解决、管理员系统初始化 和设置四部分。并具有如下特点： 基于 Web 方式，安装简单、运行方便快捷、管理安全。 有利于缺陷的清楚传达。本系统使用数据库进行管理，提供全面详尽的报 告输入项，产生标准化的 Bug 报告。提供大量的分析选项和强大的查询匹配能 力，能根据各种条件组合进行 Bug 统计。当错误在它的生命周期中变化时，开 发人员、测试人员、及管理人员将及时获得动态的变化信息，允许你获取历史 纪录，并在检查错误的状态时参考这一记录。 系统灵活，强大的可配置能力。 Bugzilla 工具可以对软件产品设定不同的模块，并针对不同的模块设定开 发人员和测试人员；这样可以实现提交报告时自动发给指定的责任人；并可设 定不同的小组。设定不同的用户对 Bug 记录的操作权限不同，可进行有效的控 制管理。允许设定不同的严重程度和优先级，可以在错误的生命期中管理错误， 从最初的报告到最后的解决，都有详细的记录，确保了错误不会被忽略，同时， 可以让开发人员将注意力集中在优先级和严重程度高的错误上。 自动发送 Email 通知相关人员。 根据设定的不同责任人，自动发送最新的动态信息，有效的帮助测试人员 和开发人员进行沟通。 1.21.2 为什么使用为什么使用 BugzillaBugzilla BUGZILLA 是一个拥有强大功能的缺陷跟踪系统。它可以使我们更好的在软 件开发过程中跟踪软件错误的处理过程，为开发和测试工作以及产品质量的度 量提供数据支持，从而有效的保证软件产品的质量。 缺陷管理系统使用规范 V1.0 5 2Bugzilla 基本操作基本操作 适用范围适用范围：高层领导人员、项目经理、开发人员、测试组所有成员 用户登录及设置流程： 打开浏览器，在地址栏中输入： 09 进入 Bugzilla 主页面。在登陆项中输入 E-Mail 地址， 在密码栏输入用户的初始密码（姓名全拼如 wangtong） ，然后，点击【登陆】 即可。 如忘记密码，请联系 wangt 成功登录后，点击页面中的“偏好设定” ，然后选择【姓名和密码】 ，进行 密码修改。 点击【设置】-【电子邮件设置】 ，进行邮件通知设置。 点击【设置】-【权限】 ，进行权限查询。 注意注意：在登陆使用系统之后，一定要退出登陆，因为在 BUGZILLA 中存在一 个隐患当你没有退出登陆而关闭页面，当用同一台机器再次访问的时候， 系统会以上次登陆的用户访问。 3Bug 提交过程提交过程 适用范围：适用范围：测试组所有人员 具体操作如下：具体操作如下： 成功登陆缺陷管理系统后，在系统首页点击【新建】或点击【输入新 BUG】 ， 点击 bug 所在的项目，系统显示输入缺陷界面（见图 1） ； 1、选择发现的 bug 所在的产品名称； 2、子产品（功能模块）：点击选择列表中的子产品。可以查看关于这 个产品的子产品的详细信息； 3、选择对应的版本号，严重程度、优先程度信息； 4、硬件平台、操作系统：可以根据发现 bug 的实际情况来选择，如果 确定这个 bug 可以发生在所有的平台，选择 all 就可以； 缺陷管理系统使用规范 V1.0 6 5、严重性：严重、一般、轻微、优化，严重程度逐渐减弱； 6、优先级：紧急、优先、一般、次要，优先级逐渐减弱； 7、初始状态：默认状态为“新建（NEW） ” ； 8、分配给谁负责: 默认是后台设定好的一般不用修改, 也可手工制定， 直接修改即可； 9、邮件组（抄送给谁）: 可为多人，需用，隔开，一般抄送都默认 加到了预设邮件组里这里一般不手工填写； 10、预设邮件组：后台默认添加的必须抄送人； 11、估计小时数、截止期限、网址: bug 的定位（可选） 12、摘要：是对 bug 的概述（必须填写） ； 13、描述中要详细说明下列情况： 1） 发现问题的步骤 2） 执行上述步骤后出现的情况 3） 期望应出现的正确结果 14、附件：点击【新增附件】 ，根据实际情况，为了更进一步描述 bug， 可以提交 bug 出现的错误图片等文件。 15、依赖于和会屏蔽的 BUG：直接输入与当前 bug 有依赖关系的 bug 的 编号。简单地说，比如说这里输入“3” ，那么就是说当前提交的 bug 有 依赖关系，不是由于 3 导致了当前 bug，就是当前 bug 导致了 bug3。 确认无误后，点击【确认】即可。 缺陷管理系统使用规范 V1.0 7 图 1 提交之后，系统会提示：bug 已经提交。在此页面的下半部分，会再次显 示刚才提交的 bug 的详细信息，你可以在这里进行修改，重新提交,也可以在此 增加新的附件或是附加说明来进一步说明 bug。 冲突冲突: :当两个或几个人同时修改一个 bug 提交信息的时候，bugzilla 会有 弹出 Mid- air collision!提示，并且列出解决冲突的选择，若提交修改，会 导致覆盖别人所做的修改；若不改，返回。建议选择返回，看看别人修改了什 么，不同的话，添加一个附加说明来补充吧！ 以上各项可能会因为权限的关系，有所缺省。 注意：注意：如果要提交的 bug 已经存在，系统会给出提示相应不能提交的信息， 若有什么建议，可在原有记录中增加注释，告知其属主。 4Bug 处理流程处理流程 适用范围适用范围：项目经理、开发人员、测试组所有成员 1、测试人员发现 bug 后，判断属于哪个子产品（功能模块）的问题，填写 bug 报告后，系统自动通过 Email 通知 bug 负责人（项目经理或开发人员） 。 2、bug 负责人根据具体情况，重新分配给 bug 所属的开发者。 缺陷管理系统使用规范 V1.0 8 3、开发者收到 Email 信息后，判断是否为自己的修改范围。 1） 若不是,重新分配给项目负责人或应该分配的开发者。 2） 若是，进行处理，并给出解决方法。 4、测试人员查询开发者已修改的 bug，进行回归测试。 1） 经验证无误后，测试人员修改状态为已认证（VERIFIED） 。待整个产品发 布后，修改为已关闭（CLOSED） 。 2） 若经验证仍有问题，测试人员修改状态为重开启（REOPENED） ，并会自动 邮件通知。 5、如果这个 BUG 一周内一直没被处理过。Bugzilla 就会一直用 email 骚扰 它的属主，直到采取行动。管理员可以设定最迟采取行动的期限，比如说 3 天，系统默认为 7 天。BUG 处理流程见下图： 说明：说明：对于测试人员新提交的缺陷，必须经过项目经理分配后，开发人员 才可以修改，并注明修改意见。如果项目经理不分配缺陷，开发人员只有浏览 缺陷的权利，不可以执行任何修改操作。 Bug 开始 初始状态 指派处理人员 二次指派 处理 Bug 确认处理 关闭 Bug 结束 重新 打开 缺陷管理系统使用规范 V1.0 9 5对于对于 BugBug 的不同处理情况的不同处理情况 适用范围适用范围：项目经理、开发人员、测试组所有成员 1 1、BugBug 的属主的属主 (owner)(owner) 处理问题，提出解决意见及方法。处理问题，提出解决意见及方法。 给出解决方法并填写附加说明（Additional Comments） ，并需要选择 BUG 处 理结果，5 种处理结果如下： 1)FIXED（已修复）：描述的问题已经修改，该 bug 已经修复并检查过，源 文件已经检入 SVN 库。 2)NVALID（无效）：描述的问题不是一个 bug (输入错误后，通过此项来 取消) 3)WONTFIX（决定不改）：描述的问题将永远不会被修复。 4)DUPLICATE(重复 bug):描述的问题是一个存在的 bug 的复件。 5)好好的 WORKSFORME (无法重现)：所有要重新产生这个 bug 的企图是无效 的。如果有更多的信息出现，请重新分配这个 bug，而现在只把它归档。 注意：注意：开发人员在修改缺陷后，必须选择以上处理结果。 2 2、项目经理或开发者重新指定、项目经理或开发者重新指定 BugBug 的属主。的属主。 bug 不属于自己的范围，可在负责人处点击编辑,指定 BUG 责任人是项目经 理，此时等待项目经理重新指定。 1) bug 不属于自己的范围，但知道谁应该负责，在负责人处点击编辑直接输 入被指定人的 Email。 2) 操作结果：此时 bug 状态又变为“新的” ，此 bug 的负责人变为被指定的 人。 3 3、测试人员验证已修改的测试人员验证已修改的 BugBug 1)测试人员查询开发者已修改的 bug，即状态为已解决, 解决方案为已 修复，进行回归测试。 2)经验证无误后，修改“已解决”为“已认证” 。待整个产品发布后，修改 为“已关闭” 。 3)若测试之后发现还有问题，修改为“重开启” ，状态重新变为“新的， 缺陷管理系统使用规范 V1.0 10 并发邮件通知 BUG 属主。 6 6有关权限说明有关权限说明 适用范围：适用范围：高层领导人员、项目经理、开发人员、测试组所有成员 分为五种权限：分为五种权限： 1、高级浏览用户：能够快速、方便的查看系统所有缺陷。 2、项目经理：负责分派项目所有缺陷。 3、测试经理：负责提交缺陷、审核缺陷、回归测试等，跟踪整个缺陷修改 过程。 4、开发人员：负责修改所属缺陷，添加修改评论，修改处理结果。 5、测试人员：负责提交缺陷、验证缺陷，并修改验证后缺陷的最终状态。 7 7查询操作查询操作 适用范围：高层领导人员、项目经理、开发人员、测试组所有成员 登录 Bugzilla 缺陷跟踪系统后，点击【进阶搜索】 ，可以按照指定的一个 或者多个查询条件进行查询（如下图 2） 。 缺陷管理系统使用规范 V1.0 11 图 2 1 1、常规项查询方式：、常规项查询方式： 1) 摘要：下拉列表框选择查询规约。在其后的输入框中输入包含的信息， 此信息的指定与提交 bug 时的注释信息相一致。 2) 产品(Product)：选择所要查找的 bugs 所在的产品。 3) 子产品（功能模块）(Component)：选择 bugs 所在的模块。 4) 版本(Version)：选择 bugs 版本。 5) 网址 URL： 指定关于 bugs 所在的 URL。 6) 描述或注释：指定包含或不包含该关键字的 bugs。每个 bug 可以被指 定描述。 7)截止期限：搜索约定某个时间段内。 8) 状态(Status)：选择 bugs 状态。 9) 解决方案(Resolution)：选择 bugs 处理的结果。 10) 严重等级(Severity)：选择 bugs 的严重级别。 11) 优先程度(Priority)：选择 bugs 的优先级别。 12) 硬件平台(Platform)：选择存在 bugs 程序运行的平台。 13) 操作系统(OpSystem)：选择存在 bugs 程序所运行的操作系统。 设置以上有关缺陷信息，点击【搜索】即可。 2 2、邮箱和编号、邮箱和编号( (邮件和编号查询方式邮件和编号查询方式) ) 在这一部分，我们可以通过复选框中的用户(bug 负责人、报告者、抄送列 表成员以及评论者)的 E-mail 地址和 bug 的编号进行查询。 这部分的查询界面(如上图)有两列相同的复选框、下拉列表框及文本框。 同一列的复选框可多选。文本框中可以输入多个 E-mail 地址，中间用“,”隔 开。查询结果取多个复选框的并集。若同时指定两列查询选项，则查询结果取 各自的交集。 例如：要查询 bug 负责人和报告者为 wangt 的 bugs，首先 点选 bug 负责人和报告者复选框，然后在下拉列表框中选择“是”,文本框中输 入，点击“搜索”显示查询结果。又如要查询 bug 负责人为 wangt 且报告人为 zhaojs 的 bugs，则可以在第 一列选项中设置 bug 的负责人，在第二列选项中设置报告者，点击【搜索】显 缺陷管理系统使用规范 V1.0 12 示查询结果。 在这一部分的查询中，我们还可以直接输入编号进行查找，选择包含或排 除，然后输入 bug 编号，即可按号查找。 3 3、BugBug 变更变更 1) 在下述天数内修改的 bugs：可查找在指定天数内修改过的 bugs。 2) 匹配下面任意条件的 bugs：可选择发生过改变的条件，指定发生改变 的时期（按照 yyyy-mm-dd 的格式）以及修改后的属性值。 4 4、使用布尔运算式进阶搜索使用布尔运算式进阶搜索高级查询高级查询 利用 Boolean Chart 高级查询可以实现以上所有的查询功能。 例如：在第一个下拉列表框中选择“bug #” ，第二个选择“等于” ，第三个 指定 n(n 为 bug 的 ID 号，如 2)，点击 Search，查询结果将列出 ID 号为 n 的 bug。点击 Or，可追加查询选项及选项值，查询结果与上一查询结果取并集； 点击 And，则查询结果取交集。点击 Add another Boolean Chart，可以添加新 的 Boolean Chart。这个键与 And 键几乎相同。只是前一个 Boolean Chart 查 询的结果，作为下一个 Boolean Chart 查询的范围。 5 5、指定查询结果的排序方式：、指定查询结果的排序方式： Sort results by ：可以指定查询结果的排列顺序。 6 6、显示全部的、显示全部的 BUGBUG 在列表框(如状态列表框)，我们可以通过 Ctrl+Click(左键单击)取消一个 选项,去掉所有的查询选项，就可以显示所有的 BUG 了。 7 7、查询结果页面显示、查询结果页面显示 点击页面上的【长的格式】键，可以显示查询结果中 bugs 的详细的相关信 息。 1)CSV：打开一个关于查询结果的.csv 文件，事实上是一个 excel 表格形 式。 2)iCalendar：以日历的形式显示。 3)一次变更多个 Bug：可以对查询结果中所有或者部分 bugs 进行统一变 更。 4)发邮件给 Bug 负责人：发邮件给 bug 负责人，邮箱地址用“,”隔开。 5)编辑搜索条件：可以重新设置查询选项。 缺陷管理系统使用规范 V1.0 13 我们还可以点击 bug 的 ID，查看单个的 BUG 信息。 8 8、 预定义查询预定义查询 在查询页面底部区域内有一个【我的缺陷】选项，其中的查询结果是当前 用户提交或指定给当前用户的 bug。可以通过该功能定制搜索条件，每次进行 搜索操作时，直接点击搜索名即可完成搜索操作。 具体操作举例说明： 1) 在缺陷管理系统首页，点击【我的缺陷】系统显示页面见下图 3； 2) 点击【编辑搜索】编辑搜索条件； 3) 点击【搜索】 ，系统显示缺陷列表； 4) 然后在 as 后面的文本框中输入搜索名称，如“甘肃省电力公司门户项目” ； 5) 选择【将这些设定设为我的搜索选项的预设值】 ，系统自动保存搜索条件； 6) 返回系统首页，在页面下方区域【我的缺陷】后就显示搜索名称，如图 4； 7) 点击搜索名称即可完成搜索操作。 8 8管理员操作指南管理员操作指南 适用范围：适用范围：缺陷管理人员 主要工作内容：主要工作内容：产品（Product） 、版本号(versions)和子产品(Components) 的定义，同时指定模块相应的开发者(owner)和测试人员(QA Contact)。 1、小组的定义和划分 2、测试中 Bug 严重程度、优先级的定义 3、增加用户，并分别设定全部用户的分组、权限。 4、主要参数（parameters）的设置 1） urlbase: 输入 bugzilla 工具所在的服务器 IP 地址。 2） whinedays：Bug 在 whinedays 设定的期限内若未被处理，将自动重发 mail，默认为 7 天。 缺陷管理系统使用规范 V1.0 14 3） defaultpriority:设定默认的优先级 4） commentonchange_resolution：设为 ON，系统将强制要求开发者处理 完 Bug 后，必须填写修改的内容。 说明：说明：若是要更改某一项的设置，不要勾选该项前面的 reset 选框，这样 会使其恢复默认设置的。 基本操作：基本操作：创建默认的管理员用户,运行 checksetup.pl。若不小心删除管 理员，重新运行 checksetup.pl 用户管理：用户管理： 1) 增加新用户 点击页面右下角【用户】,点【添加】页面。 帐号（Login name）: 一般为邮件地址。 真实姓名（Real name） :填写真实用户名。 密码：用户密码 测试人员的权限一般设为: Canconfirm, editb