Analysieren eines Projekts

Voraussetzungen

• Erstellen Sie ein Projekt.
• 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.

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:

Die Projektvalidierung wird als Teil der Aufgabe analyze ausgeführt und kann nicht übersprungen werden. Validierungsmeldungen werden zusammen mit Workflow-Analyse-Meldungen in der Analyseausgabe angezeigt.

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

Parameter	Beschreibung
Project(s) Path (pos. 0) ( Erforderlich )	Der Pfad zur project.json -Datei oder der Pfad zum Ordner, der mehrere project.json -Dateien enthält.
--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.
--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 (*) ( Optional für die Authentifizierung externer Anwendungen )	Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Optional, wenn die Authentifizierung einer externen Anwendung verwendet wird, da Standard-Scopes automatisch angewendet werden. 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.
-l , --language	Die Orchestrator-Sprache.
--traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
--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.
--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. Weitere Informationen finden Sie unter Verwalten von NuGet-Feeds . In älteren Builds wurden nur <packageSources> -URLs angewendet.
--disableBuiltInNugetFeeds	Deaktivieren Sie integrierte NuGet-Feeds.
--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.
--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 .

Hinweis: Standardmäßige Anwendungs-Scopes

Wenn Sie die Authentifizierung einer externen Anwendung verwenden, ohne den Parameter --orchestratorApplicationScope anzugeben, wendet die CLI automatisch diese standardmäßigen Orchestrator-Scopes an:

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Nutzung

uipcli package analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--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] [--excludeConfiguredSources]

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"