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

uip tm testcases

「uip tm testcases」の構文とオプション。テスト ケースの作成、一括作成、複製、一覧表示、更新、削除、エクスポート、ステップとパラメーターの管理、オートメーションのリンク、テスト セットへのテスト ケースの割り当てを行います。

Test Manager プロジェクト内のテスト ケースを管理uip tm testcases、一度に 1 つずつ作成するか、ファイルから一括で作成するか、別のテスト ケースのコピーとして作成するかそれらを取得、一覧表示、更新、削除、エクスポートするOrchestrator のオートメーションをリンクまたはリンク解除する過去の結果、およびテスト ケースが割り当てられているテスト セットと要件を調べるテスト ケースをキーで静的に、またはラベルで動的に、テスト セットに追加またはテスト セットから削除します。また、Orchestrator パッケージから直接 1 つ以上のテスト ケースを実行する testcases runと、テスト ケースの手動ステップとパラメーターを管理する testcases steps サブグループと testcases parameters サブグループも用意されています。テスト ケースのログを記録および検査する動詞 ( testcaselog start、 testcaselog finish、 testcaselog list-assertionsなど) は、 テスト ケース ログ のページに記載されています。

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

警告:

uip tm pack が Playwright プロジェクト用に作成したテスト ケースに対してtestcases link-automationを実行しないでください。Playwright のテスト ケースは、パック時の取り込み中に自動的にリンクされます。これらのサーバーに対して手動で link-automation を実行すると、代わりに RPA リンク パイプラインがたどられ、その関連付けが破損します。--no-create-test-casesでパックしたテスト ケースがまだ存在しない場合は、テスト ケースを作成してから、各テスト ケースを testcases link-automationでリンクし、表示されているspecPath > testTitle名を --test-name渡します。

概要​

uip tm testcases create <project> --name <name> [--description <text>] [--version <version>]
uip tm testcases bulk-create <project> --file <path> [--labels <labels...>] [--requirement-key <key>] [--skip-existing]
uip tm testcases clone <project> --test-case-key <key> --new-name <name> [--include <items...>]
uip tm testcases get <project> (--test-case-key <key> | --automation-id <uuid>)
uip tm testcases list <project> [--filter <text>] [--labels <labels...>] [--automated (--folder-path <path> | --folder-key <uuid>)]
uip tm testcases list-result-history <project> --test-case-id <uuid> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <number>] [--offset <number>]
uip tm testcases update <project> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete <project> --test-case-key <key> --yes
uip tm testcases export <project> [--test-case-ids <uuid...>] [--time-zone <iana-name>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testcases group-by <project> --field <name> [--sort-order <order>]
uip tm testcases link-automation <project> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name> [--entry-point-id <uuid>]
uip tm testcases link-package <project> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
uip tm testcases unlink-automation <project> --test-case-key <key>
uip tm testcases list-automations <project> [--folder-key <uuid>] [--package-name <name>]
uip tm testcases list-packages <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-studio-projects <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-testsets <project> (--test-case-key <key> | --labels <labels...>) [--limit <number>] [--offset <number>]
uip tm testcases list-requirements <project> --test-case-key <key> [--limit <number>] [--offset <number>]
uip tm testcases run <project> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <key>] [--runtime-type <type>] [--robot-user-key <key>] [--machine-key <key>] [--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> | --dynamic])
uip tm testcases remove --test-set-key <key> (--test-case-keys <keys> | --dynamic [--labels <labels...>]) --yes

uip tm testcases steps list <project> --test-case-id <uuid>
uip tm testcases steps get <project> --step-id <uuid>
uip tm testcases steps add <project> --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> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move <project> --step-id <uuid> --target-position <n>
uip tm testcases steps delete <project> --step-id <uuid> --yes

uip tm testcases parameters list <project> (--test-case-id <uuid> | --test-case-key <key>) [--search <prefix>] [--sort-by <expression>] [--limit <number>] [--offset <number>]
uip tm testcases parameters get <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>)
uip tm testcases parameters add <project> (--test-case-id <uuid> | --test-case-key <key>) --name <name> --default-value <value> [--hint <text>] [--type <type>]
uip tm testcases parameters update <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>) [--new-name <name>] [--default-value <value>] [--hint <text>] [--type <type>]
uip tm testcases parameters delete <project> (--test-case-id <uuid> | --test-case-key <key>) --parameter-ids <uuid...> --yes
uip tm testcases create <project> --name <name> [--description <text>] [--version <version>]
uip tm testcases bulk-create <project> --file <path> [--labels <labels...>] [--requirement-key <key>] [--skip-existing]
uip tm testcases clone <project> --test-case-key <key> --new-name <name> [--include <items...>]
uip tm testcases get <project> (--test-case-key <key> | --automation-id <uuid>)
uip tm testcases list <project> [--filter <text>] [--labels <labels...>] [--automated (--folder-path <path> | --folder-key <uuid>)]
uip tm testcases list-result-history <project> --test-case-id <uuid> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <number>] [--offset <number>]
uip tm testcases update <project> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete <project> --test-case-key <key> --yes
uip tm testcases export <project> [--test-case-ids <uuid...>] [--time-zone <iana-name>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testcases group-by <project> --field <name> [--sort-order <order>]
uip tm testcases link-automation <project> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name> [--entry-point-id <uuid>]
uip tm testcases link-package <project> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
uip tm testcases unlink-automation <project> --test-case-key <key>
uip tm testcases list-automations <project> [--folder-key <uuid>] [--package-name <name>]
uip tm testcases list-packages <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-studio-projects <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-testsets <project> (--test-case-key <key> | --labels <labels...>) [--limit <number>] [--offset <number>]
uip tm testcases list-requirements <project> --test-case-key <key> [--limit <number>] [--offset <number>]
uip tm testcases run <project> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <key>] [--runtime-type <type>] [--robot-user-key <key>] [--machine-key <key>] [--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> | --dynamic])
uip tm testcases remove --test-set-key <key> (--test-case-keys <keys> | --dynamic [--labels <labels...>]) --yes

