1. 安装禅道
1.1  选择适合您的安装方法
1.2  使用云禅道在线项目管理服务!
1.3  (推荐)windows用一键安装包安装
1.4  (推荐)linux用一键安装包
1.5  linux下用lampp集成包安装
1.6  使用源码包安装(MAC系统)
1.7  MAC下用XAMPP安装禅道
1.8  MAC下用XAMPP-VM安装禅道
1.9  禅道一键安装包里安装蝉知和ZDOO
1.10  使用源码包安装(各系统通用)
1.11  宝塔面板安装禅道
1.12  华芸NAS在线安装
1.13  Centos7.4系统下安装httpd,mariadb,php7.2环境运行禅道
1.14  Centos8系统下安装httpd,mariadb,php7.2环境运行禅道
1.15  安装ioncube扩展
1.16  Docker方式部署禅道
2. 禅道介绍
2.1  关于禅道项目管理软件
2.2  禅道介绍PPT下载
2.3  如何获得支持
2.4  关注我们
3. 升级禅道
3.1  选择和自己环境对应的升级方式
3.2  通过源代码方式升级(通用)
3.3  windows一键安装包的升级
3.4  linux一键安装包升级
4. 创建分组和用户
4.1  建立部门结构
4.2  添加一个用户帐号
4.3  批量维护帐号
4.4  设置分组,建立权限体系
5. 最简使用
5.1  使用禅道来进行项目任务管理
5.2  只使用禅道来做bug管理
5.3  只使用禅道来进行产品管理
5.4  个人使用禅道来做事务跟踪管理
6. 基本使用
6.1  禅道使用的基本流程和产品、研发、测试之间的三权分立
6.2  敏捷开发及scrum简介
6.3  禅道和scrum的对应关系
6.4  禅道的新手教程
6.5  创建第一个产品
6.6  添加第一个需求
6.7  开始第一个项目
6.8  确定项目要完成的需求列表
6.9  为需求分解任务
6.10  提交bug
6.11  视频教程:第一个演示项目
6.12  维护联系人
6.13  禅道的自定义功能
6.14  导入excel、csv参考文档
6.15  文档管理
6.16  工作方式的切换
6.17  操作获取积分功能
6.18  自定义必填项功能
6.19  如何排查产品、项目是否有访问权限
6.20  年度总结,工作内容统计一览表说明
7. 进阶使用
7.1. 使用流程
7.1.1  禅道使用流程图解
7.2. 个人管理
7.2.1  使用待办进行个人事务管理
7.2.2  关注需要自己处理的任务、需求、bug
7.2.3  通过我的档案查看或者修改个人信息
7.2.4  视频教程:禅道使用之个人篇
7.3. 产品经理篇
7.3.1  维护产品
7.3.2  维护产品线
7.3.3  创建和评审需求
7.3.4  变更和评审需求
7.3.5  需求的状态和研发阶段
7.3.6  需求的注意事项
7.3.7  维护产品模块
7.3.8  建立发布计划
7.3.9  建立发布
7.3.10  路线图
7.3.11  文档管理
7.3.12  主持产品会议
7.3.13  参与项目管理、演示和总结
7.3.14  需求的基本统计报表
7.3.15  视频教程:禅道使用之产品经理篇
7.4. 项目经理篇
7.4.1  建立项目
7.4.2  组建项目团队
7.4.3  确定项目要完成的需求列表
7.4.4  组织进行任务分解
7.4.5  召开每天的站立会议
7.4.6  通过燃尽图了解项目的进展
7.4.7  通过各种列表的各种功能了解项目进展
7.4.8  召开演示会议和总结会议
7.4.9  项目任务基本的报表统计
7.4.10  视频教程:禅道使用之项目经理篇
7.5. 开发团队篇
7.5.1  参加项目计划会议,分解任务
7.5.2  领取任务,并每天更新任务
7.5.3  通过看板和树状图查看任务
7.5.4  创建版本
7.5.5  申请测试
7.5.6  解决bug
7.5.7  文档管理
7.5.8  确认bug
7.5.9  视频教程:禅道使用之开发团队篇
7.6. 测试团队篇
7.6.1  维护bug视图模块
7.6.2  提交bug
7.6.3  验证bug,关闭
7.6.4  激活bug
7.6.5  找到自己需要的bug
7.6.6  维护测试用例视图
7.6.7  创建测试用例
7.6.8  测试套件、报告和公共用例库的维护
7.6.9  管理测试版本
7.6.10  执行用例,提交Bug
7.6.11  查看报表统计
7.6.12  视频教程:禅道使用之测试团队篇
8. 维护配置
8.1. 维护禅道
8.1.1  初始化管理脚本
8.1.2  备份禅道
8.1.3  恢复删除的资源
8.1.4  如何更新燃尽图
8.1.5  一键安装包如何实现mysql异机连接
8.2. 配置禅道
8.2.1  设置是否允许匿名访问
8.2.2  如何配置email发信
8.2.3  禅道云发信
8.2.4  如何成为超级管理员
8.2.5  配置禅道系统为静态访问
8.2.6  去掉禅道访问地址中的zentao
8.2.7  集成禅道和svn
8.2.8  集成禅道和git
8.2.9  在第三方应用中集成禅道
8.2.10  第三方应用配置免密登录禅道
8.2.11  第三方应用集成禅道客户端进行消息通知
8.2.12  集成webhook
8.2.13  集成ZDOO
8.2.14  客户端集成
8.2.15  禅道的翻译功能
8.2.16  浏览器通知的设置
8.2.17  集成钉钉工作消息通知
8.2.18  企业微信群机器人
8.2.19  集成企业微信应用消息通知
8.2.20  集成版本库、集成Jenkins,并进行构建
9. 定制开发
9.1  二次开发机制
9.2  禅道的目录结构
9.3  找到要修改的文件
9.4  禅道的数据库结构
9.5  公用模块--common
9.6  如何登记菜单
9.7  如何登记权限
9.8  示例:如何修改禅道的语言提示?
9.9  示例:创建bug时可以设置优先级字段
9.10  使用在线扩展编辑器
9.11  二次开发编辑器和翻译功能限制使用说明
9.12  禅道项目管理软件打包规范1.1版本
10. 其他相关
10.1  禅道所使用到的第三方代码
10.2  禅道FAQ
10.3  如何帮助禅道项目
10.4  禅道商业服务
10.5  禅道项目的贡献者
10.6  历史修改记录

