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 sie innerhalb einer Use Application/Browser- Aktivität hinzugefügt wird, wird nur die Zielanwendung erfasst. Wenn sie außerhalb einer Anwendungskarte hinzugefügt wird, 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- und plattformübergreifende Konfiguration

• In Scope arbeiten – Wählen Sie die Browserregisterkarte aus, die die zu automatisierende Webanwendung anzeigt, wenn die Aktivität Screenshot erstellen auf verschachtelten Use Application/Browser -Karten platziert wird.

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

• Ziel auf Bildschirm anzeigen – Geben Sie das UI-Element an, das als Ziel verwendet werden soll. Diese Schaltfläche ist nur verfügbar, wenn die Option Element als Screenshot-Container ausgewählt ist . Nachdem Sie das Ziel angegeben haben, klicken Sie auf das Hamburger-Menü neben dem informativen Screenshot, um auf die folgenden Optionen zuzugreifen:

  • Ziel anzeigen – Geben Sie das Ziel erneut an. Wenn der Deskriptor im Object-Repository definiert ist, müssen Sie die Verbindung zum Object-Repository trennen, wenn Sie einen Deskriptor nur für die aktuelle Aktivität angeben möchten.
  • Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
  • Informativen Screenshot entfernen – Entfernt den Screenshot der Zielanwendung oder Webseite.
  • Informativen Screenshot ändern – Ändern 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. Diese Option wird nur angezeigt, wenn das Objekt noch nicht zum Objekt-Repository hinzugefügt wurde.
  • In Object Repository anzeigen – Öffnet den Bereich Object Repository mit dem ausgewählten Deskriptor. Diese Option wird nur angezeigt, wenn das Objekt dem Object-Repository hinzugefügt wurde.
  • Verknüpfung von Object Repository aufheben – Hebt die Verknüpfung des Deskriptors mit dem Object Repository auf. Diese Option wird nur angezeigt, wenn das Objekt dem Object-Repository hinzugefügt wurde.

• Ausgabe in (nur für Windows-Projekte verfügbar) – Verwenden Sie die Optionsfelder, um den Ausgabetyp auszuwählen:

  • Datei – Speichert den Screenshot an einem bestimmten Speicherort in einer Datei. Die Standardoption.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.

• Dateiname – Der Name der Datei, in der der Screenshot des angegebenen UI-Elements gespeichert wird.

• Automatische Erhöhung – Definiert, was im Falle von Dateinamenskonflikten an den Dateinamen angefügt werden soll. Wählen Sie eine Option aus dem Dropdownmenü aus:

  • Keine (überschreiben) - Der Dateiname wird genau wie angegeben sein, und falls bereits eine andere Datei mit demselben Namen existiert, wird diese überschrieben. Dies ist die Standardoption.
  • Index - Wenn eine oder mehrere Dateien, die dem Muster Filename (XX) entsprechen, bereits vorhanden sind, wird eine neue Datei mit dem Namen Filename (N+1) erstellt, wobei N der maximale Index aus den vorhandenen Dateien ist.
  • 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.SS erstellt. 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 im Fall Index, ergibt sich eine Datei mit dem Namen Filename YYYY.MM.DD at HH.MM.SS (1).

Eigenschaften-Panel

Ziel Dieser Abschnitt ist nur verfügbar, wenn die Option Element als Screenshot-Container ausgewählt ist .

• Schaltfläche „Zieleigenschaften erweitern“/„Zieleigenschaften reduzieren“ – Zeigt den Zielcontainer und seine Ankereigenschaften an/ausgeblendet.
• Zielmethoden – Die Selektortypen, die Sie zur Identifizierung des Elements verwenden möchten. Diese Eigenschaft kann auf eine beliebige Kombination im Dropdownmenü festgelegt werden, und mindestens eine Zielmethode muss ausgewählt sein:
  • Strikter Selektor
  • Fuzzy-Selektor
  • Bild (nur für Windows-Projekte verfügbar)
  • Nativer Text (nur für Windows-Projekte verfügbar)
  • Computer Vision
  • Semantischer Selektor
