- 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-017 - Invalid parameter modifier
- 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
- Automatisierung von Citrix-Technologien
- 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
- Versionen von UiPath.UIAutomation.Activities-Paket und UiPath Remote Runtime stimmen nicht überein
- Die erforderliche UiPath-Erweiterung ist auf der Remotemaschine nicht installiert
- Einstellungen für die Bildschirmauflösung
- Gruppenrichtlinien
- 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
- Gruppenrichtlinien
- 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
- Assembly compilation errors
- 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
Debugging-Aktionen
Das Debugging einer einzelnen Datei oder des gesamten Projekts kann sowohl auf der Menüband-Registerkarte Design oder Debuggen durchgeführt werden. Der Debugging-Prozess ist jedoch nicht verfügbar, wenn Projektdateien Validierungsfehler aufweisen.
Verwenden Sie Einzelschritt, um Aktivitäten einzeln zu debuggen. Wenn diese Aktion ausgelöst wird, wird der Debugger geöffnet und hebt die Aktivität hervor, bevor sie ausgeführt wird.
ReadOnly
-Modus geöffnet und jede Aktivität wird nacheinander ausgeführt.
Der Tastaturkurzbefehl für Einzelschritt ist F11.
Im Gegensatz zur Aktion Einzelschritt öffnet Prozedurschritt nicht den aktuellen Container. Wenn die Aktion verwendet wird, debuggt sie die nächste Aktivität und hebt Container hervor (wie Flowcharts, Sequences oder Invoke Workflow File-Aktivitäten), ohne diese zu öffnen.
Diese Aktion ist praktisch zum Überspringen der Analyse großer Container, die beim Ausführen wahrscheinlich keine Probleme auslösen werden.
Prozedurschritt kann über die Tastenkombination F10 aufgerufen werden.
Mit dieser Aktion wird der Schritt bis zur nächsten Anweisung durchgeführt, dann wird die Ausführung auf der Ebene des aktuellen Containers angehalten. Rückschritt schließt die Ausführung von Aktivitäten im aktuellen Container ab, bevor das Debugging angehalten wird. Diese Option funktioniert gut mit verschachtelten Sequences.
Rückschritt kann über die Tastenkombination Umschalt+F11 aufgerufen werden.
Wiederholen führt die vorherige Aktivität erneut aus und gibt die Ausnahme aus, wenn sie erneut auftritt. Die Aktivität, die die Ausnahme ausgelöst hat, wird hervorgehoben und Details über den Fehler werden in den Panels Lokal und Aufrufliste angezeigt.
Die Aktion Ignore kann verwendet werden, um eine aufgetretene Ausnahme zu ignorieren und die Ausführung ab der nächsten Aktivität fortzusetzen, sodass der Rest des Workflows gedebuggt werden kann.
Diese Aktion ist nützlich, wenn man die Aktivität, die die Ausnahme ausgelöst hat, überspringt und den verbleibenden Teil des Projekts weiter debuggt.
Neu starten ist verfügbar, nachdem eine Ausnahme ausgelöst wurde und der Debug-Prozess angehalten wurde. Die Aktion dient dazu, den Debugging-Prozess ab der ersten Aktivität des Projekts neu zu starten. Verwenden Sie Langsamer Schritt, um die Debugging-Geschwindigkeit zu verringern und Aktivitäten während der Ausführung ordnungsgemäß zu überprüfen.
Bitte beachten Sie, dass bei dieser Option nach Verwendung der Aktion Ab dieser Aktivität ausführen das Debugging ab der zuvor angegebenen Aktivität neu gestartet wird.
Mit Unterbrechung können Sie den Debugging-Prozess jederzeit anhalten. Die Aktivität, für die das Debuggen durchgeführt wird, bleibt im angehaltenen Zustand hervorgehoben. Sobald dies geschehen ist, können Sie Fortfahren, Einzelschritt, Prozedurschritt oder Beenden für den Debugging-Prozess wählen.
Wir empfehlen die Verwendung von Unterbrechung zusammen mit Langsamer Schritt, damit Sie genau wissen, wann das Debugging angehalten werden muss.
In dieser Situation kann als Alternative zu Langsamer Schritt (Slow Step) das Panel Ausgabe (Output) überwacht und für die Aktivität, für welche gerade die Fehlersuche durchgeführt wird, Haltepunkt (Break) verwendet werden.
Mit Ausführungspunkt fokussieren (Focus Execution Point) können Sie zum aktuellen Haltepunkt oder zu der Aktivität zurückkehren, die bei der Fehlersuchen einen Fehler verursacht hat. Die Schaltfläche Fokussieren (Focus) bietet eine einfachere Möglichkeit, nach dem Navigieren durch den Prozess zu der Aktivität zurückzukehren, die den Fehler verursacht hat, und die Fehlersuche fortzusetzen.
Alternativ können Sie bei einer Unterbrechung der Fehlersuche wegen eines erreichten Haltepunkts mit Fokussieren (Focus) nach dem Navigieren durch die im Automationsprozess enthaltenen Aktivitäten zu dem besagten Haltepunkt zurückkehren.
In einem dritten Fall wird die Fehlersuche entweder nach Gehen in (Step Into) oder Übergehen (Step Over) und Navigieren durch den Prozess unterbrochen. In diesem Fehl kehren Sie mit Fokussieren (Focus) zu der Aktivität zurück, bei der die Fehlersuche unterbrochen wurde.
Im Kontextmenü Haltepunkte können Sie die Option Fokus auswählen, um die Aktivität mit dem Haltepunkt hervorzuheben.
Mit Langsamer Schritt (Slow Step) können Sie sich beliebige Aktivitäten bei der Fehlersuche aus der Nähe ansehen. Während diese Aktion aktiviert ist, sind die Aktivitäten im Fehlersuchprozess hervorgehoben. Überdies sind Container wie Flowcharts, Sequences oder Workflow-Datei-aufrufen-(Invoke Workflow File)Aktivitäten geöffnet. Dieser Vorgang ist ähnlich wie Gehen in (Step Into), jedoch ohne den Fehlersuchvorgang zu pausieren.
Langsamer Schritt (Slow Step) kann sowohl vor als auch während der Fehlersuche aktiviert werden. Durch Aktivieren der Aktion wird die Fehlersuche nicht pausiert.
Obwohl die Bezeichnung Langsamer Schritt (Slow Step) lautet, bietet die Aktion 4 verschiedene Geschwindigkeiten. Der Schritt mit der ausgewählten Geschwindigkeit führt den Fehlersuchvorgang langsamer als den vorherigen aus. So läuft die Fehlersuche mit Langsamer Schritt (Slow Step) in der Geschwindigkeit 1x am langsamsten und am schnellsten mit der Geschwindigkeit 4x ab. Mit anderen Worten, die Geschwindigkeit bestimmt, wie schnell der Debugger von einer Aktivität zu nächsten springt.
Immer, wenn Sie auf Langsamer Schritt (Slow Step) klicken, ändert sich die Geschwindigkeit um einen Schritt. Sie ist leicht am Symbol zu erkennen, das entsprechend aktualisiert wird.
Die Menüband-Schaltfläche Ausführungspfad ist standardmäßig deaktiviert. Wenn diese Option aktiviert ist, wird der genaue Ausführungspfad beim Debuggen angezeigt. Während der Prozess ausgeführt wird, wird jede Aktivität im Bedienfeld Designer hervorgehoben und markiert, die Ihnen die Ausführung wie möglich anzeigt:
- ausgeführte Aktivitäten werden grün markiert und hervorgehoben;
- Aktivitäten, die nicht ausgeführt wurden, werden in keiner Weise gekennzeichnet;
-
Aktivitäten, die eine Ausnahme ausgelöst haben, werden rot markiert und hervorgehoben.
Wenn aktiviert, werden UI-Elemente bei der Fehlersuche hervorgehoben. Die Option kann sowohl mit regulärer als auch schrittweiser Fehlersuche verwendet werden.
Wenn aktiviert, werden gedebuggte Aktivitäten als Ablaufverfolgungsprotokolle im Panel Ausgabe angezeigt. Beachten Sie, dass die Optionen Elemente hervorheben und Aktivitäten protokollieren nur vor dem Debuggen umgeschaltet werden können und erhalten bleiben, wenn Sie das Automatisierungsprojekt erneut öffnen. Für aufgerufene Workflows gilt dies nur, wenn diese Dateien im Panel Designer geöffnet werden.
Protokolle werden automatisch an den Orchestrator geschickt, wenn eine Verbindung besteht. Sie können sie jedoch auch lokal speichern, indem Sie die Option Entwicklungsprotokollierung zulassen auf der Registerkarte Roboter-Einstellungen im Fenster „Benutzer hinzufügen“ oder „Benutzer bearbeiten“ deaktivieren.
Das Deaktivieren von Protokollaktivitäten (Log Activities) ist eine Möglichkeit, kleinere Protokolldateien an Orchestrator zu senden.
Trace
, wenn Protokollaktivitäten deaktiviert sind, und Verbose
, wenn „Aktivitäten protokollieren“ aktiviert ist. Dadurch werden sowohl die Einstellung „Roboter“ als auch „Orchestrator“ außer Kraft gesetzt.
Der Debugger protokolliert standardmäßig Aktivitäten, sodass jeder Schritt im Panel Ausgabe (Output) erscheint. Wir empfehlen, ihn zwecks leichterer Nachverfolgung aktiviert zu lassen, wie Sie im Bild unten sehen können:
Das Problem hierbei ist, dass ein oder mehrere Eingabefelder der Benutzereingabe-Sequence leer sind, was eine True-Bedingung für die Ablaufentscheidung darstellt. Dies können Sie daran erkennen, dass die Benutzereingabe-Sequence bei der Fehlersuche doppelt ausgeführt wird, was bedeutet, dass ein oder mehrere Felder bei der ersten Ausführung leer gelassen wurden.
Wenn Sie die Option Aktivitäten protokollieren (Log Activities) bei der Fehlersuche deaktivieren, werden im Panel Ausgabe (Output) keine Nachverfolgungsprotokolle angezeigt. Bei einer normalen Ausführung ohne Fehler bekommen Sie nur die Zeiten für Anfang und Ende der Ausführung zu sehen. Durch Hinzufügen einer Protokollnachricht (Log Message) können Sie jedoch feststellen, wo Probleme auftreten könnten.
Beispielsweise können Sie eine Protokollnachrichts- (Log Message) Aktivität hinzufügen, die Sie informiert, dass in diesem Fall ein oder zwei Eingabefelder leer sind. Wie Sie unten sehen können, erscheint diese Nachricht bei der Fehlersuche auch dann im Panel Ausgabe (Output), wenn die Option Aktivitäten protokollieren (Log Activities) deaktiviert ist:
Denken Sie daran, dass Sie die Nachrichten im Panel Ausgabe (Output) jederzeit filtern können, indem Sie einfach die Sie interessierenden Warnungstypen auswählen oder sogar alle Meldungen löschen.
Beachten Sie, dass standardmäßig alle Debugging-Protokolle an Orchestrator gesendet werden. Sie können dies deaktivieren, indem Sie die Option Entwicklungsprotokollierung zulassen auf der Registerkarte Einstellungen im Fenster Roboter hinzufügen oder bearbeiten löschen. Wenn diese Option deaktiviert ist, werden Debugging-Protokolle nur lokal gespeichert.
Diese Debugfunktion ist standardmäßig deaktiviert. Wenn im Menüband deaktiviert, löst sie den Ausführungsfehler aus und stoppt das Debuggen, hebt die Aktivität hervor, die die Ausnahme ausgelöst hat, und protokolliert die Ausnahme im Bedienfeld Ausgabe. Wenn zuvor ein globaler Ausnahmehandler im Projekt festgelegt wurde, wird die Ausnahme an den Handler weitergegeben.
Wenn diese Option aktiviert ist, wird die Ausnahme im Bedienfeld Ausgabe protokolliert, die Ausführung wird fortgesetzt.
Die Option Bild in Bild ist auf der Registerkarte Debuggen sowohl für das Ausführen als auch für das Debuggen von Prozessen oder Bibliotheken in einer separaten Sitzung auf Ihrem Computer verfügbar.
Wenn diese Option aktiviert ist, startet der Prozess immer dann, wenn Sie Ausführen oder Datei ausführen, Debuggen oder Datei debuggen auswählen, entweder in einer separaten Sitzung oder auf einem virtuellen Desktop in der Benutzersitzung. Wenn Bild in Bild deaktiviert ist, erfolgen Debugging und Ausführung in der aktuellen Sitzung.
Die Option zum Ausführen eines Prozesses in Bild in Bild (BiB) kann in der beaufsichtigten Automatisierung sehr nützlich sein. Überprüfen Sie, ob ein Prozess im BiB-Modus erfolgreich ausgeführt wird, und aktualisieren Sie dann die Projekteinstellungen, um anzugeben, ob er nach der Veröffentlichung mit dieser Funktion ausgeführt werden kann:
- Klicken Sie im Bereich Projekt auf Einstellungen , um das Fenster „Projekteinstellungen“ zu öffnen.
-
Auf der Registerkarte Allgemein:
-
BiB-Optionen – Geben Sie an, ob das Projekt mit Bild in Bild getestet wurde und ob es standardmäßig im BiB-Modus starten soll.
- Für BiB-Verwendung getestet; in BiB starten – Die Automatisierung wurde für die Ausführung im BiB-Modus genehmigt. Wenn sie ausgeführt wird, startet sie standardmäßig im BiB-Modus.
- Für BiB-Verwendung getestet; standardmäßig nicht in BiB starten – Die Automatisierung wurde für die Ausführung im BiB-Modus genehmigt. Sie wird standardmäßig in der Hauptsitzung oder auf dem Desktop gestartet.
- Nicht für die BiB-Verwendung getestet – Die Automatisierung wurde nicht für die Ausführung im BiB-Modus genehmigt. Sie wird standardmäßig in der Hauptsitzung oder auf dem Desktop gestartet. Wenn der Benutzer sie im BiB-Modus ausführt, wird er in einem Dialogfeld darüber informiert, dass diese Funktion nicht getestet wurde, und muss dies bestätigen, bevor er fortfahren kann.
- BiB-Typ – Wählen Sie aus, wie die Automatisierung von der Benutzersitzung isoliert werden soll, wenn das Projekt im BiB-Modus ausgeführt wird: Neue Sitzung (untergeordnete Sitzung auf der Maschine) oder Neuer Desktop (virtueller Desktop in der Benutzersitzung).
-
Weitere Informationen, einschließlich zu Einschränkungen dieser Funktion, finden Sie unter Bild in Bild im Handbuch zu Robot.
Wenn diese Funktion aktiviert ist, werden alle Ausführungs- und Debugging-Vorgänge auf einem angegebenen Remote-Roboter anstelle des lokal installierten Roboters ausgeführt, sodass Sie die Automatisierung in verschiedenen Umgebungen testen können. Weitere Informationen finden Sie unter Remote-Debugging.
Sie können Leistungsengpässe im Workflow identifizieren, wenn Sie die Datei debuggen. Weitere Informationen finden Sie unter Ausführungsprofil.
%localappdata%\UiPath\Logs
angezeigt, in dem die Protokolle lokal gespeichert sind. Das Namensformat von Protokolldateien ist YYYY-DD-MM_Component.log
(wie beispielsweise 2018-09-12_Execution.log
oder 2018-09-12_Studio.log
). Weitere Informationen zur Protokollierung finden Sie hier.
- Gehen in (Step Into)
- Übergehen (Step Over)
- Rückschritt
- Wiederholen
- Ignorieren
- Neu starten
- Unterbrechung (Break)
- Fokussieren (Focus)
- Langsamer Schritt (Slow Step)
- Ausführungspfad
- Elemente hervorheben
- Protokollaktivitäten
- Bei Ausnahme fortsetzen
- Bild in Bild
- Remote-Debugging
- Ausführungsprofil erstellen
- Protokolle öffnen