uip tm testcases

「uip tm testcases」の構文とオプション - 作成、一覧表示、更新、削除、自動化のリンク、テスト ケース ログの管理など、テスト ケースを管理します。

uip tm testcases は、Test Manager プロジェクト内のテスト ケースを管理します。Orchestrator のオートメーションの作成、一覧表示、更新、削除、リンクまたはリンク解除、履歴結果の検査、テスト セットに対するテスト ケースの追加または削除などを行います。また、Orchestrator パッケージから直接 1 つ以上のテスト ケースを実行する方法である testcases run も提供します。このページでは、 uip tm testcaselog list-assertions、 testcaselog start、および testcaselog finish ( testcaselog、 で登録されている) についても説明します。これらのファイルは、アサーション成果物を読み取り、テスト ケースのログの手動ログ エントリを記録します。

テスト ケースは作成者の単位です。このアクティビティは、 を使用してパッケージのエントリ ポイントにリンクされると実行可能になります testcases link-automation。その後、テスト ケースをテスト セットの一部として実行するか (「 テスト セット」を参照)、 testcases runを介して直接実行できます。

警告:

uip tm pack が Playwright プロジェクト用に作成したテスト ケースに対してtestcases link-automationを実行しないでください。Playwright のテスト ケースは、パック時の取り込み中に自動的にリンクされます。これらのサーバーに対して手動で link-automation を実行すると、代わりに RPA リンク パイプラインがたどられ、その関連付けが破損します。--no-create-test-casesでパッケージ化した場合は、代わりに Test Manager UI の [オートメーションを選択] フローを使用してください。

概要

uip tm testcases create --project-key <key> --name <name> [--description <text>] [--version <version>]
uip tm testcases list --project-key <key> [--filter <text>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--top <number>] [--skip <number>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete --project-key <key> --test-case-key <key> [-y]
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
uip tm testcases link-package --project-key <key> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --project-key <key> [--folder-key <uuid>] [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-key <key>
uip tm testcases run --project-key <key> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <uuid>] [--runtime-type <type>] [--robot-user-key <uuid>] [--machine-key <uuid>] [--host-machine-name <name>] [--service-user-name <name>] [--test-set-packages <json>]
uip tm testcases add --test-set-key <key> (--test-case-keys <keys...> | --labels <labels...> [--limit <count>])
uip tm testcases remove --test-set-key <key> --test-case-keys <keys> [-y]
uip tm testcases list-steps --project-key <key> --test-case-id <uuid>

uip tm testcases steps list --project-key <key> --test-case-id <uuid>
uip tm testcases steps get --project-key <key> --step-id <uuid>
uip tm testcases steps add --project-key <key> --test-case-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>] [--order-no <n>] [--step <json>...]
uip tm testcases steps update --project-key <key> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move --project-key <key> --step-id <uuid> --target-position <n>
uip tm testcases steps delete --project-key <key> --step-id <uuid> [-y]

uip tm testcaselog list-assertions --project-key <key> --test-case-log-id <uuid>

uip tm testcaselog start --project-key <key> --execution-id <uuid> --test-case-id <uuid> [--run-id <number>]
uip tm testcaselog finish --project-key <key> --execution-id <uuid> --test-case-id <uuid> --result <result> --has-error <boolean> --executed-by <email> [--detail-link <url>] [--run-id <number>] [--is-post-condition-met <boolean>] (--step-logs <json> | --step-logs-file <path>)

重要:

list-assertions、 start、および finish は uip tm testcaselog (単数形) で登録されています。uip tm testcaselogs list-assertions と uip tm testcaselogs start/finish はコマンドとして存在しません。

すべての動詞は、 グローバル オプション と標準の 終了コードを尊重します。

注:

--log-level <level> (既定 Information) は、 create、 list、 list-result-history、 update、 delete、 link-automation、 link-package、 unlink-automation、 list-automations、 list-testsets、 add、 removeで利用できます。run、steps サブコマンド (list-steps エイリアスを含む)、または testcaselog start/finish/list-assertionsには存在しません。

