Testen mehrerer Pakete

Voraussetzungen

• Erstellen Sie mehrere Pakete oder Testsätze.
• Führen Sie die CLI-Datei exe (für Windows Legacy) oder dll (für Windows/Linux/maOS) aus.
• Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.

Um mehrere Pakete zu testen, führen Sie die folgenden Schritte aus:

1. Führen Sie die test -Aufgabe mit uipcli test aus. Sie können eine Liste der verfügbaren Unteraufgaben sehen.
2. Geben Sie die erforderlichen Parameter an und führen Sie die parallel -Unteraufgabe aus. In der folgenden Tabelle sind die erforderlichen Parameter beschrieben:

Parameter	Beschreibung
Orchestrator URL (pos. 0) ( Erforderlich )	Die URL der Orchestrator-Instanz.
Orchestrator Tenant (pos. 1)	Der Mandant der Orchestrator-Instanz.
--testsConfigurationFilePath	Erforderlich. Pfad zur Datei mit Testprojektkonfigurationen. Diese Konfiguration beschreibt die Liste der Projekte, die Sie verpacken und dann parallel ausführen möchten, mit bestimmten Ausführungsoptionen. Jedes Projekt kann mit den folgenden Optionen konfiguriert werden: ProjectPath : Der Pfad zum Projekt auf dem Agenten, der die Aufgabe ausführt. Dies kann ein relativer oder absoluter Pfad sein. AttachRobotLogs : Wenn auf true festgelegt, werden die Roboterprotokolle in die Testberichtsdatei aufgenommen. ContinueOnError : Bestimmt, ob die Pipelineaufgabe bei zugehörigen Testfehlern fehlschlagen soll. RetryCount : Die Anzahl der Wiederholungsversuche pro Testprojekt. Timeout : Timeout pro Testprojekt in Sekunden (Standard ist 7200). ParametersFilePath : Der Pfad zu einer JSON-Datei, die Eingabeparameter für den Test enthält. Diese ähnelt der Parameterdatei, die für die UiPathTest-Aufgabe verwendet wird. Metadaten des Testpakets: ReleaseNotes RepositoryUrl RepositoryCommit RepositoryBranch RepositoryType ProjectUrl Diese Konfiguration kann auch in JSON oder CSV formatiert werden. Beispiel für ein JSON-Schema: [ { "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-Beispiel: 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	Pfad zum Stammverzeichnis der zu testenden Projekte. Erforderlich, wenn projectPaths aus den testsConfigurationFile relativ ist.
--executionArtifactsDirectoryPath	Verzeichnispfad, in dem Testausführungsartefakte veröffentlicht werden sollen.
--cliDirectoryPath	Pfad zum CLI-Verzeichnis oder uipcli.dll . Erforderlich beim Ausführen der CLI über die ausführbare dotnet -Datei, optional beim Ausführen von uipcli.exe .
--out	Erforderlich. Typ der Ergebnisdatei < Junit | UiPath >.
--nugetConfigFilePath	Pfad zur NuGet.Config-Datei mit Feeds. Das <clear /> -Tag von der angegebenen Datei wird ignoriert und nur Quellen berücksichtigt.
--disableBuiltInNugetFeeds	Deaktivieren Sie integrierte NuGet-Feeds, die beim Packen von Testprojekten verwendet werden.
--excludeConfiguredSources	Excludes the built-in feeds and the NuGet sources configured at the user and machine level on the host running the CLI. The CLI resolves packages only from the feeds defined in --nugetConfigFilePath. See Managing NuGet feeds.
-u, --username	Erforderlich. Der Orchestrator-Benutzername, der für die Authentifizierung verwendet wird. Muss zusammen mit dem Kennwort verwendet werden.
-p, --password	Erforderlich. Das für die Authentifizierung verwendete Orchestrator-Kennwort. Muss zusammen mit dem Benutzernamen verwendet werden.
-t, --token	Erforderlich. Das für die Authentifizierung verwendete Orchestrator-Aktualisierungstoken. Muss zusammen mit dem Kontonamen und der Client-ID verwendet werden.
-a, --accountName	Erforderlich. Der Name der Orchestrator-Organisation. Muss zusammen mit dem Aktualisierungstoken und der Client-ID verwendet werden.
-A, --accountForApp	Der Name der Orchestrator-Organisation. Muss zusammen mit ID, Geheimnis und Scope(s) für eine externe Anwendung verwendet werden.
-I, --applicationId	Erforderlich. Die ID der externen Anwendung. Muss zusammen mit Organisationsname, Geheimnis und Scope(s) für eine externe Anwendung verwendet werden.
-S, --applicationSecret	Erforderlich. Der geheime Schlüssel der externen Anwendung. Muss zusammen mit Organisationsname, ID und Scope(s) für eine externe Anwendung verwendet werden.
--applicationScope	Erforderlich. Die durch Leerzeichen getrennte Liste der Anwendungs-Scopes. Muss zusammen mit Organisationsname, ID und Geheimschlüssel für eine externe Anwendung verwendet werden.
-o, --organizationUnit	Der Name des Orchestrator-Ordners.
-l, --language	Sprache für die übersetzten Protokolle.
--traceLevel	Gibt an, welche Arten von Protokollnachrichten ausgegeben werden sollen. Einer der folgenden Werte: Keine, Kritisch, Fehler, Warnung, Information, Ausführlich. (Standard ist Information).
--identityUrl	The URL of your identity server. Required when the Orchestrator runs on UiPath Automation Suite or standalone Orchestrator (on-premises MSI). Not needed for Automation Cloud — the CLI resolves the identity server from the cloud URL.
--ca-cert	Eine oder mehrere vertrauenswürdige Stammzertifikatdateien von Zertifizierungsstellen (PEM, DER oder PKCS#7), die beim Validieren der Orchestrator- und Identity Server-TLS-Zertifikate verwendet werden. Wiederholen Sie das Flag oder trennen Sie mehrere Pfade durch Komma. Weitere Informationen finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .
--pinnedpubkey	Heften Sie den öffentlichen Schlüssel des Serverblattzertifikats an. Format: sha256//<base64>. Wird zusätzlich zur Standardzertifikatvalidierung aktiviert. Weitere Informationen finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Tipp:

Für Orchestrator-Instanzen, die von einer privaten Zertifizierungsstelle signiert wurden (z. B. UiPath Automation Suite), akzeptiert dieser Befehl auch --ca-cert und --pinnedpubkey Parameter. Szenarien und Beispiele finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Nutzung

dotnet uipcli.dll 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>]

Beispiele

• dotnet uipcli.dll 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"
• dotnet uipcli.dll 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"
• dotnet uipcli.dll 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"
• dotnet uipcli.dll 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"