uip tm testcases steps list <project> --test-case-id <uuid>
uip tm testcases steps get <project> --step-id <uuid>
uip tm testcases steps add <project> --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> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move <project> --step-id <uuid> --target-position <n>
uip tm testcases steps delete <project> --step-id <uuid> --yes

uip tm testcases parameters list <project> (--test-case-id <uuid> | --test-case-key <key>) [--search <prefix>] [--sort-by <expression>] [--limit <number>] [--offset <number>]
uip tm testcases parameters get <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>)
uip tm testcases parameters add <project> (--test-case-id <uuid> | --test-case-key <key>) --name <name> --default-value <value> [--hint <text>] [--type <type>]
uip tm testcases parameters update <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>) [--new-name <name>] [--default-value <value>] [--hint <text>] [--type <type>]
uip tm testcases parameters delete <project> (--test-case-id <uuid> | --test-case-key <key>) --parameter-ids <uuid...> --yes

シノプシスでは、 <project> は --project-key <key> または --project-id <id>の略です。そのうちの1つを通過します。両方が与えられた場合、 --project-id が優先し、 --project-key は無視されます。add と remove はプロジェクトなしのオプション: プロジェクトを --test-set-key プレフィックス (DEMO:42 → project DEMO) から派生させます。

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

注:

--log-level <level> (既定では Information) は、、runsteps サブコマンド、parameters サブコマンドを除く、このページのすべての動詞で使用できます。

uip tm testcases create​

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-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 (パブリック PROJECT:N 識別子) は、他のほとんどの動詞に渡すものです。内部Id (UUID) は、 run、 export、および steps 動詞list-result-history取るものです。

UIP TM テストケース一括作成​

JSON ファイルから複数のテスト ケースを作成します。CLI は何かを送信する前にファイル全体を検証し、要求ごとに 100 個のテスト ケースを送信します。各要求は 1 つのトランザクションであり、すべてのテスト ケースを作成するか、まったく作成しません。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--file <path>必須。JSON ファイル: テスト ケースの配列、または testCases 配列を持つオブジェクトです。以下のファイル形式を参照してください。
--labels <labels...>作成したすべてのテスト ケースに付けるラベルをスペースで区切って表示します。
--requirement-key <key>作成したすべてのテスト ケースをこの要件に割り当てます (例: DEMO:5)。
--skip-existingプロジェクトに同じ名前のテスト ケースが既にある項目であれば、名前ごとにスキップします。最大 10 個の一意の名前について、名前ごとに 1 回の検索に要します。さらに、プロジェクト内のすべてのテスト ケースを 1 回読み込みます。

ファイル形式​

ファイル内の各項目は、これらのフィールドを持つオブジェクトです。不明なフィールドは却下されます。

フィールド説明
name必須。テスト ケース名。
description説明テキスト
preCondition前提条件テキスト。
postCondition事後条件テキスト。
labels空ではないラベル名の配列です (最大 100)。
steps手動ステップの配列各ステップには、必須の description と任意の expectedResult と clipboardData (最大 8,000 文字) があります。
propertiesカスタム フィールド名を文字列値にマッピングするオブジェクト。各名前はプロジェクト内の既存のテスト ケースのカスタム フィールドである必要があり、ラベル フィールドの値は許容値のいずれかである必要があります。それ以外の場合、コマンドは何かを作成する前に失敗します。
[
  {
    "name": "Login smoke",
    "description": "Logs in and out",
    "preCondition": "User account exists",
    "labels": ["Smoke"],
    "steps": [
      { "description": "Open login page", "expectedResult": "Login form is displayed" }
    ],
    "properties": { "Priority": "High" }
  },
  { "name": "Logout" }
]
[
  {
    "name": "Login smoke",
    "description": "Logs in and out",
    "preCondition": "User account exists",
    "labels": ["Smoke"],
    "steps": [
      { "description": "Open login page", "expectedResult": "Login form is displayed" }
    ],
    "properties": { "Priority": "High" }
  },
  { "name": "Logout" }
]
uip tm testcases bulk-create \
  --project-key DEMO \
  --file ./cases.json \
  --labels Imported \
  --skip-existing
uip tm testcases bulk-create \
  --project-key DEMO \
  --file ./cases.json \
  --labels Imported \
  --skip-existing

データシェイプ​

{
  "Code": "TestCaseBulkCreate",
  "Data": {
    "Requested": 3,
    "Created": 2,
    "KeysResolved": true,
    "Skipped": ["Login smoke"],
    "TestCases": [
      {
        "TestCaseKey": "DEMO:43",
        "Name": "Logout",
        "Id": "a1b2c3d4-0000-0000-0000-000000000043"
      },
      {
        "TestCaseKey": "DEMO:44",
        "Name": "Password reset",
        "Id": "a1b2c3d4-0000-0000-0000-000000000044"
      }
    ]
  }
}
{
  "Code": "TestCaseBulkCreate",
  "Data": {
    "Requested": 3,
    "Created": 2,
    "KeysResolved": true,
    "Skipped": ["Login smoke"],
    "TestCases": [
      {
        "TestCaseKey": "DEMO:43",
        "Name": "Logout",
        "Id": "a1b2c3d4-0000-0000-0000-000000000043"
      },
      {
        "TestCaseKey": "DEMO:44",
        "Name": "Password reset",
        "Id": "a1b2c3d4-0000-0000-0000-000000000044"
      }
    ]
  }
}

KeysResolved: false は、すべての項目が作成されましたが、キーを読み戻すことができなかったため、 TestCases 空で Created は空ではないことを意味します。エンベロープの Instructions フィールドには、それらを見つける方法が記載されています。要求が途中で失敗した場合、以前の要求のテスト ケースは残り、作成されたテスト ケースの数がエラー メッセージに表示されます。実行で が使用され --skip-existing場合は、同じコマンドを再実行します。それ以外の場合は、エラーの Instructionsに従って、再開元の項目に名前を付けます。ファイル全体を単純に再実行すると、重複が作成されます。

UIP TM テストケースの複製​

