任务

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

作者:王怡栋 最后编辑:宋辰轩 于 2024-09-30 15:08:15 浏览量:18646
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-02-08 10:34:14 回复
开源版21.3 连续调用此接口时 每个一次就会出现返回数据是空数组的情况 和间隔时间没关系 是什么情况
回复
本地搭建了禅道21.3版本在postman工具中进行测试,获取数据是正常的。
导致咱们这个情况的原因可能会比较多。
可以先试下通过postman这类的工具调用看下是否会有问题,如果使用这些工具是正常的,可以检查下实际调用接口的程序是否有什么限制。
另外也可以看下调用接口应用到禅道服务器之间网络上是否有什么频率限制。
方便的话,可以添加下页面上的联系方式,邀请进群后截图咨询下具体问题呢
🍻
机灵的地瓜 2024-12-19 09:18:48 回复
请问创建任务怎么在任务描述(desc)放入图片?
回复
通过接口创建任务目前不支持在任务描述中放入图片,可以通过任务附件上传,使用files[]参数
🍻
机灵的地瓜 2024-12-05 17:21:11 回复
请问tasks返回的列表长度是有限制吗?total返回171,但tasks里面只有100个字典
回复
/executions/:id/tasks?limit=200&page=1
请求里添加分页参数看看
🍻
年轻有为的烤地瓜 2024-11-07 11:12:06 回复
这个接口可以通过status过滤数据吗?
回复
可以直接在params中上传参数stauts进行过滤试下。
罗先生 2022-11-04 09:22:29 回复
怎么获取子任务呢,这个接口好像只返回了一级的任务
回复
接口应该并未区分任务类型,都可以获取的
非常重要的禅道网友 2022-10-23 19:52:54 回复
有根据项目ID获取任务列表的接口吗?
回复
如果您是经典模式的话,项目其实就相当于项目集模式中的执行,使用获取执行任务列表这个接口就可以了
居居 2022-08-08 15:54:11 回复
没有根据需求id获取任务列表的api吗
回复
目前支持根据任务id查看任务详情的api,暂不支持按照任务id查看任务列表。
啊实打 2022-07-19 17:58:02 回复
里面的:id是指那个id? 我没有执行啥,我点的地盘 获取任务列表,没有什么执行呀
回复
这里是新版本restful格式的api,需要升级到新版本的禅道才能使用,执行id为新版本禅道中任务所在迭代/阶段的id
回复
开源版17.0是新版本吗?
新版本禅道中任务所在迭代/阶段的id 我看不太明白,能不能说的详细一点,应该在哪找。有步骤吗?
回复
17.0属于新版本,可以看下新版本的说明:https://www.zentao.net/book/extra/471.html
如果有问题可以添加QQ2468103332,邀请您进群沟通。
刘斌
高级客户经理
17685869372
526288068
统一服务热线 4006-8899-23
我要提问提问有任何问题,您都可以在这里提问。 问题反馈反馈点击这里,让我们聆听您的建议与反馈。