Studio-Benutzerhandbuch

Letzte Aktualisierung 19. Dez. 2024

UI Activities-Eigenschaften

Apps und Web-Apps können mit mehreren Aktivitäten automatisiert werden. Diese finden Sie im Panel Aktivitäten (Activities) in der Kategorie UI-Automatisierung (UI Automation).

All diese Aktivitäten haben mehrere Eigenschaften gemeinsam:

BeiFehlerFortfahren (ContinueOnError) – Gibt an, ob die Automatisierung fortgesetzt werden soll, selbst wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert in diesem Feld ist „False“. Wenn dieses Feld leer ist und ein Fehler ausgelöst wird, wird die Ausführung des Projekts unterbrochen. Wenn der Wert auf „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

Hinweis: Wenn das Feld BeiFehlerFortfahren (ContinueOnError) in einer Abfangen versuchen (Try Catch)-Aktivität auf „True“ gesetzt ist, wird kein Fehler ausgegeben, wenn das Projekt ausgeführt wird.
VerzögernNach (DelayAfter) – fügt nach der Aktivität eine Pause in Millisekunden hinzu.
VerzögerungVorher (DelayBefore) – fügt eine Pause in Millisekunden vor der Aktivität hinzu.
AuszeitMS (TimeoutMS) – gibt an, wie lange (in Millisekunden) gewartet werden muss, bis ein bestimmtes Element gefunden wird, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
WartenBisBereit (WaitForReady) - Vor Ausführung der Aktionen warten, bis das Ziel bereit ist. Folgende Optionen sind verfügbar:
- Keine (None) - Wartet ausschließlich auf das UI-Zielelement, bevor die Aktion ausgeführt wird. Sie können diese Option beispielsweise verwenden, wenn Sie nur Text einer Website abrufen oder eine bestimmte Schaltfläche anklicken möchten, ohne auf das Laden aller UI-Elemente warten zu müssen. Beachten Sie, dass dies ungewünschte Folgen haben kann, wenn die Schaltfläche von Elementen wie Skripten abhängt, die noch nicht geladen sind.
- Interactive: Wartet, bis die Ziel-App Bereitschaft signalisiert, auch wenn einige Assets unter Umständen noch geladen werden.
- Abgeschlossen – Wartet, bis alle UI-Elemente in der Ziel-App geladen werden, bevor die Aktion tatsächlich ausgeführt wird.
  
  Um zu beurteilen, ob sich eine Anwendung im Status „Interaktiv“ oder „Abgeschlossen“ befindet, werden die folgenden Tags überprüft:
  
  Desktop-Anwendungen (Desktop applications) - Eine Nachricht wm_null wird versendet, um zu prüfen, ob die Tags <wnd>, <ctrl>, <java> oder <uia> vorhanden sind. Sind die Tags vorhanden, wird die Aktivität ausgeführt.
  
  Webanwendung
  - Internet Explorer – Das <webctrl>-Tag wird verwendet, um zu überprüfen, ob der Status Bereit des HTML-Dokuments Abgeschlossen ist. Darüber hinaus muss der Status Beschäftigt auf „False“ festgelegt werden.
  - Andere – Das <webctrl>-Tag wird verwendet, um zu überprüfen, ob der Bereitschafts-Status des HTML-Dokuments Abgeschlossen ist.
  SAP-Anwendungen (SAP applications) - Zuerst wird geprüft, ob der Tag <wnd> vorhanden ist. Anschließend wird eine SAP-spezifische API verwendet, um zu prüfen, ob die Session verfügbar ist.

Ziel (Target) – identifiziert das UI-Element, mit dem die Aktivität arbeitet.

Das Ziel besteht aus mehreren Teilen, nämlich dem Container, dem Selektor und dem Clippingbereich, um sicherzustellen, dass Sie ein UI-Element korrekt identifizieren.

Ein Container gibt Ihnen ein wenig mehr Kontext über die Schaltfläche oder das Feld, das Sie verwenden möchten, damit Sie Fenster oder andere Bereiche derselben App unterscheiden können. Sie werden automatisch generiert. Sie können jedoch im Panel Eigenschaften (Properties) Änderungen vornehmen.

Die folgenden sind Container: