Application event trigger

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

Beschreibung

Richtet einen Trigger basierend auf einem nativen Ereignis eines beliebigen Elementtyps ein (Fenster der obersten Ebene oder ein anderes angegebenes UI-Element). Sie können das Zielelement auf dem Bildschirm angeben und dann das native Ereignis aus der Liste der von diesem Element unterstützten Ereignisse auswählen.

Diese Aktivität ist mit Object Repository kompatibel.

Der Trigger muss die erste Aktivität im Workflow sein, und der Workflow wird ausgelöst, wenn ein bestimmtes UI-Ereignis eintritt. Pro Workflow ist nur ein Trigger zulässig. Weitere Informationen finden Sie unter Triggerbasierte Attended-Automatisierung.

Hinweis:

Wenn Sie eine niedrigere Studio-Version als 2023.4 verwenden, müssen Sie die Aktivität Application Event Trigger innerhalb einer Trigger Scope- Aktivität platzieren. In diesem Fall zeigt die Aktivität Application Event Trigger die Eigenschaften Zeitplanmodus und Aktiviert nicht an, und die Eigenschaft Zeitplanmodus ist in der Aktivität Trigger Scope verfügbar.

Projektkompatibilität

Windows – Legacy | Windows

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Klicken Sie auf Ziel auf Bildschirm anzeigen, um das UI-Element anzugeben, das als Ziel verwendet werden soll.

  Nachdem Sie das Ziel angegeben haben, wählen Sie das Menü um auf die folgenden Optionen zuzugreifen:

  • Ziel auf Bildschirm angeben – Geben Sie das Ziel erneut an.
  • Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
  • Informativen Screenshot entfernen – Entfernen Sie 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.

• Ereignistyp – Die Liste der nativen Ereignistypen, die für das angegebene Element spezifisch sind. Der Ereignistyp muss festgelegt sein. Die Liste der exponierten Ereignisse hängt vom Zielelementtyp und von der Zielanwendungstechnologie ab. Beispielsweise kann ein Web-UI-Element eine andere Liste von Ereignissen verfügbar machen als ein Java-UI-Element.

Eigenschaften-Panel

Allgemein

• Anzeigename – Der Name, der für die Aktivität im Designerbereich angezeigt wird. Ein Anzeigename wird automatisch generiert, wenn Sie ein Ziel angeben.

Eingabe

• Synchronisierung abgleichen – Gibt an, ob der Abgleich des Zielelement-Selektors synchron oder asynchron erfolgt. Wird nur für Java-Ereignisse unterstützt, mit Ausnahme von Appeared und Disappeared. Dieses Feld unterstützt nur Boolean -Werte. Der Standardwert ist False.
• Selektoren – Optionale Sammlung von Selektoren, die auf das angegebene Ereignis überwacht werden sollen; Diese Selektoren werden zusammen mit dem angegebenen Ziel überwacht. Die Selektoren müssen vollständige (nicht teilweise) Selektoren sein.

• Ziel – Das Zielelement: Fenster oder UI-Element der obersten Ebene. Es werden nur strikte Selektoren ohne Anker unterstützt. Zielelement muss festgelegt sein. Bevor es auf dem Bildschirm angezeigt wird, wird dieses Feld auf (null)festgelegt. Sobald das Ziel angegeben ist, werden alle Eigenschaften des angegebenen Elements angezeigt.
  • Strikter Selektor - Der strikte Selektor, der für das Ziel-UI-Element generiert wird. Für Fenster der obersten Ebene ist sie leer.
  • Fensterselektor (Anwendungsinstanz) – Der Selektor für das Anwendungsfenster (Anwendung/Browser).

Sonstiges

• Aktiviert – Wenn dieser Wert auf False festgelegt ist, wird der Trigger gestartet, aber löst keine Ereignisse aus. Er kann später zur Laufzeit aktiviert werden, indem die Aktivität Enable Local Trigger verwendet wird. Diese Eigenschaft ist ausgeblendet, wenn die Aktivität Application Event Trigger innerhalb einer Trigger Scope -Aktivität platziert wird. Dieses Feld unterstützt nur Boolean -Werte. Der Standardwert ist True.
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.

Optionen

• Untergeordnete Elemente einschließen - Wenn diese Option ausgewählt ist, werden auch die untergeordneten Elemente des angegebenen UI-Elements überwacht. Es unterstützt alle Ereignistypen mit Ausnahme von „Appeared“ oder „Disappeared“ sowie alle UI-Elemente mit Ausnahme von Fenstern der obersten Ebene. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.
• Zeitplanmodus – Er gibt an, wie die Actions ausgeführt werden sollen, wenn ein Trigger ausgelöst wird. Wählen Sie eine von fünf Optionen aus dem Dropdown-Menü aus:
  • 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.

  Bei den Modi „ Sequential“ und „Concurrent “ wird die Überwachung fortgesetzt, bis entweder der Benutzer die Ausführung beendet oder eine Break -Aktivität erfüllt ist.

Native Ereignisse