テスト ケースのコピーを新しい名前でキューに登録します。コピーには、説明、バージョン、事前条件と事後条件、カスタム フィールドの値、手動ステップが含まれます。ラベル、添付ファイル、要件の割り当て、パラメーター、ガバナンス データは、 --includeで名前を付ける場合にのみコピーされます。

Test Manager によってコピーはバックグラウンドで作成され、進行状況も新しいキーも報告されないため、要求が受け入れられるとすぐにコマンドは Data.Result: "Accepted" を返します。uip tm testcases list --project-key <key> --filter "<new name>"でコピーを見つけます。受け入れられた各要求は専用のコピーを作成するため、再度複製して確認しないでください。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>必須。コピーするテスト ケースです (例: DEMO:1)。
--new-name <name>必須。コピーの名前。
--include <items...>また、スペース区切りでコピーします。 labels、 documents (添付ファイル)、 requirements (要件の割り当て)、 parameters、 governance (テナントで有効化されている場合) もコピーします。既定では設定されていません。
uip tm testcases clone \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --new-name "Login smoke (copy)" \
  --include labels requirements
uip tm testcases clone \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --new-name "Login smoke (copy)" \
  --include labels requirements

データシェイプ​

{
  "Code": "TestCaseClone",
  "Data": {
    "SourceTestCaseKey": "DEMO:1",
    "Name": "Login smoke (copy)",
    "Result": "Accepted"
  }
}
{
  "Code": "TestCaseClone",
  "Data": {
    "SourceTestCaseKey": "DEMO:1",
    "Name": "Login smoke (copy)",
    "Result": "Accepted"
  }
}

UIP TM のテスト ケースは、​

単一のテスト ケースをキーまたはリンクされているオートメーションで取得します。--test-case-key または --automation-idのいずれか 1 つだけを渡します。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。
--automation-id <uuid>リンクされるオートメーションの ID です。list-automationsのPackageEntryPointId、または Studio のオートメーション ID。1 つのリンクされたテスト ケースを返します。複数のテスト ケースがオートメーションを共有している場合、どのテスト ケースが戻されるかは既定ではありません。プロジェクト内にテスト ケースがリンクされていない場合、コマンドは で失敗します ErrorCode: "not_found"。
uip tm testcases get --project-key DEMO --test-case-key DEMO:1
uip tm testcases get --project-key DEMO --test-case-key DEMO:1
uip tm testcases get \
  --project-key DEMO \
  --automation-id 7a1b2c3d-0000-0000-0000-000000000abc
uip tm testcases get \
  --project-key DEMO \
  --automation-id 7a1b2c3d-0000-0000-0000-000000000abc

データシェイプ​

{
  "Code": "TestCaseGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke",
    "Version": "1.0.0",
    "Description": "Logs in and out",
    "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
    "IsAutomated": true,
    "PackageName": "InvoiceTests",
    "PackageEntryPoint": "SmokeTest",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "AutomationId": "",
    "AutomationProjectName": "",
    "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc",
    "PackageVersion": "1.0.2",
    "HasLinkedAutomation": true,
    "Created": "2026-09-28T10:12:44.000Z",
    "Updated": "2026-09-28T10:12:44.000Z"
  }
}
{
  "Code": "TestCaseGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke",
    "Version": "1.0.0",
    "Description": "Logs in and out",
    "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
    "IsAutomated": true,
    "PackageName": "InvoiceTests",
    "PackageEntryPoint": "SmokeTest",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "AutomationId": "",
    "AutomationProjectName": "",
    "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc",
    "PackageVersion": "1.0.2",
    "HasLinkedAutomation": true,
    "Created": "2026-09-28T10:12:44.000Z",
    "Updated": "2026-09-28T10:12:44.000Z"
  }
}

uip tm testcases list​

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--filter <text>名前またはキーでフィルター処理します (サーバー側検索)。--labels と組み合わせて、一致するラベルを名前またはキーで絞り込みます。
--labels <labels...>これらのラベルを少なくとも 1 つ付いたテスト ケースのみ (スペース区切りで最大 100)。--automatedと組み合わせることはできません。
--automatedパッケージが 1 つの Orchestrator フォルダーに存在する自動化されたテスト ケースのみ。必要なのは --folder-path または --folder-keyのいずれかだけです。Playwright パッケージにリンクされたテスト ケースは省略されます。--labelsと組み合わせることはできません。
--folder-path <path>Orchestrator のフォルダー パス (例: Shared 、 Finance/AP)。--automatedの場合のみ。--folder-keyと相互に排他的です。
--folder-key <uuid>Orchestrator のフォルダー キー ( uip or folders listから)。--automatedの場合のみ。--folder-pathと相互に排他的です。
uip tm testcases list --project-key DEMO --filter login

# Name the project by ID; the key lookup is skipped
uip tm testcases list --project-id 9dfdc3ca-fc75-0100-2aae-0b46e318b723
uip tm testcases list --project-key DEMO --filter login

# Name the project by ID; the key lookup is skipped
uip tm testcases list --project-id 9dfdc3ca-fc75-0100-2aae-0b46e318b723
# test cases carrying either label
uip tm testcases list --project-key DEMO --labels Smoke Regression

# automated test cases whose package lives in the Shared folder
uip tm testcases list --project-key DEMO --automated --folder-path Shared
# test cases carrying either label
uip tm testcases list --project-key DEMO --labels Smoke Regression

# automated test cases whose package lives in the Shared folder
uip tm testcases list --project-key DEMO --automated --folder-path Shared

データシェイプ​

{
  "Code": "TestCasesList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Version": "1.0.0",
      "Description": "Logs in and out",
      "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
      "IsAutomated": false,
      "PackageName": "",
      "PackageEntryPoint": ""
    }
  ]
}
{
  "Code": "TestCasesList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Version": "1.0.0",
      "Description": "Logs in and out",
      "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
      "IsAutomated": false,
      "PackageName": "",
      "PackageEntryPoint": ""
    }
  ]
}

PackageName と PackageEntryPoint には、Test Manager の UI に表示されるとおりに、テスト ケースにリンクされているパッケージとエントリ ポイントが表示されます。パッケージがリンクされていない場合、どちらも空の文字列になります。

