Mouse Scroll

UiPath.UIAutomationNext.Activities.NMouseScroll

Beschreibung

Ermöglicht das Scrollen in Anwendungen durch Senden von Maus-Scroll-Ereignissen an das angegebene UI-Element.

Diese Aktivität muss innerhalb einer Use Application/Browser-Aktivität hinzugefügt werden.

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

Diese Aktivität ist mit Object Repository kompatibel.

Hinweis:

Wenn für diese Aktivität kein Ziel angegeben wird, wird automatisch das Ziel des Scope verwendet, in dem sie enthalten ist.

Aufgrund der Art dieser Aktivität kann sie außerdem nicht im Hintergrundmodus verwendet werden.

Weitere Informationen zum Angeben und Konfigurieren von Zielen finden Sie unter Auswahlbildschirm.

Projektkompatibilität

Windows – Legacy | Windows | Plattformübergreifend

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Wählen Sie das Menü . aus 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.

• Richtung – Die Richtung, in die der Bildlauf ausgeführt werden soll. Die folgenden Optionen sind verfügbar: Links, Oben, Rechts, Unten. Die Standardoption ist Nach unten.

• Bildlauftyp – Wählen Sie zwischen den beiden Verwendungsmethoden für diese Aktivität aus:

  • An Element – Scrollt, bis ein angegebenes UI-Element in der Zielanwendung gefunden wird. Dies ist die Standardoption.

    Hinweis: Wenn Sie Bis-Element im Feld Bildlauftyp auswählen, wird das Eigenschaftsfeld Anzahl der Bildläufe ignoriert und nach dem angegebenen UI-Element gesucht.

    Wenn das angegebene Element zur Laufzeit nicht gefunden wird, scrollt die Aktivität so weit, wie im Feld Anzahl der Bildläufe angegeben ist, und wiederholt dann die Suche nach dem angegebenen Element. Dieses Verhalten wird so oft wie nötig wiederholt, bis das Element gefunden wird, und kann bei Anwendungen mit längeren Ladezeiten nützlich sein.

  • Abstand – Scrollt nur so weit, wie im Eigenschaftsfeld Anzahl der Bildläufe angegeben.

    Hinweis: Die Anzahl der Zeilen, die bei einer Bildlaufbewegung gescrollt werden, wird im Abschnitt Mauseinstellungen in Windows konfiguriert. Wenn Sie zu einem bestimmten Element scrollen, wird das Element gesucht, nachdem alle Drehungen ausgeführt wurden. Wenn Sie diese Methode auswählen, wird auch die Eigenschaft # of scrolls im Textkörper der Aktivität angezeigt.

• Zu Element scrollen – Klicken Sie auf In App/Browser anzeigen, um das UI-Element anzugeben, zu dem Sie einen Bildlauf durchführen möchten. Diese Option wird nur angezeigt, wenn Bis-Element aus dem Dropdownmenü Bildlauftyp ausgewählt ist.

Eigenschaften-Panel

Allgemein

• BeiFehler fortfahren – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur Boolean -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 Truefestgelegt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.

• Verzögerung nach – Verzögerung (in Sekunden) zwischen dem Zeitpunkt, an dem diese Aktivität abgeschlossen ist, und dem Zeitpunkt, zu dem die nächste Aktivität Vorgänge beginnt. Der Standardwert ist 0,3 Sekunden. Durch Hinzufügen einer Verzögerung zwischen Aktivitäten wird sichergestellt, dass eine Aktivität genügend Zeit hat, um abgeschlossen zu werden, bevor die nächste Aktivität beginnt.

• Verzögerung vor – Verzögerung (in Sekunden) zwischen dem Zeitpunkt, zu dem die vorherige Aktivität abgeschlossen ist, und dem Zeitpunkt, zu dem diese Aktivität mit der Ausführung von Vorgängen beginnt. Der Standardwert beträgt 0,2 Sekunden. Durch Hinzufügen einer Verzögerung zwischen Aktivitäten wird sichergestellt, dass eine Aktivität genügend Zeit hat, um abgeschlossen zu werden, bevor die nächste Aktivität beginnt.

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

• Zeitüberschreitung – Geben Sie die Zeitspanne (in Sekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden.

  Wichtig: Wenn Sie zu einem Bildziel scrollen, wird empfohlen, den Wert der Timeout -Eigenschaft zu erhöhen, um den längeren Bildsuchzeiten Rechnung zu tragen.

Eingabe

• CursorBewegungstyp - Gibt die Art der Bewegung an, die vom Mauszeiger ausgeführt wird. Es gibt zwei verfügbare Optionen:

  • Sofort – Der Cursor springt zum Ziel. Dies ist die Standardoption.
  • Langsam – Der Cursor bewegt sich schrittweise. Die Einstellung ist nur wirksam, wenn der Eingabemodus Hardware-Ereignisse verwendet wird.
• Ziel – Das Zielelement. 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.
  • Klick-Offset – Gibt einen Offset für die Klickaktivität an, der weiter konfiguriert werden kann.
    • Ankerpunkt (Anchoring Point ) - Beschreibt den Startpunkt des Cursors, zu dem die Eigenschaften Offset X und Offset Y hinzugefügt werden. Die folgenden Optionen sind verfügbar: TopLeft, TopRight, BottomLeft, BottomRightund Center. Standardmäßig ist Mitte ( Center ) ausgewählt.
    • Offset X - Horizontale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32 -Variablen.
    • Offset y (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 Typ des Steuerelements an, das mithilfe von Computer Vision identifiziert wurde.
  • CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde.
  • Fuzzy-Selektor - Die Parameter für den Fuzzy-Selektor.
  • Native-Text - Der Text, der zum Identifizieren des UI-Elements verwendet wird.
  • ReaktionsfähigeWebsites – Aktivieren Sie das Layout für reaktionsfähige Websites.
  • Strikter Selektor - Der strenge Selektor, der für das UI-Element generiert wird.
  • Zielmethoden – Die Selektortypen, die Sie zum Identifizieren des Elements verwenden möchten. Für diese Eigenschaft kann im Dropdownmenü eine beliebige Kombination festgelegt werden:
    • Keine
    • Strikter Selektor
    • Fuzzy-Selektor
    • Bild
    • Nativer Text
    • Computer Vision
  • Sichtbarkeitsprüfung – Prüft, ob das UI-Element sichtbar ist oder nicht. Sie können eine von drei Optionen aus dem Dropdown-Menü auswählen:
    • Keine - Prüft nicht auf 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 ausgeblendet sind.
    • Vollständig sichtbar – Prüft, ob das UI-Element sichtbar ist oder nicht.
  • Warten auf das Laden der Seite – Vor dem Ausführen der Actionswarten, bis die Anwendung zum Akzeptieren von Eingaben bereit ist. Sie können eine von drei Optionen aus dem Dropdown-Menü auswählen:
    • 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 Anfügemodus für Fenster auf Anwendungsinstanz festgelegt ist.

Eingabe/Ausgabe-Element

• Eingabeelement – Das UI-Element, für das die Aktivität ausgeführt wird, gespeichert in einem UIElement -Objekt. Dieses Feld unterstützt nur UIElement -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 dasselbe Element mit anderen Aktivitäten auszurichten.

Sonstiges

• 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

• Anzahl der Bildläufe – Wie oft gescrollt werden soll, gespeichert in einer Int32 -Variablen. Wenn der Bildlauftyp im Textkörper der Aktivität auf An Elementfestgelegt ist, wird dieses Feld standardmäßig auf 10festgelegt. Wenn Entfernungfestgelegt ist, wird dieses Feld standardmäßig auf 5 festgelegt.
• Richtung – Siehe Richtung im Entwurfsbereich.

• Eingabemodus – Wählen Sie aus, welche Methode der Roboter für die Interaktion mit der Zielanwendung verwenden soll:

  • Identisch mit App/Browser – Verwenden Sie denselben Eingabemodus wie die Aktivität „Anwendung/Browser verwenden“ ( Use Application/Browser) .

  • Hardwareereignisse – Verwendet den Hardwaretreiber, um die Aktion auszuführen. Dies ist die langsamste Methode, sie kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.

  • Chromium-API – Führt Aktionen mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text auf einmal. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus ist. Weitere Informationen finden Sie auf dieser Seite.

• Zusatztasten – Fügen Sie einen oder mehrere Zusatztasten hinzu, die in Kombination mit den Actions der Aktivität verwendet werden sollen. Die folgenden Optionen sind verfügbar: Keine, Alt, Strg, Umschaltund Win. Die Standardoption ist Keine.

• Gesuchtes Element – Das angegebene UI-Element, zu dem Sie einen Bildlauf durchführen möchten.

  • Ausgabeelement – Der gesuchte UI-Elementverweis, den Sie in anderen UI-Automatisierungsaktivitäten in der Eigenschaft Eingabeelement verwenden können.
  • Ziel – Dieses UI-Element verfügt über eine eigene Zieleigenschaft , die genauso konfiguriert werden kann wie die Haupteigenschaft.
  • Zeitüberschreitung - Die Zeitspanne (in Sekunden), die gewartet werden muss, bis das gesuchte Element angezeigt wird. Der Standardwert beträgt 0,2 Sekunden.

Plattformübergreifende Konfiguration

• In Scope arbeiten – Wählen Sie die Browserregisterkarte aus, die die zu automatisierende Webanwendung rendert.
• Bildlauf-Container – Scrollen Sie durch die gesamte Seite oder innerhalb eines Elements. Die Standardoption ist Gesamte Seite.
• Bildlaufrichtung – Die Richtung, in der der Bildlauf ausgeführt werden soll. Die folgenden Optionen sind verfügbar: Links, Oben, Rechts, Unten. Die Standardoption ist Nach unten.
• Bildlauftyp – Wählen Sie zwischen den beiden Verwendungsmethoden für diese Aktivität aus:
  • An Element – Scrollt, bis ein angegebenes UI-Element in der Zielanwendung gefunden wird. Dies ist die Standardoption.
  • Abstand – Scrollt nur so weit, wie im Eigenschaftsfeld Anzahl der Bildläufe angegeben.

• Gesuchtes Element auf dem Bildschirm anzeigen – Geben Sie das UI-Element an, zu dem Sie einen Bildlauf durchführen möchten. Diese Option wird nur angezeigt, wenn Bis-Element aus dem Dropdownmenü Bildlauftyp ausgewählt ist.

  Nachdem Sie das Ziel angegeben haben, wählen Sie die Plus-Schaltfläche aus, 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.

• Anzahl der Bildläufe – Wie oft gescrollt werden soll. Diese Option wird nur angezeigt, wenn Entfernung aus dem Dropdownmenü Bildlauftyp ausgewählt ist.

Zusätzliche Optionen

Zeitliche Abläufe

• Verzögerung vor – Verzögerung (in Sekunden) zwischen dem Zeitpunkt, zu dem die vorherige Aktivität abgeschlossen ist, und dem Zeitpunkt, zu dem diese Aktivität mit der Ausführung von Vorgängen beginnt. Der Standardwert beträgt 0,2 Sekunden. Durch Hinzufügen einer Verzögerung zwischen Aktivitäten wird sichergestellt, dass eine Aktivität genügend Zeit hat, um abgeschlossen zu werden, bevor die nächste Aktivität beginnt.

• Verzögerung nach – Verzögerung (in Sekunden) zwischen dem Zeitpunkt, an dem diese Aktivität abgeschlossen ist, und dem Zeitpunkt, zu dem die nächste Aktivität Vorgänge beginnt. Der Standardwert ist 0,3 Sekunden. Durch Hinzufügen einer Verzögerung zwischen Aktivitäten wird sichergestellt, dass eine Aktivität genügend Zeit hat, um abgeschlossen zu werden, bevor die nächste Aktivität beginnt.

• Zeitüberschreitung – Geben Sie die Zeitspanne (in Sekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden.

• BeiFehler fortfahren – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur Boolean -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 Truefestgelegt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.

Eingang/Ausgang

• Eingabeelement – Das UI-Element, für das die Aktivität ausgeführt wird, gespeichert in einem UIElement -Objekt. Dieses Feld unterstützt nur UIElement -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 dasselbe Element mit anderen Aktivitäten auszurichten.
• Gesuchtes Ausgabeelement – Die gesuchte UI-Elementreferenz, die in anderen Aktivitäten als Eingabe-UI-Element verwendet werden soll. Diese Option wird nur angezeigt, wenn Bis-Element aus dem Dropdownmenü Bildlauftyp ausgewählt ist.