bugfree安装文档及基本使用手册.doc

《bugfree安装文档及基本使用手册.doc》由会员分享，可在线阅读，更多相关《bugfree安装文档及基本使用手册.doc（29页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、bugfree安装文档及基本使用手册目录Bugfree 安装1后台管理71.BugFree管理员角色7系统管理员7项目管理员7用户组管理员7管理员的具体权限72.用户管理83.用户组管理94.项目管理104.1模块管理124.2禁用和激活项目125.用户日志13Bug的状态13查询Bug13自定义显示字段15Bug管理151 新建Bug152 编辑Bug183 复制Bug194 统计报表20Test Case管理22Test Result管理22Bugfree 安装Bugfree安装在Windows server 2008上在安装Bugfree之前，需要首先安装Apache,PHP,Mysql

2、支持软件包，例如XAMPP或EASYPHP等。下面以XAMPP为例进行说明，这里我们以安装包“xampp-win32-1.8.3-3-VC11-installer.exe”为例进行说明。1.双击安装安装XAMPP，下面都是直接下一步此步记住安装地址为C:xampp最后运行如果没有上个界面，到安装目录找到“xampp-control.exe”或者点击开始依次点击Apache和MySql后面的“start”按钮，启动Apache和MySql服务，如下图此时注意（1）将bugfree.zip包解压后的文件复制到XAMPP系统的htdocs子目录下：C:xampphtdocs（2）进入bugfree的

3、安装目录，复制文件C:xampphtdocsbugfreeInclude/Config.inc.Sample.php为新文件Include/Config.inc.php2.打开IE浏览器，在地址栏中输入：http:/localhost,点击回车键出现下图所示界面3.选择“中文”链接，来到友好欢迎界面，提示你成功安装“XAMPP”，如下图所示4.此时，在地址栏中输入https:/localhost/bugfree，点击回车，系统提示：数据库连接失败！如下图5.点击“创建数据库”链接，成功创建数据库，如下图6.点击“继续安装”，提示安装全新Bugfree2，如图7.点击“安装全新Bugfree2”

4、链接开始安装。安装结束后，系统会提供默认管理员的帐号和密码，如图注意进去之后，如果看到看到有两个异常：Strict Standards: Only variables should be passed by reference inC:xampphtdocsbugfreeIncludeFuncModel.inc.phpon line 1160Fatal error: Call-time pass-by-reference has been removed in C:xampphtdocsbugfreeIncludeClassXmlParse.class.php on line46preg_re

5、place_callback(): Requires argument 2, , to be a valid callback inC: C:xampphtdocsbugfreeIncludeClassTemplateLitepiler.php on line159参照下面方法解决下面先解决1160：打开C:xampphtdocsbugfreeInclude里FuncModel.inc.php找到1160行（点击查看，勾选状态栏右下角会显示行数）；把$ProjectInfo = array_pop(testGetProjectList(ProjectID = $ProjectID);修改为$R

6、esult = testGetProjectList(ProjectID = $ProjectID);$ProjectInfo = array_pop($Result);即可；下面修改46：打开C:xampphtdocsbugfreeIncludeClass里XmlParse.class.php，把里面所有带&$前缀的&去掉即可。注意全部去掉。（可以通过替换）下面修改159：将文件中159行替换$file_contents = preg_replace_callback (!$ldq*.*?*$rdq!se,$file_contents)return $file_contents;类似问题都可

7、以修改，修改后需要重启服务远程连接配置就是配置Apache1.C:xamppapacheconf下的httpd中的ServerName localhost:80修改成IP或者主机名2.需要关闭服务器的防火墙8.进入Bugfree的主界面，如下图 项目选择框：可以快速切换当前项目，项目模块框和查询结果框显示相应的模块结构和记录。 项目模块框:显示当前项目模块结构。点击某一模块，查询结果框会显示所选模块的所有记录 个性显示框： a)指派给我：显示最近10条指派给我的记录 b)有我创建：显示最近10条有我创建的记录 c)我的查询：保存查询框的查询条件 模式切换标签：切换Bug，Test Case和T

8、est Result模式。默认登陆为Bug模式。 查询框：设置查询条件 查询结果框：显示当前查询结果a)自定义显示：设置查询结果的显示字段 b)全部导出：将当前查询记录导出到网页 c)统计报表：显示当前查询结果的统计信息 导航栏：显示当前登陆用户名等信息修改个人信息1.点击导航栏-“编辑我的信息”进行密码更改后台管理点击右上角后台管理后打开后台管理窗口，如下图： 1.BugFree管理员角色 BugFree的管理员包括系统管理员、项目管理员和用户组管理员三种角色。可以同时指派任意用户为任意角色。这三种管理员登陆BugFree之后，主页面上方导航栏会显示一个后台管理的链接。 系统管理员 全新安装