集成webhook

2017-10-27 10:46:56
刚哥
43980
最后编辑:王怡栋 于 2020-03-11 09:09:33
分享链接
摘要:本文讲述如何在禅道中集成webhook。

禅道从9.6版本开始内置了集成webhook功能,可以在禅道内进行操作时发送 JSON 格式的数据到第三方hook地址,方便进行消息集成。下面介绍如何配置该功能。

一、配置

用超级管理员用户登录禅道,进入后台 => 通知 => webhook,点击【添加webhook】新增一个 webhook,如图:

名称hook 地址为必填项,其余为选填项,hook 地址从第三方获取。

发送方式为同步时,在禅道内进行操作之后立刻发送消息给 hook 地址。发送方式为异步时则需要打开 后台-计划任务 来定时发送。

关联产品关联项目为空时,对禅道内的所有操作都会发送给 hook 地址,否则只发送所选择的产品和项目相关的操作。

参数类型指发送的数据的属性,包括以下内容:


{
    "objectType": "",  //对象类型,可以为空
    "objectID": "",    //对象ID,可以为空
    "product": "",     //关联产品ID,可以为空
    "project": "",     //关联项目ID,可以为空
    "action": "",      //动作,可以为空
    "actor": "",       //操作者,可以为空
    "date": "",        //操作时间,可以为空
    "comment": "",     //备注,可以为空
    "text": ""         //操作内容,包含操作对象的url,必选。
}
触发动作指进行何种操作时,向设定的 hook 地址发送消息,如果全部为空则不会发送任何消息。对禅道二次开发有一定了解的同学可以通过扩展 zentao/module/webhook/config.php 文件来修改此项内容。

二、示例

1、钉钉

在钉钉中通过下图两种方式添加机器人,选择【自定义机器人】,按照提示操作。机器人添加完成后,在禅道中添加一个类型为【钉钉】的webhook,填入从钉钉机器人获取的 webhook 地址,即可发送消息到钉钉。钉钉的消息发送方式默认为同步发送,不能修改。目前钉钉对自定义机器人发送消息的频率做了限制,每分钟最多发送20条消息。




禅道11.7版本,把类型为 钉钉 改为 钉钉群通知机器人。为了适应钉钉群机器人的安全设置,在添加页面增加了密钥。

需要钉钉群主到钉钉里做设置。
下面我们具体介绍如何获取到钉钉群通知机器人的密钥。

1.1 钉钉群主登录钉钉桌面客户端,到群设置里,找到群机器人。




1.2  添加群机器人

点击添加群机器人,选择自定义类型。


目前钉钉群机器人支持自定义关键词、加签和IP地址(段)的安全设置。

禅道集成时,目前仅支持加签的方式,也就是把加签的安全设置的密钥复制,粘贴到禅道后台--通知--webhook的 钉钉群通知机器人类型的webhook的密钥栏里。


已添加的群机器人,在点击群机器人列表右侧的设置按钮,可以进如群机器人详情页面。

这样可以获取到webhook地址和加签安全设置的密钥。



2、企业微信

禅道11.7版本开始,webhook新增了企业微信类型。

可以和企业微信集成,禅道里的操作和消息可以发送到企业微信里。

2.1 添加“企业微信”类型的webhook

到禅道后台--通知--webhook里添加webhook,类型选择“企业微信”。

接下来,我们需要注册登录企业微信,获取webhook的地址。

获取“企业微信”的webhook地址,需要先登录 企业微信官网

注册企业微信,请按照要求填写企业基本信息和管理员信息。

注册登录成功后,可以到 我的企业 -- 权限管理 里根据使用需要设置其他的管理员信息。

因为webhook地址的获取,只能企业微信的管理员才能获取和查看到。

手机下载企业微信APP, 企业微信的管理员登录,到企业微信的基本信息里,通过点击“群机器人”,来查看到webhook地址。

把这个webhook地址复制,填写到禅道后台--通知--webhook,添加“企业微信”类型的webhook的地址栏,点击保存即可。

添加成功的“企业微信”类型的webhook。


2.2 “企业微信”类型webhook的使用

可以根据禅道后台--通知--设置里,webhook通知的设置,集成了企业微信后,可以在企业微信里查看到禅道里相关的操作信息。

登录企业微信时,会收到禅道里设置动作的消息通知。

可以查看到详细的操作信息。


评论列表
Neal 2020-07-08 11:46:54
想问下,我设置了webhook与叮叮绑定了,但是创建的BUG在群里没有任何消息显示,日志这里看到结果是errcode310000,这是什么问题?
石洋洋 2020-07-08 13:46:17
参考https://www.zentao.net/book/zentaopmshelp/webhook-288.html 看一下钉钉的安全设置中是否有问题。如果还有问题可以加本网页最上方的QQ或者电话微信,邀请入群后截图一下报错的具体界面看一下。
黄先生 2020-07-07 14:54:13
请问一下,我是12.3.2的开源版本,按着上面的WEBHOOK设置了对应的钉钉机器人,但是禅道的WEBHOOK推送不启效果,而且在WEBHOOK对应的日志中也没有任何内容,求助我是否没有设置对?
马超 2020-07-07 15:28:07
可以加一下左上角的商务联系方式,商务邀请进群后截图出来看下。
busky 2020-06-02 10:59:07
现在用的版本时9.7版本,在webhook里加了接口获取操作信息,但是在创建bug时设置了指派给谁,可是webhook里拿到的参数只有创建人信息,没有指派人的信息,有什么办法能取到吗?在指派操作时是可以取到指派人信息的
禅道-Bee 2020-06-02 14:21:04
这块可能需要修改代码实现,可以参考文档:
http://www.zentao.net/book/zentaopmshelp/156.html
http://www.zentao.net/book/zentaopmshelp/225.html
另外建议您这边先升级一下版本。11.0之前的版本不再提供支持了。
升级前请做好数据备份
升级请参考文档:http://www.zentao.net/book/zentaopmshelp/41.html
备份请参考文档:http://www.zentao.net/book/zentaopmshelp/42.html
今晚打老虎 2020-05-07 16:42:46
配置了webhook是钉钉的机器人链接,但是钉钉里收不到信息,禅道里也没有日志,不知道是啥原因。
马超 2020-05-07 17:19:25
后台-通知-webhook 点击日志按钮看下有什么报错吗?
如果上述解答没有解决您的问题,可以加一下左上角的商务联系方式,商务邀请进群后沟通。
song 2020-03-13 19:27:57
请问开源版有webhook吗?
禅道-Bee 2020-03-16 09:42:21
禅道从开源9.6版本开始内置了集成webhook功能;之前老版本的话,需要升级下,升级前请做好数据备份
升级请参考文档:http://www.zentao.net/book/zentaopmshelp/41.html
备份请参考文档:http://www.zentao.net/book/zentaopmshelp/42.html
风在 2020-03-13 10:49:41
管理员登录后未在后台-通知下找到webhook页面,管理员权限已检查,已全部开启;禅道版本:12.1,请问是什么原因呢
张玉洁 2020-03-13 13:12:42
使用超级管理员登录看一下,超级管理员一般是组织--用户页面中ID为001的用户。
刘宁 2020-03-09 22:47:27
webhook与钉钉配置成功后,有时候消息发送失败,查看日志时显示操作结果是”Moved“,是哪里有问题吗?
禅道-Bee 2020-03-10 08:12:44
可以联系下官网顶部的商务QQ,邀请加入技术交流群,群里具体截图看下报错信息。
2020-03-07 09:46:36
配置企业微信webhook怎么设置@禅道对应指派人
王林 2020-03-09 08:44:55
微信集成目前没有这个功能的。
Mijun 2019-12-09 14:22:51
我想按照需求,任务 ,bug的指派到人进行消息提醒,需要怎么处理呢,比如我内网有腾讯通和有度等内网使用的及时交流系统,我现在指派了任务 bug或者需求需要审核等等操作,我怎么用webhook发送到人的消息。
马超 2019-12-09 16:16:16
抱歉,目前没有和腾讯通和有度等交流系统做集成,目前禅道集成webhook软件有钉钉和企业微信,相关代码是开放的,贵公司也可以自己修改代码集成一下。
Mijun 2019-12-09 16:38:15
好的,正在研究中,谢谢及时回复
Mijun 2019-12-10 15:56:32
已搞定。
解文辉 2020-02-23 13:52:36
能否分析怎么解决的嘛
liuhongyu29 2019-08-29 09:51:23
我想知道这个链接到我的webhook后怎么接收参数,java 的springboot开发 谢谢
张玉洁 2019-08-29 17:28:21
禅道集成webhook参考手册http://www.zentao.net/book/zentaopmshelp/webhook-288.html
二次开发参考文档:
http://www.zentao.net/book/zentaopmshelp/156.html
http://www.zentao.net/book/zentaopmshelp/225.html
马超 2019-08-29 17:33:28
可以参考禅道api和二次开发的手册。
后台-二次开发-api,可以查看api接口;
禅道框架介绍文档:http://devel.cnezsoft.com/book/zentaophphelp/about-10.html
禅道二次开发手册:http://devel.cnezsoft.com/book/extension/intro-45.html
1/4
发表评论
评论通过审核后显示。