複数のパッケージをテストする

前提条件:

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

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

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

パラメーター	説明
--testsConfigurationFilePath	必須。テスト プロジェクトの設定があるファイルへのパスです。 この構成では、パッケージ化して、特定の実行オプションを使用して並列で実行するプロジェクトのリストの概要を示します。 各プロジェクトは、次のオプションを使用して構成できます。 ProjectPath : タスクを実行するエージェント上のプロジェクトへのパスです。相対パスまたは絶対パスのいずれかを指定します。 AttachRobotLogs : [ true ] に設定すると、ロボット ログがテスト レポート ファイルに含まれます。 ContinueOnError : 関連するテストが失敗した場合に、パイプライン タスクが失敗するかどうかを決定します。 RetryCount : テスト プロジェクトごとのリトライ回数です。 Timeout : テスト プロジェクトごとのタイムアウト (秒単位) です (既定値は 7200)。 ParametersFilePath : テストの入力パラメーターを含む JSON ファイルへのパスです。これは、UiPathTest タスクに使用されるパラメーター ファイルに似ています。 テスト パッケージのメタデータ: ReleaseNotes RepositoryUrl RepositoryCommit RepositoryBranch RepositoryType ProjectUrl この構成は、JSON または CSV の形式にすることもできます。 JSON スキーマの例: [ { "ProjectPath": "path/to/project", "AttachRobotLogs": true, "ContinueOnError": false, "RetryCount": 3, "Timeout": 7200, "ParametersFilePath": "path/to/parameters.json", "ReleaseNotes": "release notes for the test project", "RepositoryUrl": "http://repositoryurl.com", "RepositoryCommit": "commit hash", "RepositoryBranch": "branch name", "RepositoryType": "git", "ProjectUrl": "http://projecturl.com" }, { "ProjectPath": "path/to/project2" }, { "ProjectPath": "path/to/project3", "ParametersFilePath": "path/to/parameters3.json" } ] CSV の例: ProjectPath,AttachRobotLogs,ContinueOnError,RetryCount,Timeout,ParametersFilePath,ReleaseNotes,RepositoryUrl,RepositoryCommit,RepositoryBranch,RepositoryType,ProjectUrl path/to/project,true,false,3,7200,path/to/parameters.json,release notes for the test project,http://repositoryurl.com,commit hash,branch name,git,http://projecturl.com path/to/project2,,,,,,,,,,, path/to/project3,,,,,path/to/parameters3.json,,,,,,
--projectsRootDirectoryPath	テスト対象のプロジェクトのルート ディレクトリへのパスです。testsConfigurationFileからのprojectPathsが相対的な場合は必須です。
--executionArtifactsDirectoryPath	テスト実行の成果物をパブリッシュするディレクトリ パス。
--cliDirectoryPath	CLI ディレクトリまたは uipcli.dll へのパスです。dotnet 実行可能ファイルを介して CLI を実行する場合は必須です。uipcli.exeを実行する場合は任意です。
--out	必須。結果ファイルの種類 <JUnit|UiPath>
--disableBuiltInNugetFeeds	テスト プロジェクトのパッケージ化で使用される組み込みの NuGet フィードを無効化します。
-u, --username	必須。認証に使用する Orchestrator のユーザー名。パスワードと一緒に使用する必要があります。
-p, --password	必須。認証に使用する Orchestrator のパスワードです。ユーザー名と一緒に使用する必要があります。
-t, --token	必須。認証に使用される Orchestrator 更新トークンです。アカウント名およびクライアント ID と一緒に使用する必要があります。
-a, --accountName	必須。Orchestrator の組織名。更新トークンおよびクライアント ID と一緒に使用する必要があります。
-A, --accountForApp	Orchestrator の組織名。外部アプリケーションの ID、シークレット、スコープと共に使用する必要があります。
-I, --applicationId	必須。外部アプリケーション ID です。外部アプリケーションの組織名、シークレット、スコープと共に使用する必要があります。
-S, --applicationSecret	必須。外部アプリケーションのシークレットです。外部アプリケーションの組織名、ID、およびスコープと共に使用する必要があります。
--applicationScope	必須。スペースで区切られたアプリケーション スコープのリストです。外部アプリケーションで、組織名、ID、シークレットと一緒に使用する必要があります。
-o, --organizationUnit	Orchestrator のフォルダー名。
-l, --language	翻訳されたログの言語。
--traceLevel	出力するログ メッセージの種類を指定します。None、Critical、Error、Warning、Information、Verbose のいずれかの値を指定できます。(既定値は Information です)。
--identityUrl ( PaaS または MSI デプロイに必要 )	Identity Server の URL です。
Orchestrator URL (pos.0)	必須。Orchestrator インスタンスの URL です。
Orchestrator Tenant (位置1)	Orchestrator インスタンスのテナントです。

使用状況:

./uipcli.exe test parallel <orchestrator_url> <orchestrator_tenant> [--testsConfigurationFilePath <tests_config_file_path>] [--projectsRootDirectoryPath <test_projects_root_directory_path>] [--executionArtifactsDirectoryPath <execution_artifacts_directory_path>] [--cliDirectoryPath <uipcli_dll_path>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--disableBuiltInNugetFeeds] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

例:

• ./uipcli.exe test parallel "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information --testsConfigurationFilePath "C:\userprofile\pipeline-repo-folder\test-configuration.json" --projectsRootDirectoryPath "C:\userprofile\test-projects-repo-folder" --executionArtifactsDirectoryPath "C:\userprofile\pipeline-execution-folder" --cliDirectoryPath "C:\userprofile\cli-download-path\UiPath.CLI.Windows\tools\uipcli.dll" --out "junit"
• ./uipcli.exe test parallel "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" --testsConfigurationFilePath "C:\userprofile\pipeline-repo-folder\test-configuration.json" --projectsRootDirectoryPath "C:\userprofile\test-projects-repo-folder" --executionArtifactsDirectoryPath "C:\userprofile\pipeline-execution-folder" --cliDirectoryPath "C:\userprofile\cli-download-path\UiPath.CLI.Windows\tools\uipcli.dll" --out "junit" "C:\userprofile\AutomationProjectWithTestCases\project.json"
• ./uipcli.exe test parallel "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 --testsConfigurationFilePath "C:\userprofile\pipeline-repo-folder\test-configuration.json" --projectsRootDirectoryPath "C:\userprofile\test-projects-repo-folder" --executionArtifactsDirectoryPath "C:\userprofile\pipeline-execution-folder" --cliDirectoryPath "C:\userprofile\cli-download-path\UiPath.CLI.Windows\tools\uipcli.dll" --out "junit"
• ./uipcli.exe test parallel "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 --testsConfigurationFilePath "C:\userprofile\pipeline-repo-folder\test-configuration.json" --projectsRootDirectoryPath "C:\userprofile\test-projects-repo-folder" --executionArtifactsDirectoryPath "C:\userprofile\pipeline-execution-folder" --cliDirectoryPath "C:\userprofile\cli-download-path\UiPath.CLI.Windows\tools\uipcli.dll" --out "junit"