Über

Der native Ereignisüberwachungsmechanismus wurde verbessert, indem neue Sätze von Ereignissen implementiert wurden, die von verschiedenen Typen von Anwendungstechnologien unterstützt werden:

• Native WND-Ereignisse

• STRG Native Ereignisse

• Native JAVA-Ereignisse

• Native WEBCTRL-Ereignisse

• Native HTML-Ereignisse

• Native UIA-Ereignisse

WND-Ereignisse – Fenster der obersten Ebene

Ereignistyp	TriggerEventArgs-Typ	Beschreibung
Wurde angezeigt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement erscheint.
Verschwand	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement verschwindet.
Titel geändert	TextGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Titel des Zielelements ändert. Hinweis: Dies ist das Ereignis Text geändert , das zur besseren Übersicht in Titel geändert für Fenster der obersten Ebene umbenannt wurde.
Status geändert	StatusGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Status des Zielelements ändert. Hinweis: Dieses Ereignis wird ausgelöst, wenn etwas am Status des Fensters geändert wird: aktiviert, deaktiviert, aktiviert, deaktiviert, fokussierbar, fokussiert, sichtbar usw. Der neue Wert des Status wird in der Argumentvariablen exponiert.
Speicherort geändert	GeänderteArgumente am Standort	Ereignis, das ausgelöst wird, wenn sich der Elementspeicherort des Ziels geändert hat.
Vordergrund erhalten	HwndArgs	Ereignis, das ausgelöst wird, wenn das Elementfenster des Ziels zum Vordergrundfenster wird.
Vordergrund verloren	HwndArgs	Ereignis, das ausgelöst wird, wenn sich das Elementfenster des Ziels nicht mehr im Vordergrund befindet.
Minimiert	HwndArgs	Ereignis, das ausgelöst wird, wenn das Elementfenster des Ziels minimiert werden soll.
wiederhergestellt	HwndArgs	Ereignis, das ausgelöst wird, wenn das Elementfenster des Ziels wiederhergestellt werden soll.

STRG-Ereignisse oder WND-Ereignisse – UI-Elemente

Ereignistyp	TriggerEventArgs-Typ	Beschreibung
Wurde angezeigt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement erscheint.
Verschwand	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement verschwindet.
Text geändert	TextGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Text des Zielelements ändert.
Fokus erhalten	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus erhält.
Fokus verloren	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus verliert.
Status geändert	StatusGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Status des Zielelements ändert. Hinweis: Dieses Ereignis wird ausgelöst, wenn etwas am Status des Fensters geändert wird: aktiviert, deaktiviert, aktiviert, deaktiviert, fokussierbar, fokussiert, sichtbar usw. Der neue Wert des Status wird in der Argumentvariablen exponiert.
Auswahländerung	AuswahlgeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Auswahlwert des Zielelements ändert.

JAVA-Ereignisse – UI-Elemente

Ereignistyp	TriggerEventArgs-Typ	Beschreibung
Wurde angezeigt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement erscheint.
Verschwand	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement verschwindet.
Text geändert	TextGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Text des Zielelements ändert.
Taste gedrückt	JavaKeyPressArgs	Ereignis, das ausgelöst wird, wenn eine Taste gedrückt wird, während sich der Fokus im Zielelement befindet.
Klicken (Click)	JavaMouseActionArgs	Ereignis, das ausgelöst wird, wenn auf das Zielelement geklickt wird.
Mausbewegung	JavaMouseMotionArgs	Ereignis, das ausgelöst wird, wenn die Maus auf das Zielelement bewegt wird.
Fokus erhalten	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus erhält.
Fokus verloren	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus verliert.
Aktiviert	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement aktiviert ist.
Deaktiviert	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement deaktiviert ist.
Auswahländerung	AuswahlgeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Auswahlwert des Zielelements ändert.
Maus betritt	JavaMouseMotionArgs	Ereignis, das ausgelöst wird, wenn sich die Maus in den sichtbaren Teil des Zielelements bewegt.
Maus verlässt	JavaMouseMotionArgs	Ereignis, das ausgelöst wird, wenn die Maus den sichtbaren Teil des Zielelements verlässt.
Zelle ausgewählt	JavaCellSelectedArgs	Ereignis, das ausgelöst wird, wenn das Zielelement eine Tabellenzelle ist und ausgewählt wird.
Zellenwert geändert	JavaCellValueChangedArgs	Ereignis, das ausgelöst wird, wenn das Zielelement eine Tabellenzelle ist und sein Wert geändert wird.
Maus gedrückt	JavaMouseActionArgs	Ereignis, das ausgelöst wird, wenn eine beliebige Maustaste über dem Zielelement gedrückt wird.
Maus freigegeben	JavaMouseActionArgs	Ereignis, das ausgelöst wird, wenn eine beliebige Maustaste über dem Zielelement losgelassen wird.
Menü ausgewählt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement ein Menü ist und ausgewählt wird.
Menü abgewählt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement ein Menü ist und dessen Auswahl aufgehoben wird.
Menü abgebrochen	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement ein Menü ist und abgebrochen wird.
Popup-Menü sichtbar	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement ein Popupmenü ist und sichtbar wird.
Popup-Menü unsichtbar	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement ein Popup-Menü ist und unsichtbar wird.
Popup-Menü abgebrochen	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement ein Popup-Menü ist und abgebrochen wird.

