Analysieren eines Projekts

Voraussetzungen

• Erstellen Sie ein Projekt.
• Führen Sie die CLI-Datei exe (für Windows) oder dll (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 Projekt zu analysieren:

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

Hinweis:

Projektvalidierung wird standardmäßig nicht durchgeführt. Um die strukturierte XAML-Validierung zu aktivieren, verwenden Sie das Flag --validate .

Legende: (*) – Optional, empfohlen bei Verwendung zusätzlicher Paketfeeds.

Parameter	Beschreibung
--analyzerTraceLevel	Wählen Sie aus, welche Nachrichtentypen nach der Analyse ausgegeben werden sollen: Off = don't show any message Fehler (Error) -Warnung - Info - Ausführlich
-stopOnRuleViolation	Der Auftrag schlägt fehl, wenn eine Regel verletzt wird.
--validate	Aktivieren Sie die strukturierte XAML-Validierung (z. B. das Fehlen erforderlicher Aktivitätsargumente). Die Validierung ist standardmäßig deaktiviert. Wenn diese Option aktiviert ist, verursachen Validierungsfehler einen Exit-Code ungleich Null.
--treatWarningsAsErrors	Warnungen als Fehler behandeln.
--resultPath	Der vollständige Pfad zu einer JSON-Datei, in der Sie die Ergebnisse speichern möchten. Wenn Sie dies nicht als Argument hinzufügen, werden die Ergebnisse nur in der Standardkonsole ausgegeben.
--governanceFilePath	Übergeben Sie Governance-Richtlinien, die die Workflow-Analyse-Regeln enthalten. Richtlinien können von Studio heruntergeladen oder aus der exportierten komprimierten ZIP-Datei extrahiert werden. Hinweis: Die Aufgabe schlägt fehl, wenn Sie die Verwendung einer Richtlinie angeben, die Richtliniendatei sich jedoch nicht im angegebenen Pfad befindet.
--ignoredRules	Eine durch Kommas getrennte Liste von Regeln, die Sie während der Analyse ignorieren möchten.
-u , --orchestratorUsername (*) (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 , --orchestratorPassword (*) (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 , -orchestratorAuthToken (*) (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 , --orchestratorAccountName (*) (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 , --orchestratorAccountForApp (*)	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 , --orchestratorApplicationId (*) ( Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden )	Die ID der externen Anwendung. Sie müssen sie mit dem **Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln.
-S , --orchestratorApplicationSecret (*) ( 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.
--orchestratorApplicationScope (*) ( 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.
--orchestratorFolder (*)	Der Name des Ziel-Orchestrator-Ordners. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
--orchestratorUrl (*)	Die URL der Orchestrator-Instanz.
--orchestratorTenant (*)	Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten.
-l , --language	Die Orchestrator-Sprache.
--traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
--identityUrl ( Erforderlich für PaaS- oder MSI- Bereitstellungen	Die URL Ihres Identitätsservers.
--disableBuiltInNugetFeeds	Deaktivieren Sie integrierte NuGet-Feeds.
Project(s) Path (pos.0) ( Erforderlich )	Der Pfad zur project.json -Datei oder der Pfad zum Ordner, der mehrere project.json -Dateien enthält.

Exitcodes

Der Exit-Code des Befehls analyze hängt von den Flags ab, die Sie verwenden:

Flaggen	Exitcode 0 (Erfolg)	Exit-Code nicht null (Fehler)
Keine Flags	Immer	Nie
--stopOnRuleViolation	Keine Regelverstöße	Regelverletzungen erkannt
--validate	Keine Validierungsfehler	Validierungsfehler erkannt
--validate --stopOnRuleViolation	Keine Regelverletzungen und keine Validierungsfehler	Regelverletzungen oder Validierungsfehler erkannt

Nutzung

uipcli package analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--validate] [--treatWarningsAsErrors] [--resultPath <result_path>] [--governanceFilePath <governance_file_path>] [--ignoredRules <rule_id_1,rule_id_2>] [--orchestratorUrl <orchestrator_url> --orchestratorTenant <orchestrator_tenant>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --orchestratorApplicationScope <application_scope>] [--orchestratorFolder <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>] [--disableBuiltInNugetFeeds]

Minimale Befehlsbeispiele

• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --orchestratorApplicationScope "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" --orchestratorFolder "FolderName" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://automation-suite.base.url.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --orchestratorApplicationScope "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" --orchestratorFolder "FolderName"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://cloud.uipath.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --orchestratorApplicationScope "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" --orchestratorFolder "FolderName"