CI/CD 連携ユーザーガイド

最終更新日時 2025年7月4日

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

前提条件:

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

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

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

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

次の表で、必要なパラメーターについて説明します。

パラメーター	説明
`-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 テストレポートを添付します。
`--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、アプリケーションシークレットと組み合わせて使用する必要があります。
`-o` または `--organizationUnit`	テストセットを実行する Orchestrator フォルダーです。
`-l` または `--language`	Orchestrator のユーザーインターフェイスで使用する言語です。
`--traceLevel`	イベントのトレースを表示します。
`--identityURL` (Required for PaaS or MSI deployments )	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>]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>]

例:

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"