WEBCTRL-Ereignisse – UI-Elemente

Hinweis: Ab UiPath.UIAutomation.Activities v23.10 haben wir Unterstützung für WEBCTRL-basierte native Ereignisse in nativen eingebetteten Browsern (z. B. Slack, Discord, Electron) hinzugefügt.

Ab UiPath.UIAutomation.Activities v23.12 haben wir Unterstützung für WEBCTRL-basierte native Ereignisse in verwalteten eingebetteten Browsern (z. B. CefSharp) hinzugefügt.

Das Text selection changed -Ereignis wird für eingebettete Browser ab UiPath.UIAutomation.Activities v23.12 unterstützt.

Ereignistyp	TriggerEventArgs-Typ	Beschreibung
Wurde angezeigt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement erscheint.
Verschwand	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement verschwindet.
Text geändert	TextGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Text des Zielelements ändert.
Taste gedrückt	WebKeyPressArgs	Ereignis, das ausgelöst wird, wenn eine Taste gedrückt wird, während sich der Fokus im Zielelement befindet.
Klicken (Click)	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn auf das Zielelement geklickt wird.
Doppelklicken	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn zweimal auf das Zielelement geklickt wird.
Rechtsklicken	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn mit der rechten Maustaste auf das Zielelement geklickt wird.
Mausbewegung	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn die Maus auf das Zielelement bewegt wird.
Maus gedrückt	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn eine beliebige Maustaste über dem Zielelement gedrückt wird.
Maus freigegeben	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn eine beliebige Maustaste über dem Zielelement losgelassen wird.
Maus betritt	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn sich die Maus in den sichtbaren Teil des Zielelements bewegt.
Maus verlässt	WebMouseEventArgs	Ereignis, das ausgelöst wird, wenn die Maus den sichtbaren Teil des Zielelements verlässt.
Fokus erhalten	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus erhält.
Fokus verloren	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus verliert.
Textauswahl geändert	WebTextSelectionChangedArgs	Ereignis, das ausgelöst wird, wenn sich der ausgewählte Text des Zielelements ändert.

HTML-Ereignisse – UI-Elemente

Hinweis: Die folgenden Ereignistypen werden nur für Webanwendungen unterstützt, die von <html>-Selektoren identifiziert werden, die nur das Attribut app haben:

• Download state changed

• Tab activated

• Tab created

• Tab removed

• Tab updated

Im Moment sind diese Ereignisse nur zulässig, wenn der Fensterselektor den Teil <html> enthält, z. B. <html app='chrome.exe' />. Andere Attribute wie title oder url sind nicht zulässig. Wenn der Fensterselektor andere Attribute als app enthält, wird ein Laufzeitfehler generiert.

Strikte Selektoren müssen leer sein.

Diese Ereignistypen werden für eingebettete Browser nicht unterstützt.

Ereignistyp	TriggerEventArgs-Typ	Beschreibung
Downloadstatus geändert	DownloadChangedArgs	Ereignis, das ausgelöst wird, wenn sich die Eigenschaften eines DownloadItem ändern.
Registerkarte aktiviert	TabActivatedArgs	Ereignis, das ausgelöst wird, wenn sich die aktive Registerkarte in einem Fenster ändert. Hinweis: Die URL der Registerkarte ist möglicherweise zu dem Zeitpunkt, zu dem dieses Ereignis ausgelöst wurde, nicht festgelegt, aber Sie können onUpdated-Ereignisse abhören, um benachrichtigt zu werden, wenn eine URL festgelegt wird.
Registerkarte erstellt	TabCreatedArgs	Ereignis, das ausgelöst wird, wenn eine Registerkarte erstellt wird. Hinweis: Die URL der Registerkarte und die Mitgliedschaft in der Registerkartengruppe sind zum Zeitpunkt der Auslösung dieses Ereignisses möglicherweise noch nicht festgelegt, aber Sie können auf onUpdated-Ereignisse hören, um zu erfahren, wenn eine URL festgelegt oder die Registerkarte zu einer Registerkartengruppe hinzugefügt wird.
Registerkarte entfernt	TabRemovedArgs	Ereignis, das ausgelöst wird, wenn eine Registerkarte geschlossen wird.
Registerkarte aktualisiert	TabUpdatedArgs	Ereignis, das ausgelöst wird, wenn eine Registerkarte aktualisiert wird.
Registerkartennavigation gestartet	TabNavigationStartedArgs	Ereignis, das ausgelöst wird, wenn die Registerkartennavigation zu einer bestimmten URL gestartet wurde.
Registerkartennavigation abgeschlossen	TabNavigationCompletedArgs	Ereignis, das ausgelöst wird, wenn die Registerkartennavigation zu einer bestimmten URL abgeschlossen ist.
Fensterfokus geändert	HtmlWindowFocusChangedArgs	Ereignis, das ausgelöst wird, wenn sich das aktuell fokussierte Fenster ändert.
Fenstergrenzen geändert	HtmlWindowBoundsChangedArgs	Ereignis, das ausgelöst wird, wenn die Größe eines Fensters geändert wurde. Sie wird nur ausgegeben, wenn die neuen Grenzen festgelegt werden, und nicht bei Änderungen in Bearbeitung.
Fenster erstellt	HtmlWindowCreatedArgs	Ereignis, das ausgelöst wird, wenn ein Fenster erstellt wird.
Fenster entfernt	HtmlWindowRemovedArgs	Ereignis, das ausgelöst wird, wenn ein Fenster entfernt (geschlossen) wird.

