- Überblick
- UI-Automatisierung (UI Automation)
- Über das UIAutomation-Aktivitätspaket
- Mit UI-Automatisierung automatisierte Anwendungen und Technologien
- Projektkompatibilität
- UI-ANA-016 – URL zum Öffnen eines Browsers abrufen
- UI-ANA-017 – ContinueOnError True
- UI-ANA-018 – OCR-/Bildaktivitäten auflisten
- UI-DBP-006 – Containernutzung
- UI-DBP-013 – Falscher Gebrauch von Excel-Automatisierung
- UI-DBP-030 – Verwendung unzulässiger Variablen in Selektoren
- UI-DBP-031 – Aktivitätsverifizierung
- UI-PRR-001 – Klick simulieren
- UI-PRR-002 – Typ simulieren
- UI-PRR-003 – Offener Anwendungsmissbrauch
- UI-PRR-004 – Hartcodierte Verzögerungen
- UI-REL-001 – Große IDX in Selektoren
- UI-SEC-004 – Selektor-E-Mail-Daten
- UI-SEC-010 – App-/URL-Einschränkungen
- UI-USG-011 – Nicht zulässige Attribute
- UX-SEC-010 – App-/URL-Einschränkungen
- UX-DBP-029 – Unsichere Kennwortnutzung
- UI-PST-001 – Prüfungsprotokollebene in Projekteinstellungen
- UiPath-Browsermigrationstool
- Clippingbereich
- Computer Vision Recorder
- Remote UI Automation design (Live authoring)
- Aktivitätenindex
- Aktivieren (Activate)
- Ankerbasis (Anchor Base)
- Browser anhängen (Attach Browser)
- Fenster anhängen (Attach Window)
- Benutzeingabe blockieren (Block User Input)
- Textfeld (Callout)
- Prüfen (Check)
- Klicken (Click)
- Bild anklicken (Click Image)
- Bild-Trigger anklicken (Click Image Trigger)
- OCR-Text anklicken (Click OCR Text)
- Text anklicken (Click Text)
- Trigger anklicken (Click Trigger)
- Anwendung schließen (Close Application)
- Registerkarte schließen (Close Tab)
- Fenster schließen (Close Window)
- Kontextbewusster Anker
- Ausgewählten Text kopieren (Copy Selected Text)
- Element Attribute Change Trigger
- Element vorhanden (Element Exists)
- Elementumfang (Element Scope)
- Element State Change Trigger
- Export UI Tree
- Strukturierte Daten extrahieren (Extract Structured Data)
- Untergeordnete Elemente finden (Find Children)
- Element finden (Find Element)
- Bild finden (Find Image)
- Bildübereinstimmung finden (Find Image Matches)
- OCR-Textposition finden (Find OCR Text Position)
- Relatives Element finden (Find Relative Element)
- Textposition finden (Find Text Position)
- Aktives Fenster abrufen (Get Active Window)
- Vorgänger-Element erhalten (Get Ancestor)
- Attribut erhalten (Get Attribute)
- Ereignisinfo erhalten (Get Event Info)
- Aus Zwischenablage erhalten (Get From Clipboard)
- Volltext erhalten (Get Full Text)
- OCR-Text erhalten (Get OCR Text)
- Passwort erhalten (Get Password)
- Position erhalten (Get Position)
- Quellelement erhalten (Get Source Element)
- Text erhalten (Get Text)
- Sichtbaren Text erhalten (Get Visible Text)
- Zurück (Go Back)
- Weiter (Go Forward)
- Zur Startseite (Go Home)
- Google Cloud Vision OCR
- Fenster ausblenden (Hide Window)
- Markieren (Highlight)
- Hotkey-Trigger (Hotkey Trigger)
- Darauf zeigen (Hover)
- Auf Bild zeigen (Hover Image)
- Auf OCR-Text zeigen (Hover OCR Text)
- Text beim Darauf zeigen (Hover Text)
- Bild vorhanden (Image Exists)
- Auf Bildschirm anzeigen (Indicate On Screen)
- .NET-Code einfügen
- Inject Js Script
- ActiveX-Methode aufrufen
- Tastendruck-Trigger (Key Press Trigger)
- Bild laden (Load Image)
- Fenster maximieren (Maximize Window)
- Microsoft Azure ComputerVision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Fenster minimieren (Minimize Window)
- Ereignisse überwachen (Monitor Events)
- Maus-Trigger (Mouse Trigger)
- Fenster verschieben (Move Window)
- Navigieren zu (Navigate To)
- OCR-Text vorhanden (OCR Text Exists)
- Auf Element erscheinen (On Element Appear)
- Auf Element verschwinden (On Element Vanish)
- Auf Bild erscheinen (On Image Appear)
- Auf Bild verschwinden (On Image Vanish)
- Anwendung öffnen (Open Application)
- Browser öffnen (Open Browser)
- Browser aktualisieren (Refresh Browser)
- Benutzerereignis wiedergeben (Replay User Event)
- Fenster wiederherstellen (Restore Window)
- Bild speichern (Save Image)
- Objekt auswählen (Select Item)
- Mehrere Objekte auswählen (Select Multiple Items)
- Hotkey senden (Send Hotkey)
- Ausschneidebereich einstellen (Set Clipping Region)
- Fokus legen auf (Set Focus)
- Text einstellen (Set Text)
- Auf Zwischenablage setzen (Set To Clipboard)
- Web-Attribut setzen (Set Web Attribute)
- Fenster anzeigen (Show Window)
- Prozess starten (Start Process)
- System-Trigger (System Trigger)
- Screenshot anfertigen (Take Screenshot)
- Tesseract OCR
- Text vorhanden (Text Exists)
- Tooltip
- Eingeben in (Type Into)
- Sicheren Text eingeben (Type Secure Text)
- Vordergrund verwenden
- Attribut abwarten (Wait Attribute)
- Warten, bis Element verschwindet (Wait Element Vanish)
- Warten, bis Bild verschwindet (Wait Image Vanish)
- Prüfung der Barrierefreiheit
- Application event trigger
- Benutzeingabe blockieren (Block User Input)
- Check/Uncheck
- Check App State
- Check Element
- Klicken (Click)
- Click Event Trigger
- Ziehen und Ablegen
- Elementumfang (Element Scope)
- Extract Table Data
- Find Elements
- For Each UI Element
- Get Browser Data
- Clipboard abrufen
- Text erhalten (Get Text)
- Get URL
- Zu URL wechseln
- Hide Status Window
- Markieren (Highlight)
- Darauf zeigen (Hover)
- Inject Js Script
- Tastenkombinationen
- Keypress Event Trigger
- Mouse Scroll
- Navigate Browser
- Bild speichern (Save Image)
- Objekt auswählen (Select Item)
- Set Browser Data
- Clipboard festlegen
- Legen Sie den CV-Server fest
- Set Runtime Browser
- Fokus legen auf (Set Focus)
- Projekteinstellung festlegen
- Text einstellen (Set Text)
- Show Status Message
- Show Status Window
- Screenshot anfertigen (Take Screenshot)
- Eingeben in (Type Into)
- Unblock User Input
- Window operation
- Anhängen
- Prüfen (Check)
- Klicken (Click)
- Ziehen und Ablegen
- Daten extrahieren
- Attribut erhalten (Get Attribute)
- GetChildren
- GetRuntimeTarget
- GetText
- Get URL
- GoToUrl
- Markieren (Highlight)
- Darauf zeigen (Hover)
- IsEnabled
- Tastaturkürzel (Keyboard Shortcut)
- Mouse Scroll
- Offen
- Objekt auswählen (Select Item)
- Screenshot anfertigen (Take Screenshot)
- Eingeben in (Type Into)
- Wartestatus
- Führen Sie eine Browsersuche durch und rufen Sie Ergebnisse mithilfe von UIAutomation-APIs ab
- Web-Browsing
- Finden von Bildern
- Klicken auf Bilder
- Auslösen und Überwachen von Ereignissen
- Erstellen und Überschreiben von Dateien
- HTML-Seiten: Extrahieren und Bearbeiten von Informationen
- Bearbeiten von Fenstern
- Automatisierte Listenauswahl
- Finden und Bearbeiten von Fensterelementen
- Verwalten der Textautomatisierung
- Laden und Verarbeiten von Bildern
- Verwalten von mausaktivierten Aktionen
- Automatisieren der Anwendungslaufzeit
- Automatisierte Ausführung einer lokalen Anwendung
- Browsernavigation
- Web-Automatisierung
- Beispiel für Trigger Scope
- Aktivieren der Unterstützung für die UI-Automatisierung in DevExpress
- Computer Vision Local Server
- Mobile Automation
- Versionshinweise
- Über die Architektur der Automatisierung von Mobilgeräten
- Projektkompatibilität
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Install App
- Manage Current App
- Manage Other App
- DeepLink öffnen
- Open URL
- Mobile Device Connection
- Richtungswechsel
- Muster zeichnen
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Screenshot anfertigen (Take Screenshot)
- Take Screenshot Part
- Element vorhanden (Element Exists)
- Execute Command
- Attribut erhalten (Get Attribute)
- Get Selected Item
- Text erhalten (Get Text)
- Set Selected Item
- Text einstellen (Set Text)
- Wischen
- Tap
- Type Text
- Terminal
- Versionshinweise
- Über das Terminal-Aktivitätspaket
- Projektkompatibilität
- Best Practices
- Find Text
- Get Color At Position
- Get Cursor Position
- Feld erhalten (Get Field)
- Feld an Position erhalten (Get Field at Position)
- Bildschirmbereich erhalten (Get Screen Area)
- Text erhalten (Get Text)
- Text an Position erhalten (Get Text at Position)
- Cursor bewegen (Move Cursor)
- Move Cursor to Text
- Strg-Taste senden (Send Control Key)
- Tasten senden (Send Keys)
- Sichere Tasten senden (Send Keys Secure)
- Feld setzen (Set Field)
- Feld an Position setzen (Set Field at Position)
- Terminalsitzung (Terminal Session)
- Warte auf Feldtext (Wait Field Text)
- Wait Screen Ready
- Warte auf Bildschirmtext (Wait Screen Text)
- Warte auf Text an Position (Wait Text at Position)
- Terminalcodierte Automatisierungs-APIs
Eingeben in (Type Into)
Eine Type Into-Aktivität, die Text in ein bestimmtes UI-Element eingibt, z. B. ein Textfeld.
UiPath.UIAutomationNext.Activities.NTypeInto
Beschreibung
Gibt Text in ein bestimmtes UI-Element ein, z. B. ein Textfeld.
Sie können auch Sondertasten wie die Tabulator- oder Eingabetaste an das UI-Element senden.
Sticky Keys werden ebenfalls unterstützt. Wenn Sie z. B. Shift+End eingeben möchten, um nur einen Teil des Textes eines Steuerelements auszuwählen, müssen Sie Shift und End aus der Liste der Sondertasten auswählen. Der vorgeschlagene Text ist [k(Shift)][k(End)]. Dadurch werden die Tastendrücke Shift und End nacheinander emuliert. Der korrekte Text ist [d(Shift)][k(End)][u(Shift)], wobei d für Taste nach unten, k für Tastendruck und u für Taste nach oben steht.
If you want to enter sensitive information securely, add a Get Username and Password activity before this activity and select the saved for later username and password values from that activity as the text to type.
Diese Aktivität muss innerhalb einer Use Application/Browser-Aktivität hinzugefügt werden.
Um diese Aktivität außerhalb einer Use Application/Browser- Aktivität zu verwenden, müssen Sie ein Input-Element angeben.
Diese Aktivität ist mit Object Repository kompatibel.
Informationen zur Verwendung dieser Aktivität finden Sie unter:
- Tutorial: Arbeiten mit UI-Automatisierung.
- Tutorial: Ausfüllen von PDF-Formularen in Acrobat Reader mit Daten aus Excel
Voraussetzungen für die sichere Eingabe von Anmeldeinformationen
Um Benutzername-/Kennwortinformationen mithilfe dieser Aktivität sicher einzugeben, müssen die folgenden Voraussetzungen erfüllt sein:
- A Get Username and Password activity must be added to the project.
- In the Get Username and Password activity, credentials previously saved to the Windows Credential Manager must be selected. If the credentials you want to use are not already saved in the Windows Credential Manager, you can use this activity to add them.
- Die Anmeldeinformationen müssen für die spätere Verwendung im Projekt gespeichert werden.
Projektkompatibilität
Windows - Legacy | Windows | Plattformübergreifend
Windows- und plattformübergreifende Konfiguration
- In Scope arbeiten – Wählen Sie die Browserregisterkarte oder das Anwendungsfenster aus, die die zu automatisierende Anwendung hosten, wenn die Aktivität in verschachtelten Use Application/Browser- Aktivitäten platziert wird.
- Indicate on screen - Indicate the UI element to use as target. After you indicate the target, select the hamburger menu next to the informative screenshot to access the following options:
- Ziel anzeigen – Geben Sie das Ziel erneut an. Wenn der Deskriptor im Object-Repository definiert ist, müssen Sie zuerst die Verknüpfung mit dem Object-Repository aufheben, wenn Sie einen Deskriptor nur für die aktuelle Aktivität angeben möchten.
- Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
- Informativen Screenshot entfernen – Entfernt den Screenshot der Zielanwendung oder Webseite.
- Informativen Screenshot ändern – Ändern Sie den Screenshot der Zielanwendung oder Webseite.
- Zum Object Repository hinzufügen – Fügen Sie das aktuelle UI-Element zum Object Repository hinzu, von wo aus es im gesamten Automatisierungsprozess wiederverwendet werden kann. Diese Option wird nur angezeigt, wenn das Objekt noch nicht zum Objekt-Repository hinzugefügt wurde.
- In Object Repository anzeigen – Öffnet den Bereich Object Repository mit dem ausgewählten Deskriptor. Diese Option wird nur angezeigt, wenn das Objekt dem Object-Repository hinzugefügt wurde.
- Verknüpfung von Object Repository aufheben – Hebt die Verknüpfung des Deskriptors mit dem Object Repository auf. Diese Option wird nur angezeigt, wenn das Objekt dem Object-Repository hinzugefügt wurde.
- Dies eingeben – Der einzugebende Text. Sie können Sondertasten aus dem Textgenerator hinzufügen.
- Überprüfen – Definieren Sie den Verifizierungsschritt der Aktivitätsausführung. Die folgenden Optionen sind verfügbar:
- Keine – Gibt an, dass für das Zielelement keine Verifizierung durchgeführt wird.
- Auto - Überprüft, ob der Elementtext mit dem eingegebenen Text übereinstimmt.
- Expected text is - Checks whether the element text is expected text.
- Element angezeigt – Überprüft, ob das Element angezeigt wird.
- Element verschwunden – Überprüft, ob das Element verschwindet.
- Elementtext geändert – Überprüft, ob Änderungen im Text des Elements vorhanden sind.
- Element visuell geändert (nur für Windows-Projekte verfügbar) – Überprüft, ob Bildänderungen des Elements vorhanden sind.
- Erwarteter Text – Der erwartete Text, der mit dem tatsächlichen Ergebnis der Eingabe verglichen werden soll. Diese Eigenschaft ist nur verfügbar, wenn die Option Erwarteter Text ist für Verify ausgewählt. Der Standardwert entspricht dem Wert „Dies eingeben “.
- In einer beliebigen App angeben – Ermöglicht die Angabe eines UI-Elements, das nicht zur selben Use Application/Browser- Anwendung wie das Hauptaktivitätsziel gehört. Diese Eigenschaft ist nur verfügbar, wenn die Eigenschaft Überprüfen auf eine der folgenden Optionen festgelegt ist: Element angezeigt, Element verschwunden, Elementtext geändert oder Element visuell geändert.
- Indicate on screen - Indicate the verification UI element to use as target. After you indicate the target, select the hamburger menu next to the informative screenshot to access the following options:
- Ziel anzeigen – Geben Sie das Ziel erneut an. Wenn der Deskriptor im Object-Repository definiert ist, müssen Sie zuerst die Verknüpfung mit dem Object-Repository aufheben, wenn Sie einen Deskriptor nur für die aktuelle Aktivität angeben möchten.
- Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
- Informativen Screenshot entfernen – Entfernt den Screenshot der Zielanwendung oder Webseite.
- Informativen Screenshot ändern – Ändern Sie den Screenshot der Zielanwendung oder Webseite.
- Zum Object Repository hinzufügen – Fügen Sie das aktuelle UI-Element zum Object Repository hinzu, von wo aus es im gesamten Automatisierungsprozess wiederverwendet werden kann. Diese Option wird nur angezeigt, wenn das Objekt noch nicht zum Objekt-Repository hinzugefügt wurde.
- In Object Repository anzeigen – Öffnet den Bereich Object Repository mit dem ausgewählten Deskriptor. Diese Option wird nur angezeigt, wenn das Objekt dem Object-Repository hinzugefügt wurde.
- Verknüpfung von Object Repository aufheben – Hebt die Verknüpfung des Deskriptors mit dem Object Repository auf. Diese Option wird nur angezeigt, wenn das Objekt dem Object-Repository hinzugefügt wurde.
Eigenschaften-Panel
Ziel
-
Schaltfläche „Zieleigenschaften erweitern“/„Zieleigenschaften reduzieren“ – Zeigt den Zielcontainer und seine Ankereigenschaften an/ausgeblendet.
-
Zielmethoden – Die Selektortypen, die Sie zur Identifizierung des Elements verwenden möchten. Diese Eigenschaft kann auf eine beliebige Kombination festgelegt werden und mindestens eine Zielmethode muss ausgewählt sein:
- Strikter Selektor
- Fuzzy-Selektor
- Bild (nur für Windows-Projekte verfügbar)
- Nativer Text (nur für Windows-Projekte verfügbar)
- Computer Vision
- Semantischer Selektor
-
Window selector (Application instance) - The selector that is used for the application window. Only applicable when the window attach mode is set to Application instance.
-
Strikter Selektor – Der für das UI-Element generierte strikte Selektor. Wird nur angezeigt, wenn die Zielmethode „Strikter Selektor“ ausgewählt wurde.
-
Fuzzy-Selektor – Die Parameter für den Fuzzy-Selektor. Wird nur angezeigt, wenn die Zielmethode „Fuzzy-Selektor“ ausgewählt wurde.
-
Bild – Diese Eigenschaften sind nur verfügbar, wenn die Zielmethode Bild ausgewählt ist.
- Bildgenauigkeit – Gibt den Konfidenzschwellenwert an, der für den Bildabgleich verwendet wird. Der Standardwert ist 0,8.
- Bildvorkommen – Gibt an, welche Übereinstimmung verwendet werden soll, wenn mehrere übereinstimmende Bilder gefunden werden.
-
Nativ (Native) - Diese Eigenschaften sind nur verfügbar, wenn die Zielmethode Nativ (Native) ausgewählt ist.
- Nativer Text – Gibt den Text an, der zum Identifizieren des UI-Elements verwendet wird.
- Vorkommen von nativem Text – Gibt an, welches Vorkommen verwendet werden soll, wenn mehrere Übereinstimmungen gefunden werden.
- Native Beachtung von Groß-/Kleinschreibung in Text – Gibt an, ob beim Textabgleich die Groß-/Kleinschreibung beachtet wird.
-
Computer Vision - These properties are available only when the Computer Vision targeting method is selected. To use Computer Vision as a targeting method, you need to go to Project Settings > Computer Vision and make sure to set the correct server endpoint.
- CV-Steuerelementtyp – Gibt den Typ des Steuerelements an, der mit Computer Vision identifiziert wurde.
- CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde.
- CV-Textgenauigkeit – Gibt den Konfidenzschwellenwert an, der für OCR-Textabgleich verwendet wird. Der Standardwert ist 0,7.
- CV Text occurrence - Specifies which occurrence to use when multiple matches are found.
-
Semantic selector - A semantic description that defines the target. This property is available only when the Semantic selector targeting method has been selected.
- Semantic selector method - Specifies the method used to detect elements on screen.
- Legacy - For desktop apps: Searches the elements found by the Computer Vision on screen. For web apps: Searches the elements available in the DOM. This method is deprecated.
- DOM - Searches the DOM. Reaches any element, including off-screen. Less precise on visual details. Not available on non-web applications.
- Image - Searches the screen image. Detects any object on the screen, including icons, colors, and styles. Limited to what's visible.
- Semantic selector model - Indicates the underlying LLM model used for semantic processing. This value is read-only. It can be changed only from Project settings > UI Automation > Semantic Selector > Legacy - Model / DOM - Model / Image - Model.
- Semantic selector method - Specifies the method used to detect elements on screen.
-
Wait for page load - Before performing the action, waits for the application to become ready to accept input. You can choose one of three options from the drop-down menu:
- Keine – Wartet nicht, bis das Ziel bereit ist.
- Interaktiv - Wartet, bis nur ein Teil der App geladen ist.
- Vollständig - Wartet bis die gesamte App geladen ist.
-
Sichtbarkeitsprüfung – Überprüft, ob das UI-Element sichtbar ist oder nicht. Sie können eine der drei Optionen aus dem Dropdownmenü auswählen:
- Keine – Prüft nicht die Sichtbarkeit.
- Interaktiv (für den Fuzzy-Selektor) – Standardoption. Prüft, ob das Element potenziell sichtbar ist, ignoriert Seitenscrollen und Behinderungen durch andere Apps oder die Tatsache, dass die Anwendung minimiert ist. Diese Überprüfung ist nützlich, um sicherzustellen, dass Sie nicht auf unsichtbare Elemente abzielen, die im DOM vorhanden, aber verborgen sind.
- Vollständig sichtbar – Überprüft, ob das UI-Element sichtbar ist oder nicht.
-
Reaktionsfähige Websites – Aktiviert ein reaktionsfähiges Website-Layout.
Ziel – Anker (n)
- Zielmethoden – Die Selektortypen, die Sie zur Identifizierung des Elements verwenden möchten. Diese Eigenschaft kann auf eine beliebige Kombination festgelegt werden und mindestens eine Zielmethode muss ausgewählt sein:
- Strikter Selektor
- Fuzzy-Selektor
- Bild (nur für Windows-Projekte verfügbar)
- Nativer Text (nur für Windows-Projekte verfügbar)
- Computer Vision
- Strikter Selektor – Der für das UI-Element generierte strikte Selektor. Wird nur angezeigt, wenn die Zielmethode „Strikter Selektor“ ausgewählt wurde.
- Fuzzy-Selektor – Die Parameter für den Fuzzy-Selektor. Wird nur angezeigt, wenn die Zielmethode „Fuzzy-Selektor“ ausgewählt wurde.
- Bild – Diese Eigenschaften sind nur verfügbar, wenn die Zielmethode Bild ausgewählt ist.
- Bildgenauigkeit – Gibt den Konfidenzschwellenwert an, der für den Bildabgleich verwendet wird. Der Standardwert ist 0,8.
- Bildvorkommen – Gibt an, welche Übereinstimmung verwendet werden soll, wenn mehrere übereinstimmende Bilder gefunden werden.
- Nativ (Native) - Diese Eigenschaften sind nur verfügbar, wenn die Zielmethode Nativ (Native) ausgewählt ist.
- Nativer Text – Gibt den Text an, der zum Identifizieren des UI-Elements verwendet wird.
- Vorkommen von nativem Text – Gibt an, welches Vorkommen verwendet werden soll, wenn mehrere Übereinstimmungen gefunden werden.
- Native Beachtung von Groß-/Kleinschreibung in Text – Gibt an, ob beim Textabgleich die Groß-/Kleinschreibung beachtet wird.
- Computer Vision – Diese Eigenschaften sind nur verfügbar, wenn die Computer Vision- Zielmethode ausgewählt ist.
- CV-Steuerelementtyp – Gibt den Typ des Steuerelements an, der mit Computer Vision identifiziert wurde.
- CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde.
- CV-Textgenauigkeit – Gibt den Konfidenzschwellenwert an, der für OCR-Textabgleich verwendet wird. Der Standardwert ist 0,7.
- CV Text occurrence - Specifies which occurrence to use when multiple matches are found.
Ziel – Offset-Punkt
Specifies an offset, which can be further configured.
- Anchoring point - Describes the starting point of the cursor to which it offsets from Offset X and Offset Y properties are added. The following options are available: Top left, Top right, Bottom left, Bottom right, and Center (selected by default).
- Offset X - Horizontale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32- Variablen.
- Offset Y - Vertikale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32- Variablen.
Ausführung verifizieren
- Wiederholen – Wenn diese Option ausgewählt ist, wird die Aktion für die Dauer des Aktivitäts-Timeouts ausgeführt, wenn das erwartete Ergebnis nicht erreicht wurde.
- Zeitüberschreitung - Die Zeitspanne (in Sekunden), die gewartet werden muss, bis das Verifizierungselement angezeigt wird, verschwindet oder sich ändert. Wenn die Option Wiederholen ausgewählt ist, wird die Aktion erneut ausgeführt, gefolgt von der Überprüfung, für die in der Timeout- Eigenschaft der Aktivität angegebene Dauer. Der Standardwert beträgt 10 Sekunden.
Ausführung überprüfen – Ziel
- Target from any application - Indicates that the selected verification target does not necessarily belong to the same application, and it is also searched in other applications.
- Schaltfläche „Eigenschaften des Überprüfungsausführungsziels überprüfen“/Schaltfläche „Zieleigenschaften reduzieren“ – Zeigt/ausgeblendet den Container des Überprüfungsausführungsziels und seine Ankereigenschaften an.
- Die gleichen Eigenschaften von Target gelten auch für die Überprüfung der Ausführung – Target.
Optionen
- Input mode - Selects which method the Robot should use to interact with the target application:
- Identisch mit App/Browser – Verwendet den gleichen Eingabemodus wie die Aktivität Use Application/Browser .
- Hardware-Ereignisse – Fungiert als echten Benutzer, indem „Hardware“-Eingaben wie Mausbewegungen oder Tastaturanschläge zur Interaktion mit Anwendungen verwendet werden. Dies sind durch Hardware ausgelöste Ereignisse, die direkt an das Betriebssystem gesendet werden. Obwohl diese Methode eine 100%ige Verhaltensemulation bietet, können einige Ereignisse gelegentlich verloren gehen. Als Entwickler sind Sie dafür verantwortlich, sicherzustellen, dass alle Ereignisse die Zielanwendung zuverlässig erreichen.
- Simulate - Simulates using accessibility APIs. Recommended for browsers, Java based applications, SAP. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this. In the Properties panel, the Input mode auto-detection option next to the Input Mode property field automatically tests and selects the right input mode for the action you are performing. Using this feature, the text is typed into the target field with all of the available input methods, and the one that performs the best is automatically chosen. The properties Activate, Click before typing, Delay between keys, and Empty field cannot be used with the Simulate input mode.
- Chromium API - Performs actions using debugger APIs. Works for Chrome and Edge elements only. Sends all text in one go. Works if the target app is not in focus. For more details, refer to Chromium API.
- Window Messages (Windows only) - Simulates using Win32 messages. Recommended for desktop apps. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
- Healing Agent-Modus – Konfiguriert das Verhalten des Healing Agent für diese Aktivität basierend auf Governance- oder Orchestrator-Einstellungen auf Prozess- oder Auftragsebene.
- Wie App/Browser – Übernimmt die Konfiguration von der übergeordneten Aktivität Use Application/Browser .
- Auftragseinstellungen erben – Wendet die in Governance oder im Orchestrator auf Prozess- oder Auftragsebene definierten Einstellungen an.
- Deaktiviert – Schaltet den Healing Agent für diese Aktivität aus.
- Nur Empfehlungen – Ermöglicht es dem Healing Agent, Empfehlungen zur Behebung von UI-Automatisierungsproblemen bei der Ausführung von Aufträgen abzugeben, allerdings nur, wenn die Governance- oder Orchestrator-Einstellungen dies zulassen.
- Empty field - Selects whether to delete the existing content in the field before typing the text, and how to empty the field. Fields are emptied by sending a combination of keystrokes that differs between fields with a single line and fields with multiple lines. Make sure to select the right option depending on the indicated field. The options are:
- None - Do not delete the existing content.
- Single line (End, Shift+Home, Del) - Delete the content from a text field with a single line. This is the default option.
- Multi line (Ctrl+A, Del) - Delete the content from a text field with multiple lines.
- Click before typing - Selects whether to click the specified UI element before typing the text, and the type of click to perform. The options are None (do not click), Single (execute a single click), or Double (execute a double click). The default option is Single.
- Nach Zwischenablage eingeben – Gibt an, ob die Zwischenablage zum Eingeben des angegebenen Textes verwendet wird. Die verfügbaren Optionen sind:
- Niemals – Zwischenablage niemals verwenden.
- Immer – Zwischenablage immer verwenden.
- Immer wenn möglich – Zwischenablage nach Möglichkeit verwenden. Dies hängt vom Betriebssystem und dem einzugebenden Text ab (wenn z. B. eine Sondertaste verwendet wird, wird die Zwischenablage nicht verwendet).
- Activate - If selected, the specified UI element is brought to the foreground and activated before the text is typed in. If not selected, the activity types into the current active window. This field only supports Boolean values (True, False). The default value is True.
- Auswahl am Ende aufheben – Fügt nach der Texteingabe ein Complete-Ereignis hinzu, um bestimmte UI-Antworten in Webbrowsern auszulösen.
- Deaktiviertes Element ändern – Wenn diese Option ausgewählt ist, führt die Aktivität die Aktion aus, auch wenn das angegebene UI-Element deaktiviert ist. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Diese Eigenschaft gilt nicht, wenn die Eigenschaft Eingabemodus auf Hardware-Ereignisse festgelegt ist.
- Verzögerung zwischen Tasten – Verzögerung (in Sekunden) zwischen aufeinander folgenden Tastatureingaben. Der Standardwert beträgt 0,02 Sekunden. Der Höchstwert beträgt 1 Sekunde.
- Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
Optionen – Offset-Punkt
- Offset-Punkt aktivieren – Gibt an, ob der Offset-Punkt auf Aktivitätsebene aktiviert ist. Wenn diese Option aktiviert ist, hat sie Vorrang vor dem auf dem Ziel konfigurierten Offset-Punkt.
- Anchoring point - Specifies the reference point of the cursor from which the Offset X and Offset Y values are applied. The following options are available: Top left, Top right, Bottom left, Bottom right, and Center (selected by default).
- Offset X - Definiert die horizontale Verschiebung der Cursorposition relativ zum ausgewählten Ankerpunkt.
- Offset Y – Definiert die vertikale Verschiebung der Cursorposition relativ zum ausgewählten Ankerpunkt.
Zeitliche Abläufe
- Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
- Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
- Timeout - Specifies the amount of time (in seconds) to wait for the operation to be performed before generating an error. The default value is 30 seconds.
Eingang/Ausgang
- Eingabeelement - Das UI-Element, auf dem die Aktivität ausgeführt wird, gespeichert in einem
UIElement-Objekt. Dieses Feld unterstützt nurUIElement-Objekte. Dieses Objekt kann aus dem Eigenschaftsfeld Ausgabeelement anderer UI-Automatisierungsaktivitäten abgerufen werden. - Output element - Outputs a target UI Element and stores it in a
UIElementobject, which can be further used to target the same element with other UI Automation activities.
Windows – Legacy-Konfiguration
- Wählen Sie In App/Browser anzeigen aus , um das UI-Element anzugeben, das als Ziel verwendet werden soll. Dieser Schritt ist nicht erforderlich, wenn das Element in der Zielanwendung bereits im Fokus steht.
Nachdem Sie das Ziel angegeben haben, wählen Sie das Menüaus
um auf die folgenden Optionen zuzugreifen:
- Indicate target on screen - Indicate the target again.
- Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
- Automatische Verifizierung hinzufügen / Verifizierung entfernen – Fügt die Verifizierung der von der Aktivität ausgeführten Aktion hinzu oder entfernt sie. Stellen Sie sicher, dass die Ausführung standardmäßig aktiviert ist.
- Informativen Screenshot entfernen – Entfernt den Screenshot der Zielanwendung oder Webseite.
- Zu Object-Repository hinzufügen – Fügen Sie das aktuelle UI-Element zu einem Bibliotheksprojekt hinzu, von wo aus es im gesamten Automatisierungsprozess wiederverwendet werden kann.
-
Dies eingeben – Der einzugebende Text. Sie können das Dropdownmenü verwenden, um eine Sondertaste auszuwählen, die an das Textfeld gesendet werden soll, oder Sie können Sondertasten aus dem Textgenerator hinzufügen. Sie können auch die Optionen aus dem Plusverwenden
Menü im Textgenerator, um für später gespeicherte Werte oder Daten aus dem Projekt-Notebook oder den übergeordneten Aktivitäten Use Excel File oder Use Outlook Account hinzuzufügen. Jede Kombination aus Text, Excel- oder Outlook-Daten und Sondertasten wird unterstützt. -
Empty field before typing - Selects whether to delete the existing content in the field before typing the text, and how to empty the field. Fields are emptied by sending a combination of keystrokes that differs between fields with a single line and fields with multiple lines. Make sure to select the right option depending on the indicated field. The options are:
- None - Do not delete the existing content.
- Single line (End, Shift+Home, Del) - Delete the content from a text field with a single line. This is the default option.
- Multi line (Ctrl+A, Del) - Delete the content from a text field with multiple lines.
To use the activity to clear the indicated text field, configure this property to delete the existing content, leave the Type this field empty, and set the Input Mode property to Hardware Events.
-
Click before typing - Selects whether to click the specified UI element before typing the text, and the type of click to perform. The options are None (do not click), Single (execute a single click), or Double (execute a double click). The default option is Single.
-
Sicherstellen, dass der Text leer ist – Diese Option wird angezeigt, wenn Automatische Verifizierung hinzufügen ausgewählt ist. Sie können in der aktuellen Anwendung oder in einer beliebigen Anwendung angeben.
Eigenschaften-Panel
Allgemein
-
Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
-
Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
-
Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
-
Anzeigename – Der Name, der für die Aktivität im Designerbereich angezeigt wird. Ein Anzeigename wird automatisch generiert, wenn Sie ein Ziel angeben.
-
Timeout - Specifies the amount of time (in seconds) to wait for the activity to be executed before throwing an error. The default value is 30 seconds.
-
Secure text - The secure text to enter. The field supports only SecureString variables. If this field is configured, the Text field is cleared. The maximum string length for this field is 65536 characters.
-
Ziel – Das Zielelement. Zielelement muss festgelegt sein. Vor der Anzeige auf dem Bildschirm wird dieses Feld auf
(null)festgelegt. Sobald das Ziel angegeben wurde, werden alle Eigenschaften in Bezug auf das angegebene Element angezeigt.- Klick-Offset – Gibt einen Offset für die Klickaktivität an, der weiter konfiguriert werden kann.
- Anchoring point - Describes the starting point of the cursor to which it offsets from Offset X and Offset Y properties are added. The following options are available: Top left, Top right, Bottom left, Bottom right, and Center. By default, Center is selected.
- Offset X - Horizontale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur
Int32-Variablen. - Offset Y - Vertikale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur
Int32-Variablen.
- CV-Steuerelementtyp – Gibt den Steuerelementtyp an, der mithilfe von Computer Vision identifiziert wurde.
- CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde.
- Fuzzy selector - The parameters for the fuzzy selector.
- Nativer Text – Der Text, der zum Identifizieren des UI-Elements verwendet wird.
- Reaktionsfähige Websites – Aktiviert ein reaktionsfähiges Website-Layout.
- Strikter Selektor – Der für das UI-Element generierte strikte Selektor.
- Zielmethoden – Die Selektortypen, die Sie zur Identifizierung des Elements verwenden möchten. Diese Eigenschaft kann auf eine beliebige Kombination im Dropdownmenü festgelegt werden:
- Keine
- Strikter Selektor
- Fuzzy-Selektor
- Bild
- Nativer Text
- Computer Vision – Um Computer Vision als Zielmethode zu verwenden, müssen Sie zu Projekteinstellungen > Computer Vision wechseln und sicherstellen, dass Sie den richtigen Serverendpunkt festlegen. Sie können dieses Feld unverändert lassen und UiPath Cloud verwenden, das standardmäßig ausgefüllt ist, oder Sie können einen anderen Wert eingeben, indem Sie einen der anderen öffentlichen Endpunkte auswählen, die für eine Serverregion spezifisch sind, oder Ihren eigenen lokalen Server. Eine andere Möglichkeit, Computer Vision als Zielmethode zu verwenden, besteht darin , Use Local Server auf True festzulegen. Das bedeutet, dass das UiPath.ComputerVision.LocalServer-Paket in Ihrem Projekt installiert ist. Wenn „Lokaler Server“ aktiviert ist, wird der Serverwert überschrieben. Der Lokale Server ist jedoch in plattformübergreifenden Projekten nicht verfügbar.
- Sichtbarkeitsprüfung – Überprüft, ob das UI-Element sichtbar ist oder nicht. Sie können eine der drei Optionen aus dem Dropdownmenü auswählen:
- Keine – Prüft nicht die Sichtbarkeit.
- Interaktiv (für Fuzzy-Selektor) – Standardoption. Prüft, ob das Element potenziell sichtbar ist, ignoriert Seitenscrollen und Behinderungen durch andere Apps oder die Tatsache, dass die Anwendung minimiert ist. Diese Überprüfung ist nützlich, um sicherzustellen, dass Sie nicht auf unsichtbare Elemente abzielen, die im DOM vorhanden, aber verborgen sind.
- Vollständig sichtbar
- Überprüft, ob das UI-Element sichtbar ist oder nicht.
- Wait for page load - Before performing the action, waits for the application to become ready to accept input. You can choose one of three options from the drop-down menu:
- Keine – Wartet nicht, bis das Ziel bereit ist.
- Interaktiv - Wartet, bis nur ein Teil der App geladen ist.
- Vollständig - Wartet bis die gesamte App geladen ist.
- Fensterselektor (Anwendungsinstanz) – Der Selektor, der für das Anwendungsfenster verwendet wird. Nur anwendbar, wenn der Anhängemodus für Fenster auf Anwendungsinstanz festgelegt ist.
- Klick-Offset – Gibt einen Offset für die Klickaktivität an, der weiter konfiguriert werden kann.
-
Text - The text to enter. You can add special keys to the text from the drop-down list in the body of the activity. If this field is configured, the Secure text field is cleared. The maximum string length for this field is 65536 characters.
-
Ausführung verifizieren – Verifiziert zur Laufzeit, ob die von der Aktivität ausgeführte Aktion korrekt war. Dies geschieht entweder, indem überprüft wird, ob der in der Eigenschaft Erwarteter Text angegebene Text im angegebenen UI-Element gefunden wird, nachdem die Aktivität ausgeführt wurde, oder indem ein Element angegeben wird, das nach der Ausführung der Aktion angezeigt oder ausgeblendet werden soll. Dies wird überwacht und danach überprüft die Aktivität ausgeführt wird. Diese Funktion kann über die Projekteinstellungen oder über den Textkörper der Aktivität aktiviert werden, indem Sie Automatische Verifizierung hinzufügen im Kontextmenü auswählen.
- AnzeigeName - Der Anzeigename der Verifizierungsaktion. Dieses Feld wird basierend auf der Verifizierungsaktion und dem von Ihnen gewählten Element automatisch ausgefüllt. Sobald Ausführung überprüfen eingerichtet ist, wird dieser Anzeigename in der Aktivitätskarte sichtbar.
- Erwarteter Text – Der Text, der in das angegebene Textfeld eingegeben werden soll. Dieses Feld ist optional. Dieses Feld unterstützt nur Zeichenfolgen und
String-Variablen. - Wiederholen – Wenn diese Option ausgewählt ist, wird die Aktion für die Dauer des Aktivitäts-Timeouts ausgeführt, wenn das erwartete Ergebnis nicht erreicht wurde. Standardmäßig ist dieses Kontrollkästchen aktiviert.
- Ziel – Dieses Ziel wird verwendet, um das Element anzugeben, das Sie zur Laufzeit überprüfen möchten. Weitere Informationen zu den Eigenschaftsfeldern, die unter dieser Eigenschaft erweitert werden können, finden Sie oben in der Eigenschaft Ziel , da die Funktionalität der Eigenschaften dieselbe ist.
- Timeout – Die Zeitspanne (in Sekunden), die gewartet werden muss, bis das Verifizierungselement angezeigt wird, verschwindet oder geändert wird. Wenn das Kontrollkästchen „Wiederholen“ aktiviert ist, wird die Aktion erneut für die in der Timeout- Eigenschaft der Aktivität angegebene Dauer ausgeführt. Anschließend erfolgt die Verifizierung. Der Standardwert beträgt 10 Sekunden.
- Element verifizieren
- Definiert, auf welche Änderung Sie das Verifizierungsziel überprüfen möchten. Die verfügbaren Optionen sind:
- Wurde angezeigt – Überprüfen Sie, ob das Element angezeigt wird.
- Verschwunden – Überprüfen Sie, ob das Element verschwindet.
- Text geändert – Prüft, ob Änderungen im Text des Elements vorhanden sind.
- Visuell verändert – Überprüft, ob Bildänderungen des Elements vorhanden sind.
-
Eingabeelement - Das UI-Element, auf dem die Aktivität ausgeführt wird, gespeichert in einem
UIElement-Objekt. Dieses Feld unterstützt nurUIElement-Objekte. Dieses Objekt kann aus dem Eigenschaftsfeld Ausgabeelement anderer UI-Automatisierungsaktivitäten abgerufen werden. -
Ausgabeelement – Gibt ein Ziel-UI-Element aus und speichert es in einem
UIElement-Objekt, das weiter verwendet werden kann, um mit anderen Aktivitäten auf dasselbe Element abzuzielen. -
Privat - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False.
-
Deaktiviertes Element ändern – Wenn diese Option ausgewählt ist, führt die Aktivität die Aktion aus, auch wenn das angegebene UI-Element deaktiviert ist. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False.
Diese Eigenschaft gilt nicht, wenn die Eigenschaft Eingabemodus auf Hardware-Ereignisse festgelegt ist.
- Input mode - Selects which method the Robot should use to interact with the target application:
- Wie App/Browser – Verwenden Sie den gleichen Eingabemodus wie die Aktivität Use Application/Browser . Dies ist die Standardauswahl.
- Hardwareereignisse – Verwendet den Hardwaretreiber, um die Aktion auszuführen. Dies ist die langsamste Methode. Sie kann nicht im Hintergrund ausgeführt werden, ist aber mit allen Desktop-Apps kompatibel.
- Simulate - Simulates using accessibility APIs. Recommended for browsers, Java based applications, SAP. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
Im Bereich Eigenschaften wird die
neben dem Eigenschaftsfeld Eingabemodus wird automatisch der richtige Eingabemodus für die auszuführende Aktion getestet und ausgewählt. Mit dieser Funktion wird der Text mit allen verfügbaren Eingabemethoden in das Zielfeld eingegeben und es wird automatisch diejenige ausgewählt, die am besten funktioniert.
The properties Activate, Click before typing, Delay between keys, and Empty field cannot be used with the Simulate input mode.
- Chromium-API – Führt Aktionen mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text in einer einzigen Aktion. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Weitere Informationen finden Sie unter Chromium-API.
- Window Messages - Simulates using Win32 messages. Recommended for desktop apps. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
Optionen – Hardware-Ereignisse/Chromium-API
- Activate - Brings the UI element to the foreground and activates it before clicking it. If not selected, the activity types into the current active window. This field only supports Boolean values (True, False). The default value is True.
- Vor Eingabe klicken – Siehe Vor Eingabe klicken im Designer-Panel.
- Verzögerung zwischen Tasten – Verzögerung (in Sekunden) zwischen aufeinander folgenden Tastatureingaben. Der Standardwert beträgt 0,02 Sekunden. Der Höchstwert beträgt 1 Sekunde.
- Leeres Feld – Siehe Leeres Feld vor Eingabe im Designer-Panel.
- Nach Zwischenablage eingeben – Gibt an, ob die Zwischenablage zum Eingeben des angegebenen Textes verwendet wird. Die verfügbaren Optionen sind:
- Niemals – Zwischenablage niemals verwenden.
- Immer – Zwischenablage immer verwenden.
- Immer wenn möglich – Zwischenablage nach Möglichkeit verwenden. Dies hängt vom Betriebssystem und dem einzugebenden Text ab (wenn z. B. eine Sondertaste verwendet wird, wird die Zwischenablage nicht verwendet).
Optionen – Simulieren
- Deselect at end - This check box can only be used when the Input Mode property is set to Simulate and is selected by default. Some target applications do not register a type action unless a Complete event is also sent alongside the action. Selecting this check box adds a Complete event after the text entry, in order to register the action correctly. If this check box is cleared, the Complete event is not sent to the target application. By default, this check box is selected.
- Beschreibung
- Voraussetzungen für die sichere Eingabe von Anmeldeinformationen
- Projektkompatibilität
- Windows- und plattformübergreifende Konfiguration
- Ziel
- Ausführung verifizieren
- Ausführung überprüfen – Ziel
- Optionen
- Optionen – Offset-Punkt
- Zeitliche Abläufe
- Eingang/Ausgang
- Windows – Legacy-Konfiguration
- Eigenschaften-Panel