--automatedでは、すべての行にIsAutomated: trueが表示され、行は名前で並べ替えられます。

uip tm testcases list-result-history​

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>必須。内部テスト ケースの UUID。
--filter <text>テスト ケースのログを名前で検索します。
--only-failed失敗したテスト ケースのログのみを表示します。既定値は falseです。
--results <results...>スペースで区切られた結果です。以下を含める None、 Passed、 Failed、 Restricted。
--statuses <statuses...>スペースで区切られた実行ステータスです。 pending、 running、 cancelling、 cancelled、 finished、 failedが含まれます。
--duration-period <period>期間でフィルター処理する: last7Days、 last15Days、 last30Days、 last90Days、 last180Days、 last365Days。
--limit <number>ページあたりの結果数既定値は 50です。
--offset <number>スキップする結果の数です。既定値は 0です。

--top と --skip は引き続き --limit と --offsetの非推奨のエイリアスとして機能し、非推奨化の警告を出力します。

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 testcases update​

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>必須。テスト ケース キー (例: DEMO:1)。
--name <name>新しい名前。
--description <text>新しい説明。
--pre-condition <text>新しい前提条件 — テストを実行する前に true でなければならない内容。
--post-condition <text>新しい事後条件 — テストの実行後に当てはまる内容。
uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"
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"
  }
}
{
  "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 Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>必須。テスト ケース キー (例: DEMO:1)。
-y, --yes必須。元に戻せない削除を確定します。CLI ではプロンプトは表示されません。を指定しない --yes、コマンドは失敗し、 Result: "Failure" と終了コード 1が表示されます。
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"
  }
}

UIP TM テスト ケースのエクスポート​

テスト ケースを .xlsx ファイルにエクスポートします。Test Manager によってファイルがバックグラウンド ジョブとして構築されます。--waitを指定しないと、コマンドはジョブを返します。uip tm export-jobs getで確認し、StatusがCompletedしたら、 で ファイルをダウンロードuip tm attachment download。エンベロープの Instructions フィールドは、ジョブの両方のコマンドを指定します。--waitの場合、コマンドはジョブの実行を待機し、 に--output-fileファイルを書き込みます。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-ids <uuid...>エクスポートするテスト ケースの UUID です。スペースで区切られます。プロジェクト内のすべてのテスト ケースのエクスポートを省略します。
--time-zone <iana-name>ファイルに書き込まれるタイムスタンプの IANA タイム ゾーン (例: Europe/Bucharest)。既定値は UTCです。エクスポートが開始される前に、ゾーン名が不明になると拒否されます。
--waitエクスポートが完了するまで待ってから、 ファイルを に書き込み --output-file。
--output-file <path>.xlsx ファイルを書き込む場所です。--waitで必須です。
--overwrite--output-fileすでに存在する場合は置換します。タイムアウトが設定されていない場合、既存のファイルはエクスポートの開始前に拒否されます。
--timeout <seconds>待機する最大秒数 (0 = タイムアウトなし)。--waitが必要です。既定値は 600です。
--poll-interval <seconds>ステータス チェックの間隔 (秒)。--waitが必要です。既定値は 5です。

--waitがない場合、--output-file、--overwrite、--timeout、--poll-intervalは効果がなく、コマンドは警告をログに記録します。

# start the export and get the job back
uip tm testcases export --project-key DEMO
# start the export and get the job back
uip tm testcases export --project-key DEMO
# export two test cases, wait for the file, and write it to disk
uip tm testcases export \
  --project-key DEMO \
  --test-case-ids a1b2c3d4-0000-0000-0000-000000000011 a1b2c3d4-0000-0000-0000-000000000012 \
  --wait \
  --output-file ./testcases.xlsx
# export two test cases, wait for the file, and write it to disk
uip tm testcases export \
  --project-key DEMO \
  --test-case-ids a1b2c3d4-0000-0000-0000-000000000011 a1b2c3d4-0000-0000-0000-000000000012 \
  --wait \
  --output-file ./testcases.xlsx

データシェイプ​

--waitなし:

{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Initiated",
    "TaskType": "TestCasesExcelExport",
    "AttachmentId": null,
    "Created": "2026-10-14T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2026-10-14T10:00:00.000Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Payload": { "Ids": [], "TimeZoneId": "UTC" }
  }
}
{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Initiated",
    "TaskType": "TestCasesExcelExport",
    "AttachmentId": null,
    "Created": "2026-10-14T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2026-10-14T10:00:00.000Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Payload": { "Ids": [], "TimeZoneId": "UTC" }
  }
}

--wait:

{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Completed",
    "AttachmentId": "b2c3d4e5-0000-0000-0000-000000000002",
    "OutputFile": "./testcases.xlsx",
    "FileType": "xlsx",
    "Bytes": 9472
  }
}
{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Completed",
    "AttachmentId": "b2c3d4e5-0000-0000-0000-000000000002",
    "OutputFile": "./testcases.xlsx",
    "FileType": "xlsx",
    "Bytes": 9472
  }
}

Idは、エクスポート ジョブの ID です。ジョブが完了するまでAttachmentIdnullです。

UIP TM テスト ケースのグループ化​

カスタム ラベル フィールド (例: Priority) の値ごとにプロジェクトのテスト ケースをカウントします。Test Cloud のライセンスが必要です。フィールドに値がないテスト ケースは、 Value: nullにカウントされます。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--field <name>必須。グループ化に使用するカスタム ラベル フィールドの名前で、大文字と小文字なしで一致します。その名前が付いたテスト ケースのラベル フィールドがない場合、コマンドは で失敗します ErrorCode: "not_found"。グループ化できるフィールドを uip tm customfield list --project-key <key> --object-types TestCase --data-types Labelで一覧表示します。
--sort-order <order>値を並べ替えます ( asc または desc)。既定値は ascです。
uip tm testcases group-by --project-key DEMO --field Priority
uip tm testcases group-by --project-key DEMO --field Priority

データシェイプ​

