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  禅道一键安装包里安装渠成软件
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  安装swoole扩展
1.17  Docker方式部署禅道
2. 禅道介绍
2.1  关于禅道项目管理软件
2.2  如何获得支持
2.3  关注我们
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  去掉禅道访问地址中的zentao
8.2.6  linux一键安装包去掉禅道访问地址中的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  集成飞书消息通知
8.2.21  集成版本库、集成Jenkins,并进行构建
8.2.22  解决一键安装包密码口令弱的问题
8.3. 性能优化
8.3.1  nginx反向代理禅道502或504bad gateway错误
8.3.2  linux系统中配置session使用redis
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
刚哥
72654
最后编辑:王林 于 2021-11-02 13:51:30
分享链接
摘要:本文讲述如何在禅道中集成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通知的设置,集成了企业微信后,可以在企业微信里查看到禅道里相关的操作信息。

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

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


评论列表
黑山白水 2022-05-10 15:12:37
请问绑定了企业微信webhook后,企业微信中有重名人员,但是邮箱不重复,怎么绑定呢?我看绑定里面只显示了一个人员名称,谢谢
黑山白水 2022-05-10 15:41:57 回复
不好意思说错了,是钉钉的webhook
禅道-Bee 2022-05-10 17:36:59 回复
禅道中需要创建两个账号的,真实姓名可以加上部门作为区分。
黑山白水 2022-05-10 17:41:07 回复
你好,禅道里面我是创建了两个账号,真实姓名也不一样,但是绑定的时候,从钉钉里面查询到的只有一个用户,因为钉钉里面的真是姓名是相同的,这个是需要在钉钉里面也把真实姓名改成不一样吗?谢谢!
cuiping 2022-05-11 09:04:46 回复
钉钉名字上做下区分试下
黑山白水 2022-05-11 10:17:18 回复
你好,如果钉钉上名字做区分是肯定可以的,现在如果钉钉上不做区分,是没办法处理同名问题的对吧,因为绑定钉钉账号时候,好像只显示姓名。谢谢!
cuiping 2022-05-11 11:14:49 回复
我们这里也记录下您反馈的问题
黑山白水 2022-05-11 13:10:17 回复
好的,谢谢,从钉钉拉取人员列表的时候,可以多加一个人员信息,比如邮箱或者手机号,这个一般都是唯一的。
cuiping 2022-05-11 17:46:58 回复
嗯,已经记录反馈了
苦瓜 2022-04-27 13:39:35
紧急bug通知,任务、bug超时未处理要怎么实现
于涛 2022-04-27 14:34:56 回复
后台-系统-定时 找到每日任务提醒,将这个定时任务开启下。
sky 2022-03-30 11:21:36
飞书应用消息webhoook,选择同步部门后,对应的人显示未绑定飞书,请问是什么原因?
禅道-阿龙 2022-03-30 13:14:14 回复
可以检查下是否在飞书应用中开通了禅道所需要的权限。
另外可以添加QQ2468103332,邀请您进群沟通问题。
天天 2022-03-01 22:13:28
12.5版本。webhook后台设置了所有类型的通知。结果只有创建和编辑发送了通知 。关闭和完成任务 都没有通知。从日志里也没有
马超 2022-03-02 16:15:13 回复
webhook 有多种类型的通知,例如,“钉钉通知机器人”、“钉钉工作消息通知”...请问下设置webhook什么类型的通知?
“钉钉工作消息通知”、“企业微信应用消息”、“飞书应用消息通知”这三种通知只能给指派人进行通知,抄送人是没有通知的。可以检查一下指派人是否有设置。
F 2022-02-16 15:17:08
webhook禅道端是否必须要配置ssl
禅道-阿龙 2022-02-16 17:26:45 回复
不需要的,按照手册配置就可以:https://www.zentao.net/book/zentaopmshelp/webhook-288.html
2022-01-27 13:26:09
比如,创建bug时,被指派者为:二狗,创建完成 只有二狗会收到通知,这个具体怎么搞呢
于涛 2022-01-27 13:31:14 回复
可以到后台-通知-设置 看下具体的动作触发指派,如果是集成的webhook的话,单独通知需要工作消息通知,不要集成群通知
蔡明 2022-03-29 17:57:59 回复
请问工作消息通知、集群通知这两种分类是企业版里面才具备的功能吗?
张彩玲 2022-03-30 08:20:37 回复
您好,开源版本也是支持的。
参考链接:
https://www.zentao.net/book/extra/email-notification-541.html
https://www.zentao.net/book/extra/542.html
ultrou 2021-12-27 13:33:05
客户端成员一直获取不到,转圈圈
王林 2021-12-27 14:33:40 回复
请问当前禅道、客户端、xxd 版本分别是多少?
之前客户端有出现过这个bug
可以分别升级禅道、客户端、xxd到对应的最新版本,然后再试试
2021-12-17 20:50:33
问下禅道webhook指定产品后就不往飞书发送消息,要是产品和项目都为空就没问题,指定具体某个产品怎么设置呢
禅道-金娟 2021-12-18 16:42:43 回复
您好,请加下QQ1826606239,拉您进我们技术支持群,我们技术同事帮您一起看看
2021-12-15 14:26:59
我想问下11版没有密钥的吗
马超 2021-12-15 15:01:49 回复
禅道11版本没有钉钉秘钥设置的,建议升级一下禅道的版本:
升级前请做好数据备份
备份请参考文档: http://www.zentao.net/book/zentaopmshelp/42.html
升级请参考文档: http://www.zentao.net/book/zentaopmshelp/41.html
小李 2021-11-25 11:38:35
禅道所在服务器无法直接连接互联网, 但可通过代理服务器上网,禅道是否支持通过代理服务器推送消息到企业微信
于涛 2021-11-25 13:46:39 回复
集成企业微信的首要前提是需要保证禅道服务器和企业微信webhook服务器是相通的,这个是物理条件,如果可以通过代理的方式实现网络通信,那么就可以去做集成实现消息推送的:)
1/6
发表评论
评论通过审核后显示。