uip tm testsets

「uip tm testsets」の構文とオプション - Test Manager で追跡対象の実行を生成する実行可能なテスト セット ユニットを管理します。

テスト セットを管理する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> [--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 <names...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testsets playwright-context --test-set-key <key>

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

uip tm testsets create

プロジェクトに空のテスト セットを作成します。

引数

設定はありません。

オプション

フラグ	説明
--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 testsets list

プロジェクト内のテスト セットのリストを取得します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。リストするプロジェクト。
--folder-key <uuid>	Orchestrator のフォルダー キー ( uip or folders listから) でフィルター処理します。
--filter <text>	サーバー側で名前を検索する。
--include-last-execution	最新の実行のステータスとタイムスタンプを各テスト セットに追加します (以下の LastExecutionStatus/LastExecutionAt を参照)。テスト セットごとに 1 回の追加検索コストがかかります。

例

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 は、 executions list --test-set-idで必要な内部 UUID です。--include-last-executionでは、各エントリに LastExecutionStatus と LastExecutionAt も取得されます (テスト セットが実行されたことがない場合は、どちらも空の文字列)。

uip tm testsets update

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

引数

設定はありません。

オプション

フラグ	説明
--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 testsets delete

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

引数

設定はありません。

オプション

フラグ	説明
--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 testsets list-testcases

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

引数

設定はありません。

オプション

フラグ	説明
--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 testsets run

テスト セットを実行し、その ExecutionIdを返します。既定では、実行がキューに入るとすぐに、コマンドは戻ります。実行が終了ステートに達するまでブロックに --wait 渡します — これにより、起動ステップと待機ステップが 1 つのコマンドに結合されます。

引数

設定はありません。

オプション

フラグ	説明
--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 <names...>	実行のスコープは、uip tm pack(スペース区切り、例: regression smoke ) でパッケージ化された 1 つ以上の Playwright プロジェクトに設定します。選択はテスト セット上で保持されるため、後から同じテスト セットを繰り返す必要はありません。
--wait	実行が最終ステート (finished、 cancelled) に達するまでブロックします。省略すると、キューの直後にコマンドが返されます。
--timeout <seconds>	実行が完了するまで待機する最大秒数です (タイムアウトしない場合は0 )。--waitが必要です。
--poll-interval <seconds>	待機中のステータス チェック間の間隔 (秒)。--waitが必要です。

注:

--playwright-projects は非表示のオプションです ( --helpでは省略されています)。存在し、機能しますが、基になる Test Manager Playwright の実行機能が一般的に発表される前に、フラグ画面が変更される可能性があります。これは、すべてのテスト ケースが 1 つの Playwright パッケージから取得されているテスト セットにのみ適用されます。他のテスト セットでは、パッケージの playwright.config 既定値を使用して実行が続行され、このフラグは事実上無視されます。

例

# 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 specific Playwright projects (hidden option, see note above)
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-projects regression smoke

データシェイプ

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

注:

--waitを使用すると、Status は Runningではなく最終ステート (Finished、 Cancelled) を反映します。返される ExecutionId はどちらの場合も同じで、 uip tm report get、 uip tm result download、 uip tm attachment downloadに渡すことができます。

uip tm テストセット playwright-context

テスト セットの Playwright 解像度を調べる: テスト セット内のすべてのテスト ケースが 1 つの Playwright パッケージからのものかどうか、および利用可能で現在選択されている Playwright プロジェクト名。--helpからは非表示(runの--playwright-projectsと同じ成熟度ゲート)が、実在的で機能的です—run独自のオプションテキストがここを指しているのとまったく同じように、runを呼び出す前に有効な--playwright-projects名を検出するために使用します。

引数

設定はありません。

オプション

フラグ	説明
--test-set-key <key>	必須。テスト セットのオブジェクト キー (例:DEMO:42)。
--log-level <level>	既定 Informationです。

例

uip tm testsets playwright-context --test-set-key DEMO:42

データシェイプ

{
  "Code": "TestSetPlaywrightContext",
  "Data": {
    "TestSetKey": "DEMO:42",
    "IsPlaywright": true,
    "PackageIdentifier": "my-playwright-suite",
    "Version": "1.2.0",
    "AvailablePlaywrightProjects": "chromium, firefox, webkit",
    "SelectedPlaywrightProjects": "chromium"
  }
}

テスト セットが単一のパッケージの Playwright セット (RPA、混合、手動、または単一のパッケージなし) ではない場合、 IsPlaywright は false され、代わりに応答には 1 つの Details フィールド「 "Not a Playwright test set (RPA, mixed, manual, or no single package). Run it without --playwright-projects." 」が含まれる — この場合、上記の 4 つの Playwright 固有のフィールドは省略されます。AvailablePlaywrightProjects/SelectedPlaywrightProjects はコンマ結合文字列であり、配列ではありません。

関連

• pack — Playwright プロジェクトをパッケージ化し、上記で使用した --playwright-projects スコープ名を生成します。
• テスト ケース — テスト セットを設定するテスト ケースを作成してリンクします。
• 実行 — テスト セットの実行後に実行のリストを表示してリトライします。
• 待機 — 返された ExecutionId が終了状態に達するまでブロックします。
• Report、 Result、 Attachment — 実行後の成果物。

参照

• Test Manager の概要
• スクリプト パターン