uip tm testcases

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

uip tm testcases manages test cases within a Test Manager project: create, list, update, delete, link or unlink an Orchestrator automation, inspect historical results, and add or remove test cases from a test set. It also provides testcases run — a way to execute one or more test cases directly from an Orchestrator package. This page also documents uip tm testcaselog list-assertions, testcaselog start, and testcaselog finish (registered under testcaselog, singular), which read assertion artifacts and record manual log entries for a test case log.

テスト ケースは作成者の単位です。このアクティビティは、 を使用してパッケージのエントリ ポイントにリンクされると実行可能になります 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, and finish are registered under uip tm testcaselog (singular). uip tm testcaselogs list-assertions and uip tm testcaselogs start/finish do not exist as commands.

All verbs honor the global options and the standard exit codes.

注:

--log-level <level> (default Information) is available on create, list, list-result-history, update, delete, link-automation, link-package, unlink-automation, list-automations, list-testsets, add, and remove. It does not exist on run, any steps subcommand (including the list-steps alias), or 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

Rename a test case, or change its description, pre-condition, or post-condition. At least one of these fields is required.

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--test-case-key <key>	必須。テスト ケース キー (例: DEMO:1)。
--name <name>	新しい名前。
--description <text>	新しい説明。
--pre-condition <text>	New precondition — what must be true before running the test.
--post-condition <text>	New postcondition — what should be true after running the test.

例

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 testcases link-package

Create and link a test case for every test in an Orchestrator package, in one call — the bulk counterpart to link-automation, which links one existing test case to one automation. By default it links every test the folder exposes; scope it to one package with --package-name, or to specific tests with --test-name. Each test either creates a new test case (Action: "Created") or reuses one already linked to that automation (Action: "Reused").

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--folder-key <uuid>	必須。Orchestrator フォルダーの UUID ( uip or folders listから)。
--package-name <name>	Only link tests from this package (case-insensitive exact match). Omit to link every test the folder exposes.
--test-name <name...>	Only link these tests (case-insensitive, repeatable). Omit to link all of them.
--dry-run	Preview which test cases would be created, reused, and linked, without writing anything.

例

# 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"
    }
  ]
}

With --dry-run, the Code is TestCaseLinkPackageDryRun instead, Action values become WouldCreate/WouldReuse, and TestCaseKey/TestCaseId are empty strings since nothing was actually written.

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 folder UUID. Omit to search across the tenant feed instead of one folder.
--package-name <name>	Filter the list to one package (case-insensitive exact match, not a substring search).

例

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

Add test cases to an existing test set, either by explicit keys or by label. Pass exactly one of --test-case-keys or --labels.

引数

設定はありません。

オプション

フラグ	説明
--test-set-key <key>	必須。テスト セットのオブジェクト キー (例: DEMO:42)。
--test-case-keys <keys...>	Test case keys to add, space-separated (for example, DEMO:1 DEMO:2). Comma-separated values are also accepted. Mutually exclusive with --labels.
--labels <labels...>	Space-separated label names. Adds every test case in the project carrying at least one of the labels — including the PW_Tag_*, PW_Project_*, PW_Suite_*, and PW_File_* labels applied by pack at ingestion. Mutually exclusive with --test-case-keys.
--limit <count>	Maximum number of label-matched test cases to add. Only valid with --labels. Defaults to all matches.

例

# 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"
  }
}

When adding by --labels, the response also includes 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": ""
      }
    ]
  }
}

Adding steps is not atomic: if one step in a multi-step --step batch fails, the steps before it remain created. The error message reports how many succeeded so you can inspect with steps list and retry only the remainder.

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とマークされている理由を明らかにします。

This verb is registered under testcaselog (singular), alongside testcaselog start and testcaselog finish below — not under testcases or testcaselogs (plural). uip tm testcaselogs list-assertions does not exist.

引数

設定はありません。

オプション

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

Start a test case execution within an existing test execution. Used by automations and integrations to record manual or mixed test case runs — most users don't call this directly.

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--execution-id <uuid>	Required. The test execution in which the test case is running.
--test-case-id <uuid>	必須。ログに記録されるテスト ケースの内部 UUID。
--run-id <number>	Run ID to record against. Omit to look it up automatically from the execution's current 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"
  }
}

Id is the test case log UUID — pass it to uip tm teststeplog list or testcaselog list-assertions once the run is finished. The full response includes many more fields (AutomationId, JobKey, PreCondition, PostCondition, and others) mostly empty at start time; only the fields relevant to tracking progress are shown here.

uip tm testcaselog finish

Finish a test case execution started with testcaselog start, recording the overall result and (optionally) every step result in one call.

重要:

There is no --test-case-log-id or --info flag on this command. finish re-identifies the run via --execution-id + --test-case-id (the same pair passed to start), not by the log UUID start returned.

引数

設定はありません。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--execution-id <uuid>	Required. The test execution passed to testcaselog start.
--test-case-id <uuid>	Required. The test case passed to testcaselog start.
--result <result>	Required. Overall result (from the SDK Result enum, for example Passed, Failed).
--has-error <boolean>	Required. Mark the execution as having an error (true/false).
--executed-by <email>	Required. Email of the user who executed the test.
--detail-link <url>	URL with additional execution details.
--run-id <number>	Run ID to record against. Omit to look it up automatically from the execution's current RunId.
--is-post-condition-met <boolean>	Mark whether the post-condition was met.
--step-logs <json>	JSON array of step log objects to record for this test case execution. Mutually exclusive with --step-logs-file.
--step-logs-file <path>	Path to a JSON file with the same shape as --step-logs. Mutually exclusive with --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 パッケージとエントリ ポイントの登録方法。