禅道开源版对接研究

帮助文档：https://www.zentao.net/book/zentaopmshelp/40.html

比如：禅道专业版，禅道开源版，禅道企业版

对应具体系统

1.创建产品

提倡按照功能点的方式来写需求。描述一件事情，作为什么用户，希望如何，这样做的目的或者价值何在，这样有用户角色，有行为，也有目的和价值所在，非常方便与团队成员进行沟通。

1.使用产品经理角色登录系统

2.进入产品视图

3.点击二级导航的“ 需求”，在页面右侧，有提需求的按钮，并支持批量创建，点击新增需求的页面。

步骤

需求评审，当我们选上不需要评审，这样新创建的需求状态就是激活的，否则只有指定人员进行评审通过后，才能转为激活状态。 只有激活状态的需求才能关联到项目中，进行开发

需求属于产品，必须关联产品

注意

2.创建需求（story）

产品经理-整理需求

1.创建项目

迭代开发区别于瀑布式开发就是它将众多的需求分成若干个迭代来完成，每个迭代只完成当下优先级高的那部分需求。禅道软件中项目关联需求的过程，就是对需求进行排序筛选的过程

关联的需求状态必须是激活的（评审通过，不能是草稿）

2.确定项目要做的需求

3.分解任务，指派到人

研发团队-实现任务

测试，提交bug

测试团队-保障质量

使用基本流程

1、 应用名称、应用代号、密钥是必填项，代号只能为字母或数字的组合，密钥由系统自动生成。

2、 IP 和 描述为选填项。此处的 IP 是一个白名单，默认没有限制所有 IP 都可以访问。

3、和别的系统相互调用数据，免密登录必须是 关闭状态。

一、配置：用超级管理员用户登录禅道，进入后台 => 二次开发 => 应用，点击【添加应用】按钮新增一个应用

m=moduleName&f=methodName& params=params 部分为数据请求参数，根据实际的需求进行设置。code为应用代号，需要和禅道应用设置中保持一致。time位时间戳，可以通过PHP的time函数得到。token为数字签名，其算法为：code、密钥、time字符串合并，再进行 md5。

二、签名机制：API 请求格式为 /api.php? m=moduleName&f=methodName& params=params &code=code &time=timestamp &token=tokn。

在第三方应用中集成禅道

将访问的url地址中的html换成json，得到的就是json格式的数据

页面直接调用

API对接方式

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参数放请求体表单提交，具体参数参考页面请求

新建部门

把ERP 研发中心及其下级部门 推送至禅道

创建部门

1. 获得sessionIDGET /zentao/api-getSessionID.json

2. 验证用户身份GET /zentao/user-login.json?account=超管账号&password=超管密码&zentaosid=sessionID

把研发所有员工和用户信息推送至禅道

创建用户

IT团队相关组织及用户对接

禅道手动添加产品，产品名和ERP需求的主项目保持一致，ERP需求无主项目时，则关联默认产品

GET http://192.168.1.223/zentao/api.php?m=story&f=view&id=1&code=erp&time=1631779789&token=09b88d2f70615a5bf92e0406755d5641

根据id查询需求

POST http://192.168.1.223/zentao/api.php?m=story&f=create&code=erp&time=1631779695&token=e68ba6c1feac387371e64c6c42c520b9

创建需求

需求api

草稿(draft)、激活(active)、已变更(changed)和已关闭(closed)

对应为需求的流程操作共有：创建、变更、审核、关闭、激活

一、需求的状态(status)

用来描述激活的需求在研发过程中所处的阶段

未开始、已计划、已立项、开发中、开发完毕、测试中、测试完毕、已验收、已发布

如果需求没有关联到项目，也没有关联到计划，则需求的研发阶段是\"未开始\"。

如果需求关联到了计划，还没有关联到项目中，则需求的研发阶段是\"已计划\"。

如果需求关联到了项目中，但还没有分解任务，则需求的研发阶段是\"已立项\"

如果有一个开发任务进行中，并且所有的测试任务还没有开始，需求的研发阶段为“研发中”

如果所有的开发任务已经完成，并且所有的测试任务还没有开始，则为“研发完毕”

如果有一个测试任务进行中，则视为“测试中”

如果所有的测试任务已经结束，但还有一些开发任务没有结束，则视为\"测试中\"

如果所有的测试任务已经结束，并且所有的开发任务已经结束，则视为\"测试完毕\"

如果需求关联到了项目中，且进行了任务分解

\"验收\"阶段是需要产品经理手工来进行确认的，确认后阶段改为“已验收”

产品→发布中关联的需求后，需求的研发阶段是“已发布”

二、需求的研发阶段(stage)

禅道软件设计的需求由状态和研发阶段，两个字段来跟踪它的变化

定时脚本：把状态为“待分配开发”的ERP需求推送至禅道，默认状态为“激活(active)”，默认研发阶段为“未开始”

定时脚本：检测ERP需求是否在禅道测试完毕。禅道研发阶段为“测试完毕”的需求对应ERP需求状态变为“待部署”

操作触发MQ：ERP需求状态变为“待分配开发”时，推送至禅道

产品需求对接

对接ERP需求管理

对接禅道管理软件开源版15.3