• Fensterselektor (Anwendungsinstanz) – Der Selektor, der für das Anwendungsfenster verwendet wird. Nur anwendbar, wenn der Anhängemodus für Fenster auf Anwendungsinstanz festgelegt ist.
• Strikter Selektor – Der für das UI-Element generierte strikte Selektor. Wird nur angezeigt, wenn die Zielmethode „Strikte Auswahl“ ausgewählt wurde.
• Fuzzy-Selektor – Die Parameter für den Fuzzy-Selektor. Wird nur angezeigt, wenn die Zielmethode „Fuzzy-Auswahl“ ausgewählt wurde.
• Bildgenauigkeit – Gibt die Genauigkeitsstufe für den Bildabgleich an. Der Standardwert ist 0,8. Wird nur angezeigt, wenn die Bildzielmethode ausgewählt wurde.
• Bildvorkommen – Gibt ein bestimmtes Vorkommen an, wenn mehrere Übereinstimmungen gefunden werden. Wird nur angezeigt, wenn die Bildzielmethode ausgewählt wurde.
• Nativer Text – Der Text, der zum Identifizieren des UI-Elements verwendet wird. Wird nur angezeigt, wenn die native Zielmethode ausgewählt wurde.
• Vorkommen von nativem Text – Gibt ein bestimmtes Vorkommen an, das verwendet werden soll, wenn mehrere Übereinstimmungen gefunden werden. Wird nur angezeigt, wenn die native Zielmethode ausgewählt wurde.
• Beim nativen Text wird zwischen Groß- und Kleinschreibung unterschieden – Gibt an, ob beim Abgleichen von Text die Groß-/Kleinschreibung beachtet wird. Wird nur angezeigt, wenn die native Zielmethode ausgewählt wurde.
• CV-Steuerelementtyp – Gibt den Steuerelementtyp an, der mithilfe von Computer Vision identifiziert wurde. Wird nur angezeigt, wenn die Computer Vision- Zielmethode ausgewählt wurde.
• CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde. Wird nur angezeigt, wenn die Computer Vision- Zielmethode ausgewählt wurde.
• CV-Textgenauigkeit – Gibt die Genauigkeitsstufe für den OCR-Textabgleich an. Der Standardwert ist 0,7. Wird nur angezeigt, wenn die Computer Vision- Zielmethode ausgewählt wurde.
• CV-Textvorkommen – Gibt ein bestimmtes Vorkommen an, wenn mehrere Übereinstimmungen gefunden werden. Wird nur angezeigt, wenn die Computer Vision- Zielmethode ausgewählt wurde.
• Semantischer Selektor – Eine semantische Beschreibung, die das Ziel definiert. Wird nur angezeigt, wenn die semantische Zielmethode ausgewählt wurde.
• Auf Laden der Seite warten – Wartet vor der Ausführung der Aktion, bis die Anwendung zum Akzeptieren von Eingaben bereit ist. Sie können eine der drei Optionen aus dem Dropdownmenü 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.
• Sichtbarkeitsprüfung – Überprüft, ob das UI-Element sichtbar ist oder nicht. Sie können eine der drei Optionen aus dem Dropdownmenü auswählen:
  • Keine – Prüft nicht die Sichtbarkeit.
  • Interaktiv (für den 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 verborgen sind.
  • Vollständig sichtbar – Überprüft, ob das UI-Element sichtbar ist oder nicht.
• Reaktionsfähige Websites – Aktivieren Sie das Layout für reaktionsfähige Websites.
• Ziel – Clippingbereich – Gibt einen Clippingbereich an, der weiter konfiguriert werden kann. Es kann verwendet werden, um einen kleineren/größeren Bereich des UI-Elements festzulegen, das zur Laufzeit mithilfe des Selektors des Ziels gefunden oder direkt über die Eingabeelement- Eigenschaft des Ziels bereitgestellt wird.
  • Ankerpunkt – Beschreibt den Startpunkt des Cursors, zu dem er durch die Eigenschaften Offset X und Offset Y verschoben wird. Die folgenden Optionen sind verfügbar: ObenLinks, ObenRechts, UntenLinks, UntenRechts und Mitte (standardmäßig ausgewählt).
  • Offset X - Horizontale Verschiebung der Region entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32- Variablen.
  • Offset Y - Vertikale Verschiebung der Region entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32- Variablen.
  • Offset-Breite - Breite des Offset-Bereichs.
  • Offsethöhe – Höhe des Offsetbereichs.

Optionen

• Healing Agent-Modus – Konfiguriert das Verhalten des Healing Agent für diese Aktivität basierend auf Governance- oder Orchestrator-Einstellungen auf Prozess- oder Auftragsebene.

  • Wie App/Browser – Übernimmt die Konfiguration von der übergeordneten Aktivität Use Application/Browser .
  • Auftragseinstellungen erben – Wendet die in Governance oder im Orchestrator auf Prozess- oder Auftragsebene definierten Einstellungen an.
  • Deaktiviert – Schaltet den Healing Agent für diese Aktivität aus.
  • Nur Empfehlungen – Ermöglicht es dem Healing Agent, Empfehlungen zur Behebung von UI-Automatisierungsproblemen bei der Ausführung von Aufträgen abzugeben, allerdings nur, wenn die Governance- oder Orchestrator-Einstellungen dies zulassen.

• Bei Fehler fortsetzen – 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 „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

Zeitliche Abläufe

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• 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.

Eingang/Ausgang

• Screenshotdatei – Der als .png -Datei gespeicherte Screenshot.
• Ausgabeelement – Gibt ein Ziel-UI-Element aus und speichert es in einem UIElement- Objekt, das weiter verwendet werden kann, um mit anderen Aktivitäten auf dasselbe Element abzuzielen.
• Eingabeelement - Das UI-Element, auf dem 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.

Windows – Legacy-Konfiguration

• Wählen Sie In App/Browser anzeigen aus , um das UI-Element anzugeben, das als Ziel verwendet werden soll.

Nachdem Sie das Ziel angegeben haben, wählen Sie das Menüaus Taste, um auf die folgenden Optionen zuzugreifen:

• Indicate target on screen - Indicate the target again.
• Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
• Informativen Screenshot entfernen – Entfernt den Screenshot der Zielanwendung oder Webseite.

• Ausgabe in – Verwenden Sie die Optionsfelder, um den Ausgabetyp auszuwählen:
  • Datei – Speichert den Screenshot an einem bestimmten Speicherort in einer Datei. Die Standardoption.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.
• Dateiname – Der Name der Datei, in der der Screenshot des angegebenen UI-Elements gespeichert wird. Klicken Sie auf Nach Datei suchen, navigieren Sie dann zu dem Ordner, in dem der Screenshot gespeichert werden soll, und geben Sie den Dateinamen und die zu verwendende Erweiterung an.
• Auto increment - Select what to append to the filename when saving the screenshot in case of filename conflicts. For example, if a file with the same name as the one you save already exists, choosing Index keeps the file name, creating a new file for each screenshot and adding an index number to each, consecutively.
  • None (overwrite) - If a file with the same name already exists, replace it.
  • Index - Add a number to the filename, for example screenshot (1).png.
  • YYYY.MM.DD at HH.MM.SS - Add the date and time when the screenshot is taken to the filename, for example screenshot 2020.06.22 at 10:22:32.

Eigenschaften-Panel

Allgemein

• Bei Fehler fortsetzen – 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 „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

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

• Automatische Erhöhung – Siehe Automatische Erhöhung im Designer-Panel.

• Dateiname – Siehe Dateiname im Designer-Panel.

• Ziel – Das Zielelement. Zielelement muss festgelegt sein. Vor der Anzeige auf dem Bildschirm wird dieses Feld auf (null) festgelegt. Sobald das Ziel angegeben wurde, werden alle Eigenschaften in Bezug auf das angegebene Element angezeigt.

  • CV-Steuerelementtyp – Gibt den Steuerelementtyp an, der mithilfe von Computer Vision identifiziert wurde.
  • CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Nativer Text – Der Text, der zum Identifizieren des UI-Elements verwendet wird.
  • Reaktionsfähige Websites – Aktivieren Sie das Layout für reaktionsfähige Websites.
  • Strikter Selektor – Der für das UI-Element generierte strikte Selektor.
  • Zielmethoden – Die Selektortypen, die Sie zur Identifizierung des Elements verwenden möchten. Diese Eigenschaft kann auf eine beliebige Kombination im Dropdownmenü 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.
    • Semantischer Selektor – Nutzt große Sprachmodelle (LLMs), um funktionale, menschenähnliche Beschreibungen von UI-Elementen zu generieren. Diese Beschreibungen sind sehr zuverlässig, wodurch sie an Änderungen der Benutzeroberfläche angepasst werden können und die Belastbarkeit der Automatisierung erheblich verbessert wird, wenn herkömmliche Selektoren fehlschlagen.
  • Sichtbarkeitsprüfung – Überprüft, ob das UI-Element sichtbar ist oder nicht. Sie können eine der drei Optionen aus dem Dropdownmenü auswählen:
    • Keine – Prüft nicht die 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 verborgen sind.
    • Vollständig sichtbar
      • Überprüft, ob das UI-Element sichtbar ist oder nicht.
  • Auf Laden der Seite warten – Wartet vor der Ausführung der Aktion, bis die Anwendung zum Akzeptieren von Eingaben bereit ist. Sie können eine der drei Optionen aus dem Dropdownmenü 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 Anhängemodus für Fenster auf Anwendungsinstanz festgelegt ist.

• Eingabeelement - Das UI-Element, auf dem 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 mit anderen Aktivitäten auf dasselbe Element abzuzielen.

• Privat - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.

• Saved file path - The full path to the file where to save the screenshot, including the appended suffix, if applicable. This also dictates where the Auto increment property saves the indexed screenshot files.

• Gespeichertes Bild – Der als Bild gespeicherte Screenshot; wird verwendet, wenn die Ausgabe auf image festgelegt ist.