Elementumfang (Element Scope)

Element Scope-Aktivität, die an ein vorhandenes UI-Element angefügt wird und es als Scope für mehrere untergeordnete Aktivitäten verfügbar macht.

Wichtig:

Die moderne Aktivität Element Scope ist nur in der Vorschau verfügbar.

UiPath.UIAutomationNext.Activities.NElementScope

Beschreibung

Die Aktivität Element Scope identifiziert ein einzelnes UI-Element einmal und macht es dann als Scope für jede Aktivität verfügbar, die in ihrem Textkörper platziert wird. Alle untergeordneten Aktivitäten (z. B. Click, Type Into, Get Text, Get Attribute) zielen auf Elemente relativ zu dem angegebenen Element ab, anstatt den gesamten Bildschirm erneut zu durchsuchen.

Verwenden Sie sie, wenn Sie mehrere Aktionen innerhalb desselben Containers – eine Tabellenzeile, einen Formularabschnitt, eine Karte oder einen Bereich – ausführen möchten und dabei die Selektoren kurz, stabil und schnell halten möchten.

Der Textkörper der Aktivität ist ein Container. Untergeordnete Aktivitäten, die auf das angegebene Element (oder seine Nachfolgerelemente) abzielen sollen, werden innerhalb des Textkörpers platziert. Jede untergeordnete Aktivität wird für das vom Scope erfasste Element ausgeführt, sodass Sie das übergeordnete Element nur einmal angeben.

Hinweis:

Element Scope kann innerhalb einer Use Application/Browser- Aktivität platziert werden, sodass das Element innerhalb dieses Anwendungs-/Browser-Scopes aufgelöst wird und untergeordnete Aktivitäten seine Einstellungen erben können. Er kann auch eigenständig verwendet werden, indem ein Element direkt angegeben wird.

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

• Auf Bildschirm anzeigen – Geben Sie das UI-Element an, an das Sie anhängen möchten. Sobald sie angegeben ist, zeigt die Aktivitätskarte eine Vorschau des Zielelements und seiner Anker an.
  Nachdem Sie das Ziel angegeben haben, verwalten Sie das Ziel, indem Sie die Schaltfläche für die Menüoptionen auswählen und eine der folgenden Optionen auswählen:
  • Ziel angeben – Geben Sie das Ziel erneut an. Wenn der Deskriptor im Object-Repository definiert ist, müssen Sie die Verknüpfung aufheben, bevor Sie einen Deskriptor nur für die aktuelle Aktivität angeben können.
  • Ziel bearbeiten – Öffnen Sie die Auswahlhilfe, um das Zielelement zu konfigurieren.
  • Informativen Screenshot entfernen – Entfernt den Screenshot des Zielelements.
  • Informativen Screenshot ändern – Ändert den Screenshot des Zielelements.
  • In Object Repository anzeigen – Öffnet den Bereich „Object Repository“ mit dem ausgewählten Deskriptor.
  • Verknüpfung von Object Repository aufheben – Hebt die Verknüpfung des Deskriptors mit dem Object Repository auf.
  • Zu Object-Repository hinzufügen – Fügt das aktuelle UI-Element einem Bibliotheksprojekt hinzu, aus dem es während Ihres gesamten Automatisierungsprozesses wiederverwendet werden kann.

Eigenschaften-Panel

Ziel

Das UI-Element, an das der Scope angefügt wird. Das Ziel wird konfiguriert, wenn Sie das Element auf dem Bildschirm angeben, und kann mit den folgenden Optionen verfeinert werden:

• Fensterselektor (Anwendungsinstanz) – Der Selektor für das Anwendungsfenster (Anwendung/Browser).
• Strikter Selektor – Der Selektor, der für das angegebene Element generiert wird. Ein Selektor ist ein XML-Fragment, das das Element anhand seiner Attribute identifiziert.

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.
• Eingabemodus – Gibt an, welche Technologie zur Interaktion mit dem Zielelement verwendet wird. Untergeordnete Aktivitäten innerhalb des Scope können diesen Modus erben. Die verfügbaren Optionen sind:
  • Hardwareereignisse – Fungiert wie ein richtiger Benutzer, indem es die Maus und die Tastatur über das Betriebssystem verwendet. Simuliert das menschliche Verhalten vollständig, aber einige Ereignisse können verloren gehen und die Zielanwendung muss im Fokus stehen.
  • Simulieren – Simuliert die Aktion mithilfe von Barrierefreiheits-APIs. Empfohlen für Browser, Java-basierte Apps und SAP. In der Regel zuverlässiger als Hardware-Ereignisse, sendet den gesamten Text in einer einzigen Aktion und funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Stellen Sie sicher, dass das Zielelement dies unterstützt.
  • Chromium-API – Führt Aktionen mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text auf einmal und funktioniert auch, wenn die Ziel-App nicht im Fokus steht.
  • Windows-Meldungen – Verwendet Win32-Meldungen. Empfohlen für Desktop-Apps. In der Regel zuverlässiger als Hardware-Ereignisse, sendet den gesamten Text auf einmal und funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Stellen Sie sicher, dass das Zielelement dies unterstützt.
  • Hintergrund – Wird im Hintergrund ausgeführt. Verwendet Simulieren, wenn möglich; komplexe Aktivitäten (Bild, nativer Text) werden weiterhin im Vordergrund ausgeführt.

Zeitliche Abläufe

• Timeout – Gibt an, wie lange (in Sekunden) darauf gewartet wird, dass das Zielelement gefunden wird, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden.

Hinweis:

Die Eigenschaften Verzögerung vor und Verzögerung nach werden von Element Scope nicht verwendet und sind im Designer ausgeblendet. Verzögerungseinstellungen auf Projektebene werden absichtlich nicht auf diese Aktivität angewendet.

Eingang/Ausgang

• 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 Ausgabe-Element -Eigenschaftsfeld anderer UIAutomation-Aktivitäten abgerufen werden.
• Ausgabeelement – Das aufgelöste UI-Element, gespeichert in einem UiElement -Objekt. Diese Variable kann dann an andere Aktivitäten übergeben werden, die UiElement als Eingabe akzeptieren.