9、BugFree之后，会自动创建一个默认的系统管理员帐号admin。你可以通过编辑BugFree目录下的Include/Config.inc.php文件，增加其他系统管理员帐号。 例如，假设要将user1设置为系统管理员。编辑Include/Config.inc.php文件，将user1添加到下面的行。 /* 2. Define admin user list. Like this: array(admin,test1) */$_CFGAdminUser = array(admin,user1);注意：如果user1不存在，首先需要默认管理员帐号admin登录之后，创建该用户。项目管理员项目管理

10、员只能由系统管理员指派，指定哪些用户组可以访问当前项目。该角色负责维护Bug和Case的模块结构，把系统管理员解放出来。用户组管理员可以由系统管理员或者其他用户组管理员指派，负责维护一个用户组。一般情况下，用户组管理员和项目管理员可以是同一个用户。但是在大型的组织，在人员很多的情况下，可以指派专人对用户组进行维护。技术负责人则担当项目管理员的角色，负责维护Bug和Case的模块结构。管理员的具体权限系统管理员、项目管理员和用户组管理员三种角色的详细权限如下表所列。系统管理员项目管理员用户组管理员项目管理1.可以添加项目；2.可以查看和编辑所有项目；3.可以修改项目名称和显示顺序；4.可以指派项

11、目用户组；5.可以指派项目管理员；6.可以编辑Bug或Case模块1.不可以添加项目；2.仅可以查看和编辑自己是项目管理员的项目；3.不可以修改项目名称和显示顺序；4.可以指派项目用户组；5.不可以指派项目管理员；6.可以编辑Bug或Case模块无权限用户管理1.可以查看所有用户；2.可以添加用户；3.可以编辑、禁用或激活所有用户1.可以查看所有用户；2.可以添加用户；3.可以编辑、禁用或激活自己创建的用户或本人1.可以查看所有用户；2.可以添加用户；3.可以编辑、禁用或激活自己创建的用户或本人用户组管理1.可以查看所有用户组；2.可以添加用户组；3.可以编辑或删除所有用户组1.可以查看所有用

12、户组；2.可以添加用户组；3.可以编辑或删除自己添加的用户组1.可以查看所有用户组；2.可以添加用户组；3.可以编辑或删除自己添加的用户组或自己是用户组管理员的组2.用户管理添加新用户，输入用户名、真实姓名、密码和邮件地址。用户名和密码用于登录BugFree；真实姓名则显示在指派人列表中用于选择。点击主界面导航栏中“用户管理”项切换到“用户列表”界面，如图1所示。图1点击“添加用户”切换到“添加用户”界面，如图2所示。根据提示，填写相应的信息即可点击“保存”完成。图2禁用和激活用户点击如图4.1所示“禁用”链接后，该用户将无法登录BugFree，并从所在用户组删除。包含该用户的记录将不再显示该

13、用户的真实姓名，而以用户名代替。再次点击“激活”，将恢复该用户，但需要重新指派用户组权限。3.用户组管理创建用户之后，需要将用户添加到用户组，项目管理员通过指派用户组来分配权限。新用户只有在所属用户组指派给一个项目之后才可以登录BugFree系统。安装BugFree之后，系统会默认创建一个“All Users” 默认组，该用户组包含所有用户，不需要额外添加用户。如图3所示表示要添加一个叫做“Test”的用户组，组内有“小明、小红、小芳、小王”四个成员，用户组管理员为：“小明”，点击“保存用户组”即可完成返回用户组列表，如图4所示。此时，可以看到新添加的新用户组“Test4”的信息。点击“编辑”

14、按钮就可以对其进行编辑。图3图44.项目管理以管理员的身份登录后，点击导航栏-“后台管理”打开“后台管理”界面，管理员可以对项目、用户和用户组进行相应的管理，默认为项目列表，如图5所示。图54.1模块管理创建项目之后，通过“Bug模块”和“Case模块”链接，可以分别为Bug和Test Case创建树形模块结构。一个项目可以包含多个模块，一个模块下面可以包含多个子模块。原则上，对子模块的层级没有限制。如此接连不断地“添加一个新的子模块”（注意“父模块”的选取），则各模块间可以形成类似图9左侧的树状列表。与项目的显示顺序类似，“Case模块”可以编辑模块的显示数据值更改同级模块的排列顺序。如果指

15、定模块负责人，在创建该模块下的Bug或Test Case时，会自动指派给该负责人。如果删除一个模块之后，该模块下面的Bug或Test Case将自动移动到其父模块中。图8图94.2禁用和激活项目点击“禁用”后，可以隐藏某个项目，但并不真正从数据库删除记录，该项目将对所有人员不可见。再次点击“激活”，将恢复该项目所有的记录。5.用户日志用户日志只有系统管理员可以查看，用于记录用户的登录信息，包括登录的用户名，登录机器的IP地址和登录时间。Bug的状态在BugFree中，一个Bug只有3种状态：Active、Resolved、Closed。实践中经常有不熟悉的用户通过“编辑 (Edit)”来改变所

