

首页  思维导图  详情



禅道开源版对接研究

2021-09-16 16:55:07   0  举报





AI智能生成

对接禅道api，第三方集成

对接

禅道

对接禅道

禅道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。

页面直接调用

将访问的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

2. 验证用户身份 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

4. POST 创建用户,实现新增用户 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)