uip tm 测试集

“uip tm Testets”的语法和选项，用于管理在 Test Manager 中生成被追踪执行的可执行测试集单元。

uip tm testsets管理测试集：Test Manager 中的可执行单元。测试集是一组有序的测试用例，可作为单个命令启动，并作为单次执行进行跟踪。每个testsets run调用都会返回一个ExecutionId ，其他uip tm动词（ wait 、 executions 、 report 、 result 、 attachment ）将其用作输入。

大纲

uip tm testsets create --project-key <key> --name <name> [--description <text>]
uip tm testsets list --project-key <key> [--filter <text>]
uip tm testsets update --project-key <key> --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --project-key <key> --test-set-key <key> [-y]
uip tm testsets list-testcases --project-key <key> --test-set-key <key> [--limit <n>] [--offset <n>]
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>] [--playwright-projects <project>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]

所有动词都遵循全局选项和标准退出代码。每个动词接受 --log-level <level>（默认值 Information）。

创建 uip tm 测试集

在项目中创建一个空测试集。

参数

无。

选项

标记	描述
--project-key <key>	必需。拥有的项目。
--name <name>	必需。测试集名称。
--description <text>	自由格式说明。默认为空。

示例

uip tm testsets create \
  --project-key DEMO \
  --name "Smoke Suite" \
  --description "Core smoke tests"

数据形状

{
  "Code": "TestSetCreate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite",
    "Description": "Core smoke tests"
  }
}

uip tm 测试集列表

列出项目中的测试集。

参数

无。

选项

标记	描述
--project-key <key>	必需。要列表的项目。
--filter <text>	在服务器端搜索名称。

示例

uip tm testsets list --project-key DEMO --filter smoke

数据形状

{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id是executions list --test-set-id所需的内部 UUID。

uip tm 测试集更新

重命名测试集或更改其描述。必须至少提供--name或--description其中一个。

参数

无。

选项

标记	描述
--project-key <key>	必需。拥有的项目。
--test-set-key <key>	必需。测试集键（例如 DEMO:10）。
--name <name>	新名称。
--description <text>	新说明。

示例

uip tm testsets update \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --name "Smoke Suite (2026)"

数据形状

{
  "Code": "TestSetUpdate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite (2026)",
    "Description": "Core smoke tests",
    "Result": "Updated"
  }
}

uip tm 测试集删除

通过密钥删除测试集。

参数

无。

选项

标记	描述
--project-key <key>	必需。拥有的项目。
--test-set-key <key>	必需。测试集键（例如 DEMO:10）。
-y, --yes	跳过确认提示。在非交互式环境中为必要项。

示例

uip tm testsets delete --project-key DEMO --test-set-key DEMO:10 --yes

数据形状

{
  "Code": "TestSetDelete",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Id": "a1b2c3d4-0000-0000-0000-000000000010",
    "Result": "Deleted"
  }
}

uip tm 测试集列表测试用例

列出分配给测试集的测试用例。

参数

无。

选项

标记	描述
--project-key <key>	必需。拥有的项目。
--test-set-key <key>	必需。要检查的测试集。
--limit <n>	每页的最大结果数量。默认为 50。
--offset <n>	要跳过的结果数量。默认为 0。

示例

uip tm testsets list-testcases --project-key DEMO --test-set-key DEMO:10

数据形状

{
  "Code": "TestSetTestCasesList",
  "Data": [
    {
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Description": "Logs in and out"
    }
  ]
}

运行 uip tm 测试集

运行测试集并返回其 ExecutionId。默认情况下，执行加入队列后，该命令将立即返回。传递 --wait 以阻止，直到执行到达最终状态——该操作将启动和等待步骤合并为一个命令。

参数

无。

选项

标记	描述
--test-set-key <key>	必需。测试集对象键（例如 DEMO:42）。项目键从前缀派生。
--execution-type <type>	要执行的测试用例类型： automated （默认） 、 manual 、 mixed （自动和手动）或none （无类型筛选器） 。
--input-path <file>	包含执行参数覆盖的 JSON 文件的路径。格式：[{"name":"Param","type":"String","value":"v"}]。
--playwright-projects <project>	Scope the run to one Playwright project packaged by uip tm pack (for example, regression or smoke). Requires CLI 1.200.0 or later. The selection persists on the test set, so later runs of the same test set don't need to repeat it.
--wait	阻止直到执行到达终止状态（finished，cancelled）。省略此项后，命令将在排队后立即返回。
--timeout <seconds>	等待执行完成的最大秒数（0表示不超时）。需要 --wait。
--poll-interval <seconds>	等待时状态检查之间的秒数。需要 --wait。

示例

# Fire-and-forget — returns ExecutionId immediately
uip tm testsets run --test-set-key DEMO:10

# Block until done — no need for a separate uip tm wait call
uip tm testsets run \
  --test-set-key DEMO:10 \
  --wait

# Block with a timeout and custom poll interval
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --wait \
  --timeout 900 \
  --poll-interval 15

# Pass parameter overrides from a file
uip tm testsets run \
  --test-set-key DEMO:10 \
  --input-path ./params.json \
  --wait

# Scope a run to a single Playwright project (CLI 1.200.0+)
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-projects regression

数据形状

{
  "Code": "TestSetRun",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestSetKey": "DEMO:10",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

备注：

使用 --wait 时，Status 反映最终状态（Finished、Cancelled），而不是 Running。返回的 ExecutionId 在这两种情况下相同，并且可以传递给 uip tm report get、uip tm result download 和 uip tm attachment download。

相关内容

• pack — packages a Playwright project and produces the --playwright-projects scope names used above.
• 测试用例— 创建并链接填充测试集的测试用例。
• 执行— 列出并在运行测试集后重试执行。
• wait — 阻止，直到返回的ExecutionId达到最终状态。
• 报告、结果、附件— 运行后工件。

另请参阅

• Test Manager 概述
• 脚本编写模式