任务

获取执行任务列表分享链接 /book/api/715.html

作者：王怡栋最后编辑：宋辰轩于 2024-09-30 15:08:15 浏览量：18959

本篇目录

GET

/executions/id/tasks

获取执行任务列表

请求URL

https://xxx.com/api.php/v1/executions/id/tasks

请求头

名称	类型	必填	描述
Token	String	是	认证凭证Token

请求响应

名称	类型	必填	描述
page	int	是	当前页数
total	int	是	任务总数
limit	int	是	每页任务数
tasks	array	是	任务列表
∟ id	int	是	任务ID
∟ project	int	是	所属项目
∟ execution	int	是	所属执行
∟ module	int	是	所属模块
∟ story	int	是	关联需求
∟ name	string	是	任务名称
∟ type	string	是	任务类型(design 设计 \| devel 开发 \| request 需求 \| test 测试 \| study 研究 \| discuss 讨论 \| ui 界面 \| affair 事务 \| misc 其他)
∟ pri	int	是	优先级
∟ estimate	float	是	预计工时
∟ left	float	是	剩余工时
∟ deadline	date	是	截止日期
∟ consumed	float	是	消耗工时
∟ status	string	是	状态(wait 未开始 \| doing 进行中 \| done 已完成 \| closed 已关闭 \| cancel 已取消)
∟ desc	string	是	任务详情
∟ openedBy		是	创建人
∟ openedDate	datetime	是	创建时间
∟ assignedTo		是	指派给
∟ estStarted	date	是	预计开始日期
∟ realStarted	datetime	是	实际开始时间
∟ finishedBy		否	由谁完成
∟ finishedDate	datetime	否	完成时间
∟ closedBy		否	由谁关闭
∟ closedDate	datetime	否	关闭时间
∟ mailto	array	否	抄送给

响应示例

{
    "page": 1,
    "total": 1,
    "limit": 100,
    "tasks": [
        {
            "id": 18,
            "project": 12,
            "parent": 0,
            "execution": 13,
            "module": 0,
            "design": 0,
            "story": 0,
            "storyVersion": 1,
            "designVersion": 0,
            "fromBug": 0,
            "name": "task1",
            "type": "devel",
            "pri": 3,
            "estimate": 0,
            "consumed": 2,
            "left": 0,
            "deadline": null,
            "status": "done",
            "subStatus": "",
            "color": "",
            "mailto": [],
            "desc": "",
            "version": 1,
            "openedBy": {
                "id": 1,
                "account": "admin",
                "avatar": "",
                "realname": "管理员"
            },
            "openedDate": "2021-11-29T02:33:47Z",
            "assignedTo": {
                "id": 1,
                "account": "admin",
                "avatar": "",
                "realname": "管理员"
            },
            "assignedDate": "2021-11-29T02:52:25Z",
            "estStarted": "0000-00-00",
            "realStarted": "2021-11-29T02:50:00Z",
            "finishedBy": {
                "id": 1,
                "account": "admin",
                "avatar": "",
                "realname": "管理员"
            },
            "finishedDate": "2021-11-29T02:52:17Z",
            "finishedList": "",
            "canceledBy": null,
            "canceledDate": null,
            "closedBy": null,
            "closedDate": null,
            "planDuration": 0,
            "realDuration": 0,
            "closedReason": "",
            "lastEditedBy": {
                "id": 1,
                "account": "admin",
                "avatar": "",
                "realname": "管理员"
            },
            "lastEditedDate": "2021-11-29T02:52:25Z",
            "activatedDate": "0000-00-00",
            "deleted": false,
            "storyID": null,
            "storyTitle": null,
            "product": null,
            "branch": null,
            "latestStoryVersion": null,
            "storyStatus": null,
            "assignedToRealName": "管理员",
            "needConfirm": false,
            "progress": 100
        }
    ]
}

评论列表

😌

爱玩的毛衣 2025-06-18 09:44:57

开源版20.1.1，一定要根据ID获取任务列表吗，不可以一次获取所有任何列表吗？

⛄

马超回复爱玩的毛衣

2025-06-18 10:47:28

您好，目前只能根据执行ID，获取执行下所有的任务。

🌜

发财的机器猫 2025-02-08 10:34:14

开源版21.3 连续调用此接口时每个一次就会出现返回数据是空数组的情况和间隔时间没关系是什么情况

