- Versionshinweise
- Erste Schritte
- Einstellung und Konfiguration (Setup and Configuration)
- Automationsprojekte
- Über die Veröffentlichung von Automatisierungsprojekten
- Entwerfen von Automatisierungen
- Verwalten von Aktivitätspaketen
- Konfigurieren von Aktivitätsprojekteinstellungen
- Signieren von Paketen
- Governance
- Importieren von Entitäten
- Moderne Designumgebung
- Verknüpfen eines Projekts mit einer Idee im Automation Hub
- Verwenden des Data Managers
- Abhängigkeiten
- Workflow-Typen
- Kontrollfluss
- Dateivergleich
- Beste Praktiken für die Automatisierung (Automation Best Practices)
- Integration der Quellenkontrolle
- Informationen zur Versionskontrolle
- Verwalten von Projekten mit TFS
- Verwalten von Projekten mit SVN
- Workflow Diff
- Debugging
- Protokollierung
- Das Diagnose-Tool
- Workflow-Analyse
- Über die Workflow-Analyse
- ST-NMG-001 – Namenskonvention für Variablen
- ST-NMG-002 – Namenskonvention für Argumente
- ST-NMG-004 – Duplizierung des Anzeigenamens
- ST-NMG-005 – Variable überschreibt Variable
- ST-NMG-006 – Variable überschreibt Argument
- ST-NMG-008 – Variablenlänge überschritten
- ST-NMG-009: Datentabellenvariablen mit Präfix versehen
- ST-NMG-011 – Datentabellenargumente mit Präfix versehen
- ST-NMG-012 – Standardwerte für Argumente
- ST-NMG-016 – Argumentlänge überschritten
- ST-NMG-017 – Der Klassenname stimmt mit dem Standard-Namespace überein
- ST-DBP-002 – Hohe Anzahl von Argumenten
- ST-DBP-003 – Leerer Catch-Block
- ST-DBP-007 – Mehrere Flussdiagrammebenen
- ST-DPB-010 – Mehrere Instanzen von [Workflow] oder [Testfall]
- ST-DBP-020 – Nicht definierte Ausgabeeigenschaften
- ST-DBP-021 – Hartcodiertes Timeout
- ST-DBP-023 – Leerer Workflow
- ST-DBP-024 – Prüfung der Persistenzaktivität
- ST-DBP-025 – Voraussetzung für Variablenserialisierung
- ST-DBP-026 – Verwendung der Verzögerungsaktivität
- ST-DBP-027 – Bewährte Methode für Persistenz
- ST-DBP-028 – Voraussetzung für Argumentenserialisierung
- ST-USG-005 – Hartcodierte Aktivitätsargumente
- ST-USG-009 – Nicht verwendete Variablen
- ST-USG-010 – Nicht verwendete Abhängigkeiten
- ST-USG-014 – Paketbeschränkungen
- ST-USG-020 – Minimale Protokollmeldungen
- ST-USG-024 – Nicht verwendet, gespeichert für später
- ST-USG-025 – Missbrauch gespeicherter Werte
- ST-USG-026 – Aktivitätseinschränkungen
- ST-USG-027 – Erforderliche Pakete
- ST-USG-028 – Aufruf von Dateivorlagen einschränken
- ST-USG-032 – Erforderliche Tags
- ST-USG-034 – Automation Hub-URL
- Variablen
- Argumente
- Importierte Namespaces
- Codierte Automatisierungen
- Einleitung
- Registrieren von benutzerdefinierten Diensten
- „Vor“- und „Nach“-Kontexte
- Generieren von Code
- Generieren eines codierten Testfalls aus manuellen Testfällen
- Triggerbasierte Attended-Automatisierung
- Aufzeichnung
- UI-Elemente
- Selektoren
- Objekt-Repository
- Data-Scraping
- Bild- und Textautomatisierung
- Citrix Technologies Automation
- RDP-Automatisierung
- VMware Horizon-Automatisierung
- Salesforce-Automatisierung
- SAP-Automation
- macOS UI-Automatisierung
- Das Tool ScreenScrapeJavaSupport
- Das WebDriver-Protokoll
- Erweiterungen
- Über Erweiterungen
- SetupExtensions-Tool
- „UiPathRemoteRuntime.exe“ wird nicht in der Remotesitzung ausgeführt.
- UiPath Remote Runtime blockiert das Schließen der Citrix-Sitzung
- UiPath Remote Runtime verursacht Speicherverlust
- UiPath.UIAutomation.Activities package and UiPath Remote Runtime versions mismatch
- Die erforderliche UiPath-Erweiterung ist auf der Remotemaschine nicht installiert
- Einstellungen für die Bildschirmauflösung
- Group Policies
- Kommunikation mit Browser nicht möglich
- Die Chrome-Erweiterung wird automatisch entfernt
- Möglicherweise ist die Erweiterung beschädigt
- Überprüfen Sie, ob die Erweiterung für Chrome installiert und aktiviert ist
- Überprüfen Sie, ob ChromeNativeMessaging.exe ausgeführt wird
- Überprüfen der korrekten Definition der ComSpec-Variablen
- Aktivieren Sie den Zugriff auf Datei-URLs und den Inkognito-Modus
- Mehrere Browser-Profile
- Group Policy conflict
- Spezifische bekannte Probleme für MV3-Erweiterungen
- Liste der Erweiterungen für Chrome
- Chrome-Erweiterung für Mac
- Group Policies
- Kommunikation mit Browser nicht möglich
- Die Edge-Erweiterung wird automatisch entfernt
- Möglicherweise ist die Erweiterung beschädigt
- Überprüfen, ob die Erweiterung für Microsoft Edge installiert und aktiviert ist
- Überprüfen Sie, ob ChromeNativeMessaging.exe ausgeführt wird
- Überprüfen der korrekten Definition der ComSpec-Variablen
- Aktivieren des Zugriffs auf Datei-URLs und den InPrivate-Modus
- Mehrere Browser-Profile
- Group Policy conflict
- Spezifische bekannte Probleme für MV3-Erweiterungen
- Liste der Erweiterungen für Edge
- Erweiterung für Safari
- Erweiterung für VMware Horizon
- Erweiterung für Amazon WorkSpaces
- SAP Solution Manager-Plugin
- Excel-Add-in
- Test Suite – Studio
- Fehlersuche und ‑behebung
- Informationen zur Fehlerbehebung
- Microsoft App-V – Unterstützung und Einschränkungen
- Fehlerbehebung bei Internet Explorer x64
- Probleme in Microsoft Office
- Erkennen von UI-Elementen in PDF mit Zugriffsoptionen.
- Reparieren der Active Accessibility-Unterstützung
- Die Validierung großer Windows-Legacy-Projekte dauert länger als erwartet
Über die Workflow-Analyse
Die Workflow-Analyse ist eine statische Codeanalyse, die sicherstellt, dass Ihr Projekt hohe Qualitäts- und Zuverlässigkeitsstandards erfüllt. Eine statische Codeanalyse überprüft, ob Inkonsistenzen bestehen, ohne das Projekt tatsächlich auszuführen, im Gegensatz zu dynamischen Analysen, die während der Ausführung erfolgen.
Die Workflow-Analyse verwendet eine Reihe von Regeln, um auf verschiedene Inkonsistenzen zu prüfen, die nicht mit der Projektausführung zusammenhängen. Die Regeln basieren auf Best Practices für die Automatisierung und berücksichtigen die Benennung von Variablen und Argumenten, leere Sequences oder Workflows, Paketbeschränkungen usw. Die Analyse identifiziert keine Fehler bei der Ausführung oder Kompilierung.
Die Option ist auf der Menüband-Registerkarte Design sowie den Schaltflächen Datei analysieren und Projekt analysieren verfügbar. Die erste führt eine Analyse der Datei durch, die gerade im Panel Designer fokussiert ist, während die zweite alle Dateien im Automatisierungsprojekt analysiert.
ST-
gekennzeichnet sind. UIAutomation.Activities, Excel.Activities, Testingaktivitäten und Mail.Activities haben ebenfalls ihre eigenen Regeln, die durch das Präfix gekennzeichnet sind. Weitere Informationen finden Sie in der folgenden Tabelle:
Regelkategorie |
Beschreibung |
Quelle |
---|---|---|
Benennung |
Überprüft die Datei oder das Projekt auf Inkonsistenzen im Zusammenhang mit der Benennung. |
Studio |
Stellt sicher, dass Ihr Projekt allgemeinen Best Practices entspricht. | Studio | |
Stellt sicher, dass Ihr Projekt allgemeine Anforderungen in Bezug auf die Anatomie erfüllt. | Studio | |
Bestätigt, dass Projekte leicht verständlich sind, sodass die Wartbarkeit gewährleistet ist. | Studio | |
Stellt sicher, dass die in Ihrem Projekt definierten Elemente tatsächlich verwendet werden. | Studio | |
Überprüft die Datei oder das Projekt auf Inkonsistenzen in Bezug auf Leistung und Wiederverwendbarkeit. | Studio | |
Überprüft die Datei oder das Projekt auf Inkonsistenzen in Bezug auf die Zuverlässigkeit. | Studio | |
Überprüft die Datei oder das Projekt auf Inkonsistenzen in Bezug auf die Sicherheit. | Studio | |
Testet die Workflows und Automatisierungsprojekte. |
Aktivitäten | |
Validiert Workflows, die entweder klassische oder moderne UI-Automatisierungsaktivitäten verbrauchen. |
Aktivitäten | |
Validiert Workflows, die Excel-Aktivitäten nutzen. | Aktivitäten | |
Validiert Workflows, die E-Mail-Aktivitäten nutzen. | Aktivitäten |
Sie können auch benutzerdefinierte Regeln erstellen. Weitere Informationen finden Sie unter Erstellen von Workflow-Analyseregeln im Entwicklerhandbuch.
Regeln können auch beim Erstellen einer Studio-Richtlinie in Automation Ops konfiguriert werden. Weitere Informationen finden Sie im Handbuch zu Automation Ops.
ST-NMG-001
:
ST
gibt an, dass die Regel in Studio integriert ist.NMG
- zeigt, dass die Regel Teil der Kategorie Benennungsregeln ist. Regeln, die Teil der Kategorie Regeln für die Projektanatomie sind, haben die AbkürzungANA
. Regeln, die Teil von Best Practices für den Entwurf sind, haben die AbkürzungDBP
und so weiter.001
ist die Nummer der Regel.
Jede Regel hat einen Anwendungsbereich, für den sie gilt:
- Aktivität: Die Regeln werden auf Aktivitätsebene durchgesetzt, wobei Variablen, Argumente und Eigenschaften überprüft werden. Die Namenskonvention für Variablen ist eine solche Regel.
- Workflow: Regeln führen Prüfungen in einer einzelnen Projektdatei durch, z. B. Nicht verwendete Variablen.
- Projekt: Überprüfungen werden auf Projektebene durchgeführt.
Regeln verfügen über eine Reihe von Aktionen, die festgelegt werden können:
- Fehler: Generiert einen Fehler im Panel Fehlerliste.
- Warnung: Generiert eine Warnung im Panel Fehlerliste.
- Info: Generiert eine Meldung im Panel Fehlerliste.
- Ausführlich: Erstellt große Protokolldateien.
Auf der Seite Protokollierungsstufen finden Sie weitere Informationen zur Protokollierung mit Studio.
Das Projekt oder die Datei wird basierend auf der Grundlage von Regeln analysiert, die im Fenster Projekteinstellungen verfügbar sind:
- Klicken Sie im Panel Projekt auf das Symbol , und wählen Sie dann Workflow-Analyse aus.
- Klicken Sie im Menüband auf die Schaltfläche Datei analysieren, und wählen Sie dann in der Dropdownliste Einstellungen für Workflow-Analyse aus.
Standardmäßig werden Regeln nach dem Code im Fenster angeordnet, wobei aktivierte Regeln zuerst angezeigt werden.
Verwenden Sie das Suchfeld oben im Fenster, um Regeln nach Namen oder Code zu suchen.Um Regeln nach Scope und Standardaktion zu filtern, klicken Sie auf die Schaltfläche rechts neben dem Suchfeld.
Regeln konfigurieren
Sie können eine Regel mit dem Kontrollkästchen auf der linken Seite aktivieren/deaktivieren oder die Standardaktion mit der Dropdownliste auf der rechten Seite ändern.
Einige Regeln erfordern keine zusätzliche Konfiguration, während andere konfigurierbare Parameter enthalten, beispielsweise Schwellenwerte, die nicht überschritten werden dürfen, oder Listen bestimmter Elemente, die zulässig oder unzulässig sind. Bitte beachten Sie, dass beim Konfigurieren von Regeln, die Textfelder enthalten (beispielsweise Falscher Gebrauch von SecureString oder Paketeinschränkungen), kein Text zwischen Anführungszeichen eingegeben werden darf.
Auf Standardwert zurücksetzen
Nachdem Änderungen an den Standardwerten von Regeln vorgenommen wurden, sei es Regex oder Schwellenwerte, können die Werte auf den Standardwert zurückgesetzt werden, indem Sie mit der rechten Maustaste auf die Regel klicken und dann Standard zurücksetzen auswählen.
Die Validierung der Datei oder des Projekts wird bei jedem Auslösen der Workflow-Analyse durchgeführt. Validierungsoptionen sind auf der Menüband-Schaltfläche Datei analysieren verfügbar, Datei validieren und Projekt validieren.
Diese Aktion prüft, ob Variablen, Argumente, Ausdrücke und Importe richtig konfiguriert sind. Die Aktion Datei validieren kann mit der Taste F8 ausgelöst werden, und Projekt validieren mit Umschalt+F8. Die Validierung kann jederzeit abgebrochen werden.
Die Datei(en), die Fehler enthalten, werden im Panel Projekt mit einem roten Punkt markiert, und die Fehler werden in den Panels Fehlerliste und Ausgabe angezeigt.
.xaml
geöffnet und das Element hervorgehoben, das den Fehler ausgelöst hat, unabhängig davon, ob es sich um eine Aktivität, ein Argument oder eine Variable handelt.
.xaml
-Dateien validiert sind, kann das Projekt nicht gedebuggt, ausgeführt oder veröffentlicht werden. Haltepunktbedingungen werden nicht ausgewertet.
Wenn sie ausgelöst wird, prüft die Workflow-Analyse das Projekt oder die Datei anhand des konfigurierten Regelsatzes und protokolliert die gefundenen Fehler entsprechend der Regelaktion im Panel Fehlerliste.
Das Panel Fehlerliste filtert Elemente nach Fehlern, Warnungen und Meldungen. Das Dropdownmenü „Scope“ ist nützlich, um Fehler nach Projekt, aktueller Datei oder einer bestimmten Datei in der Automatisierung zu filtern. Zusätzlich können Elemente nach Regel-ID gefiltert werden.
Klicken Sie auf eine gefundene Warnung oder einen Fehler, um die Empfehlung der Regel und einen Link zur Dokumentationsseite für die jeweilige Regel anzuzeigen.
Zusätzlich zu Regelverletzungen zeigt der Fehlerlistenbereich auch Fehler an, die bei der Ausführung der Workflow-Analyse auftreten können. Wenn die Workflow-Analyse oder eine der konfigurierten Regeln nicht ausgeführt werden kann, wird ein Fehler mit Details zur Fehlerursache in der Beschreibung protokolliert.
UiPath.Studio.CommandLine.exe
-Befehlszeile enthält eine Reihe von Parametern, um Dateien oder Projekte anhand bestimmter Regeln zu prüfen, auch in CI/CD-Pipeline-Konfigurationen.
UiPath.Studio.CommandLine.exe
ist im Installationsordner verfügbar:
- Bei Installationen pro Maschine ist der Standardpfad
%ProgramFiles%\UiPath\Studio\
- Bei Installationen pro Benutzer ist der Standardpfad
%LocalAppData%\Programs\UiPath\Studio
Regeln konfigurieren
Standardmäßig sind alle Workflow-Analyse-Regeln bei der Installation von Studio mit Ausnahme der folgenden Optionen aktiviert:
Sie können Regeln konfigurieren:
- Aktivieren oder deaktivieren Sie im Fenster „Einstellungen für Workflow-Analyse“ Regeln, indem Sie auf das Kontrollkästchen neben den einzelnen Regeln klicken.
- In der Datei
RuleConfig.json
im Pfad%LocalAppData%\UiPath\Rules
. Suchen Sie eine bestimmte Regel, ändern Sie deren Parameter, ändern Sie den ParameterIsEnabled
zufalse
, um die Regel zu deaktivieren. Wenn der Pfad nicht zugänglich ist, können Sie die DateiRuleConfig.json
an einem benutzerdefinierten Speicherort platzieren und den Pfad zur Datei in den Befehl aufnehmen. Weitere Informationen finden Sie unter Analysieren von Dateien und Projekten.
Die Regeln sind nach ihrer eindeutigen ID organisiert, die auch in den Einstellungen für die Workflow-Analyse sichtbar ist.
([A-Z])
erhalten. Dies bedeutet, dass Variablennamen in Großbuchstaben geschrieben werden müssen. Alle anderen Regeln waren in diesem Beispiel deaktiviert.
Parameter | Beschreibung |
---|---|
RuleId | Die ID der Regel. |
IsEnabled | Ob die Regel aktiviert oder deaktiviert ist. Wenn sie auf null festgelegt ist, wird der Wert des Parameters DefaultIsEnabled angewendet. |
DefaultIsEnabled | Ob die Regel standardmäßig aktiviert oder deaktiviert ist. |
DefaultErrorLevel | Die Standardstufe der Protokollmeldung (Fehler, Warnung, Info, Verbose). |
Parameters | Zusätzliche Parameter, die die Regel enthalten kann (z. B. Name oder Wert). |
ErrorLevel | Die Stufe der Protokollmeldung. Wenn sie auf null festgelegt ist, wird der Wert des Parameters DefaultErrorLevel angewendet. |
Analysieren von Dateien und Projekten
UiPath.Studio.CommandLine.exe
-Befehlszeilen zu.
Die folgenden Workflow-Analyse-Befehle sind verfügbar:
analyze
: Analysiert das gesamte Projekt. Der Pfad zur Dateiproject.json
.analyze-file
: Analysiert eine einzelne Datei. Der Pfad zur Datei.xaml
.
Die folgenden Argumente sind für Workflow-Analyse-Befehle möglich:
Argument |
Beschreibung |
---|---|
|
Zum Analysieren einer Datei geben Sie den Pfad zur
.xaml -Datei an. Zum Analysieren des gesamten Projekts geben Sie den Pfad zur project.json -Datei an.
|
|
Der Pfad zur
RuleConfig.json -Datei. Geben Sie diesen Pfad nur an, wenn die Regelkonfigurationsdatei nicht am Standardspeicherort platziert wird (%LocalAppData%\UiPath\Rules ).
|
|
Die für jeden Befehl verfügbaren Argumente anzeigen. |
|
Die Version von
UiPath.Studio.CommandLine.exe überprüfen.
|
UiPath.Studio.CommandLine.exe analyze-file -p "C:\BlankProcess\Main.xaml"
analysiert z. B. nur eine Datei in einem Projekt, Main.xaml
. Die Ausgabe des Befehls gibt ein json-codiertes Wörterbuch mit den folgenden Informationen für jede Regelverletzung zurück:
FilePath
: Der Pfad zur analysierten Datei.ErrorCode
: Die Regel-ID.ActivityDisplayName
: Der Anzeigename der Aktivität (null
falls nicht zutreffend).Item
: Der Name und der Typ des Elements (z. B. Aktivität oder Variable), in dem die Fehlermeldung generiert wurde.ErrorSeverity
: Der Wert des ParametersDefaultAction
, der die konfigurierte Protokollmeldung für jede Regel ist, entweder „Warnung“, „Fehler“, „Info“ oder „Ausführlich“.Description
: Die Beschreibung der Regel.-
Recommendation
undURL
: Die empfohlenen Änderungen zur Lösung des Problems, zusammen mit dem Link zur Dokumentation mit weiteren Informationen.
RuleConfig.json
-Datei zu verwenden, die an einem benutzerdefinierten Speicherort abgelegt wird, fügen Sie dem Befehl den Speicherort hinzu. Um den vorherigen Befehl als Beispiel zu verwenden, um Regeln mit der Datei zu konfigurieren, die sich in C:\CustomFolder\RuleConfig.json
befindet, führen Sie den Befehl wie folgt aus: UiPath.Studio.CommandLine.exe analyze-file -c "C:\CustomFolder\RuleConfig.json" -p "C:\BlankProcess\Main.xaml"
.
echo %errorlevel%
aus, nachdem Sie den Befehl ausgeführt haben. Wenn keine Meldungen mit dem Fehler ErrorSeverity
vorhanden sind, wird der Code 0
zurückgegeben. Andernfalls wird 1
zurückgegeben.
.xaml
-Datei ein Fehler angezeigt.
Die als Präfix für einen Eintrag verwendeten Globally Unique Identifier (GUID) werden bei jeder Ausführung generiert und gelten nur für das aktuelle Ergebnis.
Um Studio so zu konfigurieren, dass die Ergebnisse jeder Workflowanalyse in den Projektordner exportiert werden, wechseln Sie zur Studio Backstage-Ansicht > Einstellungen > Design, und aktivieren Sie die Option Analyseergebnisse exportieren.
\.local\.analysis\
des Projektordners in einer Datei gespeichert, die mit dem Zeitstempel der Analyse benannt ist, gefolgt von project_analysis_results.json
(wenn die Option Projekt analysieren verwendet wird) oder file_analysis_results.json
(wenn die Option Datei analysieren verwendet wird).
.local
ist ausgeblendet. Sie können die Anzeige ausgeblendeter Elemente in den Einstellungen von Windows-Explorer aktivieren.
Die Datei enthält die folgenden Informationen zu jeder aktivierten Regel:
RuleId
: die Regel-ID.RuleName
: Name der Regel.Parameters
: Die anpassbaren Parameter in der Regel, falls zutreffend.Severity
– Die Regelaktion, wenn die Regel verletzt wird.ErrorsDescription
: Eine Liste der Fehlermeldungen, die ggf. von der Regel generiert werden.
Sie können das Ausführen, Veröffentlichen und Pushen/Einchecken von Projekten in Remote-Repositorys verhindern, die Workflow-Analysefehler enthalten, indem Sie die folgenden Optionen unter Studio Backstage-Ansicht > Einstellungen > Design aktivieren:
- Analyse vor Ausführung erzwingen – Jedes Mal, wenn eine Datei oder ein Projekt ausgeführt/debuggt wird, überprüft die Workflow-Analyse alle Regeln mit der Aktion
Error
und nur wenn keine Fehler gefunden werden, ist die Ausführung zulässig. - Analyse vor Veröffentlichung erzwingen – Jedes Mal, wenn die Veröffentlichung initiiert wird, überprüft die Workflow-Analyse alle aktivierten Regeln unabhängig von ihrer Aktion, und nur, wenn keine Regelverletzungen mit der Aktion
Error
vorhanden sind, ist die Veröffentlichung zulässig. - Analyse vor Push/Check-in erzwingen – Immer wenn das Senden eines Projekts an ein Remote-Repository initiiert wird (Committen und pushen für GIT, Einchecken für SVN und TFS), überprüft die Workflow-Analyse alle aktivierten Regeln unabhängig von ihrer Aktion und der Vorgang wird nur zugelassen, wenn keine Regelverletzungen mit der Aktion
Error
vorliegen.
Error
auf), werden die Ergebnisse der Workflowanalyse in das veröffentlichte .nupkg
-Paket in der Datei project_analysis_results.json
gespeichert in \lib\net45\.analysis\
eingefügt. Die Datei enthält die folgenden Informationen zu jeder aktivierten Regel:
RuleId
: die Regel-ID.RuleName
: Name der Regel.Parameters
: Die anpassbaren Parameter in der Regel, falls zutreffend.Severity
– Die Regelaktion (wenn die Regel verletzt wird).ErrorsDescription
: Eine Liste der Fehlermeldungen, die ggf. von der Regel generiert werden.