禅道使用手册＆课堂练习

禅道使用手册&课堂练习

禅道环境搭建：

1. 其实官网已经有了很详细的搭建帮助文档了，名叫：Windows系统用一键安装包安装（推荐），参考链接如下：

http://www.zentao.net/book/zentaopmshelp/76.html

2. 安装贴士：基本上跟着官方的步骤走就可以了，但是有一个问题，亲测解压到带有中文的路径后，双击start.exe启动会报错，不知道是不是我是英语系统的原因，反正如果有碰到同样问题的不要急，重新解压到纯字母目录下就可以了，也不要带有符号、空格什么的，这点在官方的介绍里是没有提过的

3. 主要跟大家聊下Apache

数据库使用教程：

1. 准备登录数据库：禅道集成运行环境控制面板>>>工具>>>数据库（ShortcutKey: CTRL+D）>>>进入禅道数据库登录页面，如下图：

2. 输入登录信息：系统默认选择MySQL就可以；服务器默认显示localhost，即127.0.0.1；用户名、密码、数据库三个选项不知道怎么填的直接参考下图：

注1：name代表数据库名字；user代表用户名；password代表密码；只填单引号里面的内容，这是计算机软件开发的“参数”方面基本常识，切记！

注2：这个my.php文件就是记录各种信息的，具体位置是：…\xampp\zentao\config\my.php

注3：仍然建议使用Notepad++打开

3. 开始操作数据库：作为后台管理员，我们可以通过直接对数据库的操作进行各种想要的增删查改，其实软件就是这样，作为用户我们只能看到前端，但其实每个软件都有后门的，尝试执行下面这句SQL语句作为我们的数据库课程的预热吧，呵呵

SELECT*

FROM`zt_user`

WHEREzt_user.account ='administrator'

禅道的卸载：

1. 卸载服务（Service）

卸载服务有两种办法，一种是点击禅道控制面板服务菜单下的卸载服务；另一种是在”…\xampp\services”下执行remove.bat文件，效果一致，都是自动卸载的，卸载以下2个服务：

-Apachezt

-Mysqlzt

查看服务的方式：任务管理器>>>服务

启动服务的方式：右键“我的电脑”>>>管理>>>服务和程序应用>>>服务>>>个性化定制

2. 然后把禅道的文件夹删掉就可以了

3. 其实禅道没有提供自动卸载程序，所以没有办法完全卸载干净，感觉多少还是会有残留的，不过那些残留如Microsoft Visual C++ 2015就让它们去吧，反正以后装其他开发环境也会安装到的

碰到忘记管理员密码时的处理方式：

系统默认最大管理员是admin，如果作为管理员的你忘了这个密码的话，点击【忘记密码】按钮，然后按以下步骤进行：

a. 在你的禅道服务器安装路径下的”…\xampp\zentao”文件夹下创建tmp文件夹，然后根据给出的信息新建1个文件，例如：” reset_5a31e7dbc6e9a.txt”，记住，这个txt文件名是动态的。最后，新建好文件后，文件的绝对路径例如：D:\Zentao\xampp\zentao\tmp\reset_5a31e7dbc6e9a.txt

b. 文件内容必须为空

c. 如果之前文件已经存在，删除之后重新创建

d. 点击刷新，然后就可以进入重置密码的界面

e. 下次别再忘了，这可是公司最高级别的管理员密码

f. 如果是普通用户的密码忘了，管理员可以登录系统替他们进行重置，不需要之前的步骤那么麻烦

禅道使用讲解：

一、管理员

1.1维护公司

1.1.1编辑公司信息

a.以具备管理员（Admin）权限的帐号登录禅道

b.点击【组织】，如下图：

c.点击【公司】，然后点击【编辑】即可开始私人定制公司的信息，如下图：

1.1.2制定部门

a.点击【部门】，然后根据需要添加一级下级部门，如下图：

注：一级下级部门就是公司下的各大部门

b.添加完一级下级部门后，可以在左侧的【维护部门结构】视图中选择，然后继续添加二级下级部分并依此类推，如下图：

1.2添加用户

1.2.1 单个添加用户

a. 点击【组织】页面右上方的【添加用户】按钮进入添加界面，如下图：

b. 注意【所属部门】默认为空，如果已经添加，可以为新用户直接选择部门

c. 注意红色*为必填项

d. 【用户名】即是以后的登录名

e. 注意【分组】的设定，即权限的设定，在选择了上面的【职位】后，【分组】会根据系统默认设定自动填充，如：选择【职位】是测试主管，则系统自动设定【分组】为测试主管的权限，如需修改，可手动重新选择想要的权限

1.2.2 批量添加用户

a. 点击【批量添加】可以进入批量添加用户界面，如下图：

b. 注意红色*为必填项

c. 注意右上角的【密码】指该新增用户的登录密码

d. 注意下面的【请输入你的密码】指管理员密码

e. 选择【同上】即可保持与上一条的选择相同

f. 点击【保存】完成批量用户的添加，注意一次最多只能增加10个新用户

1.2.3 用户信息表

a. 点击【用户】按钮进入总体用户信息表，如下图：

b. 可以根据搜索条件进行用户的匹配查询

c. 可以根据部门结构显示用户

d. 支持批量的修改、删除功能

1.3维护权限

1.3.1 浏览权限

a. 点击【权限】进入浏览分组界面，可以查看所有权限名称以及用户的权限分配情况，如下图：

1.3.2 视图维护

a. 点击1.3.1图中的“1.视图维护”按钮图标可以进入所选角色的视图维护界面，如下图：

b. 可以在此界面根据不同角色来配置不同的视图访问权限

1.3.3 权限维护

a. 点击1.3.1图中的“2.权限维护”按钮图标可以进入所选角色的权限维护界面，如下图：

b. 此界面（截图只截取一部分）列出了所有的所选角色的权限（打勾表示具备权限）

c. 可以通过打勾、取消打勾的方式自定义某个角色的权限

1.3.4 成员维护

a. 点击1.3.1图中的“3.成员维护”按钮图标可以进入所选角色的成员维护界面，如下图：

b. 部门结构下选定指定部门可以只显示该部门下的用户

c. 组内用户的成员代表已经是该角色的用户

d. 可以将组外用户的成员加入该角色

二、产品经理

2.1 创建产品

2.1.1 所有产品

a. 点击【产品】，然后点击【所有产品】将显示所有可见（产品查阅权限开放）的产品

b. 点击左侧红框体内【维护产品线】可以添加产品线

2.1.2 新增产品

a. 点击2.1.1图中的【添加产品】或【新增产品】可以进入新增产品界面，如下图：

b. 注意红*为必填项

c. 注意根据实际需要设置访问控制（好好阅读文字）

2.2 维护模块

2.2.1 添加模块（后续测试用例的模块化就是用到这里的产品模块）

a. 点击【产品】，然后点击【模块】，进入维护子模块的界面，默认是产品层级的（即最顶层），如下图：

b. 依次输入产品下的一级模块名，可以点击+符号增加新的行，最后点击保存就可以在左侧视图中看到新添加的一级模块了，见下图：

c. 点击任意一级模块右侧的【子模块】按钮可以继续添加所选模块的子模块，依此类推，不再多做阐述

2.2.2 排序、编辑、删除模块

a. 将鼠标移动到任意模块的【排序】文字上会出现拖动图标，可以对该模块进行任意拖动，重新排序（注：只支持同层级间的排序）

b. 点击【编辑】按钮可以对指定模块进行信息重编，包括改名、更换所属产品、更换上级模块等

c. 点击【删除】可以删除当前所选的模块

2.3 维护计划

2.3.1 创建计划

a. 点击【产品】，然后点击【计划】，最后点击界面最右侧的【创建计划】按钮来完成新计划的创建，如下图：

b. 见2.3.1图，可根据【未过期】、【已过期】和【全部】对计划进行过滤

c. 见2.3.1图，每条计划的最右侧的操作列里有4个图标；特别注意第1个图标【关联需求】和第2个图标【关联bug】

e. 其实计划很好理解，就是产品的1个计划而已，我们要完成哪些需求？要完成哪些bug的修复？

f. 在计划里关联过的需求和bug，在它们各自的模块里也能显示计划名

2.4 维护需求

2.4.1 创建需求

a. 点击【产品】，然后点击【需求】，最后点击【提需求】可以进去添加需求界面，见下图：

b. 见上图，注意需求描述的格式以灰色字体显示（这的确是敏捷里标准的需求描述）

c. 见上图，产品、模块、计划以及优先级都可以设定

d. 拿模块举例，如果需求关联了模块A，那么只有模块A里能看到这条需求

2.3.2 需求变更

a. 点击下图中操作栏里的第一个图标可以对需求进行变更

b. 需求变更界面的最下面是需求变更影响性分析，见下图：