16、有的状态，那是不合适的。正确的状态转换方法应该是：1. 某个状态自己到自己的改变，使用“编辑(Edit)”。比如一个Active的Bug，从一个人指派到另外一个人；2. Active-Resolved只能用“解决(Resolve)”；Resolved-Closed只能用“关闭(Closed)”；3. Resolved-Active和Closed-Active只能使用“激活(Activate)”。查询Bug你可以设定不同的查询条件，寻找你想找的Bug。目前，BugFree提供了以下几种查询模式：1. 单击某个模块，可以显示该模块的所有bug。如图6.1所示，点击“项目模块框”下的“角色管理”模块

17、，就可以在Bug列表中显示此模块中所有Bug的信息。这样能够让修复人员很快得到某一模块的全部Bug，使修复效率得以提高。图6.12. 设定查询条件，列出符合条件的bug记录。在“查询条件”栏中填写想要查询的Bug信息，例如图6.2中查询条件为项目名称：学生信息管理系统，创建者：G郭彦海，严重程度：1，指派给：L李晓鹏。三个条件之间的关系都是并且关系，也就是说满足所有条件的Bug会在点击“提交查询内容”按钮后显示在下面的Bug列表中。查询条件的组合有很多种，你可以根据不同的需要查询Bug信息，准确性比较高。图6.2还可以点击“保存查询”按钮，来保存这些查询条件，在“查询标题”处给本次查询条件起一

18、个容易见文知义的名称。图6.3点击“保存查询”后，在屏幕的左下角会出现如图6.4所示的查询条，方便以后的查询工作。图6.43. 按某字段排序单击bug列表的任何一个字段（例如“创建者”、“BugID”、“修改日期”等），就可以按该字段将bug排序，同时，该字段旁边有 “”或“”表示当前是升序还是降序排序。再次单击一下本字段，将会改变排序方式。如图6.5中，将Bug按编号降序排序。图6.5自定义显示字段点击中 “自定义显示”按钮，调出如图所示界面。图样，我们就可以通过和按钮来添加/删除显示字段，也可以通过和按钮设置显示字段的排列顺序。表示程序默认显示的字段，包括“Bug ID”，“Sev”，“P

19、r”，“Bug标题”，“创建者”，“指派给”，“解决者”，“解决方案”，“最后修改日期”9个字段。Bug管理1 新建Bug当执行以下测试用例时，我们可能会发现，通过操作步骤得到的实际结果与期望结果不同：密码列为可视数据。这时，我们就需要提交Bug，也就是新建一个Bug。1. 点击“新建Bug”按钮，如图8.1中所示。图8.12. 打开新建Bug窗口，如图8.2所示。对话框显示为橘黄色的为必填项。3. 根据Bug的特征为Bug命名，尽量做到见文知意。4. 注意必须要指定该Bug属于哪个项目的哪个模块，指定bug的类型、Bug类型以与严重程度等必填信息，并将本bug指派给相应的同事。这里着重说明一

20、点：为了让Bug更容易重现，在书写“复现步骤”项时应尽量简洁明了。这样会使团队的工作效率得以提高，也会减少不必要的麻烦。图8.2Bug 字段说明Bug 标题：为包含关键词的简单问题摘要，要有利于其他人员进行搜索或通过标题快速了解问题项目名称/模块路径：指定问题出现在哪个项目的哪个模块。Bug处理过程中，需要随时根据需要修改项目或模块，方便跟踪。如果后台管理指定了模块负责人，选择模块时，会自动指派给负责人指派给：Bug的当前处理人。如果不知道Bug的处理人，可以指派给Active，项目或模块负责人再重新分发、指派给具体人员。如果设定了邮件通知，被指派者会收到邮件通知。状态为Closed的Bug，

21、默认会指派给Closed，表示Bug生命周期的结束抄送给：需要通知相关人员时填写，例如测试主管或者开发主管等。可以同时指派多个，人员之间用逗号分隔。如果设定了邮件通知，当Bug有任何更新时，被指派者都会收到邮件通知严重程度：Bug的严重程度。由Bug的创建者视情况来指定，其中1为最严重的问题，4为最小的问题。一般1级为系统崩溃或者数据丢失的问题；2级为主要功能的问题；3级为次要功能的问题；4级为细微的问题优先级：Bug处理的优先级。由Bug的处理人员按照当前业务需求、开发计划和资源状态指定，其中1的优先级最高，4的优先级最低。一般1级为需要立即解决的问题；2级为需要在指定时间内解决的问题；3级