{
  "Code": "TestCaseGroupBy",
  "Data": [
    { "Value": "High", "Count": 8 },
    { "Value": "Low", "Count": 3 },
    { "Value": null, "Count": 2 }
  ]
}
{
  "Code": "TestCaseGroupBy",
  "Data": [
    { "Value": "High", "Count": 8 },
    { "Value": "Low", "Count": 3 },
    { "Value": null, "Count": 2 }
  ]
}

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>必須。バインドするテスト ケース。
--folder-key <uuid>必須。Orchestrator フォルダーの UUID ( uip or folders listから)。UUID ではない値は で失敗 ErrorCode: "invalid_argument"。
--package-name <name>必須。Orchestrator のパッケージ識別子です (例: InvoiceTests)。
--test-name <name>必須。パッケージ内のテスト名です。UiPath パッケージの場合は、テスト名です (例: SmokeTest)。Playwright パッケージの場合、表示される specPath > testTitle 名です (例: "tests/login.spec.ts > Signs in")。--entry-point-id指定されている場合は無視されますが、それでも必須です。
--entry-point-id <uuid>パッケージのエントリ ポイント ID、list-automationsのPackageEntryPointId。ID で直接バインドし、 --test-nameは無視します。名前が長すぎて入力できず、 list-automations で切り捨てられている …表示されている場合に使用します。

…を含む--test-name値は切り捨てられた名前であり、一致させることはできません。--entry-point-id指定しないと、コマンドは失敗し、ID の入力を求められます。

# Link a UiPath test
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

# Link a Playwright test by its displayed 'specPath > testTitle' name
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:2 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/login.spec.ts > Signs in"

# Link by entry-point ID when the name shows truncated in list-automations
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:3 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/checkout.spec.ts > …" \
  --entry-point-id 7a1b2c3d-0000-0000-0000-000000000abc
# Link a UiPath test
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

# Link a Playwright test by its displayed 'specPath > testTitle' name
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:2 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/login.spec.ts > Signs in"

# Link by entry-point ID when the name shows truncated in list-automations
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:3 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/checkout.spec.ts > …" \
  --entry-point-id 7a1b2c3d-0000-0000-0000-000000000abc

データシェイプ​

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

TestName は、バインドされたエントリ ポイントのフル ネームです。 --entry-point-idでバインドした場合も同様です。

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--folder-key <uuid>必須。Orchestrator フォルダーの UUID ( uip or folders listから)。
--package-name <name>このパッケージのテストのみをリンクします (大文字と小文字を区別しない完全一致)。フォルダーで公開されるすべてのテストのリンクを省略します。
--test-name <name...>これらのテストのみをスペース区切りでリンクします (大文字と小文字は区別されません)。それらすべてをリンクする場合は省略します。
--dry-run作成、再利用、リンクされるテスト ケースを、何も入力せずにプレビューする
# Create and link a test case for every test in one Orchestrator package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests
# 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
# 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
# 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"
    }
  ]
}
{
  "Code": "TestCaseLinkPackage",
  "Data": [
    {
      "TestName": "SmokeTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:7",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000007",
      "Action": "Created"
    },
    {
      "TestName": "RegressionTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:3",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000003",
      "Action": "Reused"
    }
  ]
}

--dry-runでは、代わりにCodeがTestCaseLinkPackageDryRunされ、Action値は WouldCreate/WouldReuseになり、WouldCreate行で TestCaseKey/TestCaseId が空になり、WouldReuse行で既存のテスト ケースに名前が付けられます。

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

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-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値、または として渡すPackageEntryPointId --entry-point-idを検出します。link-package は、同じエントリ ポイントのセットに対して動作します。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--folder-key <uuid>Orchestrator フォルダーの UUID。1 つのフォルダーではなくテナント フィード全体を検索することを省略します。
--package-name <name>リストをフィルター処理して 1 つのパッケージにします (大文字と小文字を区別しない完全一致)。
uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001
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",
      "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc"
    }
  ]
}
{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2",
      "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc"
    }
  ]
}

uip tm testcases list-packages​

プロジェクトの自動テスト ケースがリンクされている個別の Orchestrator パッケージ名を一覧表示します。名前は並べ替えられ、並べ替えられたリストからページ --limit / --offset されます。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--filter <prefix>このテキストで始まる名前のみ (部分文字列ではなく、プレフィックスの一致)。
--limit <number>返す名前の数。既定値は 50です。
--offset <number>スキップする名前の数。既定値は 0です。
uip tm testcases list-packages --project-key DEMO --filter Invoice
uip tm testcases list-packages --project-key DEMO --filter Invoice

データシェイプ​