c. 如果项目、Bug和用例绑定过这条需求，则被显示于此

d. 需求界面也可以直接建用例，在最右侧操作栏的第5个图标

2.5 版本发布

2.5.1 创建发布

a. 点击【产品】，点击【发布】进入浏览发布界面

b. 点击【创建发布】可以新建1个发布版本记录

c. 点击发布记录最右侧操作栏里的第1个按钮【关联需求】可以关联所有本次发布需要完成的需求

d. 点击第2个按钮【关联bug】可以关联所有本次发布需要关联的bug

e. 点击具体某条发布名称可以进入发布详情界面，可以查看该“发布”所完成的需求、解决的Bug以及遗留的Bug

f. 发布一般情况下都是整个软件生命周期的最后一个步骤

三、项目经理

3.1 创建项目

3.1.1 添加项目

a. 点击【项目】视图标签>>>点击页面最右边的【添加项目】进入添加页面，如下图：

b. 同样注意上图中的红框部分【访问控制】，请仔细阅读

c. 项目名称、项目代号、起始日期是必填项

d. 添加完毕后可以在项目主页查看到

3.1.2 项目的状态

a. 在项目主页点击某个项目的名称可以进入具体的项目信息的页面，除了一些刚才填写的项目信息外，还需要研究下项目的几个状态操作

b. 激活：即开始正式做项目，激活后项目状态变为进行中

c. 延期：这里的延期指的是延长工作周期，不是延期进行的意思

d. 挂起：挂起就是暂停这个项目，什么时候想重新做，就重新点击【激活】

e. 关闭：关闭项目后，项目状态会进入已完成

3.1.3 项目的类型

a. 短期项目

b. 长期项目

c. 运维项目：没有需求、bug、版本、测试功能，禁用燃尽图；没事千万别乱选

3.2 维护团队

3.2.1 团队管理

a. 点击【项目】>>>点击【团队】>>>进入团队成员页面，默认没有成员

b. 点击【团队管理】>>>进入成员添加页面，如下图：

c. 可以直接选择部门来快速添加成员，也可以直接复制之前的团队

d. 记得帮每个成员分配“可用工日”，即可用的工作日；然后分配可用工时/天

e. 受限用户默认都是【否】，如果选择【是】，那说明进入这个项目的黑名单了，那么之前如果项目的“访问限制”选择的是“自定义白名单（团队成员和白名单的成员可以访问）”，该用户就无法查询到项目了

f. 也可以删除成员，个人认为跟上面那条很冲突，如果你看某个员工不爽，删除就是了嘛，何必搞那么麻烦，加黑名单

3.3 关联产品

3.3.1 关于产品的关联

a. 产品关联在添加项目时进行

b. 产品和项目的关系是多对一，即多个产品可以同时关联到一个项目里去

c. 注意相同产品无法重复关联项目

d. 项目可以不关联产品

3.4 关联需求

3.4.1 新增需求

a. 点击【项目】>>>点击【需求】>>>需求页面最右边点击【新增需求】

b. 是的，没错，项目也可以新增需求的，和产品一样，只是按钮的名称不同而已，在产品里叫做“提需求”

3.4.2 关联需求

a. 点击【关联需求】可以为项目关联已有需求

b. 已经关联过的不再显示于“关联需求”页面

c. 所有关联过的需求都会显示于项目的需求列表或看板

3.4.3 需求的状态：

a. 激活

b. 草稿

c. 已变更

3.4.4 需求的细分

a. 在项目需求列表里点击需求名称可以进入需求编辑界面

b. 选择细分按钮拆分需求（敏捷的特性）

c. 细分完后，本需求自动关闭，细分后的需求不再显示在项目中，需要重新回到需求视图里去查看并重新分配项目（如果需要的话）

3.4.5 建用例

a. 可以直接建测试用例，不过一般不推荐

3.5 分解任务（项目管理的重头戏）

3.5.1 从需求直接分解任务

a. 点击【项目】>>>点击【需求】>>>进入需求列表>>>每一条需求的操作栏里都有【分解任务】按钮

b. 点击【分解任务】或【批量分解】来分解任务，如下图：

注：下面全部以【分解任务】为例

c. 指派给开发人员或者测试人员甚至是市场人员

d. “添加之后”的三个选项代表点击【保存】按钮后的去向，请仔细看文字

3.5.2 新建任务

a. 点击【项目】>>>点击【任务】>>>可以看到所有任务

