Check App State

UiPath.UIAutomationNext.Activities.NCheckState

Beschreibung

Überprüft den Status einer Anwendung oder eines Webbrowsers, indem überprüft wird, ob ein Element auf der Benutzeroberfläche angezeigt wird oder nicht, und kann einen Satz von Aktivitäten ausführen, wenn das Element gefunden wird, und einen anderen Satz von Aktivitäten ausführen, wenn das Element nicht gefunden wird.

Er kann eine gesamte Anwendung auf Änderungen überwachen, nicht nur ein einzelnes UI-Element.

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

Kann auch als Bedingung für die Aktivität Retry Scope verwendet werden.

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.
• 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:
  • Indicate target on screen - Indicate the target again.
  • Ziel bearbeiten – Öffnet den Auswahlmodus, um das Ziel zu konfigurieren.
• Wait for (appear/disappear) - Select which event to use for determining the state of the application or browser:
  • Element to appear - Wait for the element to appear in the user interface. If you select this option:
    • Fügen Sie die Aktivitäten hinzu, die ausgeführt werden sollen, wenn das Element im IfExists- Block angezeigt wird.
    • Fügen Sie die Aktivitäten hinzu, die ausgeführt werden sollen, wenn das Element nicht im IfNotExists- Block angezeigt wird.
  • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
    • Fügen Sie die Aktivitäten hinzu, die ausgeführt werden sollen, wenn das Element im IfExists- Block ausgeblendet wird.
    • Fügen Sie die Aktivitäten hinzu, die ausgeführt werden sollen, wenn das Element nicht im IfNotExists- Block verschwindet.
• Timeout (Sekunden) – Die Zeitspanne die gewartet werden soll, bis das Element angezeigt wird oder verschwindet, bevor einer der beiden Aktivitätsblöcke ausgeführt wird. Standardmäßig auf 5 Sekunden festgelegt.

Eigenschaften-Panel

Eingang/Ausgang

• Status - Ein Wert von "true" oder "false", der den erkannten Status des Ziels angibt.
• 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.

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.
  • Deaktiviert – Schaltet den Healing Agent für diese Aktivität aus.
  • Auftragseinstellungen erben – Wendet die in Governance oder im Orchestrator auf Prozess- oder Auftragsebene definierten Einstellungen an.
  • 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.
  • Wie App/Browser – Übernimmt die Konfiguration von der übergeordneten Aktivität Use Application/Browser .

Ziel

• Zieleigenschaften erweitern – Ziel- und Ankereigenschaften anzeigen. Dadurch werden die anderen Aktivitätseigenschaften ausgeblendet und nur diejenigen angezeigt, die sich auf das Ziel beziehen.

• Zieleigenschaften reduzieren – Ziel- und Ankereigenschaften ausblenden. Dadurch werden zielbezogene Eigenschaften ausgeblendet und die Aktivitätseigenschaften angezeigt.

• 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 – Der für das Ziel-UI-Element generierte strikte Selektor.
  • Fuzzy-Selektor – Die Parameter des Fuzzy-Selektors.
  • 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.
    • 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.
    • CV-Textvorkommen – Gibt ein bestimmtes Vorkommen an, das verwendet werden soll, wenn mehrere Übereinstimmungen gefunden werden.
    • CV-Textgenauigkeit – Gibt die Genauigkeitsstufe für den OCR-Textabgleich an.
  • 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.
  • Bild (Nur Windows)
    • Bildgenauigkeit – Gibt die Genauigkeitsstufe für den Bildabgleich an.
    • Bildvorkommen – Gibt ein bestimmtes Vorkommen an, das verwendet werden soll, wenn mehrere Übereinstimmungen gefunden werden.
  • Nativer Text (nur Windows)
    • Nativer Text – Der zu suchende Text zur Identifizierung des UI-Elements.
    • Vorkommen von nativem Text – Gibt ein bestimmtes Vorkommen an, das verwendet werden soll, wenn mehrere Übereinstimmungen gefunden werden.

• Fensterselektor (Anwendungsinstanz) – Selektor für das Anwendungsfenster. Nur anwendbar, wenn der Anhängemodus für Fenster auf die Anwendungsinstanz festgelegt ist.

• Auf Laden der Seite warten – Wartet vor der Ausführung der Aktion, bis die Anwendung zum Akzeptieren von Eingaben bereit ist. Die Optionen sind:

  • 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 – Wenn diese Option aktiviert ist, prüft die Aktivität auch, 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.

• Reaktionsfähige Websites – Aktivieren Sie das Layout für reaktionsfähige Websites.

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.

• Sichtbarkeit überprüfen – Wenn diese Option aktiviert ist, prüft die Aktivität auch, ob das UI-Element sichtbar ist oder nicht.

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.
• In einer beliebigen App anzeigen – Wenn sie innerhalb einer Aktivität vom Typ Use Application/Browser verwendet werden, können Sie diese Option auswählen, um den Anwendungsstatus für Fenster oder Elemente zu überprüfen, die nicht mit der aktuellen Anwendungsinstanz verknüpft sind, ohne eine neue Anwendungskarte hinzufügen zu müssen.
• Informativen Screenshot entfernen – Entfernt 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.

• Wait for - Select which event to use for determining the state of the application or browser:
  • Element to appear - Wait for the element to appear in the user interface. If you select this option:
    • Add the activities to execute if the element appears in the Target appears block.
    • Add the activities to execute if the element does not appear in the Target does not appear block.
  • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
    • Add the activities to execute if the element disappears in the Target disappears block.
    • Add the activities to execute if the element does not disappear in the Target does not disappear block.
• Sekunden – Die Zeitspanne, die gewartet werden soll, bis das Element angezeigt wird oder verschwindet, bevor einer der beiden Aktivitätsblöcke ausgeführt wird. Sie können einen vordefinierten Wert aus dem Dropdownmenü auswählen. Standardmäßig auf 5 Sekunden festgelegt.
• Klicken Sie im Textkörper der Aktivität auf Verzweigungen umschalten , um die Sichtbarkeit der Container Ziel wird angezeigt und Ziel wird nicht angezeigt zu konfigurieren, in denen Sie Aktivitäten zur Ausführung hinzufügen können, je nach Status. Sie können mit beiden Containern arbeiten, entweder mit einem von ihnen oder keinem. Standardmäßig sind beide Blöcke sichtbar.

Eigenschaften-Panel

Allgemein

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

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

• Timeout (Sekunden) – Siehe Sekunden im Designer-Panel.

• Warten auf (erscheinen/verschwinden) – Siehe Warten auf im Designer-Panel.

• Ergebnis - Gibt an, ob das Element vorhanden ist oder nicht. Das Feld unterstützt nur Boolean -Variablen. Optional können Sie diesen Wert (True/False) für die spätere Verwendung speichern oder in einer Zelle in einer übergeordneten Excel-Datei oder im Projekt-Notebook speichern.