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

前提条件:

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

uipcli test を使用して test タスクを実行します。利用可能なサブタスクのリストが表示されます。

必要なパラメーターを指定し、run サブタスクを実行します。

以下のパラメーターのリストをご覧ください。

パラメーター	説明
`Orchestrator URL (pos. 0)` (必須)	Orchestrator インスタンスの URL です。
`Orchestrator Tenant (pos. 1)` (必須) SaaS デプロイの場合。 (任意) PaaS デプロイの場合。	パッケージまたはテストセットが存在するテナントです。
`-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、アプリケーションシークレットと組み合わせて使用する必要があります。
`-P` または `--project-path`	テストする Testing パッケージファイルのパスです。
`-s` または `--testset`	実行するテストセットに表示される名前です。テストセットにテストケースの最新バージョンが含まれるようにします。テストセットが既定のフォルダーに含まれていない場合は、前に適切なフォルダー名を含めてください。例: `AccountingTeam\TestSet`
`--out`	結果ファイルの種類 <junit\|uipath> です。
`-r` または `--result_path`	結果を保存するファイルの保存先パスです。
`-e` または `--environment` (クラシックフォルダーの場合は必須)	パッケージをデプロイするロボットグループです。`project path` と組み合わせて使用する必要があります。
`-w` または `--timeout`	テストセットが実行されるまで待機する時間 (秒) です。既定値は 7200 秒です。
`-i` または `--input_path` (エントリポイントワークフローに、コマンドラインを介して渡す入力パラメーターがある場合は必須)	JSON 入力ファイルのフルパスです。
`--attachRobotLogs`	実行された各テストケースのロボットログと JUnit テストレポートを添付します。
`-o` または `--organizationUnit`	テストセットを実行する Orchestrator フォルダーです。
`-l` または `--language`	Orchestrator のユーザーインターフェイスで使用する言語です。
`-y` または `--disableTelemetry`	テレメトリデータを無効化します。
`--traceLevel`	イベントのトレースを表示します。
`--identityURL` (PaaS デプロイの場合のみ必須)	Identity Server の URL です。
`--releaseNotes`	リリースノートを追加する
`--disableBuiltInNugetFeeds`	組み込みの NuGet フィードを無効にします。
`--help`	このコマンドのパラメーターと例を表示します。

例:

test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
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"
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"
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 run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --out junit
test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --out uipath

外部アプリケーションを追加する

外部アプリケーションを登録し、そのアプリケーションが OAuth を使用して UiPath リソースにアクセスできるようにするには、以下の手順を実行します。

テナントに管理者としてログインします。
[テナント] > [アクセス権を管理] > [ロールを割り当て] に移動して、[アカウントおよびグループを管理] をクリックします。

テナントレベルが開きます。
左側の [外部アプリケーション] を選択します。

現在のテナントに登録されている、すべての既存外部アプリケーションのリストが [外部アプリケーション] ページに表示されます。
表の上で、右側にある [アプリケーションを追加] をクリックします。
[アプリケーション名] フィールドに入力します。
[アプリケーションの種類] のオプションを選択します。

[機密アプリケーション] を選択した場合、最後にアプリケーションシークレットが提供されるので、使用しているアプリケーションでそのシークレットを安全に保存できることを確認してください。それが不可能な場合は [非機密アプリケーション] を選択します。
[リソース] で [スコープを追加] をクリックします。

右側に [リソースを編集] パネルが開きます。このパネルでは、アプリケーションにアクセス権を与える必要があるリソースを選択できます。
[リソース] ドロップダウンリストから、アプリケーションが使用できる UiPath API を選択します。

注: スコープは一度に 1 つのリソースに対してのみ追加できます。複数のリソースへのアクセスを許可するには、このプロセスを繰り返して各リソースにスコープを追加します。
[ユーザースコープ] タブで、必要に応じて、付与する論理 API 権限のチェックボックスを選択します。

ユーザースコープに基づく権限付与とは、外部アプリケーションがそれらのリソースにユーザーコンテキスト内でアクセス可能であり、適切な権限を持つユーザーがログインする必要があることを意味します。
機密アプリケーションの場合は、[アプリケーションスコープ] タブに切り替え、必要に応じて、選択したリソースに対するアプリケーションレベルでの権限も付与できます。

アプリケーションスコープに基づく権限を持つ外部アプリケーションは、ユーザーの操作なしで、選択したスコープのすべてのアプリケーションのデータにアクセスできます。

非機密アプリケーションは、アプリケーションスコープにアクセスできません。
[保存] をクリックします。

パネルが閉じ、フォームの [リソース] の表に、選択したリソースとスコープが追加されます。
外部アプリケーションが対応している場合、[リダイレクト URL] フィールドに URL を追加すると、認可応答がその URL に送信され、アプリケーションがその URL を使用して UiPath リソースにアクセスできるようになります。
[追加] をクリックして登録を作成します。

確認メッセージが表示されます。機密アプリケーションの場合、確認メッセージには登録済み外部アプリケーションが認可を要求するときに使用できるアプリケーションシークレットが含まれます。アプリケーションシークレットは、その後はもう表示されることがないので、必ず安全な場所に保存しておいてください。