uip tm testcases create

プロジェクト内に新しいテスト ケースを作成します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--name <name>	必須。テスト ケース名。
--description <text>	自由形式の説明。既定では空です。
--version <version>	テスト ケースのバージョン文字列。既定値は 1.0.0です。

例

uip tm testcases create \
  --project-key DEMO \
  --name "Login smoke" \
  --description "Logs in and out"

データシェイプ

{
  "Code": "TestCaseCreate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Login smoke",
    "Description": "Logs in and out",
    "Version": "1.0.0"
  }
}

TestCaseKey (public PROJECT:N 識別子) は、他の動詞に渡すものです。list-result-historyとlist-testsetsには内部Id (UUID) が必要です。

uip tm testcases list

プロジェクト内のすべてのテスト ケースのリストを表示します。CLI が自動的に結果をページ処理します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。リストするプロジェクト。
--filter <text>	名前またはキーでフィルター処理します (サーバー側検索)。

例

uip tm testcases list --project-key DEMO --filter login

データシェイプ

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

uip tm testcases list-result-history

1 つのテスト ケースのテスト ケース ログの履歴を表示します。内部 --test-case-id (UUID) — testcases list または前の TestCaseCreate 出力から UUID を検索します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-id <uuid>	必須。内部テスト ケースの UUID。
--filter <text>	テスト ケースのログを名前で検索します。
--only-failed	「失敗したログのみを表示」のショートカットです (既定 false)。
--results <results...>	含める結果のスペース区切りです。許容値は SDK Result 列挙型から取得されます。
--statuses <statuses...>	スペース区切りの実行ステータスです。許容値は SDK TestCaseLogExecutionStatus 列挙型から取得されます。
--duration-period <period>	期間バケットでフィルター処理します。許容値は SDK DurationPeriod 列挙型から取得されます。
--top <number>	ページ サイズ。既定値は 50です。
--skip <number>	スキップする結果。既定値は 0です。

注:

--results、--statuses、--duration-period に正確に受け入れられる値は、インストールされたツール バージョンに同梱されている Test Manager SDK の列挙型から実行時に生成されます。uip tm testcases list-result-history --helpを実行して、現在のセットを確認します。

例

uip tm testcases list-result-history \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --only-failed

データシェイプ

{
  "Code": "TestCaseResultHistory",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionEnd": "2025-04-15T12:00:00Z"
    }
  ]
}

uip tm testcases update

テスト ケースの名前を変更したり、説明、事前条件、事後条件を変更したりします。これらのフィールドの少なくとも 1 つは必須です。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-key <key>	必須。テスト ケース キー (例: DEMO:1)。
--name <name>	新しい名前。
--description <text>	新しい説明。
--pre-condition <text>	新しい前提条件 — テストを実行する前に true でなければならない内容。
--post-condition <text>	新しい事後条件 — テストの実行後に当てはまる内容。

例

uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"

データシェイプ

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "Description": "Logs in and out",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "Result": "Updated"
  }
}

uip tm testcases delete

テスト ケースをキーで削除します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-key <key>	必須。テスト ケース キー (例: DEMO:1)。
-y, --yes	確認プロンプトをスキップします。非対話型環境では必要です。

例

uip tm testcases delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --yes

データシェイプ

{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcases link-automation

Orchestrator パッケージのエントリ ポイントをテスト ケースにバインドします。これにより、テスト ケースをテスト セット内で実行できるようになります。内部的には、このコマンドはフォルダーの表示 --folder-key名を から解決し、一致するパッケージのエントリ ポイントを名前で検索して、テスト ケースにバインドを格納します。packによって作成された Playwright テスト ケースについては、上記の警告を参照してください。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-key <key>	必須。バインドするテスト ケース。
--folder-key <uuid>	必須。Orchestrator フォルダーの UUID ( uip or folders listから)。
--package-name <name>	必須。Orchestrator のパッケージ識別子です (例: InvoiceTests)。
--test-name <name>	必須。パッケージ内のテスト ケース名 (エントリ ポイント名)。

例

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

データシェイプ

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "PackageName": "InvoiceTests",
    "PackageSource": "Shared",
    "TestName": "SmokeTest",
    "Result": "Linked"
  }
}

