- 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 – Ungültiger Parametermodifizierer
- 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
- 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
- Fehler bei der Assembly-Kompilierung
- 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
Studio-Benutzerhandbuch
Überblick
Trigger-basierte Attended-Automatisierungen können Folgendes beinhalten:
- Formulare – Erstellt mit dem Form Builder und verarbeitet mit dem Form.Activities-Paket.
- Callouts – Erstellt mit dem Form Builder und angezeigt mit dem Callout.Activities-Paket.
- Trigger – Verwenden der Pakete System.Activities und UIAutomation.Activities.
- Globale Variablen – Werden über den Data Manager erstellt.
Formulare und Callouts sind eine Kernfunktion der Attended-Automatisierung. Wenn Sie sie mithilfe von Triggern ausführen, können Sie komplexe Szenarien erstellen. Bei diesen Szenarien können mehrere Ereignisse gleichzeitig auftreten. Und da Aktionen basierend auf den Werten globaler Variablen auslösbar sind, können Sie sogar noch mehr Attended-Szenarien abdecken.
Das folgende Diagramm zeigt einen Prozess, der mit Formularen, Formularereignis-Triggern und Anwendungsereignis-Triggern erstellt wurde. Sie können ähnliche Prozesse auch basierend auf Benutzerereignis-Triggern und Callouts erstellen.
Zum Entwerfen und Ausführen von Trigger-basierten Attended-Automatisierungen:
- Installieren Sie die folgenden Aktivitätspakete:
- Form.Activities-Version 23.4
- System.Activities 23.4
- UIAutomation.Activities 23.4
- Callout.Activities 23.4
- Wenn beim Versuch, eine Formular-Datei zu erstellen, der Fehler Es wurde keine kompatible WebView2-Laufzeitinstallation zum Hosten von WebViews gefunden auftritt, installieren Sie Microsoft Edge WebView2.
Der Zweck von Formularen bei der Attended-Automatisierung ist das Erfassen und Verarbeiten von Benutzer- oder Anwendungseingaben. Die vorhandenen Formularfunktionen ermöglichen Ihnen Folgendes:
- Erstellen Sie Formulare außerhalb von Aktivitäten mit einem Formular (uiform-Datei) in Ihrem Projekt. Sie können sie später unabhängig von einer Aktivität erstellen oder bearbeiten, die die Formulare verwendet. So können Sie den Prozess des Erstellens von Formularen und ihre anschließende Verwendung in der gleichen Automatisierung trennen.
- Erstellen Sie Formulare mit benutzerdefinierten HTML-Dateien. Sie können HTML-Formulare ähnlich wie uiform-Dateien verwenden.
- Verwenden Sie die Aktivität Show Form, um mehrere Formulare gleichzeitig anzuzeigen. Fügen Sie mehrere Show Form-Aktivitäten hinzu und geben Sie für jede von ihnen einen eindeutigen Namen im Feld Instanzname an. Die Eigenschaft Instanzname ist für die meisten Aktivitäten im Paket Form.Activities verfügbar und kann für folgende Zwecke verwendet werden:
- Zeigen oder verwenden Sie Aktionen für mehrere Instanzen des gleichen Formulars, indem Sie für jedes angezeigte Formular eindeutige Instanznamen angeben.
- Zeigen oder verwenden Sie Aktionen auf allen Instanzen, indem Sie das Feld Instanzname leer lassen.
- Konfigurieren Sie einen Trigger so, dass er basierend auf Formularereignissen gestartet wird. Diese Ereignisse können ein Formular darstellen, das geschlossen wird, oder eine bestimmte Formularkomponente, die sich ändert. Dies ist mit der Aktivität Form Event Trigger möglich.
- Wählen Sie aus, dass nur ein Formular angezeigt wird oder dass es angezeigt wird, während der restliche Workflow ausgeführt wird. Aktivieren oder deaktivieren Sie dazu die Eigenschaft Workflowausführung fortsetzen.
- Bearbeiten und nutzen Sie Formularwerte zur Laufzeit, indem Sie die Aktivitäten Set Form Values und Get Form Values verwenden.
- Ändern Sie die Formulareigenschaften zur Laufzeit, indem Sie die Aktivität Change Form Properties verwenden.
- Fügen Sie benutzerdefiniertes JavaScript in das Formular ein, indem Sie die Aktivität Run Form Script verwenden.
Die Rolle von Callouts in der Attended-Automatisierung besteht darin, den Benutzer auf ein bestimmtes UI-Element in einer Anwendung, einer Website, einem Produkt oder sogar einem Formular zu verweisen. Sie können Callouts auch verwenden, um benutzerdefinierte Validierungen für Apps zu erstellen, Felder vorab auszufüllen und mehrere Automatisierungen basierend auf Benutzereingaben auszulösen.
Callout-Funktionen ermöglichen Ihnen Folgendes:
- Erstellen Sie ein Callout mit einer Formular-Datei (uiform) und gestalten Sie ihn mit dem Form Builder.
- Geben Sie das UI-Element an, neben dem der Callout angezeigt werden soll, indem Sie die Aktivität Show Callout verwenden.
- Übergeben Sie Werte an die Elemente in einem Callout.
Auch wenn es ein Callout.Activities-Paket speziell für Callouts gibt, können Callouts ebenso mit dem Form.Activities-Paket verwendet werden, da es sich bei Callouts wie bei regulären Formularen um uiform-Dateien handelt. Das bedeutet, dass Sie Callouts genauso wie ein reguläres Formular verwenden können, wenn Sie das Form.Activities-Paket nutzen.
- Zum Starten von Workflows basierend auf Anwendungs- oder Benutzerereignissen. Zudem können Sie im Zeitplanmodus angeben, wie Aktionen ausgeführt werden sollen, wenn ein Trigger ausgelöst wird:
- Sequenziell – Aktionen werden nacheinander ausgeführt.
- Gleichzeitig – Die Ausführung von Aktionen kann sich überschneiden.
- OneTime – Führt eine Aktion aus und beendet die Überwachung.
- Sequenzielles Reduzieren – Ignoriert alle bevorstehenden Ereignisse mit Ausnahme des letzten, bis das aktuelle Ereignis die Ausführung beendet hat.
- Sequentielles Anhalten – Stoppt die vorherige Ereignisausführung und startet das nächste Ereignis.
Aktivität Beschreibung Formularereignis-Trigger Löst Workflows basierend auf einem Ereignis aus, das in einem Formular auftritt. Application event trigger Richtet einen Trigger basierend auf einem nativen Ereignis eines beliebigen Elementtyps ein (Fenster der obersten Ebene oder ein anderes angegebenes UI-Element). Trigger wiederholen Mit dieser Aktivität können Sie eine TimeSpan als InArgument konfigurieren. Wenn die Zeitspanne abläuft, wird der Trigger ausgeführt und kann basierend auf den Einstellungen wiederholt werden. Keypress Event Trigger Richtet einen Ereignistrigger für das angegebene UI-Element ein, wenn eine Taste gedrückt wird. Click Event Trigger Richtet einen Ereignistrigger für das angegebene UI-Element ein. Hotkey-Trigger (Hotkey Trigger) Überwacht ein bestimmtes systemweites Tastenereignis. Maus-Trigger (Mouse Trigger)* Überwacht ein bestimmtes systemweites Maus-Tasten-Kombinationsereignis. Bild-Trigger anklicken (Click Image Trigger)* Überwacht das vom Ziel-UI-Element definierte Bild für die Mauseingabe. System-Trigger (System Trigger)* Überwacht ein bestimmtes systemweites Tasten- und/oder Mausereignis. SAP Session Attributes Changed Trigger* Überwacht Änderungen in angegebenen SAP-Sitzungsattributen. * – Kann eigenständig sowie innerhalb einer Trigger Scope-Aktivität verwendet werden.
- Zum Automatisieren von mehreren Attended-Szenarien, die einmal, nacheinander oder gleichzeitig auftreten können. Dies können Sie mit den folgenden Aktivitäten erreichen:
Aktivität Beschreibung Lokale Trigger ausführen Initialisiert und startet alle lokalen Trigger, die auf Ereignisse auf der Maschine des Benutzers warten. Lokale Trigger anhalten Beendet die Ausführung lokaler Trigger. Bei der Ausführung werden alle laufenden Aktionen, einschließlich der durch Ereignisse ausgelösten Workflows, abgebrochen. Wenn Lokale Trigger anhalten ausgeführt wird, werden laufende ereignisgesteuerte Workflows abgebrochen, aber die Aktivitäten im Hauptworkflow werden wie gewohnt fortgesetzt. Lokalen Trigger deaktivieren Deaktiviert einen oder mehrere aktive lokale Trigger, die zuvor mit der Aktivität Run Local Triggers gestartet wurden. Lokalen Trigger aktivieren Aktiviert einen oder mehrere aktive lokale Trigger, die zuvor mit der Aktivität Run Local Triggers gestartet wurden. - Zum Starten von Workflows basierend auf dem Verhalten von globalen Variablen, die Sie im Data Manager erstellen. Dies können Sie mit den folgenden Aktivitäten erreichen:
Aktivität Beschreibung Trigger für globale Variablenänderung Sendet eine Benachrichtigung an alle Abonnenten, wenn sich der Wert einer globalen Variablen ändert. Benachrichtigung über geänderte globale Variable Trigger, der ausgelöst wird, wenn sich der Wert einer globalen Variablen ändert.
Triggereventargs
generiert. Dieser Workflow enthält mehrere Trigger Scope-Aktivitäten, die alle Trigger innerhalb Ihres Projekts parallel ausführen.
Triggereventargs
-Workflow als Argument im Argumentbereich. Jeder Trigger-Workflow hat ein eigenes Triggereventargs
-Argument, das Informationen über sich selbst enthält. Während Sie das Projekt ausführen, werden die Triggereventargs
-Argumente mit den neuesten Ausführungsinformationen aktualisiert.
Triggereventargs
-Argument stellt hauptsächlich die folgenden Informationen bereit, die für jeden Trigger-Workflow spezifisch sind:
- Triggertyp
- Triggername
- Zielelement, das den Trigger ausgelöst hat
- Formularkomponenten (bei der Form Trigger-Aktivität)
- Name der Formularinstanz (bei der Form Trigger-Aktivität)
Triggereventargs
-Arguments zuzugreifen, können Sie basierend auf dem Triggertyp verschiedene Methoden anwenden. Für Benutzerereignistrigger stehen die folgenden Methoden zur Verfügung:
- TargetElement – Ruft Informationen über das überwachte Zielelement ab.
- Attributes – Rufen die Attribute des überwachten Zielelements ab
- DisplayDpiScaleFactor – Bestimmt die Größe des Zielelements in Pixeln.
- ImageBase64 – Konvertiert das Bild des Zielelements in ein Base64-Bild.
- Selector – Ruft Informationen über den Selektor ab, der für das Zielelement verwendet wird.
- Triggertyp
- FormularQuelleID – Zugriff auf die ID des Formulars, in dem der Trigger ausgelöst wurde
- Instanzname – Ruft den Instanznamen des Formulars ab, in dem der Trigger ausgelöst wurde
- Trigger-Workflows sind Workflows, die mit einem Trigger starten. Ihr Debugging kann im Kontext des gesamten Projekts oder unabhängig ausgeführt werden.
- Wenn Sie das Gefühl haben, dass eine hohe Anzahl von Triggern die Leistung beeinträchtigt, können Sie bestimmte Trigger aktivieren oder deaktivieren, indem Sie die Aktivitäten Enable Local Trigger und Disable Local Trigger verwenden.
- Die Aktivitäten Enable Local Trigger und Disable Local Trigger sind in Szenarien nützlich, in denen Sie mehrere Workflows haben, die Benutzerereignisse überwachen, die durch die Phase in der Automatisierung bestimmt werden, die der Benutzer erreicht hat.
- Sie können beispielsweise die Aktivität Enable Local Trigger verwenden, um einen Trigger zu aktivieren, sobald der Benutzer seinen Benutzernamen in ein Formular eingegeben hat.
- Andererseits kann die Aktivität Disable Local Trigger verwendet werden, um einen Trigger zu deaktivieren, der sequenziell ausgeführt werden sollte, sobald der Benutzer beispielsweise während einer geführten Produkttour einen bestimmten Schritt erreicht hat.
Der Zweck von globalen Variablen in der Attended-Automatisierung besteht darin, Informationen über die Benutzer- oder Anwendungsereignisse aufzuzeichnen und sie in einer Variablen zu speichern, die Sie später als Eingabe oder Trigger für andere Aktivitäten verwenden können. Dadurch können Sie Daten einfach zwischen verschiedenen Workflows teilen. Funktionen für globale Variablen ermöglichen Ihnen Folgendes:
- Melden Sie, wenn sich der Wert einer globalen Variablen ändert, indem Sie die Aktivität Notify Global Variable Changed verwenden
- Lösen Sie einen Workflow oder eine Aktivität aus, wenn sich der Wert einer globalen Variablen ändert, indem Sie die Aktivität Global Variable Changed Trigger verwenden.