Auf Bild zeigen (Hover Image)

UiPath.Core.Activities.HoverImage

Sucht in einem UI-Element nach einem Bild und fährt darüber.

Eigenschaften

Eingabe

• Bild.Bild (Image.Image) - Ein vorhandenes Bild, nach dem gesucht werden soll. Das Feld unterstützt nur Variablen vom Typ Bild (Image).
• Bild.Richtigkeit (Image.Accuracy) - Eine Maßeinheit zwischen 0 und 1 zum Ausdruck der minimalen Ähnlichkeit zwischen dem gefundenen Bild und dem von Ihnen gesuchten Bild. Sinnvoll, wenn das gesuchte Bild sich nur leicht vom gefundenen Bild unterscheidet. Der Standardwert ist 0,8.
• Bild.Profil – Ermöglicht es Ihnen, den Bilderkennungsalgorithmus zu ändern, den Sie verwenden möchten. Standard ist der klassische Algorithmus mit durchschnittlicher Geschwindigkeit und Ressourcenkosten. Erweitert kann auf Kosten von mehr Ressourcen präzisere Ergebnisse liefern. Standardmäßig ist dieses Feld auf Standard festgelegt.
• Ziel.Selektor (Target.Selector) - Texteigenschaft zum Suchen eines bestimmten UI-Elements, wenn die Aktivität ausgeführt wird. Die Eigenschaft ist genau genommen ein XML-Fragment, das Attribute des gesuchten GUI-Elements und einige übergeordnete Elemente spezifiziert.
• Ziel.AuszeitMS (Target.TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe SelectorNotFoundException einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
• Ziel.WartenBisBereit (Target.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.
  • Interaktiv/Abgeschlossen – Wartet, bis alle UI-Elemente in der Ziel-App vorhanden sind, 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
  1. Internet Explorer - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
  2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
  • 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.Element (Target.Element) - Verwendet die Variable UIElement, die von einer anderen Aktivität zurückgegeben wird. Die Eigenschaft kann nicht zusammen mit der Auswahleigenschaft verwendet werden. Dieses Feld unterstützt nur Variablen vom Typ UIElement.
• Target.ClippingRegion - Definiert das Ausschneide-Rechteck in Pixel im Verhältnis zum UIElement in folgenden Richtungen: links, oben, rechts, unten. Es unterstützt sowohl positive als auch negative Zahlen.

Optionen

• SendenFensterNachrichten (SendWindowMessages) - Bei Auswahl wird das Herüberfahren durch das Senden einer bestimmten Nachricht an die Ziel-Anwendung ausgeführt. Diese Eingabemethode ist die schnellste und kann im Hintergrund arbeiten. Standardmäßig ist diese Methode nicht ausgewählt. Ist das Auswahlfeld nicht ausgewählt, führt die Standardmethode das Herüberfahren über den Hardware-Treiber aus. Die Standardmethode ist die langsamste, kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.
• Schlüssel-Modifikatoren – Ermöglicht Ihnen das Hinzufügen eines Schlüsselmodifikators. Die folgenden Optionen sind verfügbar: Alt, Strg, Umschalt, Win. Hinweis: Zusatztasten können nicht mit der Option „FenstermeldungenSenden“ verwendet werden. Beim Ausführen eines Workflows, der eine Aktivität mit dieser Kombination von Optionen enthält, wird kein Fehler ausgegeben.
• CursorPosition.OffsetX (CursorPosition.OffsetX) - Horizontale Verschiebung der Cursorposition entsprechend der im Feld Position ausgewählten Option.
• CursorPosition.OffsetY (CursorPosition.OffsetY) - Vertikale Verschiebung der Cursorposition entsprechend der im Feld Position ausgewählten Option.
• CursorPosition.Position (CursorPosition.Position) - Beschreibt den Startpunkt des Cursors, zuzüglich der Verschiebung durch die Eigenschaften OffsetX und OffsetY. Folgende Optionen sind verfügbar: ObenLinks (TopLeft), ObenRechts (TopRight), UntenLinks (BottomLeft), UntenRechts (BottomRight) und Mitte (Center). Standardmäßig ist Mitte (Center) ausgewählt.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

• VerzögerungMS (DelayMS) - Verzögerungszeit (in Millisekunden) nach dem Ausführen der Aktivität. Die Standardzeit sind 300 Millisekunden.

• VerzögerungVorher (DelayBefore) - Verzögerungszeit (in Millisekunden), bevor die Aktivität irgendwelche Operationen ausführt. Die Standardzeit sind 200 Millisekunden.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Beispiel für die Verwendung der Aktivität „Hover Image“

Die Aktivität Hover Image wird verwendet, um ein Bild in einem UI-Element zu durchsuchen und den Mauszeiger darüber zu bewegen.

Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Beispiel erstellt, das einen Browser öffnet, mit der Maus auf ein Bild zeigt, eine Aktion initiiert und die zugehörigen Ergebnisse für diese Aktion anzeigt.

So kann der Automatisierungsprozess erstellt werden:

1. Öffnen Sie Studio und erstellen Sie einen neuen Prozess.
2. Ziehen Sie eine Sequence-Aktivität in den Workflow-Designer.
3. Ziehen Sie eine Open Browser-Aktivität in den Sequence-Container.
   • Wählen Sie im Eigenschaftenbereich die Option IE in der Dropdownliste Browsertyp aus.
   • Fügen Sie den Ausdruck "https://www.goodreads.com/book/show/7144.Crime_and_Punishment" in das Feld Url ein.
   • Aktivieren Sie das Kontrollkästchen für die Option NeueSitzung. Mit dieser Option wird eine neue Sitzung des ausgewählten Browsers geöffnet.
4. Fügen Sie eine Hover Image-Aktivität im Container Textkörper der Aktivität Open Browser hinzu.
   • Öffnen Sie die Websiteadresse, die zuvor in der Aktivität Open Browser hinzugefügt wurde.
   • Wählen die Schaltfläche Dieses Feld unterstützt nur in der Aktivität Hover Image aus, und klicken Sie auf die Option Vom Bildschirm übernehmen. Wählen Sie das gewünschte Bild aus.
5. Ziehen Sie eine Click Image-Aktivität unter die Aktivität Hover Image.
   • Wählen Sie im Eigenschaftenbereich die Option CLICK_SINGLE aus der Dropdownliste Klicktyp aus.
   • Wählen Sie in der Dropdownliste Maustaste die Option BTN_LEFT aus.
   • Wählen Sie in der Dropdownliste Ziel die Option Target aus.
   • Fügen Sie den Ausdruck "<html title='*' /><webctrl aaname='Other editions' parentid='imagecol' tag='A' />" in das Feld Selektor ein.
   • Wählen Sie die Option INTERACTIVE in der Dropdownliste WartenAufBereitschaft aus.
6. Führen Sie den Prozess aus. Der Roboter öffnet einen neuen Browser, greift auf die Website zu, bewegt den Mauszeiger über das ausgewählte Bild und klickt auf die Schaltfläche Andere Editionen.

Beispiel herunterladen