パッケージをテストするか、テスト セットを実行する

前提条件:

• パッケージまたはテスト セットを作成します。
• CLI の exe ファイル (Windows の場合) または dll ファイル (Linux の場合) を実行します。
• 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。

パッケージをテストするには、次の手順を実行します。

1. uipcli testを使用して、test タスクを実行します。利用可能なサブタスクのリストが表示されます。
2. 必要なパラメーターを指定し、[ run ] サブタスクを実行します。次の表で、必要なパラメーターについて説明します。

パラメーター	説明
-P , or --project-path	テストする Testing パッケージ ファイルのパスです。
--projectKey	Test Manager の >[ダッシュボード] タブに表示されるプロジェクト キー> [プロジェクト] > [すべてのプロジェクト]プロジェクト キーは、すべてのオブジェクト キーのプレフィックスです。Test Manager を使用する場合は必要です。
--testsetkey	Test Manager の [テスト セット] タブ> [キー] 列に表示されるテスト セット>キーです。テスト セットに最新バージョンのテスト ケースが含まれていることを確認します。テスト セットが既定のフォルダーに含まれていない場合は、前に適切なフォルダー名を含めてください。例: AccountingTeam\\TestSet
-s , or --testset	The name shown for the Test Set you wish to execute. Ensure that the Test Set includes the most recent version of the Test Cases. If the project does not have a default folder set, make sure you assign a test folder at the Test Set level.
--out	結果ファイルの種類です。\<junit|uipath\>。
-r , or --result_path	結果を保存するファイルの保存先パスです。
-e 、または --environment (クラシック フォルダーの場合は 必須 )	パッケージをデプロイするロボット グループです。project path と組み合わせて使用する必要があります。
-w , or --timeout	テスト セットが実行されるまで待機する時間 (秒) です。既定値は 7200 秒です。
-i 、または --input_path (エントリ ポイントのワークフローに、コマンド ラインで渡す入力パラメーターがある場合は 必須 )	JSON 入力ファイルへのフル パスです。ファイル構造について詳しくは、「 入力パラメーター JSON 形式 」をご覧ください。
--attachRobotLogs	実行された各テスト ケースのロボット ログと JUnit テスト レポートを添付します。
--repositoryUrl	プロジェクトのバージョン管理が行われるリポジトリ URL です。
--repositoryCommit	プロジェクトのビルド元のリポジトリ コミット。
--repositoryBranch	プロジェクトの構築元のリポジトリブランチ。
--repositoryType	VCS システム リポジトリの種類。
--projectUrl	Automation Hub のアイデアの URL
--releaseNotes	リリース ノートを追加する
--disableBuiltInNugetFeeds	組み込みの NuGet フィードを無効化します。
--retryCount	失敗したテスト ケースのリトライ回数 (既定では、リトライは設定されていません)。
-u 、または --username ( 基本認証を使用する場合は必須、ユーザー名とパスワードを使用)	Orchestrator への認証に使用するユーザー名です。対応するパスワードと組み合わせて使用する必要があります。
-p 、または --password ( 基本認証を使用する場合は必須、ユーザー名とパスワードを使用)	Orchestrator への認証に使用するパスワードです。対応するユーザー名と組み合わせて使用する必要があります。
-t 、または--token ( トークンベースの認証 を使用する場合は 必須)	Orchestrator への認証に使用する OAuth2 更新トークンです。アカウント名およびクライアント ID と組み合わせて使用する必要があります。
-a 、または--accountName ( トークンベースの認証 を使用する場合は 必須)	Orchestrator Cloud RPA のアカウント名です。OAuth2 更新トークンおよびクライアント ID と組み合わせて使用する必要があります。
-A , --accountForApp	Orchestrator Cloud RPA のアカウント名 (組織名) です。外部アプリケーションのアプリケーション ID、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。
-I または--applicationId ( 外部アプリケーション認証 を使用する場合は 必須 )	外部アプリケーション ID です。アプリケーション アカウント、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。
-S または--applicationSecret ( 外部アプリケーション認証 を使用する場合は 必須 )	外部アプリケーション シークレットです。アプリケーション アカウント、アプリケーション ID、アプリケーション スコープと組み合わせて使用する必要があります。
--applicationScope (外部アプリケーション認証を使用する場合は必須)	アプリケーション スコープを単一のスペースで区切って列挙したリストです。外部アプリケーションの アプリケーション アカウント 、 アプリケーション ID 、 アプリケーション シークレット と組み合わせて使用する必要があります。Test Manager を使用する場合は、以下を含めます。 Orchestrator のスコープに加えて TM.Projects TM.TestSets TM.TestExecutions 。
-o , or --organizationUnit	テスト セットを実行する Orchestrator フォルダーです。
-l , or --language	Orchestrator のユーザー インターフェイスで使用する言語です。
--traceLevel	イベントのトレースを表示します。
--identityURL ( PaaS または MSI デプロイに必要 )	Identity Server の URL です。
Orchestrator URL (pos. 0) (必須)	Orchestrator インスタンスの URL です。
Orchestrator Tenant (pos. 1) (必須) SaaS デプロイの場合。 (任意) PaaS デプロイの場合。	パッケージまたはテスト セットが存在するテナントです。

使用法:**

uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

例:

Orchestrator のテスト:

• uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

Test Manager のテスト:

• uipcli test run "https://cloud.uipath.com/" "TenantName" --projectKey "MyTestProject" --testsetkey "MyTestSet" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" -o "FolderName" --out "junit" --result_path "C:\TestResults"
• uipcli test run "https://cloud.uipath.com/" "TenantName" --projectKey "MyTestProject" -P "C:\userprofile\AutomationProjectWithTestCases\project.json" -e "TestEnvironment" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" -o "FolderName" --out "uipath" --result_path "C:\TestResults"

注:

UiPath CLI での Test Manager の使用方法について詳しくは、「 Test Manager でパッケージをテストする、またはテスト セットを実行する」をご覧ください。