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 testcaselog list-assertionsと、手動のログ エントリを記録するためにオートメーションで使用される testcaselog start / testcaselog finish 動詞についても説明します。

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

概要

uip tm testcases create --project-key <key> --name <name> [--description <text>] [--precondition <text>] [--postcondition <text>]
uip tm testcases list --project-key <key> [--filter <text>] [--limit <n>] [--offset <n>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [--limit <n>] [--offset <n>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--precondition <text>] [--postcondition <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> --automation-id <uuid>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-id <uuid>
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 testcaselog 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>] [--precondition <text>] [--postcondition <text>]
uip tm testcases list --project-key <key> [--filter <text>] [--limit <n>] [--offset <n>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [--limit <n>] [--offset <n>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--precondition <text>] [--postcondition <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> --automation-id <uuid>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-id <uuid>
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 testcaselog 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>]

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

uip tm テストケースの作成

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

引数

設定はありません。

オプション

  • --project-key <key> (必須) — プロジェクトを所有しています。
  • --name <name> (必須) — テスト ケース名。
  • --description <text> — 自由形式の説明。既定値は空です。
  • --precondition <text> — 前提条件テキスト。既定値は空です。
  • --postcondition <text> — 事後条件テキスト。既定値は空です。

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"
  }
}
{
  "Code": "TestCaseCreate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Login smoke",
    "Description": "Logs in and out"
  }
}

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

uip tm のテスト ケースのリスト

プロジェクト内のすべてのテスト ケースのリストを取得します。

引数

設定はありません。

オプション

  • --project-key <key> (必須) — リストするプロジェクト。
  • --filter <text> — 名前またはキーでフィルタリングします (サーバー側検索)。
  • --limit <n> — ページ サイズ。既定値は [ 50です。
  • --offset <n> — スキップする結果。既定値は [ 0です。

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

データシェイプ

{
  "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
  • --limit <n> — ページ サイズ。既定値は [ 50です。
  • --offset <n> — スキップする結果。既定値は [ 0です。

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

データシェイプ

{
  "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 つを指定する必要があります。

引数

設定はありません。

オプション

  • --project-key <key> (必須) — プロジェクトを所有しています。
  • --test-case-key <key> (必須) — テスト ケース キー (例: DEMO:1)。
  • --name <name> — 新しい名前。
  • --description <text> — 新しい説明。
  • --precondition <text> — 新しい前提条件テキスト。
  • --postcondition <text> — 新しい事後条件テキスト。

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

データシェイプ

{
  "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 のオートメーションをオートメーション UUID でテスト ケースにバインドします。これにより、テスト ケースがテスト セット内で実行可能になります。testcases list-automationsを実行して、指定されたフォルダーの--automation-idを検出します。

引数

設定はありません。

オプション

  • --project-key <key> (必須) — プロジェクトを所有しています。
  • --test-case-key <key> (必須) — バインドするテスト ケース。
  • --automation-id <uuid> (必須) — Orchestrator オートメーションの UUID (パッケージのエントリ ポイント) です。uip tm testcases list-automationsから取得します。

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --automation-id f0f0f0f0-0000-0000-0000-000000000001
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --automation-id f0f0f0f0-0000-0000-0000-000000000001

データシェイプ

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Linked"
  }
}
{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
    "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に渡す--automation-id値を見つけます。

引数

設定はありません。

オプション

  • --folder-key <uuid> (必須) — Orchestrator フォルダー UUID。
  • --package-name <name> — リストを 1 つのパッケージに絞り込みます (大文字と小文字を区別しない完全一致)。

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

データシェイプ

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}
{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}

uip tm testcases list-testsets

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

引数

設定はありません。

オプション

  • --project-key <key> (必須) — プロジェクトを所有しています。
  • --test-case-id <uuid> (必須) — 内部テスト ケースの UUID ( PROJECT:N キーではありません)。testcases list または TestCaseCreate 応答から取得します。

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

データシェイプ

{
  "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を渡す。実行が完了するまでブロックするには、返された Iduip 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> (必須) — 実行の種類です。 automatedmanualmixed、または noneです。
  • --name <name> — 実行の表示名です。
  • --async — サーバーが実行の開始を確認するのを待たずに、キューイング後すぐにに戻ります。実行レコードが完全に作成されるのを待ってから戻ることを省略します。
  • --folder-key <uuid> — 実行する Orchestrator のフォルダーです。テスト ケースが特定のフォルダー内のオートメーションにリンクされている場合に必要です。
  • --runtime-type <type> — ロボット ランタイムの種類の上書き。許容値は、 nonProductionattendedunattendedrpaDeveloperstudioXheadlessrpaDeveloperProtestAutomationautomationCloudserverlessautomationKitserverlessTestAutomationautomationCloudTestAutomationattendedStudioWebhostingassistantWebprocessOrchestrationagentServiceappTestperformanceTestbusinessRulecaseManagement
  • --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 }
  }
}

主なフィールド

  • Iduip tm waitreport getresult downloadattachment 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. 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)

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

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

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

# 8. 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. 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)

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

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

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

# 8. 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": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}
{
  "Code": "TestSetAddTestCases",
  "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": "TestSetRemoveTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}
{
  "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-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-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> (必須) — プロジェクトを所有しています。
  • --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-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":"user@acme.com"}' \
  --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":"user@acme.com"}' \
  --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> (必須) — プロジェクトを所有しています。
  • --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> (必須) — プロジェクトを所有しています。
  • --step-id <uuid> (必須) — テストステップUUID。
  • --target-position <n> (必須) — 新しい0ベースのポジション(0 = first)。steps listOrderNo フィールドと一致します。
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> (必須) — プロジェクトを所有しています。
  • --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 testcaselog list-assertions

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

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

引数

設定はありません。

オプション

  • --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
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 }
  ]
}
{
  "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> — ログ エントリの実行タイプです (例: automatedmanual)。任意です。

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 フォーラム

最新情報を取得