任务 (task)

任务管理，支持获取任务列表，支持获取执行下的任务、执行的任务模块树、创建任务、获取任务详情、修改任务、修改任务模块、删除任务、删除任务模块、激活任务、关闭任务、完成任务、启动任务

动作概览

SDK 动作	说明	方法	路径
`list`	获取任务列表，支持获取执行下的任务	`GET`	`/executions/{executionID}/tasks`
`modules`	执行的任务模块树	`GET`	`/executions/{executionID}/task/modules`
`create`	创建任务	`POST`	`/tasks`
`get`	获取任务详情	`GET`	`/tasks/{taskID}`
`update`	修改任务	`PUT`	`/tasks/{taskID}`
`updateModule`	修改任务模块	`PUT`	`/task/modules/{moduleID}`
`delete`	删除任务	`DELETE`	`/tasks/{taskID}`
`deleteModule`	删除任务模块	`DELETE`	`/task/modules/{moduleID}`
`activate`	激活任务	`PUT`	`/tasks/{taskID}/activate`
`close`	关闭任务	`PUT`	`/tasks/{taskID}/close`
`finish`	完成任务	`PUT`	`/tasks/{taskID}/finish`
`start`	启动任务	`PUT`	`/tasks/{taskID}/start`

获取任务列表，支持获取执行下的任务

SDK 调用：request("task/list", params)
HTTP：GET /executions/{executionID}/tasks
动作类型：list
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`executionID`	所属执行ID

查询参数

参数	类型	必填	默认值	说明
`browseType`	string	否	`unclosed`	状态，默认是unclosed `all` 全部 `unclosed` 未关闭 `assignedtome` 指派给我 `assignedtome` 指派给我 `myinvolved` 由我参与 `assignedbyme` 由我指派
`orderBy`	string	否		排序 `id_asc` ID 升序 `id_desc` ID 降序 `name_asc` 名称升序 `name_desc` 名称降序 `status_asc` 状态升序 `status_desc` 状态降序
`recPerPage`	number	否		每页数量，不超过1000
`pageID`	number	否		页码，从第1页开始

请求体

无请求体。

返回值

返回形态：list
结果字段：tasks
分页字段：pager

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/list", {
  "executionID": 1,
  "browseType": "unclosed",
  "orderBy": "id_asc",
  "recPerPage": 1,
  "pageID": 1
});

执行的任务模块树

SDK 调用：request("task/modules", params)
HTTP：GET /executions/{executionID}/task/modules
动作类型：list
最低禅道版本：22.5 / biz13.5 / max8.5 / ipd5.5

路径参数

参数	说明
`executionID`	执行ID

查询参数

无查询参数。

请求体

无请求体。

返回值

返回形态：list
结果字段：tree

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/modules", {
  "executionID": 1
});

创建任务

SDK 调用：request("task/create", params)
HTTP：POST /tasks
动作类型：create
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

无路径参数。

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "任务名称"
    },
    "executionID": {
      "type": "integer",
      "description": "所属执行",
      "format": "int32"
    },
    "type": {
      "type": "string",
      "description": "任务类型"
    },
    "assignedTo": {
      "type": "string",
      "description": "指派给"
    },
    "estStarted": {
      "type": "string",
      "description": "预计开始"
    },
    "deadline": {
      "type": "string",
      "description": "截止日期"
    },
    "pri": {
      "type": "integer",
      "description": "优先级",
      "format": "int32"
    },
    "estimate": {
      "type": "number",
      "description": "预计工时",
      "format": "float"
    },
    "module": {
      "type": "integer",
      "description": "所属模块",
      "format": "int32"
    },
    "story": {
      "type": "integer",
      "description": "相关需求",
      "format": "int32"
    },
    "desc": {
      "type": "string",
      "description": "任务描述"
    },
    "parent": {
      "type": "integer",
      "description": "父任务",
      "format": "int32"
    }
  },
  "required": [
    "name",
    "executionID"
  ]
}

示例:

json

