4006-8899-23 0532-86893032
禅道二次开发手册 更多
1. 禅道API开发手册
1.1  配置使用与常见问题
1.2  调用SDK示例
1.3. 部门相关接口
1.3.1  获取部门列表
1.3.2  批量添加部门
1.4. 用户相关接口
1.4.1  获得添加用户所用的参数列表
1.4.2  添加单个用户
1.4.3  获取用户列表
1.5. 产品相关接口
1.5.1  获取产品列表
1.5.2  添加单个产品可选信息
1.5.3  添加单个产品
1.6. 项目相关接口
1.6.1  获取项目列表
1.6.2  添加单个项目可选信息
1.6.3  添加单个项目
1.7. 任务相关接口
1.7.1  获取任务列表
1.7.2  添加单个任务可选信息
1.7.3  添加单个任务
1.7.4  完成单个任务可选信息
1.7.5  完成单个任务
1.8. bug相关接口
1.8.1  获取Bug列表
1.8.2  添加单个Bug可选信息
1.8.3  添加单个Bug
1.8.4  解决单个Bug可选信息
1.8.5  解决单个Bug
2. 禅道API文档v1
2.1. Token
2.1.1  获取Token
2.2. 用户
2.2.1  获取我的个人信息
2.2.2  获取用户列表
2.2.3  获取用户信息
2.2.4  修改用户信息
2.2.5  删除用户
2.2.6  创建用户
2.3. 项目集
2.3.1  获取项目集列表
2.3.2  修改项目集
2.3.3  获取项目集详情
2.3.4  删除项目集
2.3.5  创建项目集
2.4. 产品
2.4.1  获取产品列表
2.4.2  创建产品
2.4.3  获取产品详情
2.4.4  编辑产品
2.4.5  删除产品
2.5. 产品计划
2.5.1  获取产品计划列表
2.5.2  创建计划
2.5.3  获取计划详情
2.5.4  修改计划
2.5.5  删除计划
2.5.6  产品计划关联需求
2.5.7  产品计划取消关联需求
2.5.8  产品计划关联Bug
2.5.9  产品计划取消关联Bug
2.6. 发布
2.6.1  获取产品发布列表
2.6.2  获取项目发布列表
2.7. 需求
2.7.1  获取产品需求列表
2.7.2  获取项目需求列表
2.7.3  获取执行需求列表
2.7.4  创建需求
2.7.5  获取需求详情
2.7.6  变更需求
2.7.7  修改需求其他字段
2.7.8  删除需求
2.8. 项目
2.8.1  获取项目列表
2.8.2  创建项目
2.8.3  获取项目详情
2.8.4  修改项目
2.8.5  删除项目
2.9. 版本
2.9.1  获取项目版本列表
2.9.2  获取执行版本列表
2.9.3  创建版本
2.9.4  获取版本详情
2.9.5  修改版本
2.9.6  删除版本
2.10. 执行
2.10.1  获取项目的执行列表
2.10.2  创建执行
2.10.3  查看执行详情
2.10.4  修改执行
2.10.5  删除执行
2.11. 任务
2.11.1  获取执行任务列表
2.11.2  创建任务
2.11.3  获取任务详情
2.11.4  修改任务
2.11.5  删除任务
2.12. Bug
2.12.1  获取产品Bug列表
2.12.2  创建Bug
2.12.3  获取Bug详情
2.12.4  修改Bug
2.12.5  删除Bug
2.13. 用例
2.13.1  获取产品用例列表
2.13.2  创建用例
2.13.3  获取用例详情
2.13.4  修改用例
2.13.5  删除用例
2.14. 测试单
2.14.1  获取测试单列表
2.14.2  获取项目的测试单
2.14.3  获取测试单详情
2.15. 反馈
2.15.1  创建反馈
2.15.2  指派反馈
2.15.3  关闭反馈
2.15.4  删除反馈
2.15.5  修改反馈
2.15.6  获取反馈详情
2.15.7  获取反馈列表
3. 定制开发
3.1  二次开发机制
3.2  禅道的目录结构
3.3  找到要修改的文件
3.4  禅道的数据库结构
3.5  公用模块--common
3.6  如何登记菜单
3.7  如何登记权限
3.8  示例：如何修改禅道的语言提示？
3.9  示例：创建bug时可以设置优先级字段
3.10  使用在线扩展编辑器
3.11  二次开发编辑器和翻译功能限制使用说明
3.12  禅道项目管理软件打包规范1.1版本

禅道的目录结构

