- Versionshinweise
- Erste Schritte
- Einstellung und Konfiguration (Setup and Configuration)
- Automationsprojekte
- Abhängigkeiten
- Workflow-Typen
- Dateivergleich
- Beste Praktiken für die Automatisierung (Automation Best Practices)
- Integration der Quellenkontrolle
- Debugging
- 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-DBP-002 – Hohe Anzahl von Argumenten
- ST-DBP-003 – Leerer Catch-Block
- ST-DBP-007 – Mehrere Flussdiagrammebenen
- ST-DBP-020 – Nicht definierte Ausgabeeigenschaften
- 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
- Variablen
- Argumente
- Importierte Namespaces
- Aufzeichnung
- UI-Elemente
- Kontrollfluss
- Selektoren
- Objekt-Repository
- Data-Scraping
- Bild- und Textautomatisierung
- Automatisierung von Citrix-Technologien
- RDP-Automatisierung
- SAP-Automation
- VMware Horizon-Automatisierung
- Protokollierung
- Das ScaleCoordinates-Migrationstool
- Das Tool ScreenScrapeJavaSupport
- Das WebDriver-Protokoll
- StudioPro
- Erweiterungen
- Fehlersuche und ‑behebung
- Internet Explorer x64
- Microsoft Office Interop-Probleme
- Erkennen von UI-Elementen in PDF mit Zugriffsoptionen.
- Erkennen von UI-Elementen nach Windows-Aktualisierungen.
- JxBrowser-Anwendungen
- Überwachung der Benutzerereignisse (User Events Monitoring)
- Java in App-V
- Microsoft App-V – Unterstützung und Einschränkungen
- Citrix-Fehlerbehebung
Ü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-
erkennbar sind. UIAutomation.Activities, Excel.Activities und Mail.Activities haben ebenfalls ihre eigenen Regeln, die durch das Präfix identifizierbar sind.
Sie können auch benutzerdefinierte Regeln erstellen. Weitere Informationen finden Sie unter Erstellen von Workflow-Analyseregeln im Entwicklerhandbuch.
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.
Regeln können nach Scope und Aktion gefiltert werden. Deaktivieren Sie das Kontrollkästchen neben den einzelnen Regeln, um eine projektspezifische Konfiguration zu definieren. Standardmäßig werden Regeln nach Code im Fenster angeordnet, und aktivierte Regeln werden zuerst angezeigt.
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:
- Der Pfad für die Windows Installer-Version (.msi) von Studio lautet standardmäßig
C:\Program Files (x86)\UiPath\Studio\
. - Bei Studio, das mit dem Installationsprogramm der Community-Edition (.exe) installiert wird, ist der Standardpfad
%LocalAppData%\UiPath\[Studio_version]\
.
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.
- Pfad
%LocalAppData%\UiPath\Rules
in der DateiRuleConfig.json
. Suchen Sie eine bestimmte Regel, ändern Sie deren Parameter, ändern Sie den ParameterIsEnabled
infalse
, um die Regel zu deaktivieren.
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.
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.
|
|
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.
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.
Sie können die Ausführung und/oder Veröffentlichung von Projekten verhindern, die Workflow-Analyse-Fehler enthalten, indem Sie die folgenden Optionen unter Studio Backstage-Ansicht > Einstellungen > Designaktivieren:
- 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.
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.ErrorsDescription
: Eine Liste der Fehlermeldungen, die ggf. von der Regel generiert werden.