Auf Bild verschwinden (On Image Vanish)

UiPath.Core.Activities.OnImageVanish

Ein Container, der auf das Verschwinden eines Bilds wartet und verschiedene andere Aktivitäten mit ausführen kann.

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.
• Target.TimeoutMS – Gibt die Zeit (in Millisekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor der Fehler SelectorNotFoundException ausgegeben wird. 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 – 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.
  2. 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.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.

Allgemein

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

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.

Optionen

• WiederholenImmer (RepeatForever) - Gibt an, ob die Aktivität das Ereignis dauerhaft überwacht. Dieses Feld unterstützt nur boolesche Werte (Wahr, Falsch). Wahr - der Block wird jedes Mal ausgeführt, wenn das angegebene Bild erscheint; dies ist der Standardwert. Falsch - die Aktivität wird nur ein Mal ausgeführt.

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 „Wait Image Vanish“

Die Aktivität On Image Vanish überprüft, wann ein bestimmtes Bild von einer Website verschwindet. Diese Aktivität wird zum Überprüfen des Flows von einer Website verwendet und kann als Trigger für einen automatisierten Prozess verwendet werden.

Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Beispiel erstellt, das einen Geschwindigkeitstest auf einer ausgewählten Website durchführt und ihr eine bestimmte Leistungsbewertung zuweist. Der automatisierte Prozess öffnet einen Browser und überprüft, wann das Bild verschwindet. Dies zeigt an, dass der Test gestartet wurde. Eine zweite On Image Vanish-Aktivität überprüft die Fertigstellung des Tests.

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.

   • Erstellen Sie die folgende Variable:

     Variablenname	Variablentyp	Standardwert
     website	String

3. Ziehen Sie eine Input Dialog-Aktivität in den Sequence-Container.

   • Fügen Sie im Panel Eigenschaften den Ausdruck "Insert Website URL" im Feld Beschriftung hinzu.
   • Fügen Sie den Ausdruck "Website" in das Feld Titel ein.
   • Fügen Sie die Variable website in das Feld Ergebnis ein.

4. Platzieren Sie eine Open Browser-Aktivität unter die Input Dialog-Aktivität.

   • Fügen Sie den Ausdruck "https://tools.pingdom.com" in das Feld Url ein.
   • Wählen Sie im Feld Eigenschaften die Option IE in der Dropdownliste Browsertyp aus.
   • Aktivieren Sie das Kontrollkästchen für die Option NeueSitzung. Dadurch wird eine neue Sitzung des ausgewählten Browsers gestartet.

5. Fügen Sie eine Type Into-Aktivität im Container Ausführen der Aktivität Open Browser hinzu.

   • Wählen Sie im Bereich Eigenschaften die Option Target in der Dropdownliste Ziel aus.
   • Fügen Sie den Ausdruck "<webctrl id='urlInput' tag='INPUT' />" in das Feld Selektor ein.
   • Wählen Sie die Option INTERACTIVE in der Dropdownliste WartenAufBereitschaft aus.
   • Fügen Sie die Variable website in das Feld Text ein.
   • Aktivieren Sie das Kontrollkästchen für die Option Aktivieren. Damit wird der Browser in den Vordergrund gebracht und aktiviert, bevor der Text geschrieben wird.

6. Setzen Sie eine Click-Aktivität unter die Type Into-Aktivität.

   • Fügen Sie im Bereich Eigenschaften den Wert 1000 in das Feld VerzögernNach ein.
   • Wählen Sie in der Dropdownliste Klicktyp die Option CLICK_SINGLE 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 "<webctrl tag='INPUT' type='submit' />" in das Feld Selektor ein.
   • Wählen Sie die Option INTERACTIVE in der Dropdownliste WartenAufBereitschaft aus.
   • Wählen Sie in der Dropdownliste CursorPosition die Option CursorPosition aus.
   • Wählen Sie in der Dropdownliste Position die Option Center aus.
   • Wählen Sie in der Dropdownliste Zusatztasten die Option None aus.

7. Ziehen Sie eine Delay-Aktivität unter die Click-Aktivität.

   • Fügen Sie im Bereich Eigenschaften den Wert 00:00:02 in das Feld Dauer ein. Dadurch wird eine Verzögerung von zwei Sekunden zwischen den Aktivitäten hinzugefügt.

8. Platzieren Sie eine On Image Vanish-Aktivität unter der Delay-Aktivität.

   • Wählen Sie im Feld Eigenschaften die Option ImageTarget in der Dropdownliste Bild aus.
   • Fügen Sie den Wert 0.8 in das Feld Genauigkeit ein.
   • Wählen Sie in der Dropdownliste Profil die Option Basic aus.
   • Wählen Sie in der Dropdownliste Ziel die Option Target aus.
   • Wählen Sie die Option INTERACTIVE in der Dropdownliste WartenAufBereitschaft aus.
   • Fügen Sie den Wert False in das Feld FürImmerWiederholen ein.

9. Ziehen Sie eine neue On Image Vanish-Aktivität in den Ausführen-Container der vorherigen On Image Vanish- Aktivität.

   • Wählen Sie im Feld Eigenschaften die Option ImageTarget in der Dropdownliste Bild aus.
     • Fügen Sie den Wert 0.8 in das Feld Genauigkeit ein.
     • Wählen Sie in der Dropdownliste Profil die Option Basic aus.
     • Wählen Sie in der Dropdownliste Ziel die Option Target aus.
     • Fügen Sie den Ausdruck "<webctrl id='speedometer' tag='svg' />" in das Feld Selektor ein.
     • Wählen Sie die Option INTERACTIVE in der Dropdownliste WartenAufBereitschaft aus.
     • Fügen Sie den Wert False in das Feld FürImmerWiederholen ein.

   • Wählen Sie den Container Ausführen der Aktivität On Image Vanish aus und erstellen Sie die folgende Variable:

     Variablenname	Variablentyp	Standardwert
     grade	String

10. Ziehen Sie eine Get Text-Aktivität in den Ausführen-Container.

    • Wählen Sie im Bereich Eigenschaften die Option Target in der Dropdownliste Ziel aus.
    • Fügen Sie den Ausdruck "<html title='Pingdom Tools' /><webctrl parentname='Performance grade' tag='app-grade-badge' />" in das Feld Selektor ein. Dadurch wird die Leistungsbewertung von der Website abgerufen und der Wert in der Variablen grade gespeichert.
    • Wählen Sie die Option INTERACTIVE in der Dropdownliste WartenAufBereitschaft aus.
    • Fügen Sie die Variable grade im Feld Wert hinzu.

11. Platzieren Sie eine Message Box-Aktivität unter der Aktivität Get Text.

    • Wählen Sie im Bereich Eigenschaften die Option Ok aus der Dropdownliste Schaltflächen aus.
    • Fügen Sie den Ausdruck "Performance Grade is " + grade im Feld Text hinzu. Dadurch wird die Bewertung angezeigt, die die von Ihnen angegebene Website erhalten hat.
    • Aktivieren Sie das Kontrollkästchen für die Option Oberste. Dadurch wird die „Message Box“ in den Vordergrund gebracht.

12. Führen Sie den Prozess aus. Der Roboter fordert Sie zur Eingabe einer Website-Adresse auf, öffnet einen neuen Browser, greift auf die Website www.pingdom.com zu, überprüft die Leistung der hinzugefügten Adresse und gibt ein Meldungsfeld mit der Leistungsbewertung zurück.

Beispiel herunterladen