{
  "Code": "TestCasePackagesList",
  "Data": [
    { "PackageName": "InvoiceTests" }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}
{
  "Code": "TestCasePackagesList",
  "Data": [
    { "PackageName": "InvoiceTests" }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}

HasMore が の場合true、エンベロープのInstructionsフィールドに次のページの--offsetが表示されます。

uip tm テストケース list-studio-projects​

プロジェクトの自動テスト ケースの由来となる個別の Studio プロジェクト名を一覧表示します。名前は並べ替えられ、並べ替えられたリストからページ --limit / --offset されます。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--filter <prefix>このテキストで始まる名前のみ (部分文字列ではなく、プレフィックスの一致)。
--limit <number>返す名前の数。既定値は 50です。
--offset <number>スキップする名前の数。既定値は 0です。
uip tm testcases list-studio-projects --project-key DEMO
uip tm testcases list-studio-projects --project-key DEMO

データシェイプ​

{
  "Code": "TestCaseStudioProjectsList",
  "Data": [
    { "StudioProjectName": "Acme.CheckoutTests" },
    { "StudioProjectName": "Acme.LoginTests" }
  ],
  "Pagination": {
    "Returned": 2,
    "Limit": 50,
    "Offset": 0,
    "Total": 2,
    "HasMore": false
  }
}
{
  "Code": "TestCaseStudioProjectsList",
  "Data": [
    { "StudioProjectName": "Acme.CheckoutTests" },
    { "StudioProjectName": "Acme.LoginTests" }
  ],
  "Pagination": {
    "Returned": 2,
    "Limit": 50,
    "Offset": 0,
    "Total": 2,
    "HasMore": false
  }
}

uip tm testcases list-testsets​

特定のテスト ケースを明示的に割り当てるテスト セット、または指定したラベルの 1 つを持つテスト ケースを明示的に割り当てるテスト セットを一覧表示します。--test-case-key または --labelsのいずれか 1 つだけを渡します。動的割り当てによってのみテスト ケースが含まれるテスト セットは一覧表示されません。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。
--labels <labels...>ラベル名 (スペース区切り) (最大 100 件)少なくとも 1 つを含むテスト ケースを明示的に割り当てたすべてのテスト セットを返します。
--limit <number>返される結果の数です。既定値は 50 です。
--offset <number>スキップする結果の数です。既定値は 0です。
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
uip tm testcases list-testsets \
  --project-key DEMO \
  --labels "Smoke Test" Regression
uip tm testcases list-testsets \
  --project-key DEMO \
  --labels "Smoke Test" Regression

データシェイプ​

{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}
{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}

uip tm testcases list-requirements​

テスト ケースに割り当てられている要件を一覧表示します。行の形状は と同じrequirements listです。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-key <key>必須。テスト ケース キー (例: DEMO:1)。
--limit <number>返される結果の数です。既定値は 50 です。
--offset <number>スキップする結果の数です。既定値は 0です。
uip tm testcases list-requirements \
  --project-key DEMO \
  --test-case-key DEMO:1
uip tm testcases list-requirements \
  --project-key DEMO \
  --test-case-key DEMO:1

データシェイプ​

{
  "Code": "TestCaseRequirementsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000005",
      "ObjKey": "DEMO:5",
      "Name": "User can sign in",
      "Description": "Sign-in works with a valid account",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2026-09-28T10:12:44.000Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2026-09-28T10:12:44.000Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}
{
  "Code": "TestCaseRequirementsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000005",
      "ObjKey": "DEMO:5",
      "Name": "User can sign in",
      "Description": "Sign-in works with a valid account",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2026-09-28T10:12:44.000Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2026-09-28T10:12:44.000Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}

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)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid...>必須。実行する 1 つ以上のテスト ケース UUID (スペース区切り)。testcases listから UUID を取得します。
--execution-type <type>必須。実行の種類: manual、 automated、 none、 mixed、または autonomous。
--name <name>必須。新しい実行のテスト セット名。
--asyncサーバーが実行の開始を確認するのを待たずに、キューイング後すぐに戻ります。実行レコードが完全に作成されるのを待ってから戻ることを省略します。
--folder-key <key>実行を実行する 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 <key>実行ターゲットのロボットのユーザー キー。
--machine-key <key>実行ターゲットのマシン キー。
--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 900
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 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"}]'
# 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": "TestManager",
    "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": "TestManager",
    "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" — 実行がまだディスパッチされていない可能性があります。

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

# 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
# 1. Discover your project key
uip tm project list --output json

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

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

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

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

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

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

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

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

uip tm testcases add​

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

割り当ては既定では静的です。--test-case-keys、または を--dynamicせずに--labelsすると、一致するテスト ケースがテスト セットに一度リンクされると、後でラベル付けされたテスト ケースは追加されません。--labels --dynamicでは、代わりにラベルがテスト セットに保存されるため、現在または後でラベルのいずれかが付いているすべてのテスト ケースがテスト セットの一部になり、すべての実行にラベルが含まれます。テスト セットの現在の動的ラベルを uip tm testsets get-dynamic-assignmentで表示する

引数​

設定はありません。

オプション​

フラグ説明
--test-set-key <key>必須。テスト セットのオブジェクト キー (例: DEMO:42)。プロジェクトはプレフィックス から派生します。
--test-case-keys <keys...>追加するテスト ケース キーです。スペース区切り (例: DEMO:1 DEMO:2)。コンマ区切り値も使用できます。--labelsと相互に排他的です。
--labels <labels...>スペースで区切られたラベル名 (スペースを含む引用符名)。ラベルは完全に一致し、大文字と小文字が区別されます。ラベルを少なくとも 1 つ付いた、プロジェクト内のすべてのテスト ケースを追加します。このラベルには、取り込み時にpackによって適用されたラベルPW_Tag_*、PW_Project_*、PW_Suite_*、PW_File_* ラベルが含まれます。を --dynamicしない場合は、現在の一致をテスト セットに 1 回だけコピーします。--test-case-keysと相互に排他的です。
--dynamic--labelsを使用して、テスト ケースを動的に割り当てます。つまり、ラベルをテスト セットに保存し、すでに設定されているラベル (合計で最大 30 個) と結合して保存します。外部ソースからリンクされたテスト セットでは許可されません。結合はラベル リストを読み取ってから置換されるため、同じテスト セットで同時に実行しないでください。
--limit <count>追加するラベル一致テスト ケースの最大数です。--labels でのみ有効です。--dynamicでは無効です。既定ではすべての一致に設定されます。
# 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

# assign every test case labeled smoke, including ones labeled later
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels smoke \
  --dynamic
# 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

# assign every test case labeled smoke, including ones labeled later
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels smoke \
  --dynamic

データシェイプ​

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

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

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

--dynamicでは、Codeは次のようにTestSetAddTestCasesDynamicされます。

{
  "Code": "TestSetAddTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression", "smoke"],
    "MatchedTestCases": 14,
    "Result": "Added"
  }
}
{
  "Code": "TestSetAddTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression", "smoke"],
    "MatchedTestCases": 14,
    "Result": "Added"
  }
}

DynamicLabels は、結合後の完全なラベルのリストであり、 MatchedTestCases 、それらのラベルが現在一致しているテスト ケースがカウントされます。ラベルを保存したもののカウントに失敗した場合、 MatchedTestCases は null され、エンベロープには Warningが付きます。

uip tm testcases remove​

