- Überblick
- UiPath-CLI
- Über UiPath-CLI
- Herunterladen der UiPath-CLI
- Kompatibilitätsmatrix
- Ausführen der UiPath-CLI
- Verwalten von NuGet-Feeds
- Über UiPath CLI-Aufgaben
- Packen von Projekten in ein Paket
- Analysieren eines Projekts
- Bereitstellen eines Pakets im Orchestrator
- Ausführen eines Auftrags im Orchestrator
- Testen eines Pakets oder Ausführen eines Testsatzes
- Testen eines Pakets oder Ausführen eines Testsatzes im Test Manager
- Testen mehrerer Pakete
- Bereitstellen von Assets im Orchestrator
- Löschen von Assets aus dem Orchestrator
- Ausführen von Aufgaben mithilfe der JSON-Konfiguration
- Wiederherstellen von Automatisierungsabhängigkeiten
- Fehlerbehebung bei der UiPath-CLI
- Azure DevOps-Erweiterung
- Jenkins-Plugin

Benutzerhandbuch zu CI/CD-Integrationen
Testen eines Pakets oder Ausführen eines Testsatzes
Prerequisites:
- Erstellen Sie ein Paket oder einen Testsatz.
- Führen Sie die CLI-Datei
exe(für Windows) oderdll(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Führen Sie die folgenden Schritte aus, um ein Paket zu testen:
- Führen Sie die
test-Aufgabe mituipcli testaus. Sie können eine Liste der verfügbaren Unteraufgaben sehen. - Geben Sie die erforderlichen Parameter an und führen Sie die
run-Unteraufgabe aus. In der folgenden Tabelle sind die erforderlichen Parameter beschrieben:
| Parameter | Beschreibung |
|---|---|
-P , or --project-path | Der Pfad zur Testpaketdatei, die Sie testen möchten. |
--projectKey | Der Projektschlüssel, angezeigt unter Test Manager > Registerkarte Dashboard > Projekte > Alle Projekte. Der Projektschlüssel ist das Präfix für alle Objektschlüssel. Erforderlich bei Verwendung des Test Managers. |
--testsetkey | Der Testsatzschlüssel, der unter Test Manager > Registerkarte Testsätze > Spalte Schlüssel angezeigt wird. Stellen Sie sicher, dass der Testsatz die neueste Version der Testfälle enthält. Wenn sich der Testsatz nicht im Standardordner befindet, stellen Sie sicher, dass Sie den entsprechenden Ordnernamen davor einschließen. Verwenden Sie beispielsweise AccountingTeam\\TestSet. |
-s , or --testset | Der Name, der für den Testsatz angezeigt wird, den Sie ausführen möchten. Stellen Sie sicher, dass der Testsatz die neueste Version der Testfälle enthält. Wenn sich der Testsatz nicht im Standardordner befindet, stellen Sie sicher, dass Sie den entsprechenden Ordnernamen davor einschließen. Verwenden Sie beispielsweise AccountingTeam\\TestSet. |
--out | Der Typ der Ergebnisdatei \<Junit|uipath\>. |
-r , or --result_path | Der Zielpfad der Datei, in der Sie die Ergebnisse speichern möchten. |
-e oder --environment ( Erforderlich für klassische Ordner) | Die Umgebung, in der Sie das Paket bereitstellen möchten. Sie müssen es mit project path koppeln. |
-w , or --timeout | Die Zeit (in Sekunden), die Sie auf die Ausführung des Testsatzes warten möchten. Der Standardwert ist 7200 Sekunden . |
-i oder --input_path ( Erforderlich , wenn der Einstiegspunkt-Workflow Eingabeparameter hat, die Sie über die Befehlszeile übergeben möchten) | Der vollständige Pfad zu einer JSON-Eingabedatei. Weitere Informationen zur Dateistruktur finden Sie unter JSON-Format der Eingabeparameter . |
--attachRobotLogs | Fügt Roboterprotokolle für jeden ausgeführten Testfall und einen JUnit-Testbericht an. |
|
| Die Repository-URL, unter der das Projekt versioniert wird. |
|
| Der Repository-Commit, aus dem das Projekt erstellt wurde. |
|
| Die Repository-Verzweigung, aus der das Projekt erstellt wurde. |
|
| VCS-System-Repository-Typ. |
|
| URL der Automation Hub-Idee. |
--releaseNotes | Versionshinweise hinzufügen. |
--disableBuiltInNugetFeeds | Deaktivieren Sie integrierte NuGet-Feeds. |
|
| Anzahl der Wiederholungen für fehlgeschlagene Testfälle (standardmäßig ist kein Wiederholungsversuch festgelegt). |
-u oder --username ( Erforderlich , wenn Sie die Standardauthentifizierung verwenden, über einen Benutzernamen und ein Kennwort) | Der Benutzername, der für die Authentifizierung bei Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Kennwort koppeln. |
-p oder --password ( Erforderlich , wenn Sie die Standardauthentifizierung verwenden, über einen Benutzernamen und ein Kennwort) | Das Kennwort, das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Benutzernamen koppeln. |
-t oder --token ( Erforderlich , wenn Sie tokenbasierte Authentifizierung verwenden ) | Das OAuth2-Aktualisierungstoken, das für die Authentifizierung bei Orchestrator verwendet wird. Sie müssen es mit dem Kontonamen und der Client-ID koppeln. |
-a oder --accountName ( Erforderlich , wenn Sie tokenbasierte Authentifizierung verwenden ) | Der Name des Orchestrator CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-ID koppeln. |
-A , --accountForApp | Der Name des Orchestrator CloudRPA-Kontos (Organisationsname). Sie müssen ihn mit der Anwendungs-ID, dem Anwendungsgeheimnis und dem Anwendungs-Scope für eine externe Anwendung koppeln. |
-I oder --applicationId ( Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden ) | Die ID der externen Anwendung. Sie müssen es mit dem Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln. |
-S oder --applicationSecret ( Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden ) | Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln. |
--applicationScope ( Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden ) | Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto , der Anwendungs-ID und dem Anwendungsgeheimnis für eine externe Anwendungen koppeln. Fügen Sie bei Verwendung des Test Manager Folgendes zu den Orchestrator-Scopes hinzu: |
-o , or --organizationUnit | Der Orchestrator-Ordner, in dem Sie die Testsätze ausführen möchten. |
-l , or --language | Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird. |
|
| Zeigt die Ablaufverfolgung der Ereignisse an. |
--identityURL ( Erforderlich für PaaS- oder MSI- Bereitstellungen ) | Die URL Ihres Identitätsservers. |
Orchestrator URL (pos. 0) ( Erforderlich ) | Die URL der Orchestrator-Instanz. |
|
| Der Mandant, in dem sich das Paket oder der Testsatz befindet. |
Nutzung:**
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>]
Beispiele:
Orchestrator-Tests:
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"
Test Manager-Tests:
uipcli test run "https://cloud.uipath.com/" "TenantName" --projectKey "MyTestProject" --testsetkey "MyTestSet" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" -o "FolderName" --out "junit" --result_path "C:\TestResults"uipcli test run "https://cloud.uipath.com/" "TenantName" --projectKey "MyTestProject" -P "C:\userprofile\AutomationProjectWithTestCases\project.json" -e "TestEnvironment" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" -o "FolderName" --out "uipath" --result_path "C:\TestResults"
Weitere Informationen zur Verwendung des Test Managers mit der UiPath-CLI finden Sie unter Testen eines Pakets oder Ausführen eines Testsatzes im Test Manager.