UIP TM テストケース リンク パッケージ

Orchestrator パッケージ内のすべてのテストのテスト ケースを 1 回の呼び出しで作成してリンクできます。 link-automationへの一括呼び出しは、1 つの既存のテスト ケースを 1 つのオートメーションにリンクします。既定では、フォルダーで公開されるすべてのテストがリンクされます。スコープを --package-nameの場合は 1 つのパッケージに、 --test-nameの場合は特定のテストにスコープを設定します。各テストで新しいテスト ケースが作成されるか (Action: "Created")、そのオートメーションに既にリンクされているテスト ケースを再利用 (Action: "Reused")。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--folder-key <uuid>	必須。Orchestrator フォルダーの UUID ( uip or folders listから)。
--package-name <name>	このパッケージのテストのみをリンクします (大文字と小文字を区別しない完全一致)。フォルダーで公開されるすべてのテストのリンクを省略します。
--test-name <name...>	これらのテストのみをリンクします (大文字と小文字を区別せず、繰り返し可能)。それらすべてをリンクする場合は省略します。
--dry-run	作成、再利用、リンクされるテスト ケースを、何も入力せずにプレビューする

例

# Create and link a test case for every test in one Orchestrator package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests

# Preview what would be created and linked, without writing
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --dry-run

# Link only two named tests out of the package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest RegressionTest

データシェイプ

{
  "Code": "TestCaseLinkPackage",
  "Data": [
    {
      "TestName": "SmokeTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:7",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000007",
      "Action": "Created"
    },
    {
      "TestName": "RegressionTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:3",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000003",
      "Action": "Reused"
    }
  ]
}

--dry-runを使用すると、代わりにCodeがTestCaseLinkPackageDryRunされ、Action値は WouldCreate/WouldReuseになり、実際には何も書き込まれていないため、TestCaseKey/TestCaseIdは空の文字列になります。

uip tm testcases unlink-automation

テスト ケースからオートメーションのバインドを削除します。リンクを解除すると、テスト ケースは再度リンクされるまで実行できなくなります。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-key <key>	必須。リンクを解除するテスト ケース

例

uip tm testcases unlink-automation \
  --project-key DEMO \
  --test-case-key DEMO:1

データシェイプ

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}

uip tm testcases list-automations

Orchestrator フォルダーで利用可能なテスト エントリ ポイントを一覧表示します。これを使用して、link-automationに渡す--package-name/--test-name値を検出します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト (検索のスコープに使用)。
--folder-key <uuid>	Orchestrator フォルダーの UUID。1 つのフォルダーではなくテナント フィード全体を検索することを省略します。
--package-name <name>	リストをフィルター処理して 1 つのパッケージにします (部分文字列検索ではなく、大文字と小文字を区別しない完全一致)。

例

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

データシェイプ

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}

uip tm testcases list-testsets

特定のテスト ケースを含むすべてのテスト セットのリストを取得します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-key <key>	必須。テスト ケース キー (例: DEMO:1)。

例

uip tm testcases list-testsets \
  --project-key DEMO \
  --test-case-key DEMO:1

データシェイプ

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

uip tm testcases run

最初にテスト セットを作成することなく、1 つ以上のテスト ケースを Orchestrator パッケージから直接実行する。testcases run 実行を開始し、実行レコードを返します。この機能について詳しくは、Test Manager のドキュメントの「 テスト セットなしでテスト ケースを実行する 」をご覧ください。

注:

testcases run は既定では同期的で、実行レコードが確認されるまでブロックされます。列に並んですぐに戻るには、 --asyncを渡す。実行が完了するまでブロックするには、返された Id を uip tm waitにパイプで接続します。

testcases run を使用すべき状況とtestsets run

