uipTMテストケース

uip tm testcases Test Manager プロジェクト内のテスト ケースを管理します。Orchestrator オートメーションの作成、一覧表示、更新、削除、リンク/リンク解除、履歴結果の検査、テスト ケースを含むテスト セットのリスト表示を行います。このページでは、単一のテスト ケース ログに添付されたアサーション成果物を読み込む uip tm testcaselog list-assertionsと、オートメーションが手動ログ エントリを記録するために使用する testcaselog start / testcaselog finish 動詞についても説明します。

テスト ケースは作成者の単位です。testcases link-automationでパッケージエントリポイントにリンクされると実行可能になり、テストセットの一部として実行されます(テストセットを参照)。

概要

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"

データシェイプ

{
  "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-historyとlist-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

データシェイプ

{
  "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

データシェイプ

{
  "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"

データシェイプ

{
  "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

データシェイプ

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

uip tm テストケース link-automation

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

データシェイプ

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Linked"
  }
}

uip tm テストケース 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に渡す--automation-id値を見つけます。

引数

設定はありません。

オプション

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

例

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

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

データシェイプ

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

uip tm テストケースの実行

テスト セットを最初に作成せずに、1 つ以上のテスト ケースの新しい実行を直接実行します。CLI は一時的なテスト セットを作成して実行し、 ExecutionIdを返します。

引数

設定はありません。

オプション

• --project-key <key> (必須) — プロジェクトを所有しています。
• --test-case-id <uuid...> (必須) — 実行する 1 つ以上のテスト ケース UUID (スペース区切り)。
• --name <name> (必須) — 新しい実行の名前。
• --execution-type <type> (必須) — 実行するテスト ケース ( automated、 manual、 mixed、または none) です。
• --async — ポーリングなしでキューに入った直後に戻ります。
• --folder-key <uuid> — 実行する Orchestrator のフォルダー。
• --runtime-type <type> — ロボットのランタイムの種類 (例: Unattended
• --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"}].

例

uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Smoke run"

データシェイプ

{
  "Code": "TestCaseRun",
  "Data": {
    "ExecutionId": "b2c3d4e5-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

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

データシェイプ

{
  "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

データシェイプ

{
  "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

データシェイプ

{
  "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

データシェイプ

{
  "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

データシェイプ

{
  "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":"[e-mail]"}' \
  --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"
    }
  ]
}

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"

データシェイプ

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

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

データシェイプ

{
  "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

データシェイプ

{
  "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

データシェイプ

{
  "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"

データシェイプ

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Result": "Finished"
  }
}

関連

• プロジェクト — すべてのテスト ケースを所有するスコープです。
• テストセット — テスト ケースを実行可能なスイートにグループ化します。
• Executions — テスト ケース ログの実行レベルのビュー。
• レポート — 実行の概要。失敗したケースとアサーション テキストが含まれます。

参照

• Test Manager の概要
• uip or folders list — list-automationsの--folder-keyのソース。