UIP TM 项目

“uip tm project”的语法和选项，将 Test Manager 项目作为测试用例和测试集的顶层容器进行管理。

uip tm project管理当前租户上的 Test Manager 项目。Test Manager 项目是测试用例、测试集和执行的顶层容器；每隔一个uip tm动词通过--project-key限定项目范围。

大纲

uip tm project list [--limit <n>] [--offset <n>]
uip tm project create --name <name> --project-key <key> [--description <text>]
uip tm project update --project-key <key> [--name <name>] [--description <text>]
uip tm project delete --project-key <key> [-y]
uip tm project set-default-folder --project-key <key> --folder-key <uuid>
uip tm project clear-default-folder --project-key <key>
uip tm project owners list [--project-key <key...>]

所有动词都遵循全局选项和标准退出代码。每个动词都接受 --log-level <level> 冗长（debug、info、warn、error；默认为 Information）。

uip tm 项目列表

列出当前租户上的每个 Test Manager 项目。

参数

无。

选项

标记	描述
--limit <n>	每页要返回的最大项目数。默认为 50。
--offset <n>	要跳过的结果数量。默认为 0。

示例

uip tm project list --limit 20 --offset 0

数据形状

{
  "Code": "ProjectsList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "Name": "Demo Project",
      "Description": "Smoke tests",
      "Active": true
    }
  ]
}

创建 UIP TM 项目

创建一个新的 Test Manager 项目。该项目创建为活动状态。

参数

无。

选项

标记	描述
--name <name>	必需。项目名称。
--project-key <key>	必需。项目键/前缀（例如 MYPROJ）。测试用例和测试集对象密钥将以此值作为前缀（例如 MYPROJ:1）。
--description <text>	自由格式的项目描述。默认为空。

示例

uip tm project create \
  --name "Demo Project" \
  --project-key DEMO \
  --description "Smoke tests"

数据形状

{
  "Code": "ProjectCreate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project",
    "Description": "Smoke tests"
  }
}

uip tm 项目更新

更新项目的名称或说明。至少提供--name或--description之一。

参数

无。

选项

标记	描述
--project-key <key>	必需。要更新的项目。
--name <name>	新名称。省略以保持不变。
--description <text>	新说明。省略以保持不变。

示例

uip tm project update --project-key DEMO --name "Demo Project (2026)"

数据形状

{
  "Code": "ProjectUpdate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project (2026)",
    "Description": "Smoke tests"
  }
}

uip tm 项目删除

通过密钥删除 Test Manager 项目。这是无条件且永久的 — 所有测试用例、测试集和执行历史记录都将被删除。

参数

无。

选项

标记	描述
--project-key <key>	必需。要删除的项目。
-y, --yes	跳过确认提示。在非交互式环境（CI 管道、脚本）中为必要项。

示例

uip tm project delete --project-key DEMO --yes

数据形状

{
  "Code": "ProjectDelete",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm 项目设置-默认-文件夹

设置项目的默认 Orchestrator 文件夹。除非覆盖，否则之后创建的测试集将继承此文件夹。

参数

无。

选项

标记	描述
--project-key <key>	必需。Test Manager 项目密钥。
--folder-key <uuid>	必需。Orchestrator 文件夹密钥 (UUID)。从 uip or folders list 获取。

示例

uip tm project set-default-folder \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

数据形状

{
  "Code": "ProjectSetDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

uip tm 项目清除默认文件夹

从项目中移除默认的 Orchestrator 文件夹。清除后，新的测试集不会自动继承文件夹。

参数

无。

选项

• --project-key <key> （必填） — Test Manager 项目密钥。

示例

uip tm project clear-default-folder --project-key DEMO

数据形状

{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}

uip tm 项目所有者列表

列出一个或多个 Test Manager 项目的所有者。在一次调用中接受一个或多个项目键。

参数

无。

选项

• --project-key <key...> — 一个或多个项目密钥（以空格分隔）。可省略，以列出所有项目的所有者。

示例

# List owners of a single project
uip tm project owners list --project-key DEMO

# List owners of multiple projects in one call
uip tm project owners list --project-key DEMO MyOtherProject

数据形状

{
  "Code": "ProjectOwnersList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Owners": [
        {
          "Identifier": "b2c3d4e5-0000-0000-0000-000000000001",
          "DisplayName": "John Doe",
          "Source": "local"
        }
      ]
    },
    {
      "ProjectKey": "MyOtherProject",
      "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
      "Owners": []
    }
  ]
}

相关内容

• 测试用例— 在项目中创建测试用例。
• 测试集— 将测试用例分组到可执行套件中。

另请参阅

• Test Manager 概述
• uip or folders list — set-default-folder使用的文件夹 UUID 的来源。