UIA-Ereignisse – UI-Elemente

Ereignistyp	TriggerEventsArgs-Typ	Beschreibung
Wurde angezeigt	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement erscheint.
Verschwand	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement verschwindet.
Text geändert	TextGeänderteArgumente	Ereignis, das ausgelöst wird, wenn sich der Text des Zielelements ändert.
Textauswahl geändert	UiaTextSelectionChangedArgs	Ereignis, das ausgelöst wird, wenn sich der ausgewählte Text des Zielelements ändert.
Fokus erhalten	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus erhält.
Fokus verloren	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement den Fokus verliert.
Aufgerufen	LeereArg.	Ereignis, das ausgelöst wird, wenn das Zielelement aufgerufen wird.
Selected	AuswahlgeänderteArgumente	Ereignis, das ausgelöst wird, wenn das Zielelement ausgewählt wird.
Abgewählt	AuswahlgeänderteArgumente	Ereignis, das ausgelöst wird, wenn die Auswahl des Zielelements aufgehoben wird.
umgeschaltet	UiaToggledArgs	Ereignis, das ausgelöst wird, wenn das Zielelement umgeschaltet wird.

TriggerEventArgs-Eigenschaften

TriggerArgs

Basisklasse für alle args -Klassen, die sich auf Trigger beziehen.

Eigenschaften	Typ	Beschreibung
TriggerName	String	Der Name des Triggers (angezeigt als Aktivitätsname).
TriggerType	Typ	Der Typ von TriggerEventArgs.

UIElement-Trigger-Argumente

Vererbung: TriggerArgs > UiElementTriggerArgs

Eigenschaften	Typ	Beschreibung
Selector	String	Der Selektor des Zielelements.
TargetElement	UiElement	Das Zielelement, das überwacht wird.

NativeTriggerBaseArgs

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs

Eigenschaften	Typ	Beschreibung
SelectorIndex	Integer	Der Index des Zielelementselektors.

LeereArg.

Gibt Daten von den folgenden Ereignissen zurück: Erschienen, Verschwunden, Fokus erhalten, Fokus verloren, Aktiviert, Deaktiviert, Menü ausgewählt, Menü abgewählt, Menü beendet, Pop-up-Menü sichtbar, Pop-up-Menü unsichtbar, Pop-up-Menü beendet.

Vererbung: TriggerArgs > UiElementTriggerArgs > EmptyArgs

TextChangedArg

Gibt Daten aus den folgenden Ereignissen zurück: Text geändert, Titel geändert.

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TextChangedArgs

Eigenschaften	Typ	Beschreibung
Text	String	Der neue Text für das Zielelement.

StatusGeänderteArgumente

Gibt Daten von den folgenden Ereignissen zurück: Status geändert.

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs

Eigenschaften	Typ	Beschreibung
State	String	Der neue Status für das Zielelement.

AuswahlgeänderteArgumente

Gibt Daten von den folgenden Ereignissen zurück: Auswahl geändert.

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs

Eigenschaften	Typ	Beschreibung
Selection	String	Die neue Auswahl für das Zielelement.

GeänderteArgumente am Standort

Gibt Daten von den folgenden Ereignissen zurück: Speicherort geändert.

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > LocationChangedArgs

Eigenschaften	Typ	Beschreibung
Location	Rectangle	Rechteck des geänderten Speicherorts mit Informationen über die Größe des Elements und seine Position.

HwndArgs

Gibt Daten von den folgenden Ereignissen zurück: Vordergrund hinzugefügt, Vordergrund entfernt, minimiert, wiederhergestellt.

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

Eigenschaften	Typ	Beschreibung
Hwnd	IntPtr	Fensterhandle.
HwndAsString	String	Fensterhandle als String.

JavaKeyPressArgs

Gibt Daten von den folgenden Ereignissen zurück: Taste gedrückt (für Java).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

