禅道使用

常见问题

  1. 视频教程: 《文档下载为什么乱码》

    可在导出文档时尝试切换编码导出。

  2. 视频教程: 《禅道哪些情况会发送邮件》

    可以登录禅道系统到”后台-通知-设置界面”设置自主设置触发通知的动作。

    禅道邮件默认通知范围:
    BUG:指派给+抄送 添加,编辑,指派,确认BUG,解决,激活,关闭,导入到项目;
    需求:指派给+抄送 添加,编辑,变更,激活,评审,关闭,更改计划,更改分支,更改阶段,指派;
    任务:指派给+抄送 添加,编辑,指派,开始,完成,激活,关闭,取消,重启;
    测试版本:负责人+抄送 创建,编辑;
    需求关联到项目后需求变动会给所有项目成员发邮件;
    项目版本提交测试给测试负责人发邮件;

    发布也会进行邮件通知。

    注意:

    1、“后台-通知-邮件”需保证发信功能已经配置成功;
    2、需要在“后台-人员-列表”需要维护好账号的个人邮箱信息;
    3、禅道不会给当前操作者发信。


  3. 视频教程: 《如何查看所有产品的需求列表》

    通过“产品-软件需求”界面上方的搜索功能,设置查询条件:“所属产品=全部产品”,点击“搜索”即可查看所有产品的需求列表。

  4. 视频教程: 《禅道的模块同步规则》

    禅道的模块同步规则:

    1、产品的模块会全部同步到BUG、用例中;
    2、产品的模块会选择性的同步到任务中:在“执行-任务”列表页面点击左侧“模块设置”,选择 “是否显示完整产品模块”,如果选择显示,产品的模块会全部同步到任务中;如果选择不显示,则具体规则如下:
    1)“项目”中关联的需求在“产品”中的“模块”。比如产品模块A下面有4个需求,项目都没有关联,那么在“项目”中是不会显示模块A的,只要关联了4个需求中的任何一个及以上,项目模块就可以显示模块A;
    2)创建任务时可以选择产品的某个模块(即使没有关联该模块下的需求,在创建任务时也可以关联),创建任务后也会显示出该模块。
    备注:任务、BUG、用例都可以维护自己的单独模块。
  5. 视频教程: 《为什么任务的工时不能自动计算》

    原因:

    任务的工时有:“最初估计“、”已消耗“和”预计剩余“。
    禅道目前的设计方案更侧重于“引导用户真实评估剩余工时”。
    如果实现自动计算,大多数用户就不会重新进行评估,无法体现任务真实的剩余工时,燃尽图无法更准确地反应项目的进度。
  6. 视频教程: 《任务工时是否可以用天数计算》

    不能。禅道目前所有的任务工时都是用小时计算,如果单位是天,表示任务的颗粒度比较大,在执行过程中理解和估算的偏差都会大一些。

    任务颗粒度小的好处:
    1、工作内容更明确,可以减少理解偏差的产生;
    2、估算更精准,有利于项目的进度控制;
    3、更快的任务进度体现,有利于项目风险的及时展示。
  7. 视频教程: 《任务是否可以指派给多个人》
    可以。两种操作方式:
    1、创建任务时可以选择“多人任务”(多人串行进行一个任务);
    2、已经创建的任务可以分解多个“子任务”(每个人一个任务,可并行执行);
    3、创建任务时,类型选择“事务类型”,指派人可多选(每个人一个任务,可并行执行)。
    注意:一个任务只能是多人任务和父子任务中的一种。
  8. 视频教程: 《为什么创建任务的时候,指派给没有相关成员》

    创建任务时,“指派给”字段是从执行团队列表中读取的。若没有相关成员,说明还没有维护团队成员,需要先到“执行-设置-团队”,维护好团队成员再创建任务。

  9. 视频教程: 《为何创建了需求,项目或执行中关联需求时列表为空》

    具体原因有以下三点:

    1、“项目”或“执行”是否已经关联了需求所在的产品;
    2、“需求”的状态需要为激活状态;
    3、已经关联过的需求不会在关联页面中列出。
  10. 视频教程: 《为什么任务完成之后会默认指派给其他用户》

    这是因为禅道的设计流程是当任务完成之后,需要有人进行确认。默认会指派给任务的创建者进行确认(可以在任务完成界面选择指派人)。

  11. 视频教程: 《如何设置项目集、产品、项目、执行只有相关人员可以访问》

    可通过设置项目集、产品、项目、执行的相应“访问权限”进行查看:

    1、项目集:创建、编辑项目集时可以设置“访问控制”为“私有”(项目集负责人和干系人可访问,干系人可后续维护);
    2、产品:创建、编辑产品时可以设置“访问控制权限”为“私有”(产品相关负责人、所属项目集的干系人、相关联项目的团队成员和干系人可访问);
    3、项目:创建、编辑项目时可以设置“访问控制权限”为“私有”(只有项目负责人、团队成员和干系人可访问);
    4、执行:创建、编辑迭代时可以设置“访问控制权限”为“私有”(团队成员和项目负责人、干系人可访问)。
  12. 关于上传附件的大小限制和时间限制:
    1、windows一键安装包最大附件默认设置成50M。
    如果还不够用,推荐把附件放到公共硬盘上,禅道中留下访问地址即可。
    一定要修改的话,可以修改 xampp/zentao/www/.ztaccess 和 xampp\runner\res\ztaccess\下面的default.access、pro.access 中的post_max_size 和upload_max_filesize值。


    2、如果是自己搭建的环境,php默认2M为最大附件。
    修改的话调整php.ini中的post_max_size和upload_max_filesize值,重启apache即可。

    3、如果是nginx服务器或者使用nginx代理,nginx有一个上传附件大小的配置client_max_body_size参数,默认是1M,调整后重启。

    4、文件上传时间限制默认为30s:
    自己搭建的环境修改参数:php.ini中的max_execution_time(最大不要超过60,不建议修改此参数)
    windows一键安装包:xampp/php/php.ini中max_execution_time(xampp\runner\res\php\php.ini 存在的话,也需要修改一下),调整后重启。

    windows zbox一键安装包:ZenTao\etc\phpphp.ini中max_execution_time,调整后重启。
    linux一键安装包:/opt/zbox/etc/php/php.ini也是修改这个参数并且重启。

  13. 视频教程: 《产品或项目删除后建不了同名的对象》

    这是因为禅道中的删除是标记删除(附件除外),可在“后台-数据-回收站”里还原,加上产品或项目的名称不能重复,所以删除后不能创建同名对象。

    如果一定要重新创建,可以先把删掉的产品或项目还原后修改名称再删除。
  14. 视频教程: 《Bug的版本怎么维护》

    在禅道中,BUG属性有两个版本:一个是解决版本,一个是影响版本。

    影响版本是指BUG在哪个版本上发现的;解决版本是指在哪个版本上修复的。
    版本在“执行-版本”中创建。
  15. 视频教程: 《如何设置不显示首页“最新动态”》
    可在“后台-人员-权限界面-视野“维护,取消”组织视图-组织动态“的相关显示权限。
    保存后重新登录就不显示动态信息了。
  16. 视频教程: 《如何修改云禅道邮件提醒》

    1、云禅道的每日提醒邮件是统一部署的,每天都会定时发送,不能单独设置;可以编辑用户资料,邮箱一栏留空,就不会收到邮件了。

    2、其他邮件通知可以到“后台-通知-设置“界面设置哪些动作进行通知。
  17. 1、登录禅道数据库zt_user表,找到用户的记录,把password的值改成 e10adc3949ba59abbe56e057f20f883e ,登录密码就是123456;
    2、管理员可以点击禅道登录页面“忘记密码”按钮,根据提示在禅道服务器上创建验证文件进行密码重置。
  18. 视频教程: 《有管理员权限,但无法查看别人创建的产品》

    禅道系统是有两种管理员权限的:

    1、超级管理员权限,不受任何权限控制(一键安装包默认为admin用户,源码部署即安装时自行设置的管理员账号);
    2、加入到管理员权限分组的账号,这些账号会受到权限分组的限制。如果需要将某个账号添加为超级管理员权限,可以参考这个手册:https://www.zentao.net/book/zentaopmshelp/107.html
  19. 视频教程: 《如何配置Email发信》

    可参照禅道发信配置文档:http://www.zentao.net/book/zentaopmshelp/96.html

    配置发信的邮箱没有限制,只要禅道所在服务器可以正常连接到邮箱服务即可。
    配置后点击“测试发信”,能收到测试邮件,说明发信成功。

    如果配置成功,没有收到邮件,请到发信邮箱的“发件箱”确认是否发送成功,到“接收邮箱”查看邮件是否发到了“垃圾箱”。

    使用QQ、163邮箱要注意:
    1、邮箱开启smtp服务(如果是刚刚申请的邮箱,需要过几天才能用smtp服务);
    2、ssl对应465端口,不加密对应25端口,应该有一个可以正常使用;
    3、smtp帐号需要填写完整的邮箱地址。
  20. 视频教程: 《如何控制客户只能看到其相关产品》

    客户提的需求应该经过产品人员整理后,把用于开发的需求录入到禅道中,“来源”可以选择“客户”。

    也可以使用收费版本的“反馈”功能,让客户直接提交反馈,具体可以参考:https://www.zentao.net/book/zentaobizhelp/266.html
  21. 视频教程: 《修改数据库密码后,禅道无法登录》

    登录数据库的密码修改后,需要在zentao/config/my.php文件中同步一下修改的密码。

  22. 视频教程: 《需求关联项目或执行后,能否移除再跟其它项目或执行关联》

    能。可在项目或执行的研发需求界面移除;另外,禅道里对需求的关联没有做限制,同一个需求可关联多个项目或执行。

  23. 视频教程: 《创建提交Bug指派给开发人员,为什么有的人看不到该BUG》

    BUG有“所属产品”、“所属项目”、“所属执行”3个属性,必须同时具有“产品”、“项目”和“执行”的访问权限才可以看到这个BUG。同时需要在“后台-人员-权限”中分配BUG的相关权限。

  24. 视频教程: 《回收站里数据怎么彻底删除》

    禅道界面上不能彻底删除。可以在“回收站”里隐藏,一定要删除的话只能到数据库进行删除。

    数据库删除方法:比如删除id是10的任务,登录数据库zt_task表找到id是10的编号记录。
    禅道数据库结构:http://www.zentao.net/book/zentaopmshelp/157.html
  25. 视频教程: 《产品里的计划和发布有什么区别》

    区别:

    计划是用来规划一个时间段内,需要完成哪些需求,解决哪些BUG。一般一个计划对应一个项目或迭代,项目的内容就是实现计划中的需求和解决计划关联的BUG。
    发布是需求开发完成后,对外发布软件或者产品上线。
  26. 视频教程: 《版本和发布所关联的需求和Bug有什么区别》

    创建版本中需求和Bug的概念:

    需求:项目关联的需求(开发完成或者关闭的需求会默认选中);
    Bug:与项目关联的非关闭的Bug(解决的Bug会默认选中)。
    创建发布中需求和Bug的概念:
    需求:版本所在项目关联的需求(开发完成或者关闭的需求会默认选中);
    BUG: 从版本所在项目的开始时间到当前解决了的当前产品的BUG(关闭或者解决的BUG会默认选中)。
  27. 视频教程: 《测试用例导入,点击保存后,怎么没有显示测试用例》

    可以参照禅道的导入格式说明: http://www.zentao.net/dynamic/79869.html

    注意以下事项:
    1、使用导出的模板导入;
    2、确认创建页面的必填项,如果导入的数据必填项没有值,这条数据会被过滤;
    3、导入数据如果标题有重名的只会保留一条;
    4、确认导入用例的所属模块和当前列表页面选择模块是否一致。
  28. 视频教程: 《Bug有预估工时功能吗》

    没有。但可以通过“迭代-任务-导入(右上角)”,将Bug导入进“迭代”中作为一个任务进行管理,就可以预估工时了。

  29. 视频教程: 《Bug可以关联需求和任务,不能关联用例吗》

    执行失败的用例可以提交Bug,Bug详情页面也可以建用例,已经存在的Bug和已经存在的用例不能关联。

  30. 视频教程: 《任务的完成、关闭有什么区别》

    区别:任务完成之后默认指派给任务的创建者进行确认,确认完成之后点击“关闭”,如果没有完成点击“激活”。

  31. 视频教程: 《在禅道中如何修改备注》

    需要同时满足3个条件:

    1、有修改备注的权限(在“后台-人员-权限”中维护);
    2、是本人自己添加的备注;
    3、只能修改历史记录最后一条记录中的备注。
  32. 这个是新版本新增的安全机制。
    可以编辑这个文件/zentao(pms/pro/biz)/config/config.php中config->file->allowed,将需要上传文件的后缀名添加到白名单中。
  33. 视频教程: 《禅道如何备份》

    1、超级管理员进入禅道“后台-系统-数据-开始备份”,可手动备份数据、附件和代码;

    2、超级管理员进入禅道“后台-系统--定时”,开启备份数据和附件计划任务后,系统会自动启动每日备份功能;
    3、参考禅道备份文档: http://www.zentao.net/book/zentaopmshelp/42.html
  34. 推荐使用Chrome、火狐、Microsoft Edge、Opera、Safari浏览器。
  35. 视频教程: 《多次输入错误密码,用户会被锁定,如何解决》

    1、管理员用户登录,在“后台-人员-用户”列表中,点击该锁定用户后面的锁图标,解锁;

    2、等待10分钟后,再次登录;
    3、到数据库找到zt_user表,把该用户的locked字段值改成:0000-00-00 00:00:00 。

  36. 视频教程: 《如何查看邮件发送记录》

    在“后台-系统-定时”,开启异步发信的计划任务,在“后台-通知-邮件”,选择“异步”,保存后可以点击“邮件列表”查看异步发信发送的所有邮件记录。里面可以显示发送的时间及发送结果,需要注意:发送成功的邮件会在2天后自动清理删除掉。

  37. 视频教程: 《为什么指派给用户Bug或任务,他没有收到邮件》

    1、点击“后台-系统-定时”,开启异步发信的计划任务,“后台-通知-邮件”选择“异步”,然后重新触发发信动作,5分钟后看“后台-通知-邮件-邮件列表”中是否有记录和结果;

    2、禅道不会给当前操作帐号发送邮件;
    3、被指派人是否在“后台-人员-用户”中维护邮箱。
  38. 视频教程: 《Bug可以只指派给团队成员吗》

    提BUG时不一定会关联所属项目或所属执行,且当前指派人员有可能为测试主管而非团队成员,因此只指派给团队成员是不严谨的。

    目前BUG当前指派显示规则如下:
    1、当BUG关联了所属项目,提BUG时,当前指派默认显示为该项目团队下的成员,点击“加载所有人员”可显示全部人员;
    2、当BUG关联了所属执行,提BUG时,当前指派默认显示为该执行团队下的成员,点击“加载所有人员”可显示全部人员;
    3、当BUG关联的所属项目为空,提BUG时,当前指派下拉列表默认为最近一次操作项目的团队成员,点击“加载所有用户”可显示全部人员;
    4、当BUG选择所属模块,提BUG时,当前指派会默认显示模块负责人。
  39. 视频教程: 《为什么文档库权限设为私有后,其他用户仍能访问》

    1、用户拥有产品或项目的访问控制权限,就拥有对应的产品文档库或项目文档库的访问控制权限,不受文档库访问控制权限的限制。

    2、可以在“文档-自定义库”中创建文档库,并设置文档库的访问控制权限。
  40. 视频教程: 《任务的“转入任务”功能,需要哪些条件》

    需要如下条件:

    1、之前的执行已经过期或者结束;
    2、当前帐号有权限访问之前执行;
    3、之前执行有未完成的任务,只能导入未完成的任务;
    4、新的执行和老的执行必须关联同一个产品;
    5、不能导入子任务;
    6、任务状态是以下状态中的一种:未开始、进行中、暂停、取消;
    7、如果任务关联了需求,那新的执行必须也关联这个需求所在的产品(如果是多平台/多分支产品,还需要新的执行关联了需求所在的平台/分支)。
  41. 视频教程: 《“后台-系统-定时”修改后为什么没有生效》

    修改后还需要执行如下操作:

    “后台-系统-定时-关闭 =》重启apache服务 =》 开启-后台-系统-定时”。
    目的是全部重新加载计划任务的配置,确保新的配置生效。
  42. 视频教程: 《禅道数据库结构(数据字典)在哪里可以查看》

    可以在“后台-二次开发-数据库“中查看数据库结构及相应字段的含义。

  43. 视频教程: 《禅道项目管理相关计算公式》

    禅道项目管理,相关计算公式:

    项目进度 = 项目下任务工时总消耗 /(项目下任务工时总消耗 + 项目下任务工时总剩余)
    执行进度 = 执行下任务工时总消耗 /(执行下任务工时总消耗 + 执行下任务工时总剩余)
    任务进度 = 消耗工时 /(消耗工时 + 剩余工时)
    工作负载 = 总工时 /(工作日天数 * 每天工时)
    执行可用工时 = 可用工作日 * 团队成员数 * 每日可用工时
  44. 视频教程: 《一个执行下的需求和BUG如何导入到下一个执行迭代中》

    1、需求:在“执行-需求-关联需求“界面手动关联一个执行未完成的需求;

    2、BUG:在新的执行“迭代-任务”界面右上角“导入-导入BUG”。
  45. 视频教程: 《用户(研发)需求拆分的条件》

    1、用户需要有批量创建需求的权限;

    2、需求状态需要是激活;
    3、需求没有被关联到项目或计划中。
  46. 视频教程: 《禅道无法正常登录的原因》

    1、检查服务器磁盘空间占用情况;

    2、检查session目录读写权限变化;
    3、检查浏览器是否开启自动密码记忆功能,建议手动输入;
    4、配置nginx代理后,需要在禅道的目录zentao(pro)/config/my.php文件中,加一行:$config->framework->filterCSRF = false。
  47. 视频教程: 《如何分析燃尽图》

    蓝色是每天实际的任务剩余工时之和;

    灰色是执行迭代开始日期所有任务预计工时汇总和迭代结束0点连成的线;
    蓝色线围绕着灰色线走 表示迭代进展比较顺利;

    燃尽图类型解析:https://blog.easycorp.cn/blog/80714.html?tdsourcetag=s_pcqq_aiomsg

  48. 视频教程: 《项目、执行和产品下提交的需求有何不同》

    需求默认是在产品下维护的,项目/执行下创建需求成功后,该需求会自动创建到当前项目/执行所关联的产品中,且自动关联到当前项目/执行。

  49. 视频教程: 《测试单、测试报告和测试任务的区别》

    测试单:针对版本创建的测试用例清单,由测试人员在测试单中执行用例;

    测试任务:测试人员在测试过程中的工作内容和消耗,可以维护在测试类型的任务中,算作测试任务。
  50. 视频教程: 《反馈邮件抄送规则》

    1、如果创建人创建反馈时设置了接收邮件通知,那这条反馈触发的邮件发送都会抄送给创建人;

    2、如果指派反馈的时候设置了抄送人,那这条反馈发送邮件的时候会给抄送人发送邮件;
    3、如果反馈关联了产品并且产品设置了反馈负责人,那发送反馈的时候会给当前产品的反馈负责人发送邮件。
  51. 视频教程: 《如何修改禅道访问端口》

    解决方法:

    1、windows一键安装包修改端口:
    运行"xampp/start.exe"后点击左上角"服务-卸载服务",然后"服务-配置默认端口"保存后退出,重新以管理员身份运行"xampp/start.exe" 点击"启动禅道"。
    2、linux 一键安装包修改端口:
    sudo /opt/zbox/zbox stop
    sudo /opt/zbox/zbox -mp 3307
    sudo /opt/zbox/zbox -ap 82
    sudo /opt/zbox/zbox start
    端口号,根据需要变更(mp是mysql端口; ap是apache端口)
  52. 这个是收件邮箱服务器上的规则决定的,禅道是无法控制的。
    可以使用 smtp服务发信,统一用企业邮箱发信,然后企业邮箱接收,一般就不会进入垃圾箱中了。
  53. 视频教程: 《执行、迭代、阶段的概念》

    在敏捷模型下,执行即迭代。

    禅道旗舰版增加了瀑布模型,在瀑布模型下,执行就是阶段。
    禅道统一将敏捷的迭代和瀑布的阶段整合到执行模块。
  54. 视频教程: 《Bug有效率如何计算》

    Bug有效率=(已解决+延期处理)/(设计如此+重复Bug+外部原因+已解决+无法重现+延迟处理+不予解决+转为需求)

  55. 视频教程: 《禅道可以导入导出任务、需求、Bug和用例吗》

    开源版可以导出csv、html、xml格式文档;

    收费版本会增加导入和导出xls、xlsx格式文档;
    开源版也可以通过安装excel导入导出的插件(http://www.zentao.net/extension-viewExt-27.html)来实现。

  56. 视频教程: 《需求版本如何维护》

    需求是有版本控制的,每次变更都会增加一个新的版本,可以在需求详情页面的标题右侧以 #1.2.. 展示。

  57. 视频教程: 《禅道后台-备份如何操作进行还原》

    方案一:

    1、搭建相同版本号的禅道,保证网页可以正常访问;
    2、拷贝备份文件到新禅道相同目录,分配读写权限;

    3、网页登录新禅道“后台-数据-备份”点击“还原”按钮进行还原。

    方案二:
    1、搭建相同版本号的禅道,保证网页可以正常访问;
    2、将备份文件sql.php用文本编辑器打开删除开头的 ,然后重命名去掉.php,然后导入禅道数据库中;
    3、将附件文件.file/upload/1目录全部放到新禅道zentao(pms)/www/data/upload/下面。

  58. 视频教程: 《如何查看禅道版本号》

    1、网页登录禅道所有页面右下角;

    2、网页登录禅道“后台-首页”查看;
    3、Linux一键安装包通过数据库查看:
    (1)进入数据库:/opt/zbox/bin/mysql -u root -P 3306 -p
    (2)选择zentao数据库:use zentao;
    (3)查看版本:select `value` from zt_config where `key`='version';
    4、windows一键安装包:xampp/start.exe启动后看控制面板,点击访问禅道,在禅道欢迎页点击数据库管理,选择 zentao库,找到zt_config表,查看字段key为version的那条数据的value值。
    5、config文件的version参数:zentao(pms)/config/config.php(开源版)
  59. 12系列禅道使用流程可以参考:https://www.zentao.net/book/zentaopmshelp/165.html

    15及以后版本使用流程可以参考:https://www.zentao.net/book/extra/503.html

  60. 在线预览是付费版本的功能,企业版及以上都可以实现,需要配置libreoffice或者collaboraoffice,通过collaboraoffice可以实现多人在线编辑的功能。
  61. 视频教程: 《如何关闭禅道登录需要输入验证码》

    1、在“后台-系统-安全”,点击“关闭登录使用验证码”;

    2、在数据库中将zt_config表中将 `key` = 'loginCaptcha' 的数据中value值设置为0 。
  62. 视频教程: 《查看任务进度和时间消耗》

    点击“执行-迭代-视图-分组视图”,左侧展开栏有对任务的统计。

  63. 文件基本信息在数据库表zt_file表,物理文件目录zentao/www/data/upload/1目录。
  64. 根据执行脚本的输出信息进行排错,常见的问题有:
    1. 首先检查宿主机的操作系统是否为Ubuntu或CentOS的发行版本。
    2. 检查你的网络是否畅通。
    3. 将软件包管理工具的下载源切换至国内源。
  65. 在宿主机上安装curl应用即可,以Ubuntu为例你可以执行以下命令:
    sudo apt install curl
    1. 通过远程桌面访问执行节点,确认执行节点已正常启动。
    2. 点击执行节点详情页面的检测服务状态按钮重新检测。
返回顶部
刘斌
高级客户经理
17685869372
526288068
统一服务热线 4006-8899-23
我要提问提问有任何问题,您都可以在这里提问。 问题反馈反馈点击这里,让我们聆听您的建议与反馈。