• testcases run を使用すると、パッケージから直接オンデマンドでテスト ケースを実行できます。
• testsets run を使用して、名前が付けられ、選定されたテスト ケースのグループを実行します。このグループは Test Manager で継続的に管理されます。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	Test Manager プロジェクト キー (例: DEMO)。コンテキストから派生可能な場合は任意です。
--test-case-id <uuid...>	必須。実行する 1 つ以上のテスト ケース UUID (スペース区切り)。testcases listから UUID を取得します。
--execution-type <type>	必須。実行の種類です automated、 manual、 mixed、または none。
--name <name>	実行の表示名。
--async	サーバーが実行の開始を確認するのを待たずに、キューイング後すぐに戻ります。実行レコードが完全に作成されるのを待ってから戻ることを省略します。
--folder-key <uuid>	実行する Orchestrator のフォルダーです。テスト ケースが特定のフォルダー内のオートメーションにリンクされている場合に必要です。
--runtime-type <type>	ロボット ランタイムの種類の上書き。許容値は、 nonProduction、 attended、 unattended、 rpaDeveloper、 studioX、 headless、 rpaDeveloperPro、 testAutomation、 automationCloud、 serverless、 automationKit、 serverlessTestAutomation、 automationCloudTestAutomation、 attendedStudioWeb、 hosting、 assistantWeb、 processOrchestration、 agentService、 appTest、 performanceTest、 businessRule、 caseManagement。
--robot-user-key <uuid>	実行ターゲットのロボットのユーザー キー。
--machine-key <uuid>	実行ターゲットのマシン キー。
--host-machine-name <name>	実行ターゲットのホスト マシン名。
--service-user-name <name>	実行ターゲットのサービス ユーザー名。
--test-set-packages <json>	パッケージ オーバーライドの JSON 配列: [{"packageName":"Pkg","version":"1.0.0"}]。

例

# Simplest — run a single test case (blocks until execution record is created)
uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Login smoke run"

# Run multiple test cases asynchronously, then wait for completion
id=$(uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
  --execution-type automated \
  --name "Smoke run" \
  --async \
  --output-filter Id)

uip tm wait --execution-id "$id" --project-key DEMO --timeout 900
uip tm report get --execution-id "$id" --project-key DEMO

# Full override — specify folder, runtime, machine, and package version
uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Smoke run" \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --runtime-type unattended \
  --machine-key 33333333-4444-5555-6666-777777777777 \
  --test-set-packages '[{"packageName":"InvoiceTests","version":"1.0.2"}]'

データシェイプ

{
  "Code": "TestCaseRun",
  "Data": {
    "Id": "b2c3d4e5-0000-0000-0000-000000000001",
    "Name": "Login smoke run",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "Status": "Running",
    "ExecutionType": "automated",
    "Source": "Manual",
    "RunId": 1,
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "EnableCoverage": false,
    "EnforceExecutionOrder": false,
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}

主なフィールド

• Id — uip tm wait、 report get、 result download、 attachment downloadに渡します。
• Status: "Running" — 実行がまだディスパッチされていない可能性があります。
• Source: "Manual" — すべての testcases run 実行に手動トリガーとしてタグ付けされます。

エンドツーエンドのワークフロー: パッケージから結果まで

# 1. Discover your project key
uip tm project list --output json

# 2. Find the test case UUIDs you want to run
uip tm testcases list --project-key DEMO --filter "login" --output json

# 3. Find the folder that holds your package
uip or folders list --output json

# 4. Link the test case to the automation entry point
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

# 5. Run the test cases directly
id=$(uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --name "PR #42 smoke" \
  --output-filter Id)

# 6. Block until done (timeout in seconds — 15 minutes here)
uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 900

# 7. Read the result
uip tm report get --execution-id "$id" --project-key DEMO

# 8. Download JUnit XML for CI
uip tm result download \
  --execution-id "$id" \
  --project-key DEMO \
  --result-path ./junit.xml

# 9. Download screenshots and logs
uip tm attachment download \
  --execution-id "$id" \
  --project-key DEMO \
  --only-failed \
  --result-path ./attachments

uip tm testcases add

明示的なキーまたはラベルを使用して、既存のテスト セットにテスト ケースを追加します。--test-case-keys または --labelsのいずれか 1 つだけを渡します。

引数

設定はありません。

オプション

フラグ	説明
--test-set-key <key>	必須。テスト セットのオブジェクト キー (例: DEMO:42)。
--test-case-keys <keys...>	追加するテスト ケース キーです。スペース区切り (例: DEMO:1 DEMO:2)。コンマ区切り値も使用できます。--labelsと相互に排他的です。
--labels <labels...>	スペース区切りのラベル名。ラベルを少なくとも 1 つ付いた、プロジェクト内のすべてのテスト ケースを追加します。このラベルには、取り込み時にpackによって適用されたラベルPW_Tag_*、PW_Project_*、PW_Suite_*、PW_File_* ラベルが含まれます。--test-case-keysと相互に排他的です。
--limit <count>	追加するラベル一致テスト ケースの最大数です。--labelsでのみ有効です。既定ではすべての一致に設定されます。

例

# add by explicit keys
uip tm testcases add \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1 DEMO:2

# add every test case carrying one of the given labels
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels PW_Tag_smoke PW_Project_chromium

データシェイプ

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

--labelsで追加する場合、応答には も含まれますMatchedLabels

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:3, DEMO:4, DEMO:7",
    "MatchedLabels": "PW_Tag_smoke, PW_Project_chromium",
    "Result": "Added"
  }
}