2010-08-27 14:44:58
王春生
102872
最后编辑：雷勇 于 2020-02-19 16:43:02
分享链接
摘要：本篇文章讲述禅道的目录结构。

了解了zentaoPHP框架的基本原理和二次开发机制之后，您对禅道项目管理软件的目录结构应该也比较熟悉了。

一、顶级目录结构：

  • bin目录是存放里禅道的一些命令行脚本；
  • config下面存放了禅道运行的主配置文件和数据库配置文件。
  • db下面是历次升级的数据库脚本和完整的建库脚本。
  • framework里面则是禅道php框架的核心类文件。
  • lib目录下面是其他几个类文件。比如数据库访问，发送邮件，数据验证等。
  • module下面则是存放了具体的模块。禅道目前已经有30余个模块了。
  • tmp目录是禅道程序运行时的临时文件存放目录。
  • www目录则是存放了各种样式表文件，js文件，图片文件，以及禅道的入口程序，index.php

二、www目录

  • data目录是上传附件所在的目录。
  • fushioncharts则存放了报表解决方案所需要用到的flash文件。
  • js目录下面则是禅道用到的各种jquery插件和相应的功能函数。
  • theme目录则是样式表文件的目录。
  • www根目录下面的index.php是整个禅道程序的入口程序。所有的请求都是通过这个程序进入的。
  • install.php则是安装程序。
  • upgrade.php是升级程序，每次升级的时候需要访问这个文件。
  • .htaccess和.ztaccess文件是apache使用的配置文件。可以在rewrite模块打开的情况下，配置禅道使用静态方式访问。

三、module目录

module目录下面总共有30多个模块，分别对应了禅道里面的某一个功能模块。整个禅道的功能，就是由这些模块组合而成。让我们来看一个具体的模块。

  • lang目录下面存放的当前模块的语言文件。zh-cn对应中文简体，zh-tw中文繁体，依次类推。如果需要修改禅道里面某些字段的名称或者配置，则需要打开相应的文件进行修改。
  • view目录下面存放了每一个页面所对应的模板文件。比如bug浏览页面，对应的模板就是browse.html.php。
  • config.php存放了当前模块相应的配置项。
  • control.php则是整个bug模块所有页面的入口。也就是说，bug相关的页面浏览都可以在这个文件里面找到相应的方法定义。
  • model.php则是bug相关数据库操作的方法列表。
发表评论
评论列表
ranran 2021-09-03 14:12:38
开源版没有看到fushioncharts相关内容啊
禅道-Bee 2021-09-03 15:58:23 回复
是需要了解禅道的统计功能吗？可以看下这儿能否帮到您：https://www.zentao.net/publicclass/zentao-statistics-80214.html
钟 2021-06-15 11:41:34
请问如何在任务列表界面将任务所属项目名称显示出来。
于涛 2021-06-15 13:12:11 回复
您好，项目-任务列表右上方有个小齿轮的图标可以点击设置下自定义显示的列，不过任务列表目前还没有所属项目列，我们的企业版有强大的工作流功能，可以针对禅道内置的流程自定义添加字段用于列表展示的，需要的话可以添加一下页面上方的商务QQ咨询一下。
John Fan 2021-02-23 18:55:08
您好，请问：

我们的禅道，安装在Linux上后添加了插件，可能还进行了升级（升级历史我找不到了），现在显示是11.6版本。问题是，需要迁移到Windows。

为了要把它迁移到Windows环境，下载了11.6.4Windows版，在Windows安装后迁移了数据库表，并替换zentao目录为Linux上的zentao目录，登录时显示：

Fatal error: The file D:\source\zentao11_6\zentaopms11_6_4run\xampp\zentao\module\my\ext\model\class\calendar.class.php was encoded by the ionCube Encoder for PHP 5.3 and cannot run under PHP 7.0. Please ask the provider of the script to provide a version encoded with the ionCube Encoder for PHP 5.6. in Unknown on line 0

18:48:18 The file D:\source\zentao11_6\zentaopms11_6_4run\xampp\zentao\module\my\ext\model\class\calendar.class.php was encoded by the ionCube Encoder for PHP 5.3 and cannot run under PHP 7.0.
Please ask the provider of the script to provide a version encoded with the ionCube Encoder for PHP 5.6. in Unknown on line 0 when visiting /zentao/index.php?m=my&f=index

我看windows版php目录里有php7ts.dll，好像确实是PHP7，而查待迁移的Linux禅道里PHP是5.4版。于是下载旧版Windows禅道（10.6版）从中取php目录，替换windows里的php目录，结果禅道启动失败。

