禅道使用手册.docx
- 文档编号:30439965
- 上传时间:2023-08-15
- 格式:DOCX
- 页数:111
- 大小:9.92MB
禅道使用手册.docx
《禅道使用手册.docx》由会员分享,可在线阅读,更多相关《禅道使用手册.docx(111页珍藏版)》请在冰豆网上搜索。
禅道使用手册
禅道使用手册
1、安装禅道
为了简化大家在windows下面的安装,我们在xampp基础上做了禅道的windows一键安装包。
xampp是业内非常著名的AMP集成运行环境。
禅道的一键安装包主要在它基础上做了大量的精简,并集成了我们自主开发的集成面板,使用起来会更加方便。
关于xampp一键安装包,大家有兴趣可以访问下面的官方网站:
https:
//www.apachefriends.org/ (注:
这个是xampp官方网站,禅道一 键安装包不需要登录这个网址下载)。
禅道9.2.stable版本升级了Windows一键安装包。
禅道运行集成面板升级到2.0.0版本,我们有针对64位和32位分别打包,请根据自己的电脑下载对应的Windows一键安装包。
启用Apache用户验证,修改mysql密码的功能,新安装时会提示安装VC环境。
注:
windows一键安装包中已经集成了XXD服务,不需要再单独安装部署XXD。
一、Windows64/32位一键安装包的安装
1、运行Windows一键安装包
在我们的站点下载新的windows集成运行环境(.exe结尾)。
双击解压缩到某一个分区的根目录,比如c:
\xampp,或者d:
\xampp,必须是根目录。
进入xampp文件夹,点击start.exe启动禅道时,如果电脑没有安装过VC运行环境时,会提示安装VC++环境。
Windows一键安装包的运行需要安装VC++环境。
注意:
如果您遇到以下界面,请删除当前xampp包,然后下载 windows一键安装包(未加安全设置) 的包安装使用。
2、修改数据库密码
禅道服务启动后,会提示数据库密码太弱,建议修改密码。
会默认显示一个密码,你也可以自己设置一个密码,点OK后数据库密码会自动修改。
可以在控制运行面板左上角服务--修改数据库密码里查看到当前的数据库密码。
也可以在xampp/zentao/config/my.php里查看到数据库密码。
3、 Apache用户访问验证(注:
未加安全设置的一键安装包无此功能)
禅道启动后,默认是开启了Apache用户访问验证 ,如下图:
∙如果不想开启访问验证功能,可以把 集成面板最后一行左侧的对号去掉。
∙启用访问验证后,用户需要先输入集成面板最后一行的帐号密码(此帐号密码需要提供给所有禅道登录人员)才可以访问到禅道登录页面(登录页面需要输入禅道的
登录帐号方可登录,默认登录禅道帐号:
admin密码:
1123456)。
∙如果需要修改Apache用户访问验证的账号和密码,可以在运行集成面板 最后一行的“更改”按钮 进行修改。
4、超级管理员登录密码修改
超级管理员登录禅道后,一键安装包默认的账号密码是admin,123456。
系统会检测密码安全级别,提示修改弱口令密码,按照提示修改即可。
如果需要维护密码安全设置可以到 后台--安全 页面进行修改。
5、登录禅道数据库
禅道Windows一键安装包默认只能在服务器本机登录。
浏览器里输入 http:
//127.0.0.1:
端口号(apache端口为非80端口时,需要填写端口号),然后点击登录页面左下的 数据库管理。
即可进入禅道数据库登录页面。
在登录页面填写 xampp/zentao/config/my.php 里的对应参数,即可进入禅道数据库。
系 统:
默认选择MySQL。
服务器:
对应填写下图的$config->db ->host和port的参数。
比如下图 $config->db ->host='127.0.0.1', $config->db ->port='3306'。
那么服务器填写:
127.0.0.1:
3306。
用户名:
对应填写下图的 $config->db ->user='zentao' 。
那么用户名就应该填写zentao。
密 码:
对应填写下图的 $config->db ->password='',中单引号里的值。
(每个人的数据库密码会不一样,单引号里显示的值是什么,密码就填写什么)
数据库:
对应填写下图的 $config->db ->name='zentao' 中的zentao。
需要注意的情况:
如果准备登录禅道数据库时, 登录界面里显示为黄底的内容,是浏览器自动填充的数据。
这里填充的用户名和密码,其实和禅道的数据库用户名和密码是不一样的。
如果不做修改直接登录的话,是没有办法登录到禅道数据库的。
请按照以上的说明,填写禅道数据库登录的参数。
二、未加安全设置的Windows一键安装包的安装(9.2.stable以上版本的未加安全设置包+9.2.stable以前的一键安装包)
2.1在我们的站点下载新的windows集成运行环境(.exe结尾)。
2.2 双击解压缩到某一个分区的根目录,比如c:
\xampp,或者d:
\xampp, 必须是根目录 。
2.3进入xampp文件夹,双击start.bat(新的windows一键安装包右键以管理员身份运行启动禅道.exe)启动集成面板程序,界面如下:
2.4修改apache和mysql的启动端口(注意:
默认系统会自动切换可以使用的端口,如果需要指定特定端口可以按以下步骤操作):
1)、点击集成面板(运行xampp/启动禅道.exe后出现的控制台)左上角服务-卸载服务;
2)、点击集成面板左上角服务-配置默认端口,修改端口号后保存;
3)、退出集成面板后重新以管理员身份运行xampp/启动禅道.exe;
4)、点击启动禅道。
三、启动并访问禅道
3.1启动集成面板之后,点击“启动禅道”按钮,系统会自动启动禅道所需要的apache和mysql服务。
3.2启动成功之后,点击“访问禅道”,即可打开禅道环境的首页。
5秒钟之后,页面会自动跳转到禅道的页面。
3.3修改端口操作步骤:
运行xampp/start.exe后左上角服务-卸载服务 然后服务-配置默认端口保存后退出重新运行xampp/start.exe 点击启动禅道。
四、相关密码
4.1禅道项目管理软件的登录帐号是 admin,密码是 123456,请登录之后尽快修改自己的密码。
4.2mysql数据库的管理员默认帐号是 root,密码为 123456。
(如果您修改了root帐号的密码,请一定记得修改zentao/config/my.php里面的数据库密码)
4.3 数据库管理是使用的phpmyadmin程序,基于安全方面的考虑,只能在禅道所在的机器上面访问,从其他机器访问会被禁止。
(禅道服务器本机浏览器访问127.0.0.1,点击数据库管理。
)
五、关于该环境
5.1禅道访问地址为 http:
//禅道机器的ip地址:
端口号/zentao/,ip地址换成禅道机器实际的ip地址,端口号换成实际的端口号。
(查看电脑IP地址方法:
5.2该集成面板会自动安装apache和mysql为服务,服务名分别是apachezt,mysqlzt。
5.3该环境是从 xampp版本精简而来。
六、如果集成面板失败
如果无法通过集成面板启动禅道程序,我们还提供了命令行的控制脚本来启动禅道:
6.1切换到xampp\service目录
6.2 双击install.bat这个脚本,系统会自动尝试安装apache和mysql为服务,并启动。
6.3 安装成功之后,在这个目录下面会有port.apache和port.mysql来记录apache和mysql的端口号,如果您想更改端口,可以将这两个文件删掉,重新运行install.bat脚本。
2、禅道介绍
一、禅道项目管理软件是做什么的?
禅道由 青岛易软天创网络科技有限公司开发,国产开源项目管理软件。
它集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体,是一款专业的研发项目管理软件,完整覆盖了研发项目管理的核心流程。
禅道管理思想注重实效,功能完备丰富,操作简洁高效,界面美观大方,搜索功能强大,统计报表丰富多样,软件架构合理,扩展灵活,有完善的API可以调用。
禅道,专注研发项目管理!
二、为什么用禅道这个名字?
禅和道这两个字含义极其丰富,有宗教方面的含义,也有文化层面的含义。
禅道项目管理软件取其文化含义,期望通过这两个字来传达我们对管理的理解和思考。
这个名字是受《编程之道》和《编程之禅》这两本书的启发。
英文里面的禅为Zen,道为Tao,所以我们软件的英文名字为zentao。
三、禅道项目管理软件的设计理念
禅道项目管理软件的主要管理思想基于国际流行的 敏捷项目管理方法—Scrum。
Scrum方法注重实效,操作性强,非常适合软件研发项目的快速迭代开发。
但它只规定了核心的管理框架,还有很多细节流程需要团队自行扩充。
禅道在遵循其管理方式基础上,结合国内研发现状,整合了bug管理,测试用例管理,发布管理,文档管理等功能,完整的覆盖了软件研发项目的整个生命周期。
在禅道软件中,明确的将产品、项目、测试三者概念区分开,产品人员、开发团队、测试人员,三者分立,互相配合,又互相制约,通过需求、任务、bug来进行交相互动,终通过项目拿到合格的产品。
四、为什么选择禅道项目管理软件?
1. 禅道是专业的研发项目管理软件,非简单任务管理软件可比。
2.管理思想简洁实效,可以帮助企业实现快速敏捷开发。
3.功能完备,您无需再费心整合若干系统在一起使用。
4.源代码开源开放,有灵活的扩展机制,方便企业使用并二次开发。
5.国产软件,本地支持,操作习惯更符合国人。
6.自主开发的底层框架和前端UI框架,健壮稳定,界面美观,交互友好。
7.完善的社区机制,可以获得及时的技术支持和帮助。
8.零投入,相比动辄十几万的商业软件,您选择禅道没有任何风险。
9.禅道支持多种部署方式,可以私有部署,也可以选择云端服务。
10. 我们团队一直专注企业管理,持续迭代更新,不断完善软件。
五、禅道项目管理软件的主要功能列表:
1.产品管理:
包括产品、需求、计划、发布、路线图等功能。
2.项目管理:
包括项目、任务、团队、版本、燃尽图等功能。
3.质量管理:
包括bug、测试用例、测试任务、测试结果等功能。
4.文档管理:
包括产品文档库、项目文档库、自定义文档库等功能。
5.事务管理:
包括todo管理,我的任务、我的Bug、我的需求、我的项目等个人事务管理功能。
6. 组织管理:
包括部门、用户、分组、权限等功能。
7. 统计功能:
丰富的统计表。
8. 搜索功能:
强大的搜索,帮助您找到相应的数据。
9. 扩展机制,几乎可以对禅道的任何地方进行扩展。
10.api机制,所见皆API,方便与其他系统集成。
3、禅道升级
如果你现在使用的是windowsxampp集成运行环境,那么请按照下面的步骤进行:
一、升级步骤:
1.下载新的源代码包(zip格式)。
(注意,不是.exe的集成运行环境,如果你下载这个,会造成数据被覆盖)
2.将其解压缩到zentao安装目录下面的/xampp/zentao下面。
比如你原来是在c:
/xampp/目录下面,那么将源代码包解压缩到c:
/xampp/zentao,覆盖原来xampp/zentao目录下面的东西( 操作方法:
把zentaopms/下面的所有文件覆盖到xampp/zentao/下面)。
3.然后访问 http:
//localhost/zentao/upgrade.php ,按照页面提示进行升级就可以了。
如果是88端口的话,路径是 http:
//localhost:
88/zentao/upgrade.php
二、注意事项:
1.不要解压缩成c:
/xampp/zentao/zentao
2.不要将原来的程序移走,再解压缩新的版本,注意是覆盖!
3.不要下载.exe的一键安装包覆盖。
4.如果你使用的一键安装包版本比较旧,还需要修改下apache的配置。
如果想使用禅道客户端需要在\xampp\runner\res\apache\conf\httpd.conf文件中增加红框中的几行(如果已有这几行无需增加)。
然后重新启动apache服务。
复制以下文本增加在的红框的位置。
SetHandlerapplication/x-httpd-php
SetHandlerapplication/x-httpd-php
修改后如下:
4、创建分组和用户
4.1、建立结构部门
禅道安装成功之后,管理员的第一件要做的事情就是设置部门结构。
一、维护部门结构
1.以管理员身份登录;
2.进入组织--用户视图;
3.点击维护部门;(或者直接点击二级导航里的“部门”。
)
4.在部门维护页面,维护公司的组织结构即可。
二、维护子部门
点击部门名称,即可添加该部门的下级部门(子部门)。
下级部门添加成功后,即可在部门机构里查看到。
4.2、添加一个用户
部门创建之后,下一步的操作就是往系统中添加用户。
步骤如下:
1.进组织视图
2.选择用户列表
3.然后选择“添加用户”,即可进入添加用户页面。
4.用户添加完之后,即可将其关联到某一个分组中。
注意点:
1.从4.0版本开始增加了职位字段,在添加帐号的时候可以选择对应的职位。
职位会影响到指派列表的顺序,比如创建bug的时候,默认会把研发职位的同学放在前面。
职位还会影响到我的地盘里面内容的排列顺序。
比如产品经理角色的人登录之后,我的地盘首先会显示我的需求,而研发的同学登录之后,会看到我的任务。
2.用户的权限都是通过分组来获得的,因此为用户指定了一个职位之后,还需要将其关联到一个分组中。
3.其中源代码提交帐号是subversion或者其他源代码管理系统中对应的用户,如果没有启用subversion集成功能,可以留空。
4.3、批量维护账号
从4.0版本开始,我们提供了批量添加帐号的功能,可以很方便的批量创建帐号。
1.使用管理员登录禅道系统,进入“组织”页面。
2.选择“用户”,然后选择右侧的“批量添加用户”
除了批量添加用户,还可以在用户列表页面选择用户,进行批量编辑。
4.4、设置分组和建立权限
在禅道中,用户权限都是通过分组来获得的。
所以在完成部门结构划分之后,就应该建立用户分组,并为其分配权限。
有的朋友可能会问,用户分组和部门结构有什么区别?
我们来解释下这个问题。
部门结构是公司从组织角度来讲的一个划分,它决定了公司内部人员的上下级汇报关系。
而禅道里面的用户分组则主要用来区分用户权限。
二者之间并没有必然的关系。
比如用户A属于产品部,用户B属于研发部,但他们都有提交bug的权限。
一、创建分组
1.使用管理员登录禅道,进入组织视图。
2.选择权限分组,进入分组的列表页面。
3.点击新增分组,即可创建分组。
4.在这个分组列表页面,还可以对某一个分组进行权限的维护、成员维护、或者复制。
二、维护权限
1.管理员身份登录
2.进入组织视图
3.点击”权限分组“,进入权限分组列表页面。
4.选择某一个分组,点击“权限维护”,即可维护该分组的权限。
5.进入权限列表页面,点击某一个模块名后面的复选框,可以全选该模块下面的所有权限,或者全部取消选择。
还可以查看某一个版本新增的权限列表,即下图的红框位置。
6.禅道7.2.stable版本开始,还提供视图维护权限。
可以设置某个分组仅能查看某个产品或者项目等。
7.限制访问框里填写了相关内容,就是表示该分组仅有权限访问限制访问框里的内容。
以下图为例:
允许访问视图:
全选的话,那么禅道导航栏里的主菜单(产品、项目、测试、文档、统计、组织、后台)都显示。
不勾选,导航栏就不显示,也无权限访问。
允许访问产品:
下图允许访问产品为 禅道项目管理软件 ,那么该权限分组的用户只能访问 禅道项目管理软件 这个产品,别的产品都没权限访问。
允许访问项目:
与允许访问产品的设置是一样的。
8.禅道9.6.2.版本,新增了 受限操作权限分组 。
组织--权限--受限用户分组,维护分组成员时,属于该分组的用户在禅道里 只能编辑与自己相关的 需求、任务、bug等 ,不能新增 需求、任务、bug等。
注:
与自己相关的内容,包含指派给、已完成、已取消、已关闭、最后编辑,不包含抄送给的内容。
如果该用户之前不是受限用户,现在是受限用户。
那么之前由他创建需求,任务,bug等,他都还有相关的操作权限。
比较适用于公司新来员工的权限设置,怕其不熟悉公司业务而导致误操作。
此外在 项目--团队--团队管理里,也增加了针对某个项目设置受限用户的功能。
如果某个团队成员设置为该项目的受限用户,那么该团队成员只能编辑该项目里与自己相关的任务、需求、bug等。
注意:
1、组织--权限-- 受限用户分组,设置的受限操作,是针对禅道整个系统的使用受限。
2、项目--团队--团队管理里,设置的受限用户,是只针对某一个项目的受限操作,其他项目不受影响。
3、 如果该用户之前不是受限用户,现在是受限用户。
那么之前由他创建的与该项目相关的需求,任务,bug等,他都还有相关的操作权限。
权限维护的注意事项:
1、一个用户在多个权限分组里,其在禅道里的权限取的是各个权限分组里权限的合集。
2、要访问到一个Bug,必须同时拥有Bug所在产品,项目的访问权限和Bug详情的权限。
3、产品/项目还可以通过访问控制来设置查看权限。
产品/项目--概况里,编辑访问控制:
默认设置,私有产品/项目,自定义白名单来调整产品/项目的查看权限。
4、禅道里权限分配比较灵活,可以根据实际需要做调整。
5、没必要过于的纠结权限的分配,禅道里每个操作都会记录,在详情页的历史记录可以查看到。
三、维护成员
1.管理员身份登录
2.进入组织视图中的权限分组。
3.点击”成员维护“,进入用户维护页面。
5、简单使用
5.1使用禅道进行项目任务管理
禅道的定位不是那种简单的任务管理软件,而是专业的协同管理软件。
研发类的项目管理本身具有其复杂性,所以禅道提供的都是必备的功能。
但这并不意味着您必须按照禅道的流程来使用,完全可以按照自己的实际情况来使用禅道。
下面让我们来看下使用禅道的简单方式。
一、创建项目
添加新项目的入口有多个,进入项目视图,可以在左侧1.5级导航的下拉菜单中直接点击“添加项目”。
或者在项目主页的项目总览区块中点击“添加项目”。
在项目添加的页面中,设置项目名称、代号、起止时间、可用工作日、团队名称、和项目描述等字段。
其中关联产品是可以为空,也可以多选。
二、设置团队
点击保存按钮,会提示项目创建成功,然后可以选择设置团队。
或者从项目视图中的团队菜单,也可以进行项目的团队管理。
在维护项目团队的时候,需要选择都是哪些用户可以参与到这个项目中,同时需要设置这个用户在本项目中的角色(角色可以随便设置,比如风清扬,冬瓜一号等)。
可用工作日和可用工时每天需要仔细设置。
通常来讲,一个人不可能每天8小时投入,也不可能一星期七天连续投入。
设置完毕之后,系统会自动计算这个项目总得可用工时。
三、分解任务
设置了团队之后,下一步操作就是创建任务。
∙在创建任务的时候,指派给是从项目团队成员中读取。
∙姓名列表中的首字母可以用来快速筛选用户。
∙任务的优先级、预计工时(单位小时)都需要进行设置。
∙如果需要设置任务必须在某一个时间点截止,可以设置截止日期。
∙可以上传附件。
四、管理任务
任务分解完毕之后,每个人就非常清楚自己做什么事情。
所以项目启动之后,对于项目团队的成员来讲,他要做的事情就是更新任务的进度和状态。
任务的列表:
在任务的列表页面,可以看到系统中所有的任务列表,可以通过各种标签方便的进行筛选。
点击某一个任务的名称进入详情页面。
任务的详情页面:
在任务的详情页面可以看到任务的详细信息,包括历次的修改记录等信息。
同时也给出了各种操作的按钮。
开始任务:
开始某一个任务的时候,可以设置已经消耗的时间和预计剩余的时间。
单位都是工时。
更新任务工时:
点击操作栏里的“工时”按钮,通过更新工时消耗,来管理任务执行进度。
完成任务:
完成任务的时候,需要设置下已经消耗的时间。
关闭任务:
任务完成之后,点击操作栏里的“关闭”按钮,将该任务关闭,这个任务就结束了。
上述就是使用禅道来进行简单的项目和任务管理,怎么样?
还是很简单的吧。
下面让我们来看下只使用禅道来进行bug的跟踪管理。
5.2、使用禅道进行bug管理
禅道的测试功能也可以独立出来单独使用。
这种方式很适合于测试团队使用。
禅道里面的bug基本流程是:
测试人员提出bug->开发人员解决bug->测试人员验证关闭。
下面我们来演示下具体的使用方法。
一、创建产品
使用 bug管理功能之前,需要先创建产品。
禅道里面设计的理念是bug主要附属在产品概念下面的,后面我们会详细讲述产品和项目之间的关系。
添加产品的入口有多个,可以在产品视图中的1.5级导航下拉菜单中直接点击“添加产品”。
也可以在所有产品页面点击右侧的“添加产品”按钮。
新增产品的时候,需要设置产品的名称、代号,几个负责人信息。
二、提出bug
有了产品之后,我们就可以来创建bug了。
∙在创建bug的时候,必填的字段是:
影响版本,bug标题,所属模块。
∙所属项目,相关产品,需求可以忽略。
∙创建bug的时候,可以直接指派给某一个人员去处理。
如果不清楚的话,可以保留为空。
三、处理bug
当一个bug指派给某一位研发人员之后,他可以来确认、解决这个bug。
在对bug进行处理之前,需要先要找到需要自己处理的bug。
禅道提供了各种各样的检索方式,比如指派给我,可以列出所有需要我处理的bug。
确认bug:
确认该bug确实存在后,可以将其指派给某人,并指定bug类型、优先级、备注、抄送等。
解决bug:
当bug修复解决后,点击解决,指定解决方案、日期、版本,并可将其再指派给测试人员。
关闭bug:
当研发人员解决了bug之后,bug会重新指派到bug的创建者头上。
这时候测试人员可以来验证这个bug是否已经修复。
如果验证通过,则可以关闭该bug。
(bug列表页和详情页中都有“关闭”按钮。
)
编辑bug:
对bug进行编辑操作。
复制bug:
复制创建当前bug,在此基础上再做改动,避免重新创建的麻烦。
5.3、使用禅道进行产品管理
前面两篇文章讲述的禅道的简流程,是分别站在研发团队、测试团队角度展开的。
研发团队可以使用禅道来做基本的任务跟踪管理,测试团队可以使用禅道来进行缺陷的跟踪管理。
那么如果您是一位产品经理,您肯定要问了,禅道能不能用来当作 需求管理工具呢?
答案当然是Yes!
禅道系统中提供了完整的需求管理流程,这其中包括需求的创建,需求的变更,需求的评审等。
下面让我们来看下。
一、创建产品。
创建需求的前提当然是要有产品,这和bug的处理是一样的。
新增产品的时候,需要设置产品的名称、代码,几个负责人信息。
二、创建需求。
有了产品之后,就可以来创建需求了。
需求的创建页面
∙创建需求的时候,可以选择需求的来源。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 使用手册