UiPath Documentation
uipath-cli
latest
false
UiPath CLI ユーザー ガイド
重要 :
このコンテンツは機械翻訳によって処理されています。 新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

uipTMテストケース

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

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

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

概要​

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>]
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 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>
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 testcaselogs list-assertions --project-key <key> --test-case-log-id <uuid>

uip tm testcaselog start --execution-id <uuid> --test-case-id <uuid> [--execution-type <type>]
uip tm testcaselog finish --test-case-log-id <uuid> [--info <text>]
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>]
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 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>
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 testcaselogs list-assertions --project-key <key> --test-case-log-id <uuid>

uip tm testcaselog start --execution-id <uuid> --test-case-id <uuid> [--execution-type <type>]
uip tm testcaselog finish --test-case-log-id <uuid> [--info <text>]

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

uip tm テストケースの作成​

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

引数​

設定はありません。

オプション​

フラグ説明
--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"
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"
  }
}
{
  "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 のテスト ケースのリスト​

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

引数​

設定はありません。

オプション​

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

例​

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

データシェイプ​

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

uip tm テストケース 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
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"
    }
  ]
}
{
  "Code": "TestCaseResultHistory",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionEnd": "2025-04-15T12:00:00Z"
    }
  ]
}

uip tm テストケースの更新​

テスト ケースの名前を変更したり、説明を変更したりします。少なくとも 1 つ --name または --description が必要です。

引数​

設定はありません。

オプション​

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

例​

uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"
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)",
    "Result": "Updated"
  }
}
{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "Result": "Updated"
  }
}

uip tm テスト ケース 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
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"
  }
}
{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

Orchestrator パッケージのエントリ ポイントをテスト ケースにバインドします。これにより、テスト ケースをテスト セット内で実行できるようになります。内部的には、このコマンドはフォルダーの表示 --folder-key名を から解決し、一致するパッケージのエントリ ポイントを名前で検索して、テスト ケースにバインドを格納します。

引数​

設定はありません。

オプション​

フラグ説明
--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
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"
  }
}
{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "PackageName": "InvoiceTests",
    "PackageSource": "Shared",
    "TestName": "SmokeTest",
    "Result": "Linked"
  }
}

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

引数​

設定はありません。

オプション​

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

例​

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

データシェイプ​

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}
{
  "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。
--package-name <name>リストをフィルター処理して 1 つのパッケージにします (大文字と小文字を区別しない完全一致)。

例​

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001
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"
    }
  ]
}
{
  "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
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"
    }
  ]
}
{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001"
    }
  ]
}

uip tm テストケースの実行​

最初にテスト セットを作成することなく、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"
# 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 900000
uip tm report get --execution-id "$id" --project-key DEMO
# 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 900000
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"}]'
# 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 }
  }
}
{
  "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 ms — 15 minutes here)
uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 900000

# 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
# 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 ms — 15 minutes here)
uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 900000

# 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 テストケースに追加​

既存のテスト セットに 1 つ以上のテスト ケースを追加します。

引数​

設定はありません。

オプション​

フラグ説明
--test-set-key <key>必須。テスト セットのオブジェクト キー (例: DEMO:42)。
--test-case-keys <keys>必須。追加するコンマ区切りのテスト ケース キーです (例: DEMO:1,DEMO:2)。

例​

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

データシェイプ​

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

uip tm のテストケースの削除​

テスト セットから 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
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1,DEMO:2 \
  --yes

データシェイプ​

{
  "Code": "TestCaseRemove",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}
{
  "Code": "TestCaseRemove",
  "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
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"
    }
  ]
}
{
  "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"
    }
  ]
}

uipTM テストケースの手順​

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

uipTM テストケースのステップリスト​

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

引数​

設定はありません。

オプション​
フラグ説明
--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
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"
    }
  ]
}
{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

uip tm テストケース ステップ 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
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"
  }
}
{
  "Code": "TestStepGet",
  "Data": {
    "Id": "d4e5f6a7-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed"
  }
}

uipTM テストケースの手順 追加​

テスト ケースに 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":"[email protected]"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'
# 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":"[email protected]"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'
データシェイプ​
{
  "Code": "TestStepAdd",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}
{
  "Code": "TestStepAdd",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

uipTM テストケースのステップの更新​

ステップの説明、期待される結果、アクションの種類、クリップボードのデータを更新します。これらのフィールドの少なくとも 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"
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"
  }
}
{
  "Code": "TestStepUpdate",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

uipTM テストケースのステップの移動​

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

引数​

設定はありません。

オプション​
フラグ説明
--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
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"
  }
}
{
  "Code": "TestStepMove",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "TargetPosition": 2,
    "Result": "Moved"
  }
}

uipTM テストケースの手順 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
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"
  }
}
{
  "Code": "TestStepDelete",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcaselogs list-assertions​

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

この動詞は testcasesではなく testcaselogsで登録されますが、テスト ケースのログのアサーション アーティファクトを読み取るため、こちらで説明しています。

引数​

設定はありません。

オプション​

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

例​

uip tm testcaselogs list-assertions \
  --test-case-log-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO
uip tm testcaselogs 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 }
  ]
}
{
  "Code": "TestCaseLogAssertions",
  "Data": [
    { "Message": "Title contains 'Welcome'", "Succeeded": true },
    { "Message": "Button 'Login' visible", "Succeeded": false }
  ]
}

uip tm testcaselog start​

実行内の特定のテスト ケースに対する手動テスト用のテスト ケース ログ エントリの開始を通知します。

引数​

設定はありません。

オプション​

フラグ説明
--execution-id <uuid>必須。テスト ケースが実行されている実行。
--test-case-id <uuid>必須。ログに記録されるテスト ケースの内部 UUID。
--execution-type <type>ログ エントリの実行の種類 (例: automated、 manual)。任意です。

例​

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

データシェイプ​

{
  "Code": "TestCaseLogStart",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Status": "InProgress"
  }
}
{
  "Code": "TestCaseLogStart",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Status": "InProgress"
  }
}

uip tm testcaselog finish​

手動で開始したテスト ケース ログ エントリの終了を通知します。

引数​

設定はありません。

オプション​

フラグ説明
--test-case-log-id <uuid>必須。testcaselog startが返すログ ID です。
--info <text>ログ エントリに添付する任意のエラー メッセージまたは通知メッセージ。

例​

uip tm testcaselog finish \
  --test-case-log-id c3d4e5f6-0000-0000-0000-000000000001 \
  --info "Login button not found on page"
uip tm testcaselog finish \
  --test-case-log-id c3d4e5f6-0000-0000-0000-000000000001 \
  --info "Login button not found on page"

データシェイプ​

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Result": "Finished"
  }
}
{
  "Code": "TestCaseLogFinish",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Result": "Finished"
  }
}
  • プロジェクト — すべてのテスト ケースを所有するスコープです。
  • テストセット — テスト ケースを実行可能なスイートにグループ化します。
  • Executions — テスト ケース ログの実行レベルのビュー。
  • レポート — 実行の概要。失敗したケースとアサーション テキストが含まれます。

参照​

このページは役に立ちましたか?

接続

ヘルプ リソース サポート

学習する UiPath アカデミー

質問する UiPath フォーラム

最新情報を取得