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 以外の終了コードを返します。
要件	要件を作成、一覧表示、取得、更新、削除、エクスポートするリンクされたテスト ケース ID のリストを取得するテスト ケースのリンクを追加または削除します。テスト実行別に要件を一覧表示します。
カスタム フィールド	カスタム フィールドの定義、その表示ラベル、許可される値を管理します。
オブジェクト ラベル	Test Manager オブジェクト (テスト ケース、要件) のラベルを追加、削除、一覧表示します。
ユーザー	現在認証されている Test Manager ユーザーのプロファイル情報を取得します。
テスト ステップ ログ	手動テストまたは混合テスト ケースのステップレベルの実行ログを一覧表示します。

testcaselog 動詞 (start、 finish、 list-assertions) は実行時に個別の testcaselog サブコマンドとして登録されますが、実行によって生成されたテスト ケース ログを直接操作するため、「 テストケース 」ページに記載されます。

概要

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を使用して実行可能なスイートにグループ化します。
4. testsets run — 実行を開始します。すべてのダウンストリーム コマンドが入力として受け取る ExecutionId を返します。
5. 待機 — 実行が終了ステート (Passed、 Failed、 Cancelled) に達するまでスクリプトをブロックします。待機時間に上限を設定するには、 --timeout を使用します。
6. レポート/結果/添付ファイル — 実行後:構造化された要約(report get)、CIテストダッシュボード用のJUnit XMLファイル(result download)、およびキャプチャされたアーティファクト(attachment download)。
7. 実行のリトライ — 任意: 実行に不安定な失敗があった場合は、失敗したテスト ケースのログのみを所定の位置で再実行します。

手動実行または混合実行の場合、拡張フローには以下が追加されます。 testcaselog start / finish — 個々のテスト ケース ログを開始および完了としてマークします。 および TestSteplog List — ステップレベルの合格/不合格の詳細を取得します。要件 : テスト ケースを追跡性レポートの要件にリンクします。 ObjectLabel / CustomField は、すべてのエンティティの種類のメタデータ管理機能を提供します。

同じフローがターミナルでアドホックに動作し、各動詞が次のステップで必要とする 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。