uip tm testcases remove

テスト セットから 1 つ以上のテスト ケースを削除します。

引数

設定はありません。

オプション

フラグ	説明
--test-set-key <key>	必須。テスト セットのオブジェクト キー (例: DEMO:42)。
--test-case-keys <keys>	必須。削除するコンマ区切りのテスト ケース キーです (例: DEMO:1,DEMO:2)。
-y, --yes	確認プロンプトをスキップします。非対話型環境では必要です。

例

uip tm testcases remove \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1,DEMO:2 \
  --yes

データシェイプ

{
  "Code": "TestSetRemoveTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

uip tm testcases list-steps

テスト ケースの手動テスト ステップを一覧表示します。これは のエイリアス testcases steps list。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー (例: DEMO)。
--test-case-id <uuid>	必須。内部テスト ケースの UUID。

例

uip tm testcases list-steps \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

データシェイプ

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

uip tm testcases steps

testcases steps は、テスト ケースの個々の手動ステップ (リスト、取得、追加、更新、移動、削除) を管理するサブグループです。

uip tm testcases steps list

テスト ケースのステップを順番に列挙します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー。
--test-case-id <uuid>	必須。内部テスト ケースの UUID。

例

uip tm testcases steps list \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

データシェイプ

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

uip tm testcases steps get

UUID で 1 つのステップを取得します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー。
--step-id <uuid>	必須。テスト ステップ UUID ( steps listから)。

例

uip tm testcases steps get \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001

データシェイプ

{
  "Code": "TestStepGet",
  "Data": {
    "Id": "d4e5f6a7-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed"
  }
}

uip tm testcases steps add

テスト ケースに 1 つ以上のステップを追加します。インライン フラグは 1 つのステップに使用し、複数のステップに一度に --step <json> (繰り返し可能) を使用します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー。
--test-case-id <uuid>	必須。ステップを追加するテスト ケース
--description <text>	ステップの説明 (シングルステップ モード)
--expected-result <text>	期待される結果 (シングルステップ モード)。
--action-type <type>	ステップ アクションの種類 (シングル ステップ モード)。
--clipboard-data <text>	ステップ用にコピーするテスト データ (シングルステップ モード)。
--order-no <n>	0 ベースの挿入位置。末尾の追加を省略します (シングルステップ モード)。
--step <json>	JSON オブジェクトとしてのステップ ({"description":"...","expectedResult":"..."})。手順を繰り返して、複数のステップを追加します。

例

# single step
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --description "Open login page" \
  --expected-result "Login form is displayed"

# multiple steps
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --step '{"description":"Open login page","expectedResult":"Login form is shown"}' \
  --step '{"description":"Enter credentials","clipboardData":"[e-mail]"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'

データシェイプ

{
  "Code": "TestStepAdd",
  "Data": {
    "AddedCount": 1,
    "Steps": [
      {
        "Id": "d4e5f6a7-0000-0000-0000-000000000001",
        "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
        "OrderNo": 0,
        "ActionType": "",
        "Description": "Open login page",
        "ExpectedResult": "Login form is displayed",
        "ClipboardData": ""
      }
    ]
  }
}

ステップの追加はアトミックではありません。複数ステップのバッチ --step 1 つのステップが失敗した場合、その前のステップは作成されたままになります。エラー メッセージには成功した件数が報告されるため、 steps list で調べて残りの部分のみをリトライできます。

uip tm testcases steps update

ステップの説明、期待される結果、アクションの種類、クリップボードのデータを更新します。これらのフィールドの少なくとも 1 つを指定する必要があります。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー。
--step-id <uuid>	必須。テスト ステップ UUID。
--description <text>	新しい説明。
--expected-result <text>	新しい期待される結果。
--action-type <type>	新しいアクションの種類。
--clipboard-data <text>	新しいクリップボード データ。

例

uip tm testcases steps update \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --expected-result "Dashboard is shown"

データシェイプ

{
  "Code": "TestStepUpdate",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

uip tm testcases steps move

テスト ケースの順序内で、ステップを新しい位置に移動します。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー。
--step-id <uuid>	必須。テスト ステップ UUID。
--target-position <n>	必須。0 から始まる新しい位置 (0 = 最初)。steps listの OrderNo フィールドに一致します。

例

uip tm testcases steps move \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --target-position 2

データシェイプ

{
  "Code": "TestStepMove",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "TargetPosition": 2,
    "Result": "Moved"
  }
}

uip tm testcases steps delete

テスト ケースからステップを削除します。これは永続的です。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。Test Manager プロジェクト キー。
--step-id <uuid>	必須。テスト ステップ UUID。
-y, --yes	必須。この元に戻せない操作を確認します。

例

uip tm testcases steps delete \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --yes

データシェイプ

{
  "Code": "TestStepDelete",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcaselog list-assertions

単一のテスト ケース ログに対して記録されたアサーションのリストを取得します。テスト ケースを実行するたびに、テスト ケース ログが 1 つだけ生成されます。そのアサーションは、オートメーションで記録された個別のチェックです。この動詞は、テスト ケース ログが Failedとマークされている理由を明らかにします。

この動詞は、testcases や testcaselogs (複数形) ではなく、testcaselog start と testcaselog finish とともに testcaselog (単数形) に登録されています。uip tm testcaselogs list-assertions 存在しません。

引数

設定はありません。

オプション

フラグ	説明
--test-case-log-id <uuid>	必須。テスト ケースのログ UUID。uip tm executions testcaselogs list または uip tm testcases list-result-historyから取得します。
--project-key <key>	必須。所有するプロジェクト。

例

uip tm testcaselog list-assertions \
  --test-case-log-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

データシェイプ

{
  "Code": "TestCaseLogAssertions",
  "Data": [
    { "Message": "Title contains 'Welcome'", "Succeeded": true },
    { "Message": "Button 'Login' visible", "Succeeded": false }
  ]
}

uip tm testcaselog start

既存のテスト実行内でテスト ケースの実行を開始します。オートメーションや連携で手動または混合テスト用のテスト ケースの実行を記録するために使用されます。ほとんどのユーザーはこれを直接呼び出しません。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--execution-id <uuid>	必須。テスト ケースが実行されているテスト実行。
--test-case-id <uuid>	必須。ログに記録されるテスト ケースの内部 UUID。
--run-id <number>	記録する実行 ID です。実行の現在の RunIdから自動的に検索する場合は省略します。

例

uip tm testcaselog start \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001

データシェイプ

{
  "Code": "TestCaseLogStart",
  "Data": {
    "Id": "c3d4e5f6-0000-0000-0000-000000000001",
    "TestCaseId": "b2c3d4e5-0000-0000-0000-000000000001",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "None",
    "BusinessResult": "None",
    "OriginalResult": "None",
    "Status": "Running",
    "ExecutionType": "manual",
    "HasError": false,
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "ExecutionEnd": null,
    "ExecutedBy": "[e-mail]",
    "RunId": 1,
    "Updated": "2025-04-15T10:30:00Z"
  }
}

テスト ケースのログの UUID をIdします。実行が完了したら、uip tm teststeplog list または testcaselog list-assertions に渡します。完全な応答にはさらに多くのフィールド (AutomationId、 JobKey、 PreCondition、 PostConditionなど) が含まれますが、開始時にはほとんどが空です。ここには、進行状況の追跡に関連するフィールドのみが表示されます。

uip tm testcaselog finish

testcaselog startで開始したテスト ケースの実行を完了し、全体的な結果と (任意で) すべてのステップの結果を 1 回の呼び出しで記録します。

重要:

このコマンドには --test-case-log-id フラグや --info フラグはありません。finish は、返されるログ UUID ではなく、 --execution-id + --test-case-id ( startに渡されたのと同じペア) によって実行を再識別 start 。

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--execution-id <uuid>	必須。テスト実行は testcaselog startに渡されました。
--test-case-id <uuid>	必須。testcaselog startに渡されたテスト ケース。
--result <result>	必須。総合的な結果 (SDK Result 列挙型 (例: Passed、 Failed) )。
--has-error <boolean>	必須。実行でエラーありとしてマークします (true/false)。
--executed-by <email>	必須。テストを実行したユーザーのメール アドレスです。
--detail-link <url>	実行に関する追加の詳細を含む URL です。
--run-id <number>	記録する実行 ID です。実行の現在の RunIdから自動的に検索する場合は省略します。
--is-post-condition-met <boolean>	事後条件が満たされているかどうかをマークします。
--step-logs <json>	このテスト ケースの実行に対して記録するステップ ログ オブジェクトの JSON 配列です。--step-logs-fileと相互に排他的です。
--step-logs-file <path>	と同じ形状の JSON ファイルへのパス --step-logs。--step-logsと相互に排他的です。

例

# finish with step results inline
uip tm testcaselog finish \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001 \
  --result Passed \
  --has-error false \
  --executed-by [e-mail] \
  --is-post-condition-met true \
  --step-logs '[{"id":"3fa85f64-0000-0000-0000-000000000001","testStepId":"d4e5f6a7-0000-0000-0000-000000000001","result":"Passed","orderNo":1,"hasError":false,"hasAttachment":false}]'

# finish with step results loaded from a file
uip tm testcaselog finish \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001 \
  --result Failed \
  --has-error true \
  --executed-by [e-mail] \
  --step-logs-file ./step-logs.json

データシェイプ

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "Id": "c3d4e5f6-0000-0000-0000-000000000001",
    "TestCaseId": "b2c3d4e5-0000-0000-0000-000000000001",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Passed",
    "BusinessResult": "Passed",
    "OriginalResult": "Passed",
    "Status": "Finished",
    "ExecutionType": "manual",
    "HasError": false,
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "ExecutionEnd": "2025-04-15T10:31:00Z",
    "ExecutedBy": "[e-mail]",
    "RunId": 1,
    "IsPostConditionMet": true,
    "Updated": "2025-04-15T10:31:00Z"
  }
}

関連

• pack — Playwright プロジェクトをパッケージ化し、取り込み時にそのテスト ケースを自動リンクします。作成されるテスト ケースには link-automation を使用しないでください。
• プロジェクト — すべてのテスト ケースを所有するスコープです。
• テストセット — テスト ケースを実行可能なスイートにグループ化します。
• Executions — テスト ケース ログの実行レベルのビュー。
• レポート — 実行の概要。失敗したケースとアサーション テキストが含まれます。

参照

• Test Manager の概要
• uip or folders list — link-automation と list-automationsの--folder-keyのソースです。
• uip or packages — Orchestrator パッケージとエントリ ポイントの登録方法。