22、为项目开发计划内解决的问题；4级为资源充沛时解决的问题其余选项字段（Bug类型、如何发现、操作系统、浏览器）：可以通过编辑Lang/ZH_CN_UTF-8/_COMMON.php来自定义创建Build：Bug是在哪个版本（Build或者Tag）被发现的解决Build：Bug是在哪个版本（Build或者Tag）被解决的解决方案：参考Bug的七种解决方案。如果解决方案为Duplicated，需要指定重复Bug的编号处理状态：Bug处理过程的附属子状态，例如Local Fix表示已在本地修复；Checked In表示修复代码已经提交；Cant Regress表示修复的问题暂无法验证等机器配置：测试运

23、行的硬件环境，例如Dell G280 2G/200G关键词：主要用于自定义标记，方便查询。关键词之间用逗号或者空格分隔。例如，对于跨团队的项目开发，可以约定一个关键词统一标记项目相关 Bug：与当前Bug相关的Bug。例如，相同代码产生的不同问题，可以在相关Bug注明相关 Case：与当前Bug相关的Case。例如，测试遗漏的Bug可以在补充了Case之后，在Bug的相关Case注明上传附件：上传Bug的屏幕截图，Log日志或者Call Stack等，方便处理人员复现步骤：步骤要描述清晰，简明扼要，步骤数尽可能少；结果说明Bug产生的错误结果；期望说明正确的结果。可以在备注提供一些辅助性的信息

24、，例如，这个bug在上个版本是否也能复现，方便处理人员。5. 当Bug的信息填写完整时，就可以点击“保存”按钮完成Bug的提交。Bugfree就会自动为我们生成Bug编号，如图8.3中所示，此Bug的编号为：Bug#4。此时，我们可以再审查一下有没有错误，是否和自己的最初意愿一致。如果一切OK，那么就可以关闭此界面，一个Bug就提交完毕了。图8.32 编辑Bug在我们提交Bug的过程中不免会出现一些失误，这就需要对Bug进行编辑修改。我们就以刚才的Bug#4为例。1. 首先，点击此Bug。2. 点击“编辑”按钮，打开“编辑Bug”窗口3. 修改相应的信息，点击“保存”完成编辑。3 复制Bug在

25、一个系统的测试过程中，难免会遇到很多相似的Bug。如果我们每一个Bug都要彻底描述一遍，无论对个人还是对团队都是很大的损失。Bugfree为了防止这种现象的出现，特意增加了“复制”Bug的功效。例如，我们前面已经提交了一个“2”的Bug。现经过测试，又出现了错别字。那我们就可以进行Bug的复制了。1. 找到一个“2”Bug，直接点击此Bug行，打开Bug，如图8.5所示。图8.5图8.62. 点击“复制”按钮，进入新建Bug窗口。这个与前面直接进行新建的Bug相同，只需在Bug的描述上进行简单的修改即可保存完成了。4 统计报表前面我们提到过Bug的查询，在输入一定的查询条件后，点击“提交查询内

26、容”会在下方显示符合条件的Bug信息。可是在一个项目中一定会存在符合某一条件的bug数量很多，如果想要进一步，更加清晰地查看一下Bug的分布情况就可以点击“统计报表”按钮，如图所示。图8.8在打开的“Bug统计报表”窗口，如图8.9所示。窗口左侧为查看统计的方式，勾选相应的查看方式，点击“查看统计”按钮就会在右侧的空白处出现对前面Bug列表中的Bug的分布情况。图8.9我们以一个“bug模块分布”查询方式为例说明。勾选“bug模块分布”选项，点击“查看统计”按钮，统计结果如图8.10所示。图8.10不同的颜色代表不同模块中的Bug，这样不同模块中的Bug数以与各个模块所占的比例一览无遗。Tes

27、t Case管理测试用例（Test Case）是在测试执行之前设计的一套详细的测试计划，包括测试环境、测试步骤、测试数据和预期结果。测试用例的录入与Bug的新建过程相似，在主界面导航栏点击“Test Case”按钮，即切换到“Test Case”模式，点击“新建Case”，切换到“新建Case”界面，按照事先编写的测试用例录入相关内容，创建测试用例。也可以通过页面上方的“复制”按钮快速创建类似的测试用例。图9.1Test Result管理Test Result只能通过运行已有测试用例来创建。打开一个已有的测试用例，点击页面上方“运行”按钮，进入创建Test Result界面。Case标题、模块路径和步骤等信息自动复制到新的Test Result中。同时，Test Result相关 Case自动指向该测试用例。记录执行结果（Pass或Fail）和运行环境信息（运行Build、操作系统、浏览器等信息），保存测试用例。针对执行结果为Fail的Test Result，点击页面上方的“新建 Bug”按钮，创建新Bug。Result标题、模块路径、运行环境和步骤等信息自动复制到新的Bug中。同时Test Result相关Bug指向新建Bug。