UIP TM テストセット

テスト セットを管理するuip tm testsets: Test Manager で実行可能な単位です。テスト セットは、1 つのコマンドで実行し、1 回の実行として追跡できる、順序付けられたテスト ケースのグループです。すべての testsets run 呼び出しは、他の uip tm動詞 (wait、executions、report、result、attachment) が入力として受け取るExecutionIdを返します。

概要

uip tm testsets create --project-key <key> --name <name> [--description <text>]
uip tm testsets list --project-key <key> [--folder-key <uuid>] [--filter <text>]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key>
uip tm testsets list-testcases --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>]

すべての動詞は、 グローバルオプション と標準 終了コードを尊重します。すべての動詞は -t, --tenant <name> と --log-level <level> を受け入れます(デフォルト Information)。

--test-set-keyキーのプレフィックス (例:DEMO:10 → プロジェクト DEMO) であるため、 --project-key は create と listでのみ必要です。

uip tm testsets create

プロジェクトに空のテスト セットを作成します。後で testcases add を使用して入力します。

引数

設定はありません。

オプション

• --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 テストセットのリスト

プロジェクト内のテスト セットのリストを取得します。CLI は結果を自動的にページングします。

引数

設定はありません。

オプション

• --project-key <key> (必須) — リストするプロジェクト。
• --folder-key <uuid> — この Orchestrator フォルダーにバインドされているテスト セットのみに制限します。フェッチ後にクライアント側に適用されます。
• --filter <text> — サーバーサイドで名前を検索します。

例

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

データシェイプ

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

Id 内部 UUID です — たとえば、 execution list --test-set-idで必要です。

UIP TM テストセットの更新

テスト セットの名前を変更するか、テスト セットの説明を変更します。--nameまたは--descriptionのうち少なくとも1つを指定する必要があります。

引数

設定はありません。

オプション

• --test-set-key <key> (必須) — テスト セット キー (例:DEMO:10)。
• --name <name> — 新しい名前。
• --description <text> — 新しい説明。

例

uip tm testsets update \
  --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 テストセットの削除

テスト セットをキーで削除する

引数

設定はありません。

オプション

• --test-set-key <key> (必須) — テストセットキー。

例

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

データシェイプ

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

uip tm testsets list-testcases

テスト セットに割り当てられているテスト ケースのリストを表示します。

引数

設定はありません。

オプション

• --test-set-key <key> (必須) — 検査するテスト セット。

例

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

データシェイプ

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

uip tm テストセットの実行

テスト セットを実行し、すぐにその ExecutionId を返します。テスト セット自体に、Test Manager の Web UI 内で作成するか、REST API 経由で手動で作成して、パッケージとフォルダーを設定しておく必要があります。[実行] はブロックしません。[スクリプトの uip tm wait ] と組み合わせて使用します。

引数

設定はありません。

オプション

• --test-set-key <key> (必須) — 実行するテスト セット。プロジェクト キーはプレフィックスから派生します。
• --execution-type <type> — 実行するテスト ケース。以下のいずれかを使用します。
  • automated (既定) — 自動化されたテスト ケースのみ。
  • manual — 手動テスト用のテスト ケースのみ
  • mixed — 自動と手動の両方。
  • none — 型フィルターなし。
• --input-path <file> — パラメーターをオーバーライドした JSON ファイルへのパスです。ファイルには、 [{"name":"Param","type":"String","value":"v"}]のような形式の配列が含まれている必要があります。オーバーライドは、 name (存在する場合は type) によってテスト セットの現在のパラメーター定義と照合されます。大文字と小文字は区別されません。サーバーがパラメーター定義を報告しない場合、入力はそのまま送信されます。

例

# simplest
uip tm testsets run --test-set-key DEMO:10

# with parameter overrides and manual execution
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type mixed \
  --input-path ./params.json

データシェイプ

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

注:

返された Status は、起動時の状態を反映します(通常は Running)。これは、実行が成功した ことを意味するものではありません 。実行結果を取得するには、 uip tm wait をブロックしてから uip tm report getを読み取ります。起動と待機を組み合わせたフローでの終了コードの動作については、 uip tm executionsに記載されています。waitとreportの参照については、以下の「関連」セクションを参照してください。

関連

• テスト ケース — テスト セットを設定するテスト ケースを作成してリンクします。
• 実行 — テスト セットの実行後に実行のリストを表示してリトライします。
• 待機 — 返された ExecutionId が終了状態に達するまでブロックします。
• Report、 Result、 Attachment — 実行後の成果物。

参照

• Test Manager の概要
• スクリプトパターン — 実行を開始および検証するためのCIに適したパターン。