如何才能成功把它从Linux迁移到Windows？

谢谢！
张玉洁 2021-02-24 09:14:08 回复
禅道迁移数据需要在同版本之间进行，如果目前使用的禅道页面右下角显示11.6版本，在新机器上也需要安装这个版本，然后迁移数据。在新服务器上搭建好相同版本的禅道 然后把数据库导出sql到新禅道中导入 附件（zentao/www/data/upload/1）拷贝到新禅道相同目录。可以参考迁移视频 http://www.zentao.net/video/c1456/p3.html 迁移中如果出现问题，可以添加网页上方QQ，邀请进群，方便截图排查问题。
Faith 2021-01-11 17:14:29
bug中优先级、严重程度默认值已经修改，是否能修改成空值，不进行选择优先级或严重程度，将有提示优先级或严重程度不能为空
王林 2021-01-11 17:32:55 回复
这个需要修改代码实现的
二次开发参考文档：
http://www.zentao.net/book/zentaopmshelp/156.html
http://www.zentao.net/book/zentaopmshelp/225.html

可以看下文件zentaopms/module/bug/contorl.php
东湖 2020-11-30 19:12:24
你好，关于日志咨询下：1）对于日志填报中，当日所涉及的所有项目的工时之和能否做个限制，比如不能大于12小时？2）日志填报完成后，能否增加审核功能，由相关项目的项目经理对于填报的本项目工时进行审核？谢谢！
张玉洁 2020-12-01 09:24:50 回复
您好，暂时没有这两项功能。可以尝试修改代码实现，二次开发参考文档：
http://www.zentao.net/book/zentaopmshelp/156.html
http://www.zentao.net/book/zentaopmshelp/225.html
盛光 2020-09-21 15:42:31
这个构建是项目中的版本（build）有关系吗？我们现在的做法是，jenkins构建成功后调用zentao的api生成一个版本build，不知道zentao有没有类似的功能。
（另外提一个这个评论内容输入框的问题，输入过程中按左右键会切换文章，本来是想在输入框中移动光标的，把刚才的输入全部清楚掉，输入了好多次才搞定）
王林 2020-09-21 17:36:00 回复
这个可能和您说的构建不太一样
禅道中集成jenkins的构建，是根据创建构建时设置的触发构建条件来自动创建构建的，不一定是build才创建构建，和禅道中项目-版本是没有直接关联关系的。
第二个问题没太明白什么意思，您可以添加页面上方QQ，邀请进群后具体问题截图咨询下呢。
MK 2020-02-20 11:15:30
在统计->组织->统计报表模块，能不能查询展示一个月内，各员工在每天的负载工时，希望可以查询到员工在一个月内那些时间被占用了，这些多项目查询人力资源时，可以更有效率地协调资源。当前的报表，只能查询到员工在一个月内占用的工时，但未体现具体在那些时间。
张玉洁 2020-02-20 13:30:34 回复
可以尝试一下专业版企业版的自定义报表功能，使用SQL语句自定义查询然后生成报表。参考手册：http://www.zentao.net/book/zentaoprohelp/229.html
程明 2019-07-10 16:57:42
相关的图标、logo，不得私自去除、修改、隐藏，图标和logo是指哪些，组织中公司名可以改吗
禅道-Bee 2019-07-10 17:34:41 回复
禅道相关的标识 logo都不可以私自去除，组织-公司，可以编辑的。
小宝 2019-04-19 14:41:21
在config.php 修改了cookieLife 怎么没有作用呢？它的时间是使用一次sid，时间自动往后扩大，如果直接是 time(); ，关闭浏览器后，sid还是不会失效, 怎么让sid失效呢？比如cookie过期后登录自动失效
石洋洋 2019-04-19 15:48:19 回复
1、关闭浏览器重新打开浏览器访问禅道如果cookies过期是会转到登录页面要求输入帐号密码登录的；
2、sessionsid这块需要看浏览器的机制，默认是关闭浏览器就失效的，新开浏览器会重新请求一个新的sessionsid的。
周 2019-03-19 20:55:24
请问如何在页面新增字段
王林 2019-03-20 09:11:46 回复
如果是需要新增禅道中没有的字段，这个要修改代码实现的
二次开发可以看下文档：
https://www.zentao.net/book/zentaopmshelp/225.html
https://www.zentao.net/book/zentaopmshelp/156.html
1/3 1 2 3
发表评论
评论通过审核后显示。