b. 点击【建任务】同样可以新建任务

3.5.3 子任务

a. 可以为某个任务分解成很多个子任务

b. 所有子任务完成后，任务爸爸状态自动变为已完成

3.5.4 报表

a. 任务同样有报表，很多模块都有，比如需求模块，之前没提到，这里以任务为例，报表很有用，通过软件生产，直接贴到word里做测试总结或者测试报告时肯定会用到

b. 点击【任务】界面的【报表】按钮可以进入报表界面

c. 点击左侧的报表类型，然后点击【生产报表】可以产生各种丰富的报表，如下图：

四、研发人员

4.1 领取任务和Bug

4.1.1 领取任务

a. 点击【项目】视图标签>>>点击【任务】

b. 点击【指派给我】可以查询到所有“指派给我”的任务

c. 当别人和你说已经把任务指派给你的时候，你查询不到任何记录，请不要质疑别人，请看看你的项目选择是否正确，如下图：

d. 同理可得，模块的选择也要注意

e. 注意使用批量功能，非常好用

4.1.2 领取Bug

a. 点击【Bug】进入，和【任务】只有微小的区别，如下：

b. Bug界面里提供了一个强大的搜索功能

c. Bug界面里不再提供“模块的选择”，因为的确没有什么意义

d. 注意使用批量指派Bug功能

4.2 更新状态

4.2.1 更新任务的状态

a. 在任务列表里选中你需要操作的那一行任务

b. 在右侧的操作栏里点击【指派】同样可以指派给其他开发人员

c. 点击【开始】按钮，状态会变更为“进行中”

d. 点击【工时】，可以输入工时；注意，当剩余工时填写为的时候，系统会给出提示，确认后任务状态自动变为“已完成”

e. 点击【完成】，状态直接变成“已完成”，但仍然能在列表中看到

f. 点击【关闭】，状态变为“已关闭”，然后自动从默认列表里消失，点击【由我关闭】可以重新看到

4.3 完成任务和Bug

a. 完成任务上面已经写了

b. Bug的状态更新和完成其实和任务差不多的，最多只是按钮多少的区别，不再多做描述

五、测试人员

5.1 撰写用例

5.1.1 建用例

a. 点击【测试】>>>点击【用例】>>>进入用例页面，如下图：

b. 注意左侧的模块列表，准备将用例写在哪个模块下就点击那个模块，比如帐户管理的用例就写在帐户管理下，客户端下载的用例就写在客户端下载下，彼此都无法看到其他模块的用例。但是，他们的父级模块“百度网盘WEB版”能看到所有用例

c. 点击【建用例】开始写新的用例

d. 其它步骤都比较普通，一看就知道，讲一下分组的概念，为某一个步骤点击分组以后，然后再点击该步骤最右侧的【添加步骤】按钮，新的步骤将会以子步骤的形式来实现，注意，这里分组只能分一组，不能无限循环的继续向下分组，如下图：

e.另外要注意的是，分组后的步骤无法填写预期结果，只有它的子步骤可以填写预期结果

切换到高级表格

5.2 执行用例

5.2.1 执行用例的业务流

a. 点击【测试】>>>点击【套件】>>>进入套件列表

注：套件的概念就是“测试用例集”

b. 点击【建套件】>>>填写基本信息>>>注意访问权限“私有”和“公开”

c. 套件建完后会出现在条件列表中，此时，点击【关联用例】按钮将测试用例拉到这个套件里去；至此，套件建立完毕

d. 点击【测试单】进入测试单列表>>>然后点击【提交测试】按钮>>>输入信息并保存后，一个新的测试单就会显示在列表中

e. 关联用例到测试单，并使用刚才新建的套件关联，默认测试单状态是“未开始”

f. 执行测试单里的用例，执行完以后，记得点击【编辑】然后根据实际情况手动把测试单的状态改成对应状态“进行中”、“已完成”或“被阻塞”

g. 测试单的操作栏里可以【创建报告】

5.2.2 为什么要用测试单进行测试？明明很多地方都能执行测试用例嘛！

a. 项目视图里有测试单

b. 测试单可以生产测试报告

c. 行业标准

5.2.3 聊聊测试用例执行时的几个状态在禅道里的规则

a. 步骤的测试结果有4种“通过”、“忽略”、“失败”、“阻塞”

b. 所有步骤通过，则用例显示通过

c. 坑爹的所有步骤“忽略”在禅道里居然也是通过，这点有点不合理