CRITICAL — Before starting, you MUST first use the Read tool to read ../zentao-shared/SKILL.md, which contains authentication, environment variable configuration, error handling, and general options descriptions.
Commands
testtask list— List test taskstesttask get— Get test task details
Core Concepts
- Testtask: The unit used in ZenTao to manage testing tasks.
- Relationship with executions: Test tasks are associated with a specific project and execution.
- Test task status: wait / doing / done / closed
Testtask Status Values
| Status | Chinese | Description |
|---|---|---|
wait |
Waiting | The testing task has not started yet |
doing |
In progress | Testing is being executed |
done |
Completed | Testing has been completed |
closed |
Closed | The test task has been closed |
Common Use Cases
1. View a project's test tasks
# 列出项目 1 下的所有测试单
zentao-cli testtask list --project 1
2. View details of a specific test task
# 获取测试单详情
zentao-cli testtask get 1
Examples
# 列出项目 1 下的所有测试单
zentao-cli testtask list --project 1
# 获取测试单详情
zentao-cli testtask get 1
Output Fields
| Field | Type | Description |
|---|---|---|
| id | u64 | Test task ID |
| name | string | Test task name |
| project | u64 | Project ID it belongs to |
| execution | u64 | Execution/iteration ID it belongs to |
| status | string | Test task status: wait / doing / done / closed |
| type | string | Test task type |
| product | u64 | Product ID it belongs to |
Gotchas
-
Project Required:
testtask listYou need to specify the--projectparameter to filter test tasks for a specific project. -
Difference from Testcase: Testtask is a testing task, while Testcase is a specific test case.
-
Execution association: Test tasks are associated with a specific execution/iteration through the
executionfield.