🚢

王林回复发财的机器猫

2025-02-08 11:16:49

本地搭建了禅道21.3版本在postman工具中进行测试，获取数据是正常的。
导致咱们这个情况的原因可能会比较多。
可以先试下通过postman这类的工具调用看下是否会有问题，如果使用这些工具是正常的，可以检查下实际调用接口的程序是否有什么限制。
另外也可以看下调用接口应用到禅道服务器之间网络上是否有什么频率限制。
方便的话，可以添加下页面上的联系方式，邀请进群后截图咨询下具体问题呢

🍻

机灵的地瓜 2024-12-19 09:18:48

请问创建任务怎么在任务描述（desc）放入图片？

⛄

马超回复机灵的地瓜

2024-12-19 10:03:17

通过接口创建任务目前不支持在任务描述中放入图片，可以通过任务附件上传，使用files[]参数

🍻

机灵的地瓜 2024-12-05 17:21:11

请问tasks返回的列表长度是有限制吗？total返回171，但tasks里面只有100个字典

🤖

金凯回复机灵的地瓜

2024-12-05 17:31:42

/executions/:id/tasks?limit=200&page=1
请求里添加分页参数看看

🍻

年轻有为的烤地瓜 2024-11-07 11:12:06

这个接口可以通过status过滤数据吗？

禅道-阿龙回复年轻有为的烤地瓜

2024-11-07 11:14:15

可以直接在params中上传参数stauts进行过滤试下。

罗先生 2022-11-04 09:22:29

怎么获取子任务呢，这个接口好像只返回了一级的任务

🌽

cuiping 回复罗先生

2022-11-04 13:28:18

接口应该并未区分任务类型，都可以获取的

非常重要的禅道网友 2022-10-23 19:52:54

有根据项目ID获取任务列表的接口吗？

🤖

金凯回复非常重要的禅道网友

2022-10-24 09:16:45

如果您是经典模式的话，项目其实就相当于项目集模式中的执行，使用获取执行任务列表这个接口就可以了

居居 2022-08-08 15:54:11

没有根据需求id获取任务列表的api吗

禅道-阿龙回复居居

2022-08-08 15:56:21

目前支持根据任务id查看任务详情的api，暂不支持按照任务id查看任务列表。

啊实打 2022-07-19 17:58:02

里面的：id是指那个id? 我没有执行啥，我点的地盘获取任务列表，没有什么执行呀

禅道-阿龙回复啊实打

2022-07-20 08:20:30

这里是新版本restful格式的api，需要升级到新版本的禅道才能使用，执行id为新版本禅道中任务所在迭代/阶段的id

啊实打回复禅道-阿龙

2022-07-20 08:52:07

开源版17.0是新版本吗？
新版本禅道中任务所在迭代/阶段的id 我看不太明白，能不能说的详细一点，应该在哪找。有步骤吗？

禅道-阿龙回复啊实打

2022-07-20 09:23:25

17.0属于新版本，可以看下新版本的说明：https://www.zentao.net/book/extra/471.html
如果有问题可以添加QQ2468103332，邀请您进群沟通。

禅道产品
禅道开源版禅道企业版禅道旗舰版禅道IPD版
核心功能
产品管理项目管理质量管理效能管理
使用文档
基本版手册企业版手册旗舰版手册 IPD版手册开发中心手册
帮助中心
积分问答常见问题论坛交流使用视频 Gitee GitHub
关于我们
关于我们禅道软件最新动态禅道活动
禅道社区
禅道博客积分排行积分商城禅道书院
联系方式
联系人：张淑钧电话：13156280939 微信：13156280939 Q Q：2082428410
北京、上海、深圳分部

友情链接： ZTF自动化测试框架 ZenData测试数据生成器喧喧IM 敏捷开发敏捷咨询测试窝悦库网盘 Ledge知识平台渠成软件 ZDOO全协同企业管理软件融管理社区 ZenDAS数据分析工具 ZenShot跨平台截图工具飞信钉即时通讯解决方案项目管理 IPD学习网 PMP百科网艾体验创无记2049

本篇目录

获取执行任务列表

请求URL

请求头

请求响应

响应示例

禅道产品

核心功能

使用文档

帮助中心

关于我们

禅道社区

联系方式

北京、上海、深圳分部