UIP TM

uip tm は Test Manager ツールであり、UiPath Test Manager テナント上のテスト プロジェクト、テスト ケース、テスト セット、実行、結果、レポート、添付ファイルを管理します。uip tools install tmでインストールするか、uip tm … を呼び出して自動インストールを実行します。インストール モデルについては 「ツール (プラグイン)」 を、ツールのインストールを管理するコマンドについては「 uip ツール 」を参照してください。

tm はコマンドプレフィックスであり、 uip test-managerではありません。uip tools list の [commandPrefix] 列を使用して確定します。

リソース

各リソースには、独自のリファレンス ページがあります。各ページに設定された動詞は、 uip tm によって登録されたコマンドと一致します— uip tm --help を実行して、インストールの完全な表面を確認します。

リソース	目的
プロジェクト	Test Manager プロジェクトを作成、一覧表示、更新、削除する既定の Orchestrator フォルダーを設定またはオフします。
件のテスト ケース	テスト ケースを作成、一覧表示、更新、削除するOrchestrator のオートメーションをリンクまたはリンク解除する結果の履歴のリストを取得します。テスト ケースを含むテスト セットのリストを取得するテスト セットに対してテスト ケースを追加または削除します。
テスト セット	テスト セットを作成、一覧表示、更新、削除する含まれるテスト ケースのリストを取得します。テスト セットを実行し、実行 ID を返します。
実行	テスト セットの実行のリストを取得します。実行のテスト ケース ログのリストを取得します。完了した実行の失敗したテスト ケースをリトライします。
結果	テスト実行の結果をJUnit XMLレポートとしてダウンロードします。
レポート	完了した実行の概要レポート (カウント、合格率、期間、失敗したケース) を取得します。
添付ファイル	実行でテスト ケース ログでキャプチャした添付ファイル (スクリーンショット、ログ、ファイル) をダウンロードします。
待機	テスト実行が終了ステートになるまでポーリングします。タイムアウト時に 0 以外の終了コードを返します。
requirement	Create, list, update, delete, clone, and export requirements; assign and unassign test cases; link to defects and connector integrations.
customfield	Manage custom field definitions, their display labels, and allowed values.
objectlabel	Add, remove, and list labels on Test Manager objects (test cases, requirements).
ユーザー	Get profile information for a Test Manager user by account ID.
teststeplog	List the step-level execution log for a manual or mixed test case log.

testcaselog verbs (start, finish, list-assertions) are registered as a separate testcaselog subcommand at runtime but are documented on the testcases page because they operate directly on test case logs produced by a run.

概要

uip tm <resource> <verb> [options]

既定の出力は --output jsonです。すべての uip tm 動詞は、4 つの グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) に従います。

一般的なフロー

Test Manager のリソースはチェーンを形成します。完全な CI 実行では、通常、エンドツーエンドで実行されます。

1. プロジェクト — 1 回限りのセットアップ。プロジェクトを作成 (または既存のプロジェクトを再利用) し、必要に応じて既定の Orchestrator フォルダーをピン留めして、後のコマンドで --folder-keyを省略できるようにします。
2. テスト ケース — テスト ケースを作成し、各テスト ケースを testcases link-automationOrchestrator パッケージのエントリ ポイントにリンクします。これは、それらを実行可能にするステップです。
3. テスト セット — テスト ケースを実行可能なスイートにグループ化します。 testsets create とその後に testcases addが続きます。
4. testsets run — 実行を開始します。すべてのダウンストリーム コマンドが入力として受け取る ExecutionId を返します。
5. 待機 — 実行が終了ステート (Passed、 Failed、 Cancelled) に達するまでスクリプトをブロックします。待機時間に上限を設定するには、 --timeout を使用します。
6. レポート/結果/添付ファイル — 実行後:構造化された要約(report get)、CIテストダッシュボード用のJUnit XMLファイル(result download)、およびキャプチャされたアーティファクト(attachment download)。
7. 実行のリトライ — 任意: 実行に不安定な失敗があった場合は、失敗したテスト ケースのログのみを所定の位置で再実行します。

For manual or mixed runs, the extended flow adds: testcaselog start / finish — mark individual test case logs as started and finished; and teststeplog list — retrieve step-level pass/fail detail. requirement links test cases to requirements for traceability reporting, and objectlabel / customfield provide metadata management across all entity types.

同じフローがターミナルでアドホックに動作し、各動詞が次のステップで必要とする ID を含む自己完結型の JSON エンベロープを出力します。

認証とスコープ

すべての uip tm 動詞は、アクティブなセッションを通じてテナントとプロジェクトのコンテキストを解決します。「サインインの 認証 」をご覧ください。すべての動詞の --tenant / -t フラグは、その 1 つの呼び出しのセッションのデフォルトを上書きします。プロジェクト スコープは、 --project-key から解決されます (または、いずれかを受け入れる実行レベルの動詞の --test-set-key から派生します)。

終了コード

標準の CLI終了コードは 、すべての動詞に適用されます。1 つの動詞は、ドメイン固有の動作を追加します。

• uip tm testsets runの後にuip tm waitが続く — 実行時の終了コードを参照してください。wait はタイムアウト時に 2 を終了するため、スクリプトは JSON を解析せずにタイムアウト、失敗での終了、クリーン パスで分岐できます。テストエラーの検出自体は、実行コマンドの終了コードではなく、 report get または result downloadを介して行われます。

参照

• 概念: UiPath CLI の構成
• セッション — テナントとプロジェクトのコンテキストがどのように解決されるか。
• スクリプティングパターン — CI の出口コードの分岐と JSON フィルタリング。
• 出力形式 — JSON エンベロープと --output-filter。