测试单 (testtask)

测试单管理，支持获取测试单列表，支持获取产品/项目/执行下的测试单、创建测试单、修改测试单、删除测试单

动作概览

SDK 动作	说明	方法	路径
`list`	获取测试单列表，支持获取产品/项目/执行下的测试单	`GET`	`/{scope}/{scopeID}/testtasks`
`create`	创建测试单	`POST`	`/testtasks`
`update`	修改测试单	`PUT`	`/testtasks/{testtaskID}`
`delete`	删除测试单	`DELETE`	`/testtasks/{testtaskID}`

获取测试单列表，支持获取产品/项目/执行下的测试单

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

路径参数

参数	说明
`scope`	测试单所属范围
`scopeID`	所属范围ID

查询参数

参数	类型	必填	默认值	说明
`browseType`	string	否	`all`	状态，默认是all `all` 全部 `wait` 未开始 `doing` 进行中 `done` 已完成 `blocked` 阻塞
`orderBy`	string	否		排序 `id_asc` ID 升序 `id_desc` ID 降序 `name_asc` 名称升序 `name_desc` 名称降序 `status_asc` 状态升序 `status_desc` 状态降序
`recPerPage`	number	否		每页数量，不超过1000
`pageID`	number	否		页码，从第1页开始

请求体

无请求体。

返回值

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

SDK 示例

import { request } from 'zentao-api';

const result = await request("testtask/list", {
  "scope": "<string>",
  "scopeID": 1,
  "browseType": "all",
  "orderBy": "id_asc",
  "recPerPage": 1,
  "pageID": 1
});

创建测试单

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

路径参数

无路径参数。

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "productID": {
      "type": "integer",
      "description": "所属产品ID",
      "format": "int32"
    },
    "name": {
      "type": "string",
      "description": "测试单名称"
    },
    "build": {
      "type": "integer",
      "description": "提测构建/版本",
      "format": "int32"
    },
    "execution": {
      "type": "integer",
      "description": "所属执行",
      "format": "int32"
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "类型(integrate 集成测试 | system 系统测试 | acceptance 验收测试 | performance 性能测试 | safety 安全测试)"
    },
    "owner": {
      "type": "string",
      "description": "负责人"
    },
    "status": {
      "type": "string",
      "description": "状态(wait 未开始 | doing 进行中 | done 已关闭 | blocked 被阻塞)"
    },
    "begin": {
      "type": "string",
      "description": "开始日期"
    },
    "end": {
      "type": "string",
      "description": "结束日期"
    },
    "desc": {
      "type": "string",
      "description": "描述"
    }
  },
  "required": [
    "productID",
    "name",
    "build",
    "begin",
    "end"
  ]
}

示例:

json

{
  "productID": 1,
  "name": "智能家居V1.0测试单",
  "build": 1,
  "execution": 3,
  "type": [
    "integrate"
  ],
  "owner": "admin",
  "status": "wait",
  "begin": "2026-01-01",
  "end": "2026-02-01",
  "desc": "test"
}

返回值

返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("testtask/create", {
  "productID": 1,
  "name": "<string>",
  "build": 1,
  "execution": 1,
  "type": [
    "<string>"
  ],
  "owner": "<string>",
  "status": "<string>",
  "begin": "<string>",
  "end": "<string>",
  "desc": "<string>"
});

修改测试单

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

路径参数

参数	说明
`testtaskID`	测试单ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

json

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "测试单名称"
    },
    "build": {
      "type": "integer",
      "description": "提测构建/版本",
      "format": "int32"
    },
    "execution": {
      "type": "integer",
      "description": "所属执行",
      "format": "int32"
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "类型(integrate 集成测试 | system 系统测试 | acceptance 验收测试 | performance 性能测试 | safety 安全测试)"
    },
    "owner": {
      "type": "string",
      "description": "负责人"
    },
    "status": {
      "type": "string",
      "description": "状态(wait 未开始 | doing 进行中 | done 已关闭 | blocked 被阻塞)"
    },
    "begin": {
      "type": "string",
      "description": "开始日期"
    },
    "end": {
      "type": "string",
      "description": "结束日期"
    },
    "desc": {
      "type": "string",
      "description": "描述"
    }
  },
  "required": [
    "name",
    "build",
    "begin",
    "end"
  ]
}

示例:

json

{
  "name": "智能家居V1.0测试单",
  "build": 1,
  "execution": 3,
  "type": [
    "integrate"
  ],
  "owner": "admin",
  "status": "wait",
  "begin": "2026-01-01",
  "end": "2026-02-01",
  "desc": "test"
}

返回值

返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("testtask/update", {
  "testtaskID": 1,
  "name": "<string>",
  "build": 1,
  "execution": 1,
  "type": [
    "<string>"
  ],
  "owner": "<string>",
  "status": "<string>",
  "begin": "<string>",
  "end": "<string>",
  "desc": "<string>"
});

删除测试单

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

路径参数

参数	说明
`testtaskID`	测试单ID

查询参数

无查询参数。

请求体

无请求体。

返回值

返回形态：text

SDK 示例

import { request } from 'zentao-api';

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

测试单 (testtask) ​

动作概览 ​

获取测试单列表，支持获取产品/项目/执行下的测试单 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

创建测试单 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

修改测试单 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

删除测试单 ​

路径参数 ​

查询参数 ​

请求体 ​

返回值 ​

SDK 示例 ​

测试单 (testtask)

动作概览

获取测试单列表，支持获取产品/项目/执行下的测试单

路径参数

查询参数

请求体

返回值

SDK 示例

创建测试单

路径参数

查询参数

请求体

返回值

SDK 示例

修改测试单

路径参数

查询参数

请求体

返回值

SDK 示例

删除测试单

路径参数

查询参数

请求体

返回值

SDK 示例