{
  "name": "开发电容压力监测模块",
  "executionID": 3,
  "type": "devel",
  "assignedTo": "admin",
  "estStarted": "2025-12-25",
  "deadline": "2025-12-30",
  "pri": 1,
  "estimate": 1,
  "module": 1,
  "story": 1
}

返回值

返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/create", {
  "name": "<string>",
  "executionID": 1,
  "type": "<string>",
  "assignedTo": "<string>",
  "estStarted": "<string>",
  "deadline": "<string>",
  "pri": 1,
  "estimate": 1,
  "module": 1,
  "story": 1,
  "desc": "<string>",
  "parent": 1
});

获取任务详情

SDK 调用：request("task/get", params)
HTTP：GET /tasks/{taskID}
动作类型：get
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

无请求体。

返回值

返回形态：object
结果字段：task

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/get", {
  "taskID": 1
});

修改任务

SDK 调用：request("task/update", params)
HTTP：PUT /tasks/{taskID}
动作类型：update
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "任务名称"
    },
    "type": {
      "type": "string",
      "description": "任务类型"
    },
    "assignedTo": {
      "type": "string",
      "description": "指派给"
    },
    "estStarted": {
      "type": "string",
      "description": "预计开始"
    },
    "deadline": {
      "type": "string",
      "description": "截止日期"
    },
    "pri": {
      "type": "integer",
      "description": "优先级",
      "format": "int32"
    },
    "estimate": {
      "type": "number",
      "description": "预计工时",
      "format": "float"
    },
    "module": {
      "type": "integer",
      "description": "所属模块",
      "format": "int32"
    },
    "story": {
      "type": "integer",
      "description": "相关需求",
      "format": "int32"
    },
    "desc": {
      "type": "string",
      "description": "任务描述"
    },
    "parent": {
      "type": "integer",
      "description": "父任务",
      "format": "int32"
    }
  }
}

示例:

json

{
  "name": "开发电容光敏监测模块",
  "type": "devel",
  "assignedTo": "admin",
  "estStarted": "2025-12-25",
  "deadline": "2025-12-30",
  "pri": 1,
  "estimate": 1,
  "module": 1,
  "story": 1
}

返回值

返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/update", {
  "taskID": 1,
  "name": "<string>",
  "type": "<string>",
  "assignedTo": "<string>",
  "estStarted": "<string>",
  "deadline": "<string>",
  "pri": 1,
  "estimate": 1,
  "module": 1,
  "story": 1,
  "desc": "<string>",
  "parent": 1
});

修改任务模块

SDK 调用：request("task/updateModule", params)
HTTP：PUT /task/modules/{moduleID}
动作类型：update
最低禅道版本：22.5 / biz13.5 / max8.5 / ipd5.5

路径参数

参数	说明
`moduleID`	模块ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "模块名称"
    },
    "parent": {
      "type": "integer",
      "description": "父模块",
      "format": "int32"
    }
  }
}

示例:

json

{
  "name": "任务新模块",
  "parent": "0"
}

返回值

返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/updateModule", {
  "moduleID": 1,
  "name": "<string>",
  "parent": 1
});

删除任务

SDK 调用：request("task/delete", params)
HTTP：DELETE /tasks/{taskID}
动作类型：delete
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

无请求体。

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/delete", {
  "taskID": 1
});

删除任务模块

SDK 调用：request("task/deleteModule", params)
HTTP：DELETE /task/modules/{moduleID}
动作类型：delete
最低禅道版本：22.5 / biz13.5 / max8.5 / ipd5.5

路径参数

参数	说明
`moduleID`	模块ID

查询参数

无查询参数。

请求体

无请求体。

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/deleteModule", {
  "moduleID": 1
});

激活任务

SDK 调用：request("task/activate", params)
HTTP：PUT /tasks/{taskID}/activate
动作类型：action
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "left": {
      "type": "number",
      "description": "预计剩余",
      "format": "float"
    },
    "assignedTo": {
      "type": "string",
      "description": "指派给"
    },
    "comment": {
      "type": "string",
      "description": "备注"
    }
  }
}

示例:

json

{
  "left": 1,
  "assignedTo": "admin"
}

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/activate", {
  "taskID": 1,
  "left": 1,
  "assignedTo": "<string>",
  "comment": "<string>"
});

关闭任务

SDK 调用：request("task/close", params)
HTTP：PUT /tasks/{taskID}/close
动作类型：action
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "comment": {
      "type": "string",
      "description": "备注"
    }
  }
}

示例:

json

{
  "comment": "<string>"
}

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/close", {
  "taskID": 1,
  "comment": "<string>"
});

完成任务

SDK 调用：request("task/finish", params)
HTTP：PUT /tasks/{taskID}/finish
动作类型：action
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "currentConsumed": {
      "type": "number",
      "description": "本次消耗",
      "format": "float"
    },
    "assignedTo": {
      "type": "string",
      "description": "指派给"
    },
    "consumed": {
      "type": "number",
      "description": "总计消耗",
      "format": "float"
    },
    "realStarted": {
      "type": "string",
      "description": "实际开始，精确到秒"
    },
    "finishedDate": {
      "type": "string",
      "description": "实际完成，精确到秒"
    },
    "comment": {
      "type": "string",
      "description": "备注"
    }
  },
  "required": [
    "currentConsumed",
    "realStarted",
    "finishedDate"
  ]
}

示例:

json

{
  "currentConsumed": 1,
  "assignedTo": "admin",
  "consumed": 1,
  "realStarted": "2025-12-25 09:00:00",
  "finishedDate": "2025-12-30 17:30:00"
}

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/finish", {
  "taskID": 1,
  "currentConsumed": 1,
  "assignedTo": "<string>",
  "consumed": 1,
  "realStarted": "<string>",
  "finishedDate": "<string>",
  "comment": "<string>"
});

启动任务

SDK 调用：request("task/start", params)
HTTP：PUT /tasks/{taskID}/start
动作类型：action
最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
`taskID`	任务ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "assignedTo": {
      "type": "string",
      "description": "任务名称"
    },
    "realStarted": {
      "type": "string",
      "description": "实际开始，精确到秒"
    },
    "consumed": {
      "type": "number",
      "description": "总计消耗",
      "format": "float"
    },
    "left": {
      "type": "number",
      "description": "预计剩余",
      "format": "float"
    },
    "comment": {
      "type": "string",
      "description": "备注"
    }
  },
  "required": [
    "realStarted"
  ]
}

示例:

json

{
  "assignedTo": "admin",
  "realStarted": "2025-12-26 09:00:00",
  "consumed": 1,
  "left": 1
}

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

const result = await request("task/start", {
  "taskID": 1,
  "assignedTo": "<string>",
  "realStarted": "<string>",
  "consumed": 1,
  "left": 1,
  "comment": "<string>"
});

任务 (task) ​

动作概览 ​

获取任务列表，支持获取执行下的任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

执行的任务模块树 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

创建任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

获取任务详情 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

修改任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

修改任务模块 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

删除任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

删除任务模块 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

激活任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

关闭任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

完成任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

启动任务 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

任务 (task)

动作概览

获取任务列表，支持获取执行下的任务

路径参数

查询参数

请求体

返回值

SDK 示例

执行的任务模块树

路径参数

查询参数

请求体

返回值

SDK 示例

创建任务

路径参数

查询参数

请求体

返回值

SDK 示例

获取任务详情

路径参数

查询参数

请求体

返回值

SDK 示例

修改任务

路径参数

查询参数

请求体

返回值

SDK 示例

修改任务模块

路径参数

查询参数

请求体

返回值

SDK 示例

删除任务

路径参数

查询参数

请求体

返回值

SDK 示例

删除任务模块

路径参数

查询参数

请求体

返回值

SDK 示例

激活任务

路径参数

查询参数

请求体

返回值

SDK 示例

关闭任务

路径参数

查询参数

请求体

返回值

SDK 示例

完成任务

路径参数

查询参数

请求体

返回值

SDK 示例

启动任务

路径参数

查询参数

请求体

返回值

SDK 示例