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, die während der Wiederherstellung verwendet wird. Ab 25.10.18 wird die Datei durchgängig berücksichtigt – <clear />, <packageSourceCredentials>, <packageSourceMapping> und <fallbackPackageFolders> werden alle wirksam. Siehe Verwalten von NuGet-Feeds. In älteren Builds wurden nur <packageSources> -URLs angewendet.
--disableBuiltInNugetFeeds	Deaktivieren Sie integrierte NuGet-Feeds, die beim Packen von Testprojekten verwendet werden.
--excludeConfiguredSources	Schließen Sie die integrierten Feeds und die NuGet-Quellen aus, die auf Benutzer- und Maschinenebene auf dem Host konfiguriert sind, auf dem die CLI ausgeführt wird. Die CLI löst Pakete nur aus den in --nugetConfigFilePath definierten Feeds auf. Siehe Verwalten von 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	Die URL Ihres Identity Servers. Erforderlich, wenn der Orchestrator auf der UiPath Automation Suite oder einem eigenständigen Orchestrator (lokale MSI) ausgeführt wird. Nicht erforderlich für Automation Cloud – die CLI löst den Identitätsserver von der Cloud-URL auf.
--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"