Klicken (Click)

UiPath.UIAutomationNext.Activities.NClick

Beschreibung

Klickt auf ein bestimmtes UI-Element, z. B. eine Schaltfläche oder einen Link. Sie kann so konfiguriert werden, dass eine beliebige Maustaste oder ein Doppelklick verwendet wird, und sie kann in Kombination mit einer Zusatztaste verwendet werden.

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.

Projektkompatibilität

Windows – Legacy | Windows | Plattformübergreifend

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Klicken Sie auf In App/Browser 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.
  • Verifizierung hinzufügen/ Verifizierung entfernen – Fügt die Funktion Verifizierungsziel auf dem Bildschirm anzeigen auf der Aktivitätskarte hinzu oder entfernt sie. Die Ausführung von „Verifizieren“ ist standardmäßig aktiviert.
  • 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.

• Klicktyp – Wählen Sie im Dropdownmenü den Typ des auszuführenden Klicks aus: Einfach, Doppelt, Nach untenoder Nach oben. Die Standardoption ist Single.

• Maustaste – Wählen Sie im Dropdownmenü die Maustaste aus, mit der geklickt werden soll: Links, Mitteoder Rechts. Die Standardoption ist Left.
• Verifizierungsziel auf dem Bildschirm anzeigen – Geben Sie das UI-Element an, das als Ziel verwendet und nach der Ausführung der Aktion angezeigt oder ausgeblendet werden soll. Verwenden Sie diese Funktion, wenn Sie sich vergewissern möchten, ob eine bestimmte Aktion der Aktivität während der Laufzeit korrekt ausgeführt wurde. Dies ist besonders nützlich in automatisierten Prozessen, bei denen Sie bestätigen müssen, dass bestimmte UI-Elemente als Ergebnis einer Aktion angezeigt werden oder verschwinden. Dies ist eine zusätzliche Möglichkeit, um zu überprüfen, dass der Prozess wie erwartet ausgeführt wird. Wenn Ihr Automatisierungsprozess also von der korrekten Ausführung bestimmter Schritte abhängt, ist es von Vorteil, die Ausführung zu überprüfen. Diese Funktion kann über die Projekteinstellungen oder über den Textkörper der Aktivität aktiviert werden, indem Sie Verifizierung hinzufügen auswählen.

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.

Eingabe

• Klicktyp – Siehe Klicktyp im Panel Designer.

• 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.
• Maustaste – Siehe Maustaste im Designer-Panel.
• 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 – 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 – 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.

• Ausführung verifizieren – Verifiziert zur Laufzeit, ob die von der Aktivität ausgeführte Aktion korrekt war. Dies geschieht, indem ein Element angegeben wird, das nach der Ausführung der Aktion angezeigt oder ausgeblendet werden soll, was überwacht und nach der Ausführung der Aktivität verifiziert wird. Diese Funktion kann über die Projekteinstellungen oder über den Textkörper der Aktivität aktiviert werden, indem Sie Verifizierung hinzufügen im Kontextmenü auswählen.

  • Anzeigename – Der Anzeigename der Actions. Dieses Feld wird basierend auf den von Ihnen gewählten Actions und dem Element automatisch ausgefüllt. Sobald „Ausführung verifizieren“ eingerichtet ist, wird dieser Anzeigename in der Aktivitätskarte sichtbar.
  • Wiederholen – Wenn diese Option ausgewählt ist, werden die Actions für die Dauer des Aktivitäts-Timeouts wiederholt, 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 Runtimeüberprüfen möchten. Weitere Informationen zu den Eigenschaftsfeldern, die unter dieser Eigenschaft erweitert werden können, finden Sie unter der Eigenschaft Ziel oben, da die Funktionalität der Eigenschaften identisch ist.
  • Timeout – Die Zeitspanne (in Sekunden), die gewartet werden muss, bis das Verifizierungselement angezeigt wird, verschwindet oder sich ändert. Wenn das Kontrollkästchen „Wiederholen“ aktiviert ist, werden die Actions erneut für die in der Timeout- Eigenschaft der Aktivität angegebene Dauer ausgeführt, gefolgt von der Überprüfung. Der Standardwert beträgt 10 Sekunden.

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

• Aktivieren – Holen Sie das UI-Element in den Vordergrund und aktivieren Sie es, bevor Sie darauf klicken. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist True.
• Deaktiviertes Element ändern – Wenn diese Option ausgewählt ist, führt die Aktivität die Actions aus, auch wenn das angegebene UI-Element deaktiviert ist. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.

  Diese Eigenschaft gilt nicht, wenn die Eigenschaft Eingabemodus auf Hardware-Ereignisse festgelegt ist.

• 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.

    Diese Option ist standardmäßig ausgewählt, wenn Sie die Standardeinstellung für eine der folgenden Eigenschaften ändern: ClickType, MouseButtonoder KeyModifiers.

  • Simulieren – Simuliert die Verwendung von Barrierefreiheits-APIs. Empfohlen für Browser, Java-basierte Anwendungen, SAP. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.

    Simulieren kann nur mit den Optionen „ Einzelklick “ und der Option „ Linke Maustaste“ verwendet werden.

  • 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.

    Wenn der Browser mit ChromiumAPI gestartet wird, erscheint ein Menüband, das angibt, dass der Browser im Debugmodus gestartet wurde. Diese Meldung wird nicht angezeigt, wenn die Erweiterung über eine Richtlinie installiert ist.

  • Windows-Meldungen – Simulieren mit Win32-Meldungen. Empfohlen für Desktop-Apps. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.

• 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.

  Schlüsselmodifikatoren können nicht mit dem Eingabemodus „ Simulieren “ verwendet werden.

Plattformübergreifende Konfiguration

• In Scope arbeiten – Wählen Sie die Browserregisterkarte aus, die die zu automatisierende Webanwendung rendert.

• Ziel auf Bildschirm anzeigen – Geben Sie das UI-Element an, das als Ziel verwendet werden soll.

  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.

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.

Optionen

• Klicktyp – Wählen Sie im Dropdownmenü den Typ des auszuführenden Klicks aus: Einfach, Doppelt, Nach untenoder Nach oben. Die Standardoption ist Single.
• Maustaste – Wählen Sie im Dropdownmenü die Maustaste aus, mit der geklickt werden soll: Links, Mitteoder Rechts. Die Standardoption ist Left.
• Zusatztasten – Fügen Sie einen oder mehrere Zusatztasten hinzu, die in Kombination mit dem Klick verwendet werden sollen. Die folgenden Optionen sind verfügbar: Alt, Ctrl, Shiftund Win.

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

  • Wie Browser – Verwenden Sie die Einstellung Eingabemodus aus der übergeordneten Aktivität Use Browser .
  • Chromium-API – Führt Actions mithilfe von Debugger-APIs aus. Funktioniert nur für Chrome- und Edge-Elemente. Sendet den gesamten Text auf einmal. Funktioniert, wenn die Ziel-App nicht im Fokus steht.
  • Simulate – Simuliert den Klick mithilfe von Barrierefreiheits-APIs. Funktioniert für Browser. Sendet den gesamten Text auf einmal. Diese Eingabemethode funktioniert im Hintergrund (auch wenn die Ziel-App nicht im Fokus ist).

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.