Expand Tree

UiPath.UIAutomationNext.Activities.NSAPExpandTree

Beschreibung

Erweitern Sie die übergeordnete Struktur zu einem aktiven Knoten oder einem aktiven Element. Nachdem Sie das SAP-Strukturelement aus dem SAP GUI-Fenster angegeben haben, wird in der Aktivität die Strukturliste mit allen verfügbaren Knoten und Elementen angezeigt.

Projektkompatibilität

Windows – Legacy | Windows | Plattformübergreifend

Windows- und plattformübergreifende 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ü 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.
• Strukturpfad – Gibt das Strukturelement oder den Strukturknoten aus der übergeordneten Struktur an. Der aktive Knoten oder das Element wird ausgewählt. Nachdem Sie das SAP-Strukturelement im SAP-GUI-Fenster angegeben haben, wird die Strukturelementliste mit allen verfügbaren Knoten und Elementen in der Aktivität angezeigt.

Eigenschaften-Panel

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 zum Identifizieren des Elements verwenden möchten. Für diese Eigenschaft kann im Dropdownmenü eine beliebige Kombination 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 Typ des Steuerelements an, das 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 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.
• ReaktionsfähigeWebsites – Aktivieren Sie das Layout für reaktionsfähige Websites.

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.

Optionen

• Deaktiviertes Element ändern – Wenn diese Option ausgewählt ist, führt die Aktivität die Aktion aus, auch wenn das Zielelement deaktiviert ist. Der Standardwert ist False.
• Healing Agent-Modus (nur plattformübergreifend) – 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 .
• 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.

Eingang/Ausgang

• 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

Eigenschaften-Panel

• 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ü 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.
• Strukturelement – Gibt das Strukturelement oder den Strukturknoten aus der übergeordneten Struktur an. Der aktive Knoten oder das Element wird ausgewählt. Nachdem Sie das SAP-Strukturelement im SAP-GUI-Fenster angegeben haben, wird die Strukturelementliste mit allen verfügbaren Knoten und Elementen in der Aktivität angezeigt.

• 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.
  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf True festgelegt ist, wird kein Fehler beim Ausführen des Projekts erfasst.

• 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 (DisplayName) - Der Anzeigename der Aktivität.

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

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

    • 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 – 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.
• Strukturelement – Gibt das Strukturelement oder den Strukturknoten aus der übergeordneten Struktur an. Der aktive Knoten oder das Element wird ausgewählt. Nachdem Sie das SAP-Strukturelement im SAP-GUI-Fenster angegeben haben, wird die Strukturelementliste mit allen verfügbaren Knoten und Elementen in der Aktivität angezeigt.

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

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

• Deaktiviertes Element ändern – Wenn diese Option ausgewählt ist, führt die Aktivität die Actions aus, auch wenn das angegebene UI-Element deaktiviert ist. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.

  Diese Eigenschaft gilt nicht, wenn die Eigenschaft Eingabemodus auf Hardware-Ereignisse festgelegt ist.