テスト セットからテスト ケースを削除する。静的に割り当てられたテスト ケースを削除する --test-case-keysまたは --dynamicのいずれか 1 つだけを渡す (一部またはすべてのラベルによる動的な割り当てを停止します)。キーを削除しても、テスト セット内のテスト ケースには影響しません。テスト ケースは、動的なラベルを介してのみ存在します。

引数​

設定はありません。

オプション​

フラグ説明
--test-set-key <key>必須。テスト セットのオブジェクト キー (例: DEMO:42)。プロジェクトはプレフィックス から派生します。
--test-case-keys <keys>削除するコンマ区切りのテスト ケース キーです (例: DEMO:1,DEMO:2)。--dynamicと相互に排他的です。
--dynamicテスト ケースの動的割り当てを停止する: --labels で指定したラベルをテスト セットの動的な割り当てから削除するか、ラベルが省略されている場合はすべて削除 --labels 。静的な割り当てはそのまま残ります。このコマンドはラベル リストを読み取って置換するため、同じテスト セットで同時に実行しないでください。
--labels <labels...>削除する動的割り当てラベル、スペース区切り、大文字と小文字なしで一致。--dynamicでのみ有効です。
-y, --yes必須。削除を確定します。CLI ではプロンプトは表示されません。を指定しない --yes、コマンドは失敗し、 Result: "Failure" と終了コード 1が表示されます。
# remove statically assigned test cases
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1,DEMO:2 \
  --yes

# stop assigning test cases dynamically by the smoke label
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --dynamic \
  --labels smoke \
  --yes
# remove statically assigned test cases
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1,DEMO:2 \
  --yes

# stop assigning test cases dynamically by the smoke label
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --dynamic \
  --labels smoke \
  --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"
  }
}

--dynamicでは、Codeは次のようにTestSetRemoveTestCasesDynamicされます。

{
  "Code": "TestSetRemoveTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression"],
    "Result": "Removed",
    "NotFound": []
  }
}
{
  "Code": "TestSetRemoveTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression"],
    "Result": "Removed",
    "NotFound": []
  }
}

DynamicLabels は残るラベル リストです。NotFound には、テスト セットに設定されていない --labels 値が一覧表示され、 --labelsに合格した場合にのみ表示されます。Result 次のいずれかに該当します。

結果意味
Removed一部のラベルは削除され、他のラベルは残っています。
Cleared動的割り当てラベルは残りません。
Unchangedテスト セットに --labels 値が設定されていませんでした。
NotSetテスト セットに動的な割り当てはありません。

uip tm testcases steps​

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

uip tm testcases steps list​

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

uip tm testcases list-steps は、古いスクリプトでは、この動詞の非表示のエイリアスとして実行されます。 steps list は文書化されたフォームです。

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-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",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed",
      "ClipboardData": ""
    }
  ]
}
{
  "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",
      "ClipboardData": ""
    }
  ]
}

ステップは順番 OrderNo リストされています。

uip tm testcases steps get​

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

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-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",
    "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed",
    "ClipboardData": ""
  }
}
{
  "Code": "TestStepGet",
  "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",
    "ClipboardData": ""
  }
}

uip tm testcases steps add​

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

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>必須。ステップを追加するテスト ケース
--description <text>ステップの説明。シングルステップ モードでは必須です。
--expected-result <text>期待される結果 (シングルステップ モード)。
--action-type <type>ステップ アクションの種類 (シングル ステップ モード)。
--clipboard-data <text>ステップ用にコピーするテスト データ (シングルステップ モード)。
--order-no <n>0 ベースの挿入位置。末尾の追加を省略します (シングルステップ モード)。
--step <json...>必須の description と任意の expectedResultを持つ JSON オブジェクトとしてのステップ actionType、 clipboardData、 orderNoを指定します。複数のステップをスペースで区切って渡すか、 を繰り返して --step渡し、複数のステップを順番に追加します。両方を使用する --stepは、ステップ フラグまたはのいずれかを使用します。
# 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@example.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@example.com"}' \
  --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": ""
      }
    ]
  }
}
{
  "Code": "TestStepAdd",
  "Data": {
    "AddedCount": 1,
    "Steps": [
      {
        "Id": "d4e5f6a7-0000-0000-0000-000000000001",
        "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
        "OrderNo": 0,
        "ActionType": "",
        "Description": "Open login page",
        "ExpectedResult": "Login form is displayed",
        "ClipboardData": ""
      }
    ]
  }
}

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

uip tm testcases steps update​

ステップの説明、期待される結果、アクションの種類、またはクリップボード データを更新します。これらのフィールドを少なくとも 1 つ指定する必要があります。渡さないフィールドでは値が保持されます。ステップの位置を変更するには、 を使用します steps move。

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-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"
  }
}

uip tm testcases steps move​

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

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--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"
  }
}

uip tm testcases steps delete​

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

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--step-id <uuid>必須。テスト ステップ UUID。
-y, --yes必須。元に戻せない削除を確定します。CLI ではプロンプトは表示されません。を指定しない --yes、コマンドは失敗し、 Result: "Failure" と終了コード 1が表示されます。
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 TestCases パラメーター​

testcases parameters は、テスト ケースのパラメーター (リスト表示、取得、追加、更新、削除) を管理するサブグループです。すべての動詞は、テスト ケースを --test-case-id または --test-case-keyのいずれかで識別します。パラメーター名はテスト ケースごとに一意であり、大文字と小文字なしで比較されます。すでに使用されている名前を追加したり名前を変更したりすると、失敗します。

UIP TM TestCases パラメーター一覧​

テスト ケースのパラメーターを一覧表示します。

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>テスト ケースの UUID。--test-case-keyと相互に排他的です。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。--test-case-idと相互に排他的です。
--search <prefix>名前がこのプレフィックスで始まるパラメーターのみ
--sort-by <expression>並べ替え式 (例: "name asc")。
--limit <number>ページあたりの結果数既定値は 50です。
--offset <number>スキップする結果の数です。既定値は 0です。
uip tm testcases parameters list \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --sort-by "name asc"
uip tm testcases parameters list \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --sort-by "name asc"
データシェイプ​
{
  "Code": "TestCaseParametersList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000101",
      "Name": "Username",
      "DefaultValue": "admin",
      "Hint": "User name for the test account",
      "Type": "Text",
      "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "ObjectType": "testCase",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2025-04-15T10:30:00Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2025-04-15T10:30:00Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ]
}
{
  "Code": "TestCaseParametersList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000101",
      "Name": "Username",
      "DefaultValue": "admin",
      "Hint": "User name for the test account",
      "Type": "Text",
      "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "ObjectType": "testCase",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2025-04-15T10:30:00Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2025-04-15T10:30:00Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ]
}