Eigenschaften	Typ	Beschreibung
KeyChar	String	Das Zeichen, das der gedrückten Taste entspricht.
KeyCode	Integer	Der Code, der der gedrückten Taste entspricht.
ExtendedKeyCode	Integer	Der erweiterte Tastencode für die gedrückte Taste. Im Gegensatz zu KeyCodehängt dieser Wert vom aktuellen Tastaturlayout ab.
Location	String	Der Ort der Taste, die das Ereignis ausgelöst hat.
KeyModifiers	NTasteModifikatoren	Der Zusatzschlüssel, der neben dem Schlüssel verwendet wird. Mögliche Werte: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

JavaMouseActionArgs

Gibt Daten von den folgenden Ereignissen zurück: Klicken, Maus gedrückt, Maus losgelassen (für Java).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

Eigenschaften	Typ	Beschreibung
X	Integer	Die X-Koordinate des Mauszeigers.
Y	Integer	Die Y-Koordinate des Mauszeigers.
Button	Integer	Die Maustaste, auf die geklickt wurde. Mögliche Werte: 1 - Links 2 – Mitte 3 - Rechts
ClickCount	Integer	Die Anzahl der Klicks auf die Schaltfläche.
KeyModifiers	NTasteModifikatoren	Die neben der Maustaste verwendete Zusatztaste. Mögliche Werte: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

JavaMouseMotionArgs

Gibt Daten von den folgenden Ereignissen zurück: Mausbewegung, Maus eingegeben, Maus verlassen (für Java).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

Eigenschaften	Typ	Beschreibung
X	Integer	Die X-Koordinate des Mauszeigers.
Y	Integer	Die Y-Koordinate des Mauszeigers.
MouseButton	Integer	Die Maustaste, auf die geklickt wurde Mögliche Werte: 0 – Keine 1 - Links 2 – Mitte 3 - Rechts

JavaCellSelectedArgs

Gibt Daten von den folgenden Ereignissen zurück: Klicken (für Java).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

Eigenschaften	Typ	Beschreibung
Row	Integer	Ausgewählte Zellenzeile.
Column	Integer	Ausgewählte Zellenspalte.

JavaCellValueChangedArgs

Gibt Daten von den folgenden Ereignissen zurück: Klicken (für Java).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

Eigenschaften	Typ	Beschreibung
Row	Integer	Zellenzeile.
Column	Integer	Zellenspalte.
Value	String	Neuer Wert der Zelle.

WebMouseEventArgs

Gibt Daten von den folgenden Ereignissen zurück: Klicken, Doppelklick, Rechtsklick, Mausbewegung, Maus eingegeben, Maus verlassen, Maus gedrückt, Maus losgelassen (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

Hinweis: Er folgt den Eigenschaftsnamen, die für Mouse Events definiert sind.

Eigenschaften	Typ	Beschreibung
AltKey	Boolescher	Wenn die ALT-Taste gedrückt wird.
Button	Integer	Welche Maustaste gedrückt wird. Mögliche Werte: 0 - Links 1 – Mitte 2 - Rechts
ClientX	Integer	Die X-Koordinate des Mauszeigers (relativ zum Fenster).
ClientY	Integer	Die Y-Koordinate des Mauszeigers (relativ zum Fenster).
CtrlKey	Boolescher	Wenn die STRG-Taste gedrückt wird.
MetaKey	Boolescher	Wenn die META-Taste gedrückt wird.
MovementX	Integer	Die X-Koordinate des Mauszeigers (relativ zur Position des letzten mousemove-Ereignisses).
MovementY	Integer	Die Y-Koordinate des Mauszeigers (relativ zur Position des letzten mousemove-Ereignisses).
OffsetX	Integer	Die X-Koordinate des Mauszeigers (relativ zum Ziel).
OffsetY	Integer	Die Y-Koordinate des Mauszeigers (relativ zum Ziel).
PageX	Integer	Die X-Koordinate des Mauszeigers (relativ zum Dokument).
PageY	Integer	Die Y-Koordinate des Mauszeigers (relativ zum Dokument).
ScreenX	Integer	Die X-Koordinate des Mauszeigers (relativ zum Bildschirm).
ScreenY	Integer	Die Y-Koordinate des Mauszeigers (relativ zum Bildschirm).
ShiftKey	Boolescher	Wenn die UMSCHALT-Taste gedrückt wird.

WebKeyPressArgs

Gibt Daten von den folgenden Ereignissen zurück: Taste gedrückt (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

Hinweis: Es folgt den Eigenschaftsnamen, die für Tastaturereignisse definiert sind.

Eigenschaften	Typ	Beschreibung
AltKey	Boolescher	Wenn die ALT-Taste gedrückt wird.
Code	String	Der Code der Taste, die das Ereignis ausgelöst hat (z. B. KeyA, KeyB, ControlLeft, ControlRight).
CtrlKey	Boolescher	Wenn die STRG-Taste gedrückt wird.
IsComposing	Boolescher	Ob der Status des Ereignisses gerade zusammengestellt wird oder nicht.
Key	String	Der Wert der Taste, die das Ereignis ausgelöst hat (z. B a, b, Control).
Location	Integer	Die Position einer Taste auf der Tastatur oder auf dem Gerät. Mögliche Werte: 0 – Standard – steht für fast jede Taste auf der Tastatur 1 – Linke Taste wurde gedrückt 2 – Rechte Taste wurde gedrückt 3 – Die Taste wurde auf dem Ziffernblock gedrückt
MetaKey	Boolescher	Wenn die META-Taste gedrückt wird.
Repeat	Boolescher	Ob eine Taste wiederholt gedrückt wird oder nicht.
ShiftKey	Boolescher	Wenn die UMSCHALT-Taste gedrückt wird.

WebTextSelectionChangedArgs

Gibt Daten von den folgenden Ereignissen zurück: Textauswahl geändert (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

Hinweis: Es folgt den Eigenschaftsnamen, die für Tastaturereignisse definiert sind.

Eigenschaften	Typ	Beschreibung
AnchorClientBounds	Rectangle	Die Grenzen des Anker-Clients: Informationen über die Größe des Elements und seine Position relativ zum Ansichtsfenster.
AnchorElement	UiElement	Das Anker-UI-Element.
AnchorOffset	Integer	Der 0-basierte Index des Zeichens, bei dem die Textauswahl begonnen hat (aus dem Volltext des Zielelements).
FocusClientBounds	Rectangle	Die Grenzen des Fokus-Clients: Informationen über die Größe des Elements und seine Position relativ zum Ansichtsfenster.
FocusElement	UiElement	Der Fokus des UI-Elements.
FocusOffset	Integer	Der 0-basierte Index des Zeichens, bei dem die Textauswahl beendet wurde (aus dem Volltext des Zielelements).
SelectedText	String	Die neue Textauswahl für das Zielelement.

DownloadChangedArgs

Gibt Daten von den folgenden Ereignissen zurück: Downloadstatus geändert (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs

Eigenschaften	Typ	Beschreibung
State	String	Die Zeichenfolge, die eine Änderung im state des downloads.DownloadItem beschreibt.
Id	String	Der id des geänderten downloads.DownloadItem.
FileName	String	Die Zeichenfolge, die eine Änderung im url des downloads.DownloadItem beschreibt.
Url	String	Die Zeichenfolge, die eine Änderung im filename des downloads.DownloadItem beschreibt.
StartTime	String	Die Zeichenfolge, die eine Änderung im startTime des downloads.DownloadItem beschreibt.
EndTime	String	Die Zeichenfolge, die eine Änderung im endTime des downloads.DownloadItem beschreibt.
Error	String	Die Zeichenfolge, die eine Änderung des error-Status des downloads.DownloadItem beschreibt.

TabActivatedArgs

Gibt Daten von den folgenden Ereignissen zurück: Registerkarte aktiviert (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabActivatedArgs

Eigenschaften	Typ	Beschreibung
TabId	String	Die ID der Registerkarte, die aktiv geworden ist.
WindowId	String	Die ID des Fensters, in dem sich die ausgewählte Registerkarte geändert hat.
Title	String	Der neue Titel der Registerkarte.
Url	String	Die URL der Registerkarte, wenn sie sich geändert hat.

TabCreatedArgs

Gibt Daten von den folgenden Ereignissen zurück: Registerkarte erstellt (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

Eigenschaften	Typ	Beschreibung
TabId	String	Die ID der erstellten Registerkarte.
WindowId	String	Die ID des Fensters, das die Registerkarte enthält.
Title	String	Der neue Titel der Registerkarte.
Url	String	Die URL der Registerkarte.

TabRemovedArgs

Gibt Daten von den folgenden Ereignissen zurück: Registerkarte entfernt (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

Eigenschaften	Typ	Beschreibung
TabId	String	Die ID der entfernten Registerkarte.
WindowId	String	Die ID des Fensters, dessen Registerkarte geschlossen ist.
IsWindowClosing	Boolescher	True wenn die Registerkarte geschlossen wurde, weil das übergeordnete Fenster geschlossen wurde.

TabUpdatedArgs

Gibt Daten aus den folgenden Ereignissen zurück: Registerkarte aktualisiert (für WEBCTRL).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

Eigenschaften	Typ	Beschreibung
TabId	String	Die ID der aktualisierten Registerkarte.
WindowId	String	Die ID des Fensters, das die Registerkarte enthält.
Status	String	Der Ladestatus der Registerkarte.
Title	String	Der neue Titel der Registerkarte.
Url	String	Die URL der Registerkarte, wenn sie sich geändert hat.
Active	Boolescher	Ob die Registerkarte in ihrem Fenster aktiv ist. Bedeutet nicht unbedingt, dass das Fenster fokussiert ist.

TabNavigationStartedArgs

Gibt Daten von den Ereignissen zurück, die für die Registerkartennavigation gestartet wurden (für html).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs

Eigenschaften	Typ	Beschreibung
Url	String	Die URL, die aktuell mit dem Rahmen verbunden ist, wenn der durch FrameId identifizierte Rahmen an einem Punkt auf der gegebenen Registerkarte vorhanden war. Die Tatsache, dass eine URL mit einem bestimmten FrameId verknüpft ist, bedeutet nicht, dass der entsprechende Rahmen noch vorhanden ist.
TabId	Integer	Die ID der Registerkarte, auf der sich der Rahmen befindet.
FrameId	Integer	Die ID des Rahmens innerhalb der Registerkarte, für die das gestartete Ereignis ausgelöst wurde, wodurch die Registerkartennavigation erhalten wird. Frames werden durch ihre TabId und FrameId eindeutig identifiziert.
TimeStampMs	Double	Es wird nur garantiert, dass die Eigenschaft TimeStampMs der Ereignisse der Webnavigation intern konsistent ist. Wenn Sie ein Ereignis mit einem anderen vergleichen, erhalten Sie den richtigen Offset zwischen ihnen. Ein Vergleich mit der aktuellen Zeit innerhalb der Erweiterung (z. B. (new Date()).getTime()) kann jedoch zu unerwarteten Ergebnissen führen.
DateTime	Datum	Keine Angabe

TabNavigationCompletedArgs

Gibt Daten von den Ereignissen „Registerkartennavigation abgeschlossen“ zurück (für html).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs

Eigenschaften	Typ	Beschreibung
Url	String	Die URL, die diesem Rahmen derzeit zugeordnet ist, wenn der durch FrameId identifizierte Rahmen an einem Punkt auf der angegebenen Registerkarte vorhanden war. Die Tatsache, dass eine URL mit einem bestimmten FrameId verknüpft ist, bedeutet nicht, dass der entsprechende Rahmen noch vorhanden ist.
TabId	Integer	Die ID der Registerkarte, auf der sich der Rahmen befindet.
FrameId	Integer	Die ID des Rahmens innerhalb der Registerkarte, für die das abgeschlossene Ereignis ausgelöst wurde, wodurch die Registerkartennavigation erhalten wird. Frames werden durch ihre TabId und FrameId eindeutig identifiziert.
TimeStampMs	Double	Es wird nur garantiert, dass die Eigenschaft TimeStampMs der Ereignisse der Webnavigation intern konsistent ist. Wenn Sie ein Ereignis mit einem anderen vergleichen, erhalten Sie den richtigen Offset zwischen ihnen. Ein Vergleich mit der aktuellen Zeit innerhalb der Erweiterung (z. B. (new Date()).getTime()) kann jedoch zu unerwarteten Ergebnissen führen.
DateTime	Datum	Keine Angabe

HtmlWindowFocusChangedArgs

Gibt Daten von den Ereignissen zur Änderung des Fensterfokus zurück (für html).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

Eigenschaften	Typ	Beschreibung
TabId	String	Die ID der neu fokussierten Registerkarte.
WindowId	String	Die ID des Fensters, das die Registerkarte enthält.
Title	String	Der Titel der Registerkarte.
Url	String	Die URL der Registerkarte, wenn sie sich geändert hat.

HtmlWindowBoundsChangedArgs

Gibt Daten von den geänderten Fenstergrenzen-Ereignissen zurück (für html).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

Eigenschaften	Typ	Beschreibung
WindowId	String	Die ID des Fensters, dessen Grenzen sich geändert haben.
Focused	Boolescher	Ob das Fenster derzeit das fokussierte Fenster ist.
Top	Integer	Der Offset des Fensters vom oberen Bildschirmrand in Pixeln.
Left	Integer	Der Offset des Fensters vom linken Bildschirmrand in Pixeln.
Width	Integer	Die Breite des Fensters, einschließlich des Rahmens, in Pixeln.
Height	Integer	Die Höhe des Fensters, einschließlich des Rahmens, in Pixeln.

HtmlWindowCreatedArgs

Gibt Daten von den Ereignissen vom Typ „Fenster erstellt“ zurück (für html).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

Eigenschaften	Typ	Beschreibung
WindowId	String	Die ID des erstellten Fensters.

HtmlWindowRemovedArgs

Gibt Daten von den Ereignissen „Fenster entfernt“ zurück (für html).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

Eigenschaften	Typ	Beschreibung
WindowId	String	Die ID des entfernten Fensters.

UiaToggledArgs

Gibt Daten von den folgenden Ereignissen zurück: Umschaltereignisse (für UIA).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

Eigenschaften	Typ	Beschreibung
State	String	Der neue Status für das Zielelement.

UiaTextSelectionChangedArgs

Gibt Daten von den Ereignissen „Textauswahl geändert“ zurück (für uia).

Vererbung: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

Eigenschaften	Typ	Beschreibung
TextRanges	UiaTextRange()	Array, das unterschiedliche Informationen zu den ausgewählten Textelementen im Zielelement enthält (bei nicht zusammenhängender Textauswahl können mehrere ausgewählte Textelemente vorhanden sein). Jedes Element aus diesem Array macht die folgenden Informationen verfügbar: Text (Typ String) – Textauswahl für dieses ausgewählte Textelement. Beispiel: TriggerEventArgs.TextRanges(0).Text stellt den Text des ersten ausgewählten Textelements dar. BoundingRectangles (Typ Rectangle()) – Array von Begrenzungsrechtecken für das ausgewählte Textelement. Einem ausgewählten Textelement können mehrere Begrenzungsrechtecke zugeordnet sein, wenn es sich über mehrere Zeilen erstreckt. Jedes Begrenzungsrechteck hat den Typ Rectangle {X, Y, Width, Height} und enthält Informationen über die Position und Größe des Elements. Beispiel: TriggerEventArgs.TextRanges(0).BoundingRectangles(0) stellt das Begrenzungsrechteck der ersten Zeile im ersten ausgewählten Textelement dar.

Tool zur Ereignisuntersuchung

Im Kontext der triggerbasierten Attended-Automatisierung kann das Ereignisinspektionstool verwendet werden, um den Typ der nativen Ereignisse zu identifizieren, die ausgelöst werden, wenn Sie mit bestimmten UI-Elementen in einer Anwendung interagieren, und dann kann es zum Konfigurieren der Aktivität Application Event Trigger verwendet werden. Das Tool erfasst und überwacht alle ausgewählten Ereignistypen, z. B. Klicken, Taste gedrückt, Fokus erhalten, Fokus verloren und andere relevante Interaktionen, sodass Sie die ausgeführten Aktionen analysieren und ggf. Probleme diagnostizieren können.

Das Ereignisinspektionstool kann im UI Explorer geöffnet werden, sobald ein gültiges UI-Element ausgewählt wurde, indem Sie auf die Symbolleistenschaltfläche Ereignisse untersuchen klicken.

Die Symbolleiste umfasst die folgenden Optionen:

• Aufzeichnen – Die durch die Interaktion mit dem UI-Element generierten Ereignisse werden aufgezeichnet und der Ereignisliste hinzugefügt.
• Pausieren – Die Ereignisse, die das UI-Element bei der Interaktion mit dem Element erzeugt, werden nicht mehr aufgezeichnet.
• Hervorheben – Zeigt die Kontur des Zielelements an und bringt es für einige Sekunden in den Vordergrund. Die Hervorhebung bleibt bis zur Deaktivierung aktiviert.
• In UI-Explorer öffnen – Das überwachte Element wird im UI-Explorer geöffnet, wo Sie den Selektor dieses Elements beobachten können.

Sobald Sie die Ereignisaufzeichnung starten, stehen zwei weitere Optionen zur Verfügung:

• Löschen – Löscht alle aufgezeichneten Ereignisse.
• CSV – Die erfassten Ereignisse können zur weiteren Analyse in eine .csv-Datei exportiert werden.

Das Fenster mit dem Tool zur Ereignisuntersuchung hat zwei Hauptabschnitte:

• Ereignisfilter – Ermöglicht die Auswahl der Ereignistypen, die Sie für das Zielelement überwachen möchten.
• Ereignisliste – Zeigt Informationen zu erfassten Ereignissen an.

Sie können die zu erfassenden Ereignistypen filtern, indem Sie die Kontrollkästchen in der Liste der Ereignistypen aktivieren oder deaktivieren. Die Liste kann je nach ausgewählter Elementtechnologie variieren.

Alle Mausereignistypen (Mausbewegung, Maus gedrückt, Maus losgelassen, Maus eingegeben, Maus verlassen), die für Web- oder Java-UI-Elemente spezifisch sind, sind standardmäßig deaktiviert, da die Ereignisliste in solchen Fällen ziemlich groß werden kann. Wir empfehlen, die Mausereignistypen nur dann zu aktivieren, wenn Sie einen besonderen Bedarf an deren Überwachung haben.

Es ist auch zu erwähnen, dass Ereignistypen aktiviert oder deaktiviert werden können, auch nachdem Sie die Ereignisaufzeichnung gestartet haben.

Die Ereignisliste hat drei Spalten:

• Ereignisname – Der Ereignistyp.
• Zeitstempel – Das Datum und die Stunde, zu der das Ereignis durchgeführt wurde.
• Ereignisdaten – Die zugehörigen Daten und Parameter für ein bestimmtes Ereignis.

Jede Spalte kann in aufsteigender oder absteigender Reihenfolge sortiert werden. Die Ereignisse werden standardmäßig in der Reihenfolge angezeigt, in der sie ausgeführt wurden.

Wenn der Ereignistyp Verschwunden gefunden wird, können Sie die Überwachung nicht mehr fortsetzen, und eine Fehlermeldung wird auf dem Bildschirm angezeigt. Wenn Sie auf eine Option in der Symbolleiste klicken, wird dieselbe Fehlermeldung auf dem Bildschirm angezeigt. Die einzigen verfügbaren Optionen sind das Löschen der Daten oder das Exportieren in eine .csv-Datei. Um die Überwachung erneut zu starten, schließen Sie das Fenster und öffnen Sie eine weitere Instanz des Ereignisinspektionstools.