禅道开源版对接研究
2021-09-16 16:55:07 0 举报AI智能生成
对接禅道api，第三方集成
作者其他创作
大纲/内容
帮助文档：https://www.zentao.net/book/zentaopmshelp/40.html
使用基本流程
产品经理-整理需求
1.创建产品
对应具体系统
比如：禅道专业版，禅道开源版，禅道企业版
2.创建需求（story）
提倡按照功能点的方式来写需求。描述一件事情，作为什么用户，希望如何，这样做的目的或者价值何在，这样有用户角色，有行为，也有目的和价值所在，非常方便与团队成员进行沟通。
步骤
1.使用产品经理角色登录系统
2.进入产品视图
3.点击二级导航的“ 需求”，在页面右侧，有提需求的按钮，并支持批量创建，点击新增需求的页面。
注意
需求评审，当我们选上不需要评审，这样新创建的需求状态就是激活的，否则只有指定人员进行评审通过后，才能转为激活状态。 只有激活状态的需求才能关联到项目中，进行开发
需求属于产品，必须关联产品
研发团队-实现任务
1.创建项目
2.确定项目要做的需求
迭代开发区别于瀑布式开发就是它将众多的需求分成若干个迭代来完成，每个迭代只完成当下优先级高的那部分需求。禅道软件中项目关联需求的过程，就是对需求进行排序筛选的过程
关联的需求状态必须是激活的（评审通过，不能是草稿）
3.分解任务，指派到人
测试团队-保障质量
测试，提交bug
对接ERP需求管理
API对接方式
在第三方应用中集成禅道
一、配置：用超级管理员用户登录禅道，进入后台 => 二次开发 => 应用，点击【添加应用】按钮新增一个应用
1、 应用名称、应用代号、密钥是必填项，代号只能为字母或数字的组合，密钥由系统自动生成。
2、 IP 和 描述为选填项。此处的 IP 是一个白名单，默认没有限制所有 IP 都可以访问。
3、和别的系统相互调用数据，免密登录必须是 关闭状态。
二、签名机制：API 请求格式为 /api.php? m=moduleName&f=methodName& params=params &code=code &time=timestamp &token=tokn。
m=moduleName&f=methodName& params=params 部分为数据请求参数，根据实际的需求进行设置。
code为应用代号，需要和禅道应用设置中保持一致。
time位时间戳，可以通过PHP的time函数得到。
token为数字签名，其算法为：code、密钥、time字符串合并，再进行 md5。
code为应用代号，需要和禅道应用设置中保持一致。
time位时间戳，可以通过PHP的time函数得到。
token为数字签名，其算法为：code、密钥、time字符串合并，再进行 md5。
页面直接调用
将访问的url地址中的html换成json，得到的就是json格式的数据
IT团队相关组织及用户对接
创建部门
把ERP 研发中心及其下级部门 推送至禅道
查询部门
GET http://192.168.1.223/zentao/api.php?m=dept&f=browse&id=1&code=erp&time=1631777389&token=782d12b7a568906557b620dc9db3bea1
新建部门
POST http://192.168.1.223/zentao/api.php?m=dept&f=manageChild&code=erp&time=1631777684&token=9c6d33cce13cd8fa7f5a88fd2de6c137
参数放请求体表单提交，具体参数参考页面请求
参数放请求体表单提交，具体参数参考页面请求
创建用户
把研发所有员工和用户信息推送至禅道
1. 获得sessionID
GET /zentao/api-getSessionID.json
GET /zentao/api-getSessionID.json
2. 验证用户身份
GET /zentao/user-login.json?account=超管账号&password=超管密码&zentaosid=sessionID
GET /zentao/user-login.json?account=超管账号&password=超管密码&zentaosid=sessionID
3. GET 创建用户,获取随机码
GET /zentao/api.php?m=user&f=create&code=erp&time=1631778167162&token=45a527447313f671a2ea88c1727be547&zentaosid=sessionID
GET /zentao/api.php?m=user&f=create&code=erp&time=1631778167162&token=45a527447313f671a2ea88c1727be547&zentaosid=sessionID
4. POST 创建用户,实现新增用户
POST /zentao/user-create.json?zentaosid=9e37aeac1f29eebc4ed2970ca37a6f00
具体参数参考页面请求及js代码。
password1和password2传值逻辑：md5(password1) + rand
verifyPassword：md5(md5(超管登录密码) + rand)
POST /zentao/user-create.json?zentaosid=9e37aeac1f29eebc4ed2970ca37a6f00
具体参数参考页面请求及js代码。
password1和password2传值逻辑：md5(password1) + rand
verifyPassword：md5(md5(超管登录密码) + rand)
禅道手动添加产品，产品名和ERP需求的主项目保持一致，ERP需求无主项目时，则关联默认产品
产品需求对接
需求api
根据id查询需求
GET http://192.168.1.223/zentao/api.php?m=story&f=view&id=1&code=erp&time=1631779789&token=09b88d2f70615a5bf92e0406755d5641
创建需求
POST http://192.168.1.223/zentao/api.php?m=story&f=create&code=erp&time=1631779695&token=e68ba6c1feac387371e64c6c42c520b9
创建需求后会返回新增的需求id,可以保存进ERP需求内，方便根据id查询禅道需求
定时脚本：把状态为“待分配开发”的ERP需求推送至禅道，默认状态为“激活(active)”，默认研发阶段为“未开始”
禅道软件设计的需求由状态和研发阶段，两个字段来跟踪它的变化
一、需求的状态(status)
草稿(draft)、激活(active)、已变更(changed)和已关闭(closed)
对应为需求的流程操作共有：创建、变更、审核、关闭、激活
二、需求的研发阶段(stage)
用来描述激活的需求在研发过程中所处的阶段
未开始、已计划、已立项、开发中、开发完毕、测试中、测试完毕、已验收、已发布
如果需求没有关联到项目，也没有关联到计划，则需求的研发阶段是"未开始"。
如果需求关联到了计划，还没有关联到项目中，则需求的研发阶段是"已计划"。
如果需求关联到了项目中，但还没有分解任务，则需求的研发阶段是"已立项"
如果需求关联到了项目中，且进行了任务分解
如果有一个开发任务进行中，并且所有的测试任务还没有开始，需求的研发阶段为“研发中”
如果所有的开发任务已经完成，并且所有的测试任务还没有开始，则为“研发完毕”
如果有一个测试任务进行中，则视为“测试中”
如果所有的测试任务已经结束，但还有一些开发任务没有结束，则视为"测试中"
如果所有的测试任务已经结束，并且所有的开发任务已经结束，则视为"测试完毕"
"验收"阶段是需要产品经理手工来进行确认的，确认后阶段改为“已验收”
产品→发布中关联的需求后，需求的研发阶段是“已发布”
定时脚本：检测ERP需求是否在禅道测试完毕。禅道研发阶段为“测试完毕”的需求对应ERP需求状态变为“待部署”
操作触发MQ：ERP需求状态变为“待分配开发”时，推送至禅道
0 条评论
下一页
