Screenshot anfertigen (Take Screenshot)

UiPath.UIAutomationNext.Activities.NTakeScreenshot

Beschreibung

Erstellt einen Screenshot eines angegebenen UI-Elements oder einer bestimmten Anwendung und speichert ihn als Bilddatei.

Diese Aktivität kann sowohl innerhalb als auch außerhalb der Aktivität Use Application/Browser verwendet werden.

Wenn es innerhalb einer Use Application/Browser- Aktivität hinzugefügt wird, wird nur die Zielanwendung erfasst. Beim Hinzufügen außerhalb einer Anwendungskarte wird der gesamte Desktop erfasst, da kein Ziel angegeben ist.

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

• Ausgabe in – Verwenden Sie die Optionsfelder, um den Ausgabetyp auszuwählen:

  • Datei – Speichert den Screenshot in einer Datei an einem bestimmten Speicherort. Die Standardoption.
  • Bild – Speichert den Screenshot im angegebenen Bild.
  • Zwischenablage – Speichert den Screenshot als Bild in der Zwischenablage zur späteren Verwendung.
• Dateiname – Der Name der Datei, in der der Screenshot des angegebenen UI-Elements gespeichert wird. Klicken Sie auf Nach Datei suchen, navigieren Sie zu dem Ordner, in dem der Screenshot gespeichert werden soll, und geben Sie den Dateinamen und die Erweiterung an, die verwendet werden soll.

• Automatisch erhöhen – Wählen Sie aus, was beim Speichern des Screenshots an den Dateinamen angehängt werden soll, wenn Dateinamenskonflikte auftreten. Wenn z. B. eine Datei mit demselben Namen wie die von Ihnen gespeicherte bereits vorhanden ist, wird bei Auswahl von Index der Dateiname beibehalten, eine neue Datei wird für jeden Screenshot erstellt und nacheinander eine Indexnummer hinzugefügt.

  • Keine (überschreiben) – Wenn bereits eine Datei mit demselben Namen vorhanden ist, ersetzen Sie sie.
  • Index – Fügen Sie dem Dateinamen eine Zahl hinzu, z. B. screenshot (1).png.
  • YYYY.MM.DD at HH.MM.SS – Fügen Sie das Datum und die Uhrzeit der Screenshot-Erstellung zum Dateinamen hinzu, z. B. screenshot 2020.06.22 at 10:22:32.

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

• Automatische Erhöhung – Siehe Automatische Erhöhung im Panel Designer.
• Dateiname – Siehe Dateiname im Panel Designer (Designer).
• 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.
  • 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.

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.

Ausgabe

• Pfad der gespeichertenDatei – Der vollständige Pfad zu der Datei, in der der Screenshot gespeichert werden soll, einschließlich des angehängten Suffixes, falls zutreffend. Dies bestimmt auch, wo die Eigenschaft Automatisch erhöhen die indizierten Screenshot -Dateien speichert.
• Gespeichertes Bild – Der als Bildgespeicherte Screenshot; Wird verwendet, wenn die Ausgabe auf imagefestgelegt ist.

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.

• Screenshot-Container – Wählen Sie zwischen Gesamte Seite und Element aus, um entweder einen Screenshot der gesamten Seite oder einen Screenshot eines einzelnen Elements zu erstellen. Die Standardoption ist Gesamte Seite.

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

• Dateiname – Der Name der Datei, in der der Screenshot des angegebenen UI-Elements gespeichert wird.
• Automatisch inkrementieren – Definiert, was im Falle von Dateinamenskonflikten an den Dateinamen angefügt werden soll. Wählen Sie eine Option aus dem Dropdown-Menü aus:
  • JJJJ.MM.TT um HH.MM.SS – Wenn eine Datei mit dem angegebenen Namen bereits vorhanden ist, wird eine neue Datei mit dem Namen Filename YYYY.MM.DD at HH.MM.SSerstellt. Wenn eine Datei mit dem Dateinamen Filename YYYY.MM.DD at HH.MM.SS bereits vorhanden ist und ein Index hinzugefügt wird, ähnlich wie beim Index, was zu einer Datei mit dem Namen Filename YYYY.MM.DD at HH.MM.SS (1)führt.
  • Index - Wenn bereits eine oder mehrere Dateien, die dem Muster Filename (XX) entsprechen, vorhanden sind, wird eine neue Datei mit dem Namen Filename (N+1)erstellt, wobei N der maximale Index der vorhandenen Dateien ist.
  • Keine (überschreiben) – Der Dateiname wird genau wie angegeben sein, und falls bereits eine andere Datei mit demselben Namen vorhanden ist, wird diese überschrieben. Dies ist die Standardoption.

Eingang/Ausgang

• Screenshot-Datei – Der Screenshot, der als .png -Datei gespeichert wird.
• 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.