UIP TM テストケースのパラメーターは、 を取得します。​

テスト ケースの 1 つのパラメーターを ID または名前で取得します。--parameter-id または --parameter-nameのいずれか 1 つだけを渡します。テスト ケースにそのようなパラメーターがない場合、コマンドは で失敗しますErrorCode: "not_found"

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>テスト ケースの UUID。--test-case-keyと相互に排他的です。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。--test-case-idと相互に排他的です。
--parameter-id <uuid>パラメーター UUID。
--parameter-name <name>大文字と小文字なしで一致したパラメーター名。
uip tm testcases parameters get \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name username
uip tm testcases parameters get \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name username
データシェイプ​
{
  "Code": "TestCaseParameterGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}
{
  "Code": "TestCaseParameterGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}

UIP TM TestCases パラメーター:​

テスト ケースにパラメーターを追加します。

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>テスト ケースの UUID。--test-case-keyと相互に排他的です。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。--test-case-idと相互に排他的です。
--name <name>必須。パラメーター名。
--default-value <value>必須。既定値です。空の値を保存するには "" 渡します。
--hint <text>パラメーターの横に表示されるヒント。
--type <type>Text 値を型指定されたとおりに格納します。 Asset には、実行時にロボットが解決する Orchestrator アセット名が格納されます。既定値は Textです。
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Username \
  --default-value admin \
  --hint "User name for the test account"
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Username \
  --default-value admin \
  --hint "User name for the test account"
# the value is the name of an Orchestrator asset
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Credentials \
  --default-value LoginCredentials \
  --type Asset
# the value is the name of an Orchestrator asset
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Credentials \
  --default-value LoginCredentials \
  --type Asset
データシェイプ​
{
  "Code": "TestCaseParameterAdd",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}
{
  "Code": "TestCaseParameterAdd",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}

UIP TM テストケースのパラメーターの更新​

ID または名前で見つかったパラメーターを更新します。--parameter-id または --parameter-nameのいずれかと、--new-name、--default-value、--hint、または --typeのうち少なくとも 1 つを渡します。渡さないフィールドでは現在の値が保持されます。保存された値を --default-value "" して --hint "" クリアします。

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>テスト ケースの UUID。--test-case-keyと相互に排他的です。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。--test-case-idと相互に排他的です。
--parameter-id <uuid>パラメーター UUID。
--parameter-name <name>現在のパラメーター名です。大文字と小文字を指定せずに一致します。
--new-name <name>パラメーターの名前を this に変更します。
--default-value <value>新しい既定値。
--hint <text>新しいヒント。
--type <type>新しいパラメーター型: Text または Asset。
uip tm testcases parameters update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name Username \
  --new-name UserId
uip tm testcases parameters update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name Username \
  --new-name UserId
データシェイプ​
{
  "Code": "TestCaseParameterUpdate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "UserId",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001"
  }
}
{
  "Code": "TestCaseParameterUpdate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "UserId",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001"
  }
}

Data は、保存された完全なレコードではなく、コマンドによって送信された値をエコーします。保存されているレコードに対して parameters get を実行します。

UIP TM TestCases パラメーターの削除​

テスト ケースから 1 つ以上のパラメーターを削除します。最初に parameters list を実行して ID を収集します。

引数​

設定はありません。

オプション​
フラグ説明
--project-key <key>Test Manager プロジェクト キー (例: DEMO)。--project-idも指定されている場合は無視されます。
--project-id <id>Test Manager プロジェクト IDの代わりに --project-keyを使用し、両方を指定した場合に優先されます。
--test-case-id <uuid>テスト ケースの UUID。--test-case-keyと相互に排他的です。
--test-case-key <key>テスト ケース キー (例: DEMO:1)。--test-case-idと相互に排他的です。
--parameter-ids <uuid...>必須。削除するパラメーター UUID です。スペース区切りで、呼び出しごとに最大 100 個です。
-y, --yes必須。元に戻せない削除を確定します。CLI ではプロンプトは表示されません。を指定しない --yes、コマンドは失敗し、 Result: "Failure" と終了コード 1が表示されます。
uip tm testcases parameters delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-ids a1b2c3d4-0000-0000-0000-000000000101 a1b2c3d4-0000-0000-0000-000000000102 \
  --yes
uip tm testcases parameters delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-ids a1b2c3d4-0000-0000-0000-000000000101 a1b2c3d4-0000-0000-0000-000000000102 \
  --yes
データシェイプ​
{
  "Code": "TestCaseParameterDelete",
  "Data": {
    "Passed": 2,
    "Failed": 0
  }
}
{
  "Code": "TestCaseParameterDelete",
  "Data": {
    "Passed": 2,
    "Failed": 0
  }
}

Passed と Failed はカウントです。応答では、どの ID が失敗したかは示されません。 parameters list を実行して、何が残っているかを確認します。

  • pack — Playwright プロジェクトをパッケージ化し、取り込み時にそのテスト ケースを自動リンクします。作成されるテスト ケースには link-automation を使用しないでください。
  • プロジェクト — すべてのテスト ケースを所有するスコープです。
  • テストセット — テスト ケースを実行可能なスイートにグループ化します。
  • TestCaseLog — テスト ケースのログ (testcaselog list-assertionsを含む) を開始、完了、検査します。
  • Executions — テスト ケース ログの実行レベルのビュー。
  • レポート — 実行の概要。失敗したケースとアサーション テキストが含まれます。
  • 要件 — list-requirements と bulk-create --requirement-key が参照する要件です。
  • export-jobs — testcases export 開始するジョブを確認します。

参照​

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

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得