IA-Connect UI
IA-Connect ist eine Roboter-Prozessautomatisierungs-RPA-Plattform, die RPA-Funktionen aus der Cloud zu lokalen virtuellen Computern oder über Citrix- oder Microsoft Remote Desktop -RDS-Verbindungen hinzufügt. Dies ist das Modul für die Benutzeroberflächenautomatisierung der Windows-Anwendung "UIA".
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Ultima Business |
| Webseite | https://www.ultima.com/ultima-labs |
| Datenschutzrichtlinie | https://www.ultima.com/privacy-policy |
| Kategorien | IT-Vorgänge; Produktivität |
IA-Connect ist eine RPA-Plattform (Robot Process Automation), die RPA-Funktionen von Power Automate Cloud Flows zu lokalen virtuellen Computern oder über Citrix- oder RdS-Verbindungen (Microsoft Remote Desktop) hinzufügt. Die IA-Connect Connectors bieten über 800 Aktionen, sodass Sie jede Art von lokaler Anwendung direkt aus einem Power Automate Cloud Flow automatisieren können. Alle IA-Connect Aktionen stehen direkt aus Ihrem Power Automate Cloud Flow zur Verfügung, die eine einfache Integration zwischen Cloud-basierten und lokalen Anwendungen ermöglicht, die Möglichkeit, vorhandene Power Automate-Bedingungen, Schleifen, dynamische Inhalte, Ausdrücke und Ausnahmebehandlung in Ihren RPA-Prozessen zu nutzen. Die Verwendung der IA-Connect Connectors bietet außerdem vollständige Ausführungsverlauf und Auditierbarkeit aus dem Flussausführungsverlauf und entfernt gleichzeitig die Notwendigkeit, eine separate Anwendung/Konsole/Studio für die Entwicklung Ihrer RPA-Prozesse zu haben.
Voraussetzungen
Um einen der IA-Connect Connectors zu verwenden, müssen Sie die IA-Connect Software installieren. Dies ist kostenlos für 30 Tage zu testen, nachdem Sie eine IA-Connect Lizenz benötigen.
Die IA-Connect Software besteht aus zwei Hauptkomponenten:
Der IA-Connect Orchestrator, bei dem es sich um eine Azure WebApp handelt, die Sie in Ihrem eigenen Azure-Mandanten hosten würden. Dies behandelt das Routing und die Sicherheit von RPA-Flüssen an einen oder mehrere lokale oder cloudbasierte virtuelle Computer.
Der IA-Connect Agent und Director, der auf den virtuellen Computern installiert ist, auf denen die Software, auf die Sie automatisieren möchten, zugänglich ist. Darüber hinaus kann der IA-Connect-Agent innerhalb einer Citrix- oder Microsoft Remote Desktop Services (RDS)-Sitzung ausgeführt werden, in der die RPA-Befehle zur Ausführung in die Remotesitzung übergeben werden. Der IA-Connect Agent kann über eine Netzwerkfreigabe ausgeführt werden und erfordert keine Installation.
Verfügbare IA-Connect Connectors
Die verfügbaren IA-Connect Connectors sind:
- dynamischer Code IA-Connect
- IA-Connect Java
- IA-Connect JML
- IA-Connect Mainframe
- IA-Connect Microsoft Office
- IA-Connect SAP-GUI
- IA-Connect-Sitzung
- IA-Connect UI
- IA-Connect Webbrowser
So erhalten Sie Anmeldeinformationen
Um Ihre Lizenz zu erhalten und Ihre 30-tägige kostenlose Testversion zu beginnen, übermitteln Sie bitte eine Anfrage auf unserer Website (https://www.ultima.com/IA-Connect/Power-Automate).
Sobald eine Testanfrage eingegangen ist, werden wir Sie über die angegebene E-Mail-Adresse kontaktieren, um die Einrichtung der IA-Connect Software zu unterstützen und Ihnen die Testlizenz zur Verfügung zu stellen. Dies ist eine voll ausgestattete Testversion und ermöglicht es Ihnen, alle 800 Aktionen in allen 9 IA-Connect Connectors innerhalb Ihrer eigenen Umgebung während des Testzeitraums zu testen.
Erste Schritte mit Ihrem Connector
Nachdem Sie eine Testanforderung für IA-Connect eingereicht haben, können Sie eine ZIP-Datei herunterladen, die die IA-Connect Software und Dokumentation enthält, die die Installation und Einrichtung abdeckt. Wir werden Sie auch kontaktieren, um Support und Anleitungen über den Installationsprozess nach Bedarf anzubieten.
Support
Während des Testzeitraums können Sie sich an Ultima Labs (IAConnect@ultima.com) wenden, um Support und Unterstützung zu erhalten.
Beim Kauf IA-Connect Lizenzen erhalten Sie Supporttoken, die für maßgeschneiderte Schulungen oder Support von Ultimas UK Technical Service Centre (TSC) eingelöst werden können.
Bekannte Probleme, häufige Fehler und HÄUFIG gestellte Fragen
Unsere Knowledge Base enthält eine Reihe von Artikeln über bekannte Probleme, häufige Fehler, die bei verwendung der IA-Connect Connectors und häufig gestellten Fragen auftreten können. Dies ist verfügbar https://support.ultima.com/ultimalabs und ein Konto für den Zugriff auf diese Ressourcen wird während der IA-Connect Testversion und beim Kauf einer IA-Connect-Lizenz bereitgestellt.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
| IA-Connect Orchestrator-Adresse | Schnur | Angeben der IA-Connect Orchestrator-Adresse ohne die HTTP(S)-Komponente | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen des UIA-Elementbeschriftungswerts |
Gibt den Wert der Beschriftung für das Element zurück. |
| Abrufen des UIA-Elements an Bildschirmkoordinaten |
Gibt das UIA-Element zurück, das sich an den angegebenen Bildschirmkoordinaten befindet. |
| Abrufen des UIA-Elementsuchmodus |
Ruft ab, welcher UIA-Elementsuchmodus vom IA-Connect Agent für UIA-Aktionen verwendet wird. |
| Abrufen des UIA-Elementtextwerts |
Gibt den Textwert eines Elements zurück. Ein Textwert ist in der Regel einer Beschriftung zugeordnet, aber viele Elemente können diese Eigenschaft aufweisen. |
| Abrufen des UIA-Elementwerts |
Gibt den Wert eines Elements zurück. Ein Wert ist in der Regel einem Texteingabebereich zugeordnet, aber viele Elemente können diese Eigenschaft aufweisen. |
| Abrufen des UIA-Handles für das Hauptfenster des fokussierten Elements |
Gibt ein Handle für das Hauptfenster des aktuell fokussierten UIA-Elements zurück. Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. |
| Abrufen des UIA-Handles für fokussiertes Element |
Gibt ein Handle für das aktuell fokussierte UIA-Element zurück. |
| Abrufen des UIA-Handles für Win32-Fenster der obersten Ebene |
Eine schnelle Win32-Aktion, die ein UIA-Handle für jedes Win32-Fenster auf oberster Ebene zurückgibt, das den angegebenen Klassennamen oder Fenstertitel aufweist, oder Sie können erweiterte Suchfilter angeben, einschließlich Wildcards. Ein Fenster der obersten Ebene ist ein Fenster, das mit dem Desktop verbunden ist. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Das Fenster muss vorhanden sein, IA-Connect wartet nicht. Es ist häufiger, die UIA-Aktion "Ist das UIA-Desktopelement vorhanden" zu verwenden, das leistungsfähiger ist, aber diese Win32-Aktion wird in der Regel schneller ausgeführt. |
| Abrufen des übergeordneten UIA-Elementhandles |
Gibt ein Handle für das übergeordnete Element des angegebenen Elements zurück. Das übergeordnete Element wird als Element definiert, das sich auf der nächsten Ebene der UIA-Struktur befindet und fast immer ein enthaltenes Element ist. |
| Abrufen mehrerer UIA-Elemente als Tabelle |
Listet die Werte untergeordneter Elemente eines angegebenen übergeordneten Elements auf und gibt in einem Tabellenformat zurück. Dies kann verwendet werden, um Zeilen und Spalten von Daten aus Elementen zurückzugeben, die technisch keine Tabellen sind, aber in einer Tabellenstruktur angeordnet wurden. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung dieser Aktion abzurufen, die als Agent-Thread ausgeführt wird. |
| Abrufen mehrerer UIA-Elementeigenschaften |
Gibt die Eigenschaften mehrerer Elemente zurück. Dies kann hilfreich sein, wenn Sie unsicher sind, welche Felder die erforderlichen Eigenschaftswerte enthalten. |
| Abrufen mehrerer übergeordneter UIA-Elementeigenschaften |
Gibt eine hierarchische Struktur der übergeordneten Elemente des angegebenen Elements zurück, bis zur Desktopebene (Stammebene). Das übergeordnete Element wird als Element definiert, das sich auf der nächsten Ebene der UIA-Struktur befindet und fast immer ein enthaltenes Element ist. |
| Abrufen von UIA-Datagrid-Elementeigenschaften |
Gibt Tabelleneigenschaften eines DataGrid-Elements zurück. Dies ist ein Element mit Zeilen, Spalten, Kopfzeilen und Zellen (d. h. einer Tabelle). |
| Abrufen von UIA-Datagrid-Elementinhalten |
Gibt den Inhalt eines Datagrid-Elements zurück. Dies ist ein Element mit Zeilen, Spalten, Kopfzeilen und Zellen (d. h. einer Tabelle). Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung dieser Aktion abzurufen, die als Agent-Thread ausgeführt wird. |
| Abrufen von UIA-Desktopelementen |
Gibt eine Liste aller Fenster und Dialogfelder auf dem Desktop zurück. |
| Abrufen von UIA-Elementeigenschaften |
Gibt alle Eigenschaften eines Elements zurück. Dies kann hilfreich sein, wenn Sie unsicher sind, welches Feld die erforderlichen Eigenschaftswerte enthält. |
| Abrufen von UIA-Elementeigenschaften als Liste |
Gibt die Eigenschaften eines Elements als einzelne Zeilenliste (einzelzeilenauflistung / Datentabelle) anstelle einzelner Elemente zurück, dies kann je nachdem, wie Sie die Daten verwenden möchten, nützlich sein. |
| Abrufen von UIA-Elementmustern |
Rufen Sie ab, welche UIA-Muster für ein UIA-Element verfügbar sind und welche IA-Connect UIA-Aktionen wahrscheinlich auswirkungen auf das Element haben. |
| Abrufen von UIA-Listenelementelementen |
Gibt eine Liste der untergeordneten Elementelemente zurück, die unter dem angegebenen Element gefunden werden (in der Regel Dropdown-/Menüelemente). |
| Auf sichtbares Suchbild im UIA-Element warten |
Wartet, bis ein Suchbild, das als Eingabe für diese Aktion bereitgestellt wird, sichtbar innerhalb eines UIA-Elements auf dem Bildschirm gespeichert wurde oder die angegebene Zeitspanne vergangen ist. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent einen Screenshot an den Koordinaten des Elements erstellt und im Screenshot nach dem bereitgestellten Suchbild sucht. Das UIA-Element muss von Anfang an vorhanden sein. Die Aktion wird sofort abgeschlossen, sobald sich das Bild befindet. |
| Collapse UIA-Element |
Reduziert ein Element (in der Regel ein Menü/Dropdownelement). Wenn das Element bereits reduziert ist, geschieht nichts. |
| Drücken des UIA-Elements |
Drückt ein Element (in der Regel eine Schaltfläche). |
| Eingabekennwort in das UIA-Element |
UIA-Aktion, die ein Kennwort in ein Element eingibt (in der Regel ein Kennworteingabefeld), ersetzen den vorhandenen Text. |
| Eingaberücklauf in UIA-Element |
Gibt eine Windows-Rückgabe-/neue Zeile in ein Element ein (in der Regel ein Texteingabefeld), entweder den vorhandenen Text zu ersetzen oder die Rückgabe an einer bestimmten Position einzufügen. |
| Eingeben von Text in mehrere UIA-Elemente |
UIA-Aktion, die unterschiedliche Textabschnitte in mehrere Elemente eingibt (in der Regel Texteingabefelder), entweder durch Ersetzen des vorhandenen Texts oder Einfügen des neuen Werts an einer bestimmten Position. |
| Eingeben von Text in UIA-Element |
UIA-Aktion, die Text in ein Element eingibt (in der Regel ein Texteingabefeld), entweder durch Ersetzen des vorhandenen Texts oder Einfügen des neuen Werts an einer bestimmten Position. |
| Enthält das Win32-Fenster |
Eine einfache und schnelle Win32-Aktion, die meldet, ob ein Prozess (mit Namen angegeben) über sichtbare Fenster verfügt. Das Fenster muss vorhanden sein: IA-Connect wartet nicht. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist. |
| Erweitern des UIA-Elements |
Erweitert ein Element (in der Regel ein Menü/Dropdownelement). Wenn das Element bereits erweitert ist, geschieht nichts. |
| Festlegen des Bildlaufprozentsatzes für UIA-Elemente |
Legen Sie den horizontalen und/oder vertikalen Bildlaufprozentsatz des angegebenen Elements fest, wenn der Bildlauf von diesem Element unterstützt wird. Wenn das Element das Bildlaufmuster unterstützt, können Sie diese Aktion direkt auf das Element anwenden und entweder einen horizontalen oder vertikalen Bildlaufbetrag (oder beides) angeben. Wenn das Element das Muster "Scrollen" nicht unterstützt, fällt diese Aktion auf die Muster "Bereichswert" oder "Wert" zurück, aber Sie müssen diese direkt auf das Bildlaufleisten-Steuerelement(n) anwenden, nicht auf das Element selbst. |
| Festlegen des Timeouts für UIA-Transaktionen |
Steuert, wie lange die UIA-API wartet, bis eine Anwendung die Informationen zu einem Element zurückgibt. Dieses Transaktionstimeout würde in der Regel nur erreicht werden, wenn die Anwendung nicht reaktionsfähig war. |
| Festlegen des UIA-Elements auf einen numerischen Bereichswert |
Legt den Wert des Elements fest, das einen numerischen Bereich aufweist, z. B. eine Bildlaufleiste. |
| Festlegen des UIA-Elements auf numerischen Wert |
Legt den Wert des Elements fest, das eine numerische Eingabe aufweist, z. B. ein Textfeld oder eine Bildlaufleiste. |
| Festlegen des UIA-Elementsuchmodus |
Wählen Sie aus, welcher UIA-Elementsuchmodus vom IA-Connect Agent beim Ausführen von UIA-Aktionen verwendet werden soll. In der Regel wird diese Aktion nur verwendet, wenn Sie ein Problem mit dem Standardmodus haben (Alle suchen). |
| Festlegen des UIA-Fensters auf "Normal" |
Normalisiert das Fenster mit dem angegebenen UIA-Ziehpunkt (d. h. legt es auf ein normales Fenster fest, anstatt minimiert oder maximiert). |
| Focus UIA-Element |
Konzentriert sich auf ein Element, das es zum aktiven Element für den Tastaturfokus macht und je nach Anwendung das Elementfenster in den Vordergrund bringen kann. |
| Global mouse click UIA element search color region |
Verschiebt die Maus über einen Pixelbereich in einem UIA-Element, das den angegebenen Farbkriterien entspricht, und führt einen Mausklick aus. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Screenshot eine Kopie des Bildschirms an der Position der Elemente erstellt. |
| Globale mittlere Mausklick auf das UIA-Element |
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element und klickt auf die mittlere Maustaste. |
| Globaler Doppelklick mit der linken Maustaste auf das UIA-Element |
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element, und doppelklicken Sie auf die linke Maustaste. |
| Globaler Eingabetext in UIA-Element |
Verschiebt die Maus in die Mitte des Elements, fokussiert es, klickt links und drückt die Tasten. Wird in der Regel mit einer Texteingabe verwendet, die keine systemeigenen UIA-Eingabemethoden akzeptiert. |
| Globaler linker Mausklick auf das UIA-Element |
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element und klickt auf die linke Maustaste. |
| Globaler Rechtsklick auf das UIA-Element |
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element und klickt auf die rechte Maustaste. |
| Globales Eingabekennwort in das UIA-Element |
Verschiebt die Maus in die Mitte des Elements, fokussiert es, klickt links und drückt die Tasten. Wird in der Regel mit einer Kennworteingabe verwendet, die systemeigene UIA-Eingabemethoden nicht akzeptiert. |
| Ist das UIA-Desktopelement vorhanden |
Gibt an, ob ein Desktopelement vorhanden ist und einige grundlegende Elementeigenschaften bereitstellt. |
| Ist das UIA-Element aktiviert |
Diese Aktion gibt "true" oder "false" zurück, der angibt, ob ein Element (in der Regel ein Kontrollkästchen oder ein Optionsfeld) aktiviert ist. |
| Ist das Win32-Fenster der obersten Ebene vorhanden |
Eine schnelle Win32-Aktion, die meldet, ob ein Win32-Fenster auf oberster Ebene vorhanden ist. Ein Fenster der obersten Ebene ist ein Fenster, das mit dem Desktop verbunden ist. Sie können nach Klassennamen oder Fenstertiteln suchen oder erweiterte Suchfilter angeben, einschließlich Wildcards. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Das Fenster muss vorhanden sein, IA-Connect wartet nicht. Es ist häufiger, die UIA-Aktion "Ist das UIA-Desktopelement vorhanden" zu verwenden, das leistungsfähiger ist, aber diese Win32-Aktion wird in der Regel schneller ausgeführt. |
| Ist UIA-Element vorhanden |
Gibt an, ob ein Element vorhanden ist, und gibt einige grundlegende Elementeigenschaften zurück. |
| Klicken Sie auf das UIA-Listenelementelement anhand des Namens. |
Klickt auf das Listenelement mit dem angegebenen Namen. Dies wird in der Regel verwendet, um ein Element in einem Dropdown-/Menüelement auszuwählen. |
| Klicken Sie nach Index auf UIA-Listenelementelement. |
Klickt auf das Listenelement, das dem angegebenen Index entspricht. Dies wird in der Regel verwendet, um ein Element in einem Dropdown-/Menüelement auszuwählen. |
| Maximieren des UIA-Fensters |
Maximiert das Fenster mit dem angegebenen UIA-Handle. |
| Minimieren des UIA-Fensters |
Minimiert das Fenster mit dem angegebenen UIA-Handle. |
| Schließen des UIA-Elementfensters |
Schließt das Elementfenster. Funktioniert in der Regel nur für Fenster oder Dialogfelder. |
| Screenshot des UIA-Elementspeicherorts erstellen |
Erstellt einen Screenshot der Position eines Elements und gibt ein Bild zurück. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Screenshot eine Kopie des Bildschirms an der Position der Elemente erstellt. |
| Suchbereich für UIA-Elemente abrufen |
Gibt die Details des Bereichs von Pixeln innerhalb eines UIA-Elements zurück, die den angegebenen Farbkriterien entsprechen. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent Farben findet, indem er einen Screenshot an den Koordinaten des Elements erstellt. |
| Suchen eines sichtbaren Suchbilds innerhalb des UIA-Elements |
Gibt zurück, ob ein Suchbild, das als Eingabe für diese Aktion bereitgestellt wird, sichtbar innerhalb eines UIA-Elements auf dem Bildschirm gespeichert wurde. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent einen Screenshot an den Koordinaten des Elements erstellt und im Screenshot nach dem bereitgestellten Suchbild sucht. |
| Suchen nach dem ersten übergeordneten UIA-Element |
Durchsucht die UIA-Strukturhierarchie nach dem ersten übergeordneten Element, das den Suchkriterien entspricht. Das übergeordnete Element wird als Element definiert, das sich auf der nächsten Ebene der UIA-Struktur befindet und fast immer ein enthaltenes Element ist. |
| UIA-Element auswählen |
Wählt ein Element aus (in der Regel ein Element in einer Liste oder Dropdownliste). |
| UIA-Element umschalten |
Schaltet ein Element um (in der Regel ein Kontrollkästchen oder ein Optionsfeld). Dadurch erhält das Element den entgegengesetzten Zustand zu seinem aktuellen Zustand (z. B. aktiviert und umgekehrt). Wenn Sie einen bestimmten Zustand festlegen möchten, verwenden Sie stattdessen die Aktion "Element überprüfen". |
| UIA-Element verschieben |
Verschiebt ein UIA-Element an eine angegebene Position auf dem Bildschirm. Diese Aktion funktioniert in der Regel nur mit Fensterelementen (die das Transformationsmuster aufweisen). |
| UIA-Handle für Desktop abrufen |
Gibt ein Handle für den Desktop zurück. Dies ist eine veraltete Aktion, da das Handle "-2" verwendet werden kann, um auf das Desktopelement zu verweisen, aber auch weil es viele Aktionen gibt, die relativ zum Desktop suchen können (z. B. "Warten auf desktopelement"). |
| UIA-Handle für Prozess-Hauptfenster abrufen |
Eine einfache und schnelle Win32-Aktion, die das Handle für ein beliebiges Hauptfenster eines Prozesses zurückgibt (mit Namen angegeben). Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Das Fenster muss vorhanden sein: IA-Connect wartet nicht. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist. |
| UIA-Handle für Prozess-ID-Hauptfenster abrufen |
Eine einfache und schnelle Win32-Aktion, die das Handle für ein beliebiges Hauptfenster eines Prozesses zurückgibt (angegeben durch Prozess-ID). Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist. |
| Vordergrund-UIA-Fenster festlegen |
Bringt ein Fenster in den Vordergrund. |
| Warten, bis das sichtbare Suchbild nicht innerhalb des UIA-Elements vorhanden ist |
Wartet, bis ein Suchbild, das als Eingabe für diese Aktion bereitgestellt wird, nicht sichtbar innerhalb eines UIA-Elements auf dem Bildschirm gefunden werden kann oder der angegebene Zeitraum vergangen ist und das Bild noch vorhanden ist. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent einen Screenshot an den Koordinaten des Elements erstellt und im Screenshot nach dem bereitgestellten Suchbild sucht. Das UIA-Element muss von Anfang an vorhanden sein. Die Aktion wird sofort abgeschlossen, sobald das Bild nicht mehr vorhanden ist. |
| Warten, bis das UIA-Desktopelement nicht vorhanden ist |
Wartet, bis ein Desktopelement (in der Regel ein Fenster) nicht mehr vorhanden ist. |
| Warten, bis das UIA-Element nicht vorhanden ist |
Wartet auf ein Element (in der Regel ein einzelnes Element innerhalb eines Fensters, z. B. eine Schaltfläche oder einen Texteingabebereich), bis es nicht mehr vorhanden ist. |
| Warten auf das Hauptfenster der UIA-Prozess-ID |
Eine einfache und schnelle Win32-Aktion, die auf ein Hauptfenster eines Prozesses (angegeben durch Prozess-ID) wartet und ein Handle zurückgibt. Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist. |
| Warten auf das Hauptfenster des UIA-Prozesses |
Eine einfache und schnelle Win32-Aktion, die vor dem Zurückgeben eines Handles auf eine angegebene Zeit wartet, bis das Hauptfenster eines Prozesses (mit Dem Namen angegeben) vorhanden ist. Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist. |
| Warten auf das UIA-Desktopelement |
Wartet, bis ein Desktopelement (in der Regel ein Fenster) vorhanden ist. |
| Warten auf das Win32-Fenster der obersten Ebene von UIA |
Eine schnelle Win32-Aktion, die auf eine angegebene Zeit wartet, bis ein Win32-Fenster auf oberster Ebene vorhanden ist, bevor ein UIA-Handle zurückgegeben wird. Ein Fenster der obersten Ebene ist ein Fenster, das mit dem Desktop verbunden ist. Sie können nach Klassennamen oder Fenstertiteln suchen oder erweiterte Suchfilter angeben, einschließlich Wildcards. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Es ist häufiger, die UIA-Aktion "Auf Desktopelement warten" zu verwenden, was leistungsfähiger ist, aber diese Win32-Aktion wird in der Regel schneller ausgeführt. |
| Warten auf UIA-Element |
Wartet auf ein Element (in der Regel ein einzelnes Element innerhalb eines Fensters, z. B. eine Schaltfläche oder einen Texteingabebereich), um vorhanden zu sein. |
| Win32-Fenster abrufen |
Eine schnelle Win32-Aktion, die eine Liste aller Win32-Fenster zurückgibt, die optional den angegebenen Klassennamen oder Fenstertitel aufweisen, oder Sie können erweiterte Suchfilter angeben, einschließlich Wildcards. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Win32 Windows kann unerwartete Elemente wie Taskleiste, Desktop, Startmenü, transparente Überlagerungen, Offscreen- oder ausgeblendete Fenster enthalten, sodass die zurückgegebene Liste möglicherweise mehr Ergebnisse als erwartet enthält. |
| Zeichnen eines Rechtecks um das UIA-Element |
Zeichnet ein Rechteck um den Umkreis eines Elements, um zu ermitteln, dass das gefundene Element die erforderliche ist. Das Rechteck wird nach 5 Sekunden automatisch entfernt. |
| Zurücksetzen aller UIA-Elementhandles |
Setzt alle UIA-Elementhandles zurück, die derzeit von IA-Connect gespeichert werden, was nützlich sein kann, wenn Sie viele Elemente identifizieren und eine große Anzahl von Elementhandles gespeichert haben. In Szenarien mit extrem hoher Anzahl von Elementhandles (100.000+) kann diese Aktion auch verwendet werden, um die RAM-Nutzung freizugeben. |
| Ändern der Größe des UIA-Elements |
Ändert die Größe eines UIA-Elements. Diese Aktion funktioniert in der Regel nur mit Fensterelementen (die das Transformationsmuster aufweisen). |
| Überprüfen des UIA-Elements |
Legt den Status eines Elements (in der Regel ein Kontrollkästchen oder ein Optionsfeld) auf aktiviert oder deaktiviert fest. |
| Überprüfen mehrerer UIA-Elemente |
Legt den Status mehrerer Elemente (in der Regel ein Kontrollkästchen oder ein Optionsfeld) auf aktiviert oder deaktiviert fest. |
Abrufen des UIA-Elementbeschriftungswerts
Gibt den Wert der Beschriftung für das Element zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Elementbeschriftungswert
|
ElementLabelValue | string |
Der Wert der Beschriftung für das Element. |
Abrufen des UIA-Elements an Bildschirmkoordinaten
Gibt das UIA-Element zurück, das sich an den angegebenen Bildschirmkoordinaten befindet.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
X-Koordinate
|
XCoord | integer |
Der X-Koordinatenwert des Bildschirms (in Pixeln), nach dem das UIA-Element gesucht werden soll. |
|
|
Y-Koordinate
|
YCoord | integer |
Der Y-Koordinatenwert (in Pixel), nach dem das UIA-Element gesucht werden soll. |
|
|
Auslösen einer Ausnahme, wenn das Element nicht gefunden wurde
|
RaiseExceptionIfElementNotFound | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn sich ein UIA-Element nicht an der angegebenen Position befindet? |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element gefunden
|
ElementFound | boolean |
Gibt true zurück, wenn ein UIA-Element an der angegebenen Position gefunden wurde. |
|
Elementhandle
|
ElementHandle | integer |
Das UIA-Handle für das Element. Dies kann als Eingabe für weitere UIA-Aktionen verwendet werden, die auf dieses Element wirken. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
Abrufen des UIA-Elementsuchmodus
Ruft ab, welcher UIA-Elementsuchmodus vom IA-Connect Agent für UIA-Aktionen verwendet wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
UIA-Elementsuchmodus
|
UIAElementSearchMode | string |
Der vom IA-Connect Agent verwendete UIA-Elementsuchmodus. |
Abrufen des UIA-Elementtextwerts
Gibt den Textwert eines Elements zurück. Ein Textwert ist in der Regel einer Beschriftung zugeordnet, aber viele Elemente können diese Eigenschaft aufweisen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Elementtextwert
|
ElementTextValue | string |
Der Textwert des Elements. |
Abrufen des UIA-Elementwerts
Gibt den Wert eines Elements zurück. Ein Wert ist in der Regel einem Texteingabebereich zugeordnet, aber viele Elemente können diese Eigenschaft aufweisen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Elementwert
|
ElementValue | string |
Der Wert des Elements. |
Abrufen des UIA-Handles für das Hauptfenster des fokussierten Elements
Gibt ein Handle für das Hauptfenster des aktuell fokussierten UIA-Elements zurück. Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
Abrufen des UIA-Handles für fokussiertes Element
Gibt ein Handle für das aktuell fokussierte UIA-Element zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
Abrufen des UIA-Handles für Win32-Fenster der obersten Ebene
Eine schnelle Win32-Aktion, die ein UIA-Handle für jedes Win32-Fenster auf oberster Ebene zurückgibt, das den angegebenen Klassennamen oder Fenstertitel aufweist, oder Sie können erweiterte Suchfilter angeben, einschließlich Wildcards. Ein Fenster der obersten Ebene ist ein Fenster, das mit dem Desktop verbunden ist. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Das Fenster muss vorhanden sein, IA-Connect wartet nicht. Es ist häufiger, die UIA-Aktion "Ist das UIA-Desktopelement vorhanden" zu verwenden, das leistungsfähiger ist, aber diese Win32-Aktion wird in der Regel schneller ausgeführt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchklassenname
|
SearchClassName | string |
Der Elementklassenname des Fensters der obersten Ebene, nach dem gesucht werden soll, z. B. "Editor". |
|
|
Titel des Suchfensters
|
SearchWindowTitle | string |
Der Titel des Fensters der obersten Ebene, nach dem gesucht werden soll. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Die optionale Prozess-ID des Prozesses, der das Fenster besitzt (z. B. wie durch die Ausgabe der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt). Auf 0 festgelegt, um nicht nach Prozess-ID zu suchen. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren auf verfügbare Fenstereigenschaften weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Titel] wie '*Excel' UND [IsMinimised] = False AND [IsResizeable] = True. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Fenster mit der Suche übereinstimmen, können Sie angeben, nach welcher Fenstereigenschaft sortiert werden soll. Dies wird zusammen mit "Index abgleichen" verwendet, um das erforderliche Fenster zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Fenster zurückgegeben, das am oberen Rand des Bildschirms liegt. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Fenster mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
Abrufen des übergeordneten UIA-Elementhandles
Gibt ein Handle für das übergeordnete Element des angegebenen Elements zurück. Das übergeordnete Element wird als Element definiert, das sich auf der nächsten Ebene der UIA-Struktur befindet und fast immer ein enthaltenes Element ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Elementhandle
|
ElementHandle | True | integer |
Das UIA-Handle für das Zielelement. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Übergeordnetes Elementhandle
|
ParentElementHandle | integer |
Ein UIA-Handle für das übergeordnete Element. |
Abrufen mehrerer UIA-Elemente als Tabelle
Listet die Werte untergeordneter Elemente eines angegebenen übergeordneten Elements auf und gibt in einem Tabellenformat zurück. Dies kann verwendet werden, um Zeilen und Spalten von Daten aus Elementen zurückzugeben, die technisch keine Tabellen sind, aber in einer Tabellenstruktur angeordnet wurden. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung dieser Aktion abzurufen, die als Agent-Thread ausgeführt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Suchzellenkopf-Unterelement des lokalisierten Steuerelementtyps
|
SearchCellHeaderSubElementLocalizedControlType | string |
Der lokalisierte Steuerelementtyp für die Zellüberschrift. Lassen Sie leer, wenn Sie nicht nach Zellüberschriften suchen. |
|
|
Suchzellenkopf-Unterelement-Steuerelementtyp
|
SearchCellHeaderSubElementControlType | integer |
Der Steuerelementtyp des Unterelements für die Zellenüberschrift (eine nicht lokalisierte ganze Zahl), nach der gesucht werden soll. Dies ist derselbe Wert in verschiedenen Sprachen. Belassen Sie bei 0, wenn Sie nicht nach Zellüberschriften suchen. |
|
|
Lokalisierter Steuerelementtyp des Suchzellenunterelements
|
SearchCellSubElementLocalizedControlType | string |
Der lokalisierte Steuerelementtyp des Zellunterelements, nach dem gesucht werden soll. |
|
|
Steuerelementtyp des Suchzellenunterelements
|
SearchCellSubElementControlType | integer |
Der Steuerelementtyp des Zellunterelements (eine nicht lokalisierte ganze Zahl), nach der gesucht werden soll. Dies ist derselbe Wert in verschiedenen Sprachen. |
|
|
Durchsuchen von Nachfolgern nach Zellunterelementen
|
SearchDescendantsForCellSubElements | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die UIA-Struktur unterhalb des gefundenen Elements nach Zellen- und Zellüberschriftenunterelementen gesucht (d. h. die Elementwerte, die die Zellen in der Ausgabetabelle auffüllen). Dies ist gründlicher, kann aber länger dauern. Sie können dies auf "false" festlegen, wenn Sie nur an Elementen direkt unterhalb des Elements interessiert sind. |
|
|
Erstes Zellenüberschriften-Unterelement, das zurückgegeben werden soll
|
FirstCellHeaderSubElementToReturn | integer |
Der Index des zurückzugebenden Unterelements für die erste Zelle, beginnend mit 1. Wenn Sie die Elemente in umgekehrter Reihenfolge (vom unteren Rand der UIA-Struktur) zurückgeben möchten, können Sie alternativ einen negativen Index ab -1 angeben. |
|
|
Max cell header subelements to return
|
MaxCellHeaderSubElementsToReturn | integer |
Die maximale Anzahl der zurückzugebenden Zellüberschriftenunterelemente oder 0, um alle Unterelemente zurückzugeben. |
|
|
Erstes Zellenunterelement, das zurückgegeben werden soll
|
FirstCellSubElementToReturn | integer |
Der Index des ersten zurückzugebenden Zellunterelements ab 1. Wenn Sie die Elemente in umgekehrter Reihenfolge (vom unteren Rand der UIA-Struktur) zurückgeben möchten, können Sie alternativ einen negativen Index ab -1 angeben. |
|
|
Max. Zellenunterelemente, die zurückgegeben werden sollen
|
MaxCellSubElementsToReturn | integer |
Die maximale Anzahl der zurückzugebenden Zellunterelemente oder 0, um alle Unterelemente zurückzugeben. |
|
|
Angeforderte Anzahl von Spalten
|
RequestedNumberOfColumns | integer |
Die Anzahl der Spalten, die In der Ausgabetabelle angezeigt werden sollen. Dieser Wert muss für das zu lesende Element korrekt sein, oder Sie erhalten unerwartete Ergebnisse. |
|
|
Priorität des Zellunterelementwerts
|
CellSubElementValuePriority | integer |
Die Priorität für die Verwendung des Zellunterelementwerts als Wert, der in der Ausgabetabelle verwendet werden soll. 1 ist höchste Priorität. 2 ist zweite Priorität. 3 ist die dritte Priorität. 0 wird nicht verwendet. |
|
|
Priorität des Textwerts des Zellunterelements
|
CellSubElementTextValuePriority | integer |
Die Priorität für die Verwendung des Textwerts des Zellunterelements als Wert, der in der Ausgabetabelle verwendet werden soll. 1 ist höchste Priorität. 2 ist zweite Priorität. 3 ist die dritte Priorität. 0 wird nicht verwendet. |
|
|
Priorität des Zellunterelementnamens
|
CellSubElementNameValuePriority | integer |
Die Priorität für die Verwendung des Zellunterelementnamens (häufig für Bezeichnungen) als Wert, der in der Ausgabetabelle verwendet werden soll. 1 ist höchste Priorität. 2 ist zweite Priorität. 3 ist die dritte Priorität. 0 wird nicht verwendet. |
|
|
Mindestbreite des Zellunterelements
|
MinimumCellSubElementWidth | integer |
Die Mindestbreite in Pixeln eines Zellunterelements, das in die Tabelle aufgenommen werden soll. |
|
|
Mindesthöhe des Zellunterelements
|
MinimumCellSubElementHeight | integer |
Die Mindesthöhe in Pixeln eines Zellunterelements, das in die Tabelle aufgenommen werden soll. |
|
|
Umgebendes Feld "Zellenunterelement durchsuchen" nach links
|
SearchCellSubElementBoundingBoxLeft | integer |
Schließen Sie nur Zellunterelemente ein, die vollständig im umgebenden Feld enthalten sind. Standardmäßig ist das umgebende Feld groß, um alle Elemente einzuschließen. |
|
|
Umgebendes Feld 'Zellenunterelement durchsuchen' rechts
|
SearchCellSubElementBoundingBoxRight | integer |
Schließen Sie nur Zellunterelemente ein, die vollständig im umgebenden Feld enthalten sind. Standardmäßig ist das umgebende Feld groß, um alle Elemente einzuschließen. |
|
|
Umgebendes Feld "Zellenunterelement durchsuchen" oben
|
SearchCellSubElementBoundingBoxTop | integer |
Schließen Sie nur Zellunterelemente ein, die vollständig im umgebenden Feld enthalten sind. Standardmäßig ist das umgebende Feld groß, um alle Elemente einzuschließen. |
|
|
Umgebendes Feld "Zellenunterelement durchsuchen" unten
|
SearchCellSubElementBoundingBoxBottom | integer |
Schließen Sie nur Zellunterelemente ein, die vollständig im umgebenden Feld enthalten sind. Standardmäßig ist das umgebende Feld groß, um alle Elemente einzuschließen. |
|
|
Tabelle als Thread lesen
|
ReadTableAsThread | boolean |
Bei Festlegung auf "false" (Standardeinstellung) liest der IA-Connect Agent die Tabelle sofort und gibt den Inhalt an den Director zurück. Wenn Sie große Tabellen lesen, kann diese Aktion zeitüberschreitungen. Wenn dieser Wert auf "true" festgelegt ist, liest der IA-Connect Agent die Tabelle als Agent-Thread und der IA-Connect Director (oder Orchestrator, PowerShell-Modul, Blue Prism) kann den Status dieses Agent-Threads überwachen und darauf warten, dass er abgeschlossen ist. Dadurch können große Tabellen ohne Timeouts gelesen werden. IA-Connect Agents 9.3 und früher konnten Tabellen nur sofort lesen, nicht als Agent-Thread. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie diese Aktion zuvor als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Wird auf 0 (Standardeinstellung) festgelegt, wenn Sie eine Tabelle lesen (und daher nicht die Ergebnisse einer vorherigen Abfrage abrufen, die als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Tabelle als Thread lesen" auf "true" festgelegt ist, wie viele Sekunden warten müssen, bis der Agent-Thread abgeschlossen ist. Wenn der Agent-Thread, der die Tabelle liest, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent liest die Tabelle weiterhin, ist aber auch für die nächste Aktion verfügbar. Sie können dann die Ergebnisse (den Inhalt der Tabelle) zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Agent-Thread warten, bis der Agent-Thread erfolgreich abgeschlossen wurde" warten und dann diese Aktion "Mehrere UIA-Elemente als Tabelle abrufen" erneut ausführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der gefundenen Zellunterelemente
|
NumberOfCellSubElementsFound | integer |
Die Anzahl der Zellunterelemente (keine Überschriften), die den Suchkriterien entsprechen. |
|
Anzahl der zurückgegebenen Zellunterelemente
|
NumberOfCellSubElementsReturned | integer |
Die Anzahl der zurückgegebenen Zellunterelemente (keine Überschriften) (dies kann niedriger sein als die Anzahl der Elemente, die gefunden werden, wenn eine erste oder maximale Anzahl von Elementen angegeben wird, die zurückgegeben werden sollen). |
|
JSON für Tabelleninhalte
|
TableContentsJSON | string |
Die aus dem Inhalt mehrerer Elemente erstellte Tabelle im JSON-Format. |
|
Anzahl der Zeilen in der Tabelle
|
NumberOfRowsInTable | integer |
Die Anzahl der Zeilen in der Ausgabetabelle. |
|
Anzahl der Spalten in der Tabelle
|
NumberOfColumnsInTable | integer |
Die Anzahl der Spalten in der Ausgabetabelle. |
|
Thread-ID
|
ThreadId | integer |
Wenn diese Aktion als Agent-Thread ausgeführt wird, enthält diese Ausgabe die Agentthread-ID, die zum Überwachen des Prozesses der Aktion verwendet werden kann, und den Tabelleninhalt abruft, wenn der Thread abgeschlossen ist. |
Abrufen mehrerer UIA-Elementeigenschaften
Gibt die Eigenschaften mehrerer Elemente zurück. Dies kann hilfreich sein, wenn Sie unsicher sind, welche Felder die erforderlichen Eigenschaftswerte enthalten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchElementLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Durchsuchen von Nachfolgern
|
SearchDescendants | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Rückgabeelementwert
|
ReturnElementValue | boolean |
Wenn dieser Wert auf "true" festgelegt ist als der Wert des gefundenen Elements, wird zurückgegeben. |
|
|
Erstes Element, das zurückgegeben werden soll
|
FirstItemToReturn | integer |
Der Elementindex des ersten zurückzugebenden Elements ab 1. Wenn Sie die Elemente in umgekehrter Reihenfolge (vom unteren Rand der UIA-Struktur) zurückgeben möchten, können Sie alternativ einen negativen Index ab -1 angeben. |
|
|
Max. Zurückzugebende Elemente
|
MaxItemsToReturn | integer |
Die maximale Anzahl der zurückzugebenden Elemente oder 0, um alle Elemente zurückzugeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der gefundenen Elemente
|
NumberOfElementsFound | integer |
Die Anzahl der gefundenen Elemente, die den Suchkriterien entsprechen. |
|
Anzahl der zurückgegebenen Elemente
|
NumberOfElementsReturned | integer |
Die Anzahl der zurückgegebenen Elemente (dies kann niedriger als die Anzahl der gefundenen Elemente sein, wenn eine maximale Anzahl von Elementen angegeben wird, die zurückgegeben werden sollen). |
|
Elementeigenschaften
|
ElementProperties | array of object |
Die Elementeigenschaften der Gefundenen, die den Suchkriterien entsprechen. |
|
items
|
ElementProperties | object |
Abrufen mehrerer übergeordneter UIA-Elementeigenschaften
Gibt eine hierarchische Struktur der übergeordneten Elemente des angegebenen Elements zurück, bis zur Desktopebene (Stammebene). Das übergeordnete Element wird als Element definiert, das sich auf der nächsten Ebene der UIA-Struktur befindet und fast immer ein enthaltenes Element ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Elementhandle
|
ElementHandle | True | integer |
Das UIA-Handle für das Zielelement. |
|
Max. Eltern, die verarbeitet werden sollen
|
MaxParentsToProcess | integer |
Die maximale Anzahl der zu verarbeitenden übergeordneten Elemente. Standardmäßig ist dies auf 50 festgelegt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Übergeordnete UIA-Elemente
|
UIAParentElements | array of object |
Eine Liste aller übergeordneten Elemente (und deren Eigenschaften). Die zurückgegebenen Eigenschaften entsprechen denen, die von der Aktion "Mehrere Elementeigenschaften abrufen" zurückgegeben werden. |
|
items
|
UIAParentElements | object | |
|
Anzahl der zurückgegebenen übergeordneten Elemente
|
NumberOfParentElementsReturned | integer |
Die Anzahl der übergeordneten Elemente, die aus der Suche zurückgegeben wurden. |
Abrufen von UIA-Datagrid-Elementeigenschaften
Gibt Tabelleneigenschaften eines DataGrid-Elements zurück. Dies ist ein Element mit Zeilen, Spalten, Kopfzeilen und Zellen (d. h. einer Tabelle).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Alternativer Kopfzeilenname
|
AlternativeHeaderRowName | string |
Standardmäßig weist die Kopfzeile in einem DataGrid den UIA-Namen "Oberste Zeile" auf. Wenn die Kopfzeile einen anderen Namen hat, geben Sie diesen Namen hier an. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Spaltenanzahl
|
NumberOfColumns | integer |
Die Anzahl der Spalten im Datagrid. |
|
Anzahl der sichtbaren Spalten
|
NumberOfVisibleColumns | integer |
Die Anzahl der sichtbaren Spalten im Datagrid. |
|
Anzahl der Zeilen
|
NumberOfRows | integer |
Die Anzahl der Zeilen im Datagrid. |
|
Anzahl der sichtbaren Zeilen
|
NumberOfVisibleRows | integer |
Die Anzahl der sichtbaren Zeilen im Datagrid. |
|
Erste sichtbare Zeile
|
FirstVisibleRow | integer |
Der Index der ersten sichtbaren Zeile im Datagrid. |
|
Letzte sichtbare Zeile
|
LastVisibleRow | integer |
Der Index der letzten sichtbaren Zeile im Datagrid. |
|
Anzahl der Bildlaufleisten
|
NumberOfScrollbars | integer |
Die Anzahl der Bildlaufleisten, über die das Datagrid verfügt. |
|
Scrollleistennamen
|
ScrollbarNames | string |
Eine durch Trennzeichen getrennte Liste der Namen der Bildlaufleisten (z. B. Horizontal, Vertikal). |
Abrufen von UIA-Datagrid-Elementinhalten
Gibt den Inhalt eines Datagrid-Elements zurück. Dies ist ein Element mit Zeilen, Spalten, Kopfzeilen und Zellen (d. h. einer Tabelle). Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung dieser Aktion abzurufen, die als Agent-Thread ausgeführt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Nur Bildschirmspalten abrufen
|
OnScreenColumnsOnly | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden nur Bildschirmspalten zurückgegeben. |
|
|
Nur Bildschirmzeilen abrufen
|
OnScreenRowsOnly | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden nur Bildschirmzeilen zurückgegeben. |
|
|
Zurückgeben von NULL-Werten als leer
|
ReturnNullValuesAsBlank | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden NULL-Werte als "" (d. h. leer) zurückgegeben. Bei Festlegung auf "false" werden Nullwerte in der Regel als "(null)" zurückgegeben. |
|
|
Alternativer Kopfzeilenname
|
AlternativeHeaderRowName | string |
Standardmäßig weist die Kopfzeile in einem DataGrid den UIA-Elementnamen "Top Row" auf. Wenn die Kopfzeile einen anderen Namen hat, geben Sie diesen Namen hier an. |
|
|
Zeilen-UIA-Name zurückgeben
|
ReturnRowUIAName | boolean |
Wenn diese Eingabe auf diese Einstellung festgelegt ist, wird der Zeilen-UIA-Name in einer Spalte in der Ausgabeauflistung gespeichert. Der Name der Spalte wird durch die Eingabe "Name der Spalte zum Speichern des Zeilen-UIA-Namens" definiert. |
|
|
Name der Spalte zum Speichern des Zeilen-UIA-Namens
|
NameOfColumnToStoreRowUIAName | string |
Wenn die Eingabe "UIA-Name der Rückgabezeile" auf "true" festgelegt ist, gibt diese Eingabe den Namen der Spalte in der Ausgabeauflistung an, um den Zeilen-UIA-Namen zu enthalten. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Erstes Element, das zurückgegeben werden soll
|
FirstItemToReturn | integer |
Der Elementindex des ersten Zurückzugebenden Elements (Zeile) beginnend mit 1. |
|
|
Max. Zurückzugebende Elemente
|
MaxItemsToReturn | integer |
Die maximale Anzahl der zurückzugebenden Elemente (Zeilen) oder 0, um alle Elemente (Zeilen) zurückzugeben. |
|
|
Scannen der ersten N-Zeilen nach leeren Zeilen
|
ScanFirstNRowsForEmptyRows | integer |
Einige Datagrids verfügen über einige leere /NULL-Zeilenelemente in der UIA-Struktur (normalerweise oben) und IA-Connect überspringen diese Zeilenelemente automatisch, da sie nichts in der Tabelle darstellen, die in der Benutzeroberfläche sichtbar ist. Wenn diese Eingabe auf 0 (Standardeinstellung) festgelegt ist, scannt der IA-Connect Agent zeilenelemente immer ab der ersten Zeile, auch wenn "Erstes Zurückzugebende Element" festgelegt ist, um Zeilen tiefer in der Tabelle abzurufen. Dadurch wird die Konsistenz mit Zeilenindexnummern sichergestellt, wirkt sich jedoch auf die Leistung aus, da alle Zeilen aus der ersten Zeile bis zu den angeforderten Zeilen gescannt werden müssen. Wenn Sie sicher sind, dass sich die einzigen leeren /NULL-Zeilenelemente in der Tabelle innerhalb der ersten N -Zeilen (z. B. 10) befinden, können Sie dies auf N (z. B. 10) festlegen, um die Leistung potenziell zu verbessern. Legen Sie nicht auf einen anderen Wert als 0 fest, es sei denn, Sie wissen, was Sie tun. |
|
|
Tabelle als Thread lesen
|
ReadTableAsThread | boolean |
Bei Festlegung auf "false" (Standardeinstellung) liest der IA-Connect Agent die Tabelle sofort und gibt den Inhalt an den Director zurück. Wenn Sie große Tabellen lesen, kann diese Aktion zeitüberschreitungen. Wenn dieser Wert auf "true" festgelegt ist, liest der IA-Connect Agent die Tabelle als Agent-Thread und der IA-Connect Director (oder Orchestrator, PowerShell-Modul, Blue Prism) kann den Status dieses Agent-Threads überwachen und darauf warten, dass er abgeschlossen ist. Dadurch können große Tabellen ohne Timeouts gelesen werden. IA-Connect Agents 9.3 und früher konnten Tabellen nur sofort lesen, nicht als Agent-Thread. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie diese Aktion zuvor als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Wird auf 0 (Standardeinstellung) festgelegt, wenn Sie ein Datagrid lesen (und daher nicht die Ergebnisse einer vorherigen Abfrage als Agentthread abrufen). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Tabelle als Thread lesen" auf "true" festgelegt ist, wie viele Sekunden warten müssen, bis der Agent-Thread abgeschlossen ist. Wenn der Agent-Thread, der die Tabelle liest, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent liest weiterhin das Datagrid, ist aber auch für die nächste Aktion verfügbar. Sie können dann die Ergebnisse (den Inhalt des Datagrids) zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Agent-Thread warten, bis der Agent-Thread erfolgreich abgeschlossen ist" verwenden, um zu warten, bis der Agent-Thread abgeschlossen ist, und dann diese Aktion "UIA-Datagrid-Elementinhalt abrufen" erneut ausführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Vertikales Scrollen des Datagrids um N Prozent
|
ScrollDataGridVerticallyEveryNPercent | integer |
Die Leistung beim Lesen einiger großer Datagrids (z. B. mit Tausenden von Zeilen) wurde beobachtet, um zu verbessern, wenn Sie regelmäßig in das Datagrid scrollen (oder in der Nähe) der Position, an der ein Bildlauf ausgeführt wird. Bei Festlegung auf 0 (Standardeinstellung) wird das Datagrid beim Lesen des Inhalts nicht gescrollt. Wenn dieser Wert auf einen Wert zwischen 1 und 100 festgelegt ist, wird das Datengrid während des Lesens des Inhalts in regelmäßigen Abständen (alle N Prozent der Gesamtanzahl der Zeilen) scrollen. Beispiel: Bei Festlegung auf 20 wird das Datengrid bei 0, 20, 40, 60, 80 Prozent gescrollt. Alternativ können Sie "Scroll datagrid vertikal alle N-Zeilen" verwenden, um alle N-Zeilen anstelle aller N Prozent zu scrollen. |
|
|
Vertikales Scrollen des Datagrids für alle N-Zeilen
|
ScrollDataGridVerticallyEveryNRows | integer |
Die Leistung beim Lesen einiger großer Datagrids (z. B. mit Tausenden von Zeilen) wurde beobachtet, um zu verbessern, wenn Sie regelmäßig in das Datagrid scrollen (oder in der Nähe) der Position, an der ein Bildlauf ausgeführt wird. Bei Festlegung auf 0 (Standardeinstellung) wird das Datagrid beim Lesen des Inhalts nicht gescrollt. Wenn dieser Wert auf einen Wert 1 oder höher festgelegt ist, wird das Datagrid beim Lesen des Inhalts alle N Zeilen scrollen. Beispiel: Bei Festlegung auf 5 wird das Datagrid alle fünf Zeilen gescrollt. Alternativ können Sie "Scroll datagrid vertikal alle N Prozent" verwenden, um alle N Prozent der Zeilen anstelle jeder N-Zeilen zu scrollen. |
|
|
Vertikales Scrollen des Datagrid-Elementhandles
|
ScrollDataGridVerticallyElementHandle | integer |
Wenn das Datagrid beim Lesen von Inhalten vertikal gescrollt wird, definiert diese Eingabe, wie IA-Connect die vertikale Bildlaufleiste findet. Wenn dieser Wert auf 0 festgelegt ist, versucht IA-Connect, das Datengrid direkt zu scrollen, entweder mithilfe des Musters "scrollen" (sofern das Datagrid es unterstützt) oder durch Suchen nach der vertikalen Bildlaufleiste, die im Datengrid enthalten ist. Alternativ können Sie den IA-Connect UIA-Handle des vertikalen Bildlaufleistenelements (das Bildlaufleistenelement selbst, nicht die Schaltflächen) angeben, die den Wert 1 oder höher aufweisen. |
|
|
Minimale Datengitterzeilen für den Bildlauf
|
MinimumDataGridRowsForScrolling | integer |
Wenn beim Lesen von Inhalten vertikal das Datagrid gescrollt wird, gibt diese Eingabe die Mindestanzahl der Zeilen an, die in der Tabelle erforderlich sind, bevor IA-Connect einen Bildlauf durchführt. Bei Festlegung auf 0 scrollt IA-Connect unabhängig von der Anzahl der Zeilen. Wenn dies auf eine positive Zahl festgelegt ist, führt IA-Connect nur einen Bildlauf durch, wenn das Datengrid über diese Anzahl von Zeilen oder mehr verfügt. |
|
|
Auslösen einer Ausnahme, wenn kein Bildlauf möglich ist
|
RaiseExceptionIfCannotScroll | boolean |
Beim vertikalen Scrollen des Datagrids beim Lesen von Inhalten: Legen Sie diese Eingabe auf "true" fest, wenn ein Fehler beim Scrollen als Ausnahme angesehen werden soll, oder auf "false" (Standardeinstellung), wenn ein Fehler beim Scrollen ignoriert werden soll. Häufige Fehler beim Scrollen sind fehler beim Auffinden der Bildlaufleisten oder der Bildlaufleisten, die für das Scrollen geeignet sind ('scroll', 'rangevalue' oder 'value'). |
|
|
Alternativer vertikaler Bildlaufleistenname
|
AlternativeVerticalScrollbarName | string |
Standardmäßig weist die vertikale Bildlaufleiste "Zeile" in einem Datagrid den UIA-Elementnamen "Vertikale Bildlaufleiste" auf. Wenn die vertikale Bildlaufleiste einen anderen Namen hat, geben Sie diesen Namen hier an. Dies wird verwendet, wenn IA-Connect beim Lesen des Inhalts in regelmäßigen Abständen das Datengrid scrollen soll, das Eingabefeld "Scroll datagrid vertically element handle" auf 0 festgelegt ist (wobei angegeben wird, dass IA-Connect das Datagrid direkt scrollen soll), aber das Datengrid implementiert nicht das Bildlaufmuster. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON-Code für Datengridinhalte
|
DataGridContentsJSON | string |
Der Inhalt des Datagrid-Elements im JSON-Format. |
|
Anzahl der Zeilen in der Tabelle
|
NumberOfRowsInTable | integer |
Die Anzahl der Zeilen in der Ausgabetabelle, wenn die Tabelle sofort gelesen wurde. |
|
Anzahl der Spalten in der Tabelle
|
NumberOfColumnsInTable | integer |
Die Anzahl der Spalten in der Ausgabetabelle, wenn die Tabelle sofort gelesen wurde. |
|
Thread-ID
|
ThreadId | integer |
Wenn diese Aktion als Agentthread ausgeführt wird, enthält diese Ausgabe die Agent-Thread-ID, die zum Überwachen des Prozesses der Aktion verwendet werden kann, und den Datagrid-Inhalt abruft, wenn der Thread abgeschlossen ist. |
Abrufen von UIA-Desktopelementen
Gibt eine Liste aller Fenster und Dialogfelder auf dem Desktop zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchElementLocalizedControlType | string |
Filtern Sie die Ergebnisse nach dem lokalisierten Steuerelementtyp des Elements. |
|
|
Suchprozess-ID
|
SearchProcessID | integer |
Wenn dies angegeben ist, berücksichtigt die Suche nur Elemente, die im Besitz eines Prozesses mit dieser Prozess-ID (PID) sind. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Erstes Element, das zurückgegeben werden soll
|
FirstItemToReturn | integer |
Der Elementindex des ersten zurückzugebenden Elements ab 1. Wenn Sie die Elemente in umgekehrter Reihenfolge (vom unteren Rand der UIA-Struktur) zurückgeben möchten, können Sie alternativ einen negativen Index ab -1 angeben. |
|
|
Max. Zurückzugebende Elemente
|
MaxItemsToReturn | integer |
Die maximale Anzahl der zurückzugebenden Elemente oder 0, um alle Elemente zurückzugeben. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess zurückgegeben, der der exakten "Suchprozess-ID" entspricht. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der gefundenen Elemente
|
NumberOfElementsFound | integer |
Die Anzahl der Desktopelemente, die den Suchkriterien entsprechen. |
|
Anzahl der zurückgegebenen Elemente
|
NumberOfElementsReturned | integer |
Die Anzahl der zurückgegebenen Desktopelemente (dies kann niedriger als die Anzahl der gefundenen Elemente sein, wenn eine maximale Anzahl von Elementen angegeben wird, die zurückgegeben werden sollen). |
|
Elementeigenschaften
|
ElementProperties | array of object |
Die Elementeigenschaften der Desktopelemente wurden gefunden, die den Suchkriterien entsprechen. |
|
items
|
ElementProperties | object |
Abrufen von UIA-Elementeigenschaften
Gibt alle Eigenschaften eines Elements zurück. Dies kann hilfreich sein, wenn Sie unsicher sind, welches Feld die erforderlichen Eigenschaftswerte enthält.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Rückgabeelementwert
|
ReturnElementValue | boolean |
Wenn dieser Wert auf "true" festgelegt ist als der Wert des gefundenen Elements, wird zurückgegeben. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Elementframework-ID
|
ElementFrameworkId | string |
Die UIA-Framework-ID des Elements. |
|
Elementsteuerelementtyp
|
ElementControlType | string |
Der UIA-Steuerelementtyp als Zahl. Dies ähnelt dem lokalisierten Steuerelementtyp, ist jedoch nicht sprachspezifisch. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
|
Element ist aktiviert
|
ElementIsEnabled | boolean |
Gibt zurück, ob das Element aktiviert ist oder nicht. |
|
Element ist aus dem Bildschirm
|
ElementIsOffscreen | boolean |
Gibt zurück, ob das Element offscreen ist oder nicht. |
|
Element ist tastaturfokussierbar
|
ElementIsKeyboardFocusable | boolean |
Gibt zurück, ob das Element von der Tastatur fokussiert werden kann. |
|
Element verfügt über tastaturfokus
|
ElementHasKeyboardFocus | boolean |
Gibt zurück, ob das Element derzeit den Tastaturfokus hat. |
|
Element ist Kennwortfeld
|
ElementIsPasswordField | boolean |
Gibt zurück, ob ein Element ein Kennworteingabefeld ist. |
|
Tastenkombination für Elemente
|
ElementAcceleratorKey | string |
Gibt den Hotkey zurück, der zum Aktivieren des Elements gedrückt werden kann. |
|
Elementzugriffsschlüssel
|
ElementAccessKey | string |
Gibt den Hotkey zurück, der zum Aktivieren eines Menüelements gedrückt werden kann. |
|
Element links
|
ElementLeftEdge | integer |
Der Abstand in Pixel zwischen dem linken Rand des Elements oder Fensters und dem linken Rand der Anzeige. |
|
Element rechte Kante
|
ElementRightEdge | integer |
Der Abstand in Pixeln zwischen dem rechten Rand des Elements oder Fensters und dem linken Rand der Anzeige. |
|
Oberer Rand des Elements
|
ElementTopEdge | integer |
Der Abstand in Pixel zwischen dem oberen Rand des Elements oder Fensters und dem oberen Rand der Anzeige. |
|
Element unterer Rand
|
ElementBottomEdge | integer |
Der Abstand in Pixel zwischen dem unteren Rand des Elements oder Fensters und dem oberen Rand der Anzeige. |
|
Element klickbar Punkt X
|
ElementClickablePointX | integer |
Die X-Koordinate in Pixeln eines zentralen klickbaren Punkts im Element relativ zum linken Rand der Anzeige, wie sie von der zugrunde liegenden Anwendung zurückgegeben wird. |
|
Element klickbar Punkt Y
|
ElementClickablePointY | integer |
Die Y-Koordinate in Pixeln eines zentralen klickbaren Punkts im Element relativ zum oberen Rand der Anzeige, wie von der zugrunde liegenden Anwendung zurückgegeben. |
|
Elementprozess-ID
|
ElementProcessId | integer |
Die Prozess-ID (Process ID, PID) des Prozesses, der dieses Element besitzt. |
|
Elementhandle
|
ElementHandle | integer |
Wenn die Eingabe "Rückgabeelementhandle" auf "true" festgelegt wurde, enthält dies ein numerisches Elementhandle, das in weiteren Aktionen verwendet werden kann, um als "übergeordnetes" Handle für weitere Aktionen zu fungieren. |
|
Elementwert
|
ElementValue | string |
Wenn die Eingabe "Rückgabeelementwert" auf "true" festgelegt wurde und wenn das Element ein Wertmuster aufweist, enthält dies diesen Wert. |
|
Elementtextwert
|
ElementTextValue | string |
Wenn die Eingabe "Rückgabeelementwert" auf "true" festgelegt wurde und das Element ein Textwertmuster aufweist, enthält dies diesen Textwert. |
Abrufen von UIA-Elementeigenschaften als Liste
Gibt die Eigenschaften eines Elements als einzelne Zeilenliste (einzelzeilenauflistung / Datentabelle) anstelle einzelner Elemente zurück, dies kann je nachdem, wie Sie die Daten verwenden möchten, nützlich sein.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Elementhandle
|
ElementHandle | True | integer |
Das UIA-Handle für das Zielelement. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der gefundenen Elemente
|
NumberOfElementsFound | integer |
Die Anzahl der gefundenen Elemente. |
|
Anzahl der zurückgegebenen Elemente
|
NumberOfElementsReturned | integer |
Die Anzahl der zurückgegebenen Elemente. |
|
JSON-Elementeigenschaften von UIA-Elementen
|
UIAElementPropertiesJSON | string |
Die UIA-Eigenschaften des Elements im JSON-Format. |
Abrufen von UIA-Elementmustern
Rufen Sie ab, welche UIA-Muster für ein UIA-Element verfügbar sind und welche IA-Connect UIA-Aktionen wahrscheinlich auswirkungen auf das Element haben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Reduzieren-Muster erweitern verfügbar
|
ExpandCollapsePatternAvailable | boolean |
Das UIA-Erweiterungs-Reduzieren-Muster ist verfügbar, und daher funktionieren Aktionen, die ein Element erweitern oder reduzieren (z. B. ein Dropdownmenü), wahrscheinlich funktionieren. |
|
Aufrufmuster verfügbar
|
InvokePatternAvailable | boolean |
Das UIA-Aufrufmuster ist verfügbar und somit Aktionen, die ein Element drücken oder auf ein Listenelement klicken, funktionieren wahrscheinlich. |
|
Bereichswertmuster verfügbar
|
RangeValuePatternAvailable | boolean |
Das Wertmuster des UIA-Bereichs ist verfügbar, und daher funktionieren Aktionen, mit denen ein Element oder Schieberegler scrollen kann. |
|
Bildlaufmuster verfügbar
|
ScrollPatternAvailable | boolean |
Das UIA-Bildlaufmuster ist verfügbar und somit Aktionen, die ein Element scrollen, funktionieren wahrscheinlich. |
|
Auswahlelementmuster verfügbar
|
SelectionItemPatternAvailable | boolean |
Das UIA-Auswahlelementmuster ist verfügbar, und daher funktionieren Aktionen, die ein Element auswählen, wahrscheinlich funktionieren. |
|
Textmuster verfügbar
|
TextPatternAvailable | boolean |
Das UIA-Textmuster ist verfügbar und somit Aktionen, die einen Elementtextwert lesen, funktionieren wahrscheinlich. |
|
Umschaltmuster verfügbar
|
TogglePatternAvailable | boolean |
Das UIA-Umschaltmuster ist verfügbar und somit Aktionen, die ein Element überprüfen, deaktivieren oder umschalten, funktionieren wahrscheinlich. |
|
Wertmuster verfügbar
|
ValuePatternAvailable | boolean |
Das UIA-Wertmuster ist verfügbar und somit Aktionen, die Text in ein Element eingeben oder einen Elementwert lesen, funktionieren wahrscheinlich. Bildlaufleisten können auch auf ein Wertmuster reagieren. |
|
Fenstermuster verfügbar
|
WindowPatternAvailable | boolean |
Das UIA-Fenstermuster ist verfügbar und somit Aktionen, die ein Element schließen, maximieren oder minimieren, funktionieren wahrscheinlich. |
|
Rastermuster verfügbar
|
GridPatternAvailable | boolean |
Das UIA-Rastermuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Rasterelementmuster verfügbar
|
GridItemPatternAvailable | boolean |
Das UIA-Rasterelementmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Legacy-IAccessible-Muster verfügbar
|
LegacyIAccessiblePatternAvailable | boolean |
Das UIA-Legacymuster "IAccessible" ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Auswahlmuster verfügbar
|
SelectionPatternAvailable | boolean |
Das UIA-Auswahlmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Kalkulationstabellenmuster verfügbar
|
SpreadsheetPatternAvailable | boolean |
Das UIA-Kalkulationstabellenmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Kalkulationstabellenelementmuster verfügbar
|
SpreadsheetItemPatternAvailable | boolean |
Das UIA-Tabellenkalkulationselementmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Tabellenmuster verfügbar
|
TablePatternAvailable | boolean |
Das UIA-Tabellenmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Tabellenelementmuster verfügbar
|
TableItemPatternAvailable | boolean |
Das UIA-Tabellenelementmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Textmuster 2 verfügbar
|
TextPattern2Available | boolean |
Das UIA-Textmuster 2 ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Textbearbeitungsmuster verfügbar
|
TextEditPatternAvailable | boolean |
Das UIA-Textbearbeitungsmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
|
Transformationsmuster verfügbar
|
TransformPatternAvailable | boolean |
Das UIA-Transformationsmuster ist verfügbar. Dieses Muster wird von IA-Connect nicht verwendet. |
Abrufen von UIA-Listenelementelementen
Gibt eine Liste der untergeordneten Elementelemente zurück, die unter dem angegebenen Element gefunden werden (in der Regel Dropdown-/Menüelemente).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Zuerst erweitern
|
ExpandFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, die Liste zu erweitern, bevor nach den Listenelementelementen gesucht wird. Dies ist nützlich für dynamische Listen, da die Listenelementelemente möglicherweise erst erstellt werden, wenn die Liste erweitert wird. |
|
|
Reduzieren nach
|
CollapseAfter | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die Liste nach der Ausführung der Suche reduziert. |
|
|
Auf ausgewählte Elemente überprüfen
|
CheckForSelectedItems | boolean |
Wenn dieser Wert auf "true" festgelegt ist, enthält die Ausgabeauflistung eine zusätzliche Eigenschaft, die angibt, ob das Listenelement derzeit ausgewählt ist. |
|
|
Sekunden zwischen Erweitern und Reduzieren
|
SecondsBetweenExpandCollapse | double |
Die Anzahl der Sekunden, die zwischen den Aktionen zum Erweitern und Reduzieren warten sollen, wenn diese auf "true" festgelegt sind. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der Listenelemente
|
NumberOfListItems | integer |
Die Anzahl der Elemente in der Liste. |
|
JSON für Listenelemente
|
ListItemsJSON | string |
Die Eigenschaften der Elemente in der Liste im JSON-Format. |
|
Anzahl der ausgewählten Elemente
|
NumberOfSelectedItems | integer |
Die Anzahl der ausgewählten Elemente in der Liste. |
|
Index des ersten ausgewählten Elements
|
IndexOfFirstSelectedItem | integer |
Der Index in der Liste des ersten ausgewählten Elements. |
|
Name des ausgewählten Elements
|
SelectedItemName | string |
Der Name des ausgewählten Elements. |
Auf sichtbares Suchbild im UIA-Element warten
Wartet, bis ein Suchbild, das als Eingabe für diese Aktion bereitgestellt wird, sichtbar innerhalb eines UIA-Elements auf dem Bildschirm gespeichert wurde oder die angegebene Zeitspanne vergangen ist. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent einen Screenshot an den Koordinaten des Elements erstellt und im Screenshot nach dem bereitgestellten Suchbild sucht. Das UIA-Element muss von Anfang an vorhanden sein. Die Aktion wird sofort abgeschlossen, sobald sich das Bild befindet.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Suchbildtyp
|
SearchImageType | string |
Definiert, was die Eingabe "Suchbild" darstellt. Bei Festlegung auf "Director-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Director zugreifen kann. Bei Festlegung auf "Agent-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Agent zugreifen kann. Bei Festlegung auf "Base64" ist das Suchbild eine Base64-Darstellung des Bilds. |
|
|
Suchbild
|
SearchImage | string |
Das Suchbild, das innerhalb des angegebenen UIA-Elements gefunden werden soll. Je nach dem angegebenen Suchbildtyp kann dies den Pfad zu einer Bilddatei (am Director- oder Agent-Ende) enthalten oder die Base64 (Textdarstellung) des zu suchnden Bilds enthalten. |
|
|
Alternativer Suchbildtyp
|
AltSearchImageType | string |
Definiert, was die Eingabe "Alternatives Suchbild" darstellt. Wenn dieser Wert auf "Keine" oder leer festgelegt ist, gibt es kein alternatives Suchbild. Bei Festlegung auf "Director-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Director zugreifen kann. Bei Festlegung auf "Agent-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Agent zugreifen kann. Bei Festlegung auf "Base64" ist das Suchbild eine Base64-Darstellung des Bilds. |
|
|
Alternatives Suchbild
|
AltSearchImage | string |
Ein optionales alternatives Suchbild, das innerhalb des angegebenen UIA-Elements gefunden werden soll. Je nach dem angegebenen "Alternativen Suchbildtyp" kann dies den Pfad zu einer Bilddatei (am Director- oder Agent-Ende) enthalten oder die base64 (Textdarstellung) des gesuchten Bilds enthalten. Wenn Sie ein alternatives Suchbild angeben, sucht der Agent entweder nach dem Such- oder alternativsuchbild und dem Bericht, der sich befindet. |
|
|
Maximale Farbabweichung
|
MaxColourDeviation | integer |
Die Pixelfarben eines Elements können von den Pixelfarben des Suchbilds abweichen, bevor es nicht als Übereinstimmung betrachtet wird. 0 für keine Abweichung. Die Abweichung wird in RGB-Werten gemessen. Beispiel: #FF0000 unterscheidet sich von #FE0102. Dadurch können geringfügige Farbunterschiede ignoriert werden. |
|
|
Max. Pixelunterschiede
|
MaxPixelDifferences | integer |
Die maximale Anzahl von Pixeln, die sich (oberhalb der maximalen Farbabweichung) über das gesamte Suchbild unterscheiden können, bevor ein Bild als nicht übereinstimmend betrachtet wird. Dadurch können geringfügige Unterschiede zwischen Bildern ignoriert werden, aber höhere Werte können die Zeit erhöhen, die zum Auffinden eines Bilds erforderlich ist. Es wird empfohlen, bei Bedarf auf 0 festzulegen und um kleine Mengen zu erhöhen. Wenn die Einstellung auf einen Wert über 0 festgelegt ist, müssen Sie auch "Max. aufeinanderfolgende Pixelunterschiede" festlegen. |
|
|
Max. aufeinander folgende Pixelunterschiede
|
MaxConsecutivePixelDifferences | integer |
Die maximale Anzahl von Pixeln, die sich (über der maximalen Farbabweichung) unterscheiden können, in jeder Zeile, bevor ein Bild als nicht übereinstimmend betrachtet wird. Dadurch können geringfügige Unterschiede zwischen Bildern ignoriert werden, aber höhere Werte können die Zeit erhöhen, die zum Auffinden eines Bilds erforderlich ist. Es wird empfohlen, bei Bedarf auf 0 festzulegen und um kleine Mengen zu erhöhen. Wenn die Einstellung auf einen Wert über 0 festgelegt ist, müssen Sie auch "Max. Pixelunterschiede" festlegen. |
|
|
X-Offset für das linke Pixel
|
LeftPixelXOffset | integer |
Ein optionaler X-Offset für den linken Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Rechter Pixel X-Offset
|
RightPixelXOffset | integer |
Ein optionaler X-Offset für den rechten Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Y-Offset des oberen Pixels
|
TopPixelYOffset | integer |
Ein optionaler Y-Offset für den oberen Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Unterer Pixel-Y-Offset
|
BottomPixelYOffset | integer |
Ein optionaler Y-Offset für den unteren Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Pixel X-Offsetseinheit
|
PixelXOffsetsUnit | string |
Wird auf "Pixel" (Standardeinstellung) festgelegt, wenn links- und rechte Pixel X-Offsets in Pixeln gemessen werden. Wird auf "Prozent" festgelegt, wenn links- und rechte Pixel X-Offsets als Prozentsatz der Elementbreite gemessen werden. |
|
|
Pixel-Y-Offseteinheit
|
PixelYOffsetsUnit | string |
Wird auf "Pixel" (Standardeinstellung) festgelegt, wenn obere und untere Pixel-Y-Offsets in Pixeln gemessen werden. Wird auf "Prozent" festgelegt, wenn obere und untere Pixel-Y-Offsets als Prozentsatz der Elementhöhe gemessen werden. |
|
|
Suchbildindex
|
SearchImageIndex | integer |
Legen Sie den 1 fest, um die erste Instanz des Suchbilds (in Richtung der Suche) innerhalb des UIA-Elements zu finden. Legen Sie für die zweite Instanz , .... , N für die Nth-Instanz auf 2 fest. Wenn Sie auch nach einem alternativen Bild suchen, wird das UIA-Element zuerst nach dem Suchbild gescannt, und zweitens nach dem alternativen Bild, suchen Sie nach der angeforderten Instanz dieses bestimmten Bilds (d. h. der Agent erwartet ein oder das andere, nicht eine Mischung aus beiden Bildern). |
|
|
Bildsuchrichtung
|
ImageSearchDirection | string |
Die Suchrichtung. "Von oben" sucht nach Zeile von oben, scannt von links nach rechts innerhalb jeder Zeile. "Von unten" sucht nach Zeile von unten, scannt von links nach rechts innerhalb jeder Zeile. "Von links" sucht nach Spalte von links, und scannt von oben nach unten in jeder Spalte. "Von rechts" sucht nach Spalte von rechts, und scannt von oben nach unten in jeder Spalte. Dies kann in Verbindung mit "Suchbildindex" verwendet werden, um das Nth-Bild von oben, unten, links oder rechts zu suchen. Um die Leistung zu verbessern, wählen Sie die Suchrichtung aus, die Sie denken, dass Ihr Bild schneller gefunden wird. |
|
|
Agent ausblenden
|
HideAgent | boolean |
Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass es das zu analysierende Element nicht verdeckt. |
|
|
Zurückgeben von Bildschirmkoordinaten als physisch
|
ReturnPhysicalCoordinates | boolean |
Wird auf "true" festgelegt, damit die Bildschirmkoordinaten als physische Koordinaten zurückgegeben werden. Auf "false" festgelegt, damit die Bildschirmkoordinaten als virtuelle Koordinaten zurückgegeben werden. Wenn die zugrunde liegende Anzeigeskalierung 100%ist, sind sowohl physische als auch virtuelle Koordinaten identisch. Elementkoordinaten werden immer als virtuelle Koordinaten zurückgegeben. |
|
|
Hervorhebungsrechteck anzeigen
|
ShowHighlightRectangle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird das bild vom IA-Connect Agent auf dem Bildschirm hervorgehoben. Dies kann während der Entwicklung hilfreich sein, um zu visualisieren, dass das richtige Bild erkannt wird. |
|
|
Sekunden, die auf das Suchbild warten
|
SecondsToWait | integer |
Die Anzahl der Sekunden, bis das Suchbild im UIA-Element gefunden wird. Wenn sich das Bild nicht befindet, wird eine Ausnahme ausgelöst, wenn "Ausnahme auslösen, wenn das Bild nicht gefunden wurde" auf "true" festgelegt ist, andernfalls meldet die Aktion, dass das Bild nicht gefunden wurde. |
|
|
Millisekunden zwischen Suchvorgängen
|
MillisecondsBetweenSearches | integer |
Die Anzahl der Millisekunden, die zwischen jedem UIA-Element auf dem Bildschirmscan gewartet werden sollen. Da die Bilderkennung CPU-kostenintensiv sein kann, kann eine Verzögerung sowohl dazu beitragen, die CPU-Auslastung zu verringern als auch auszudehnen. Beispiel: Wenn Sie davon ausgehen, dass ein Bild bis zu 1 Minute sichtbar sein kann, wird durch das Hinzufügen einer Pause von 5000 Millisekunden (5 Sekunden) zwischen Scans die CPU-Auslastung erheblich verringert (durch erhebliche Reduzierung der Anzahl der Scans), aber nur eine geringe Auswirkung auf die Reaktionszeit. Der zulässige Mindestwert beträgt 100 Millisekunden (1/10 Sekunde). |
|
|
Auslösen einer Ausnahme, wenn das Bild nicht gefunden wurde
|
RaiseExceptionIfImageNotFound | boolean |
Wird auf "true" festgelegt, wenn IA-Connect eine Ausnahme auslösen soll, wenn das Bild nach dem Wartezeitzeitraum nicht gefunden werden konnte. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie zuvor "Auf Thread warten" auf "false" festgelegt haben (was bewirkt, dass der Agent die Wartezeit in einem Hintergrundthread ausführt), geben Sie die Agent-Thread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Andernfalls wird "0" (Standardeinstellung) festgelegt. |
|
|
Auf Thread warten
|
WaitForThread | boolean |
Auf "true" festlegen, bis der Agent-Thread abgeschlossen ist; Der Agent wartet so lange wie angegeben von "Sekunden, bis auf das Suchbild gewartet wird". Auf "false" festgelegt, um die Wartezeit zu umgehen; Der Agent führt weiterhin die Wartezeit im Hintergrund aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können die Ergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis der Agent-Thread erfolgreich abgeschlossen ist" verwenden, bis der Agent-Thread abgeschlossen ist, und dann diese Aktion "Auf sichtbares Suchbild innerhalb des UIA-Elements warten" erneut ausführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Suchbild befindet sich
|
SearchImageLocated | boolean |
Diese Ausgabe wird auf "true" festgelegt, wenn sich das Suchbild befindet. Diese Ausgabe wird auf "false" festgelegt, wenn sich das Suchbild nicht befindet. |
|
Welches Suchbild sich befindet
|
WhichSearchImageLocated | integer |
Diese Ausgabe wird auf 0 festgelegt, wenn keine Suchbilder gefunden wurden. Legen Sie den 1 fest, wenn sich das Suchbild befindet. Legen Sie "2" fest, wenn sich das alternative Suchbild befindet. |
|
Bild match bounding box element left pixel
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Die virtuelle X-Koordinate des linken Pixels, das dem angegebenen Bild entspricht, relativ zum virtuellen Element oben links. |
|
Bild match bounding box element right pixel
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Die virtuelle X-Koordinate des rechten Pixels, das dem angegebenen Bild entspricht, relativ zum element virtual top-left. |
|
Bild match bounding box element top pixel
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Die virtuelle Y-Koordinate des obersten Pixels, das dem angegebenen Bild entspricht, relativ zum virtuellen Element oben links. |
|
Bildabgleich umgebendes Feldelement unteres Pixel
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Die virtuelle Y-Koordinate des unteren Pixels, das dem angegebenen Bild entspricht, relativ zum virtuellen Element oben links. |
|
Bildabgleich umgebendes Feldelement zentriert X Pixel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Die virtuelle X-Koordinate der Mitte des umgebenden Felds, die Pixel enthält, die dem angegebenen Bild entsprechen, relativ zum virtuellen Element oben links. |
|
Bild match bounding box element center Y pixel
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Die virtuelle Y-Koordinate der Mitte des umgebenden Felds, die Pixel enthält, die dem angegebenen Bild entsprechen, relativ zum virtuellen Element oben links. |
|
Bild match bounding box screen left pixel
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels, die mit dem angegebenen Bild übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen right pixel
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels, die mit dem angegebenen Bild übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen top pixel
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Die Y-Koordinate des Bildschirmpixels, die mit dem angegebenen Bild übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen bottom pixel
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Die Pixel-Y-Koordinate des Bildschirmpixels am unteren Rand, der dem angegebenen Bild entspricht. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen center X pixel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels der Mitte des umgebenden Felds, das Pixel enthält, die dem angegebenen Bild entsprechen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen center Y pixel
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Die Y-Koordinate des Bildschirmpixels der Mitte des umgebenden Felds, das Pixel enthält, die dem angegebenen Bild entsprechen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Thread-ID
|
ThreadId | integer |
Wenn Sie "Auf Thread warten" auf "false" festgelegt haben (was bewirkt, dass der Agent die Wartezeit in einem Hintergrundthread ausführt), enthält diese Ausgabe die Agentthread-ID, mit der der Prozess der Aktion überwacht und die Ergebnisse später abgerufen werden kann, wenn der Thread abgeschlossen wurde. |
Collapse UIA-Element
Reduziert ein Element (in der Regel ein Menü/Dropdownelement). Wenn das Element bereits reduziert ist, geschieht nichts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Drücken des UIA-Elements
Drückt ein Element (in der Regel eine Schaltfläche).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Warten, bis das Schaltflächenereignis abgeschlossen ist
|
Wait | boolean |
Sollte die Automatisierung warten, bis das Schaltflächenereignis abgeschlossen ist, bevor Sie fortfahren. Wenn dieser Wert auf "true" festgelegt ist, kann ein Timeout verursacht werden, wenn die Schaltfläche ein modales Dialogfeld öffnet. |
|
|
Win32-Klickschaltfläche
|
Win32ClickButton | boolean |
Bei Festlegung auf "true" wird anstelle von UIA ein Win32-Klickereignis verwendet. Dies ist ein Klickereignis "Auslösen und Vergessen", das beim Umgang mit modalen Dialogfeldern nützlich sein kann, die nach einem Klick angezeigt werden, oder Elemente, die kein UIA-Aufrufmuster aufweisen. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Probieren Sie das Aufrufmuster aus.
|
TryInvokePattern | boolean |
Bei Festlegung auf "true" (Standardeinstellung) versucht der IA-Connect Agent, ein UIA-Aufrufmuster zum Ausführen der Druckaktion zu verwenden (es sei denn, "Win32 Click Button" ist auf "true" festgelegt). Wenn das UIA-Aufrufmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Bei Festlegung auf "false" versucht der IA-Connect Agent nicht, ein Aufrufmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. |
|
|
Legacymuster ausprobieren
|
TryLegacyPattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Legacymuster zum Ausführen der Druckaktion zu verwenden, wenn das Aufrufmuster nicht verfügbar ist (entweder weil es für das Element nicht vorhanden ist oder weil die Verwendung deaktiviert wurde) und wenn "Win32 Click Button" falsch ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Eingabekennwort in das UIA-Element
UIA-Aktion, die ein Kennwort in ein Element eingibt (in der Regel ein Kennworteingabefeld), ersetzen den vorhandenen Text.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Kennwort für eingabe
|
PasswordToInput | True | password |
Der einzugebende Kennwortwert. |
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Kennwort enthält gespeichertes Kennwort
|
PasswordContainsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn das Kennwort einen IA-Connect gespeicherten Kennwortbezeichner enthält (oder vollständig), im Format {IAConnectPassword:StoredPasswordIdentifier} oder in einem IA-Connect Orchestrator generische Anmeldeinformationen im Format {OrchestratorCredential:FriendlyName}. Dieses gespeicherte Kennwort könnte beispielsweise durch die Aktion "Kennwort generieren" generiert oder vom IA-Connect Orchestrator gehalten werden. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Probieren Sie das Wertmuster aus.
|
TryValuePattern | boolean |
Bei Festlegung auf "true" (Standardeinstellung) versucht der IA-Connect Agent, ein UIA-Wertmuster zum Ausführen der Texteingabeaktion zu verwenden. Wenn das UIA-Wertmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Wertmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. |
|
|
Legacymuster ausprobieren
|
TryLegacyPattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Legacymuster zum Ausführen der Texteingabeaktion zu verwenden, wenn das Wertmuster nicht verfügbar ist (entweder weil es für das Element nicht vorhanden ist oder weil die Verwendung deaktiviert war). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Eingaberücklauf in UIA-Element
Gibt eine Windows-Rückgabe-/neue Zeile in ein Element ein (in der Regel ein Texteingabefeld), entweder den vorhandenen Text zu ersetzen oder die Rückgabe an einer bestimmten Position einzufügen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Vorhandenen Wert ersetzen
|
ReplaceExistingValue | boolean |
Wenn im Element Text vorhanden ist, sollte dies ersetzt werden? |
|
|
Position einfügen
|
InsertPosition | integer |
Die Position (Index), um mit dem Einfügen von Text zu beginnen. Wenn text vorhanden ist, kann die Einfügeposition verwendet werden, um an einer bestimmten Position innerhalb des vorhandenen Texts einzufügen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Auslösen einer Ausnahme, wenn die Eingabeüberprüfung fehlschlägt
|
RaiseExceptionIfInputValidationFails | boolean |
Wenn diese Option aktiviert ist, überprüft der IA-Connect Agent den neuen Wert des Elements, nachdem der angeforderte Text eingegeben wurde. Wenn der neue Wert nicht mit dem erwarteten Wert übereinstimmt, wird eine Ausnahme ausgelöst. Wenn diese Eingabe "false" (Standardeinstellung) ist, wird eine Warnung in das Protokoll eingegeben, es wird jedoch keine Ausnahme ausgelöst. |
|
|
Probieren Sie das Wertmuster aus.
|
TryValuePattern | boolean |
Bei Festlegung auf "true" (Standardeinstellung) versucht der IA-Connect Agent, ein UIA-Wertmuster zum Ausführen der Texteingabeaktion zu verwenden. Wenn das UIA-Wertmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Wertmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. |
|
|
Legacymuster ausprobieren
|
TryLegacyPattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Legacymuster zum Ausführen der Texteingabeaktion zu verwenden, wenn das Wertmuster nicht verfügbar ist (entweder weil es für das Element nicht vorhanden ist oder weil die Verwendung deaktiviert war). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Eingeben von Text in mehrere UIA-Elemente
UIA-Aktion, die unterschiedliche Textabschnitte in mehrere Elemente eingibt (in der Regel Texteingabefelder), entweder durch Ersetzen des vorhandenen Texts oder Einfügen des neuen Werts an einer bestimmten Position.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Eingabeelemente
|
InputElementsJSON | True | string |
Ein Array von UIA-Elementen zum Eingeben von Text in das JSON-Format. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Eingeben von Text in UIA-Element
UIA-Aktion, die Text in ein Element eingibt (in der Regel ein Texteingabefeld), entweder durch Ersetzen des vorhandenen Texts oder Einfügen des neuen Werts an einer bestimmten Position.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Text, der eingegeben werden soll
|
TextToInput | string |
Der textwert, der eingegeben werden soll. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Vorhandenen Wert ersetzen
|
ReplaceExistingValue | boolean |
Wenn im Element Text vorhanden ist, sollte dies ersetzt werden? |
|
|
Position einfügen
|
InsertPosition | integer |
Die Position (Index), um mit dem Einfügen von Text zu beginnen. Wenn text vorhanden ist, kann die Einfügeposition verwendet werden, um an einer bestimmten Position innerhalb des vorhandenen Texts einzufügen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Auslösen einer Ausnahme, wenn die Eingabeüberprüfung fehlschlägt
|
RaiseExceptionIfInputValidationFails | boolean |
Wenn diese Option aktiviert ist, überprüft der IA-Connect Agent den neuen Wert des Elements, nachdem der angeforderte Text eingegeben wurde. Wenn der neue Wert nicht mit dem erwarteten Wert übereinstimmt, wird eine Ausnahme ausgelöst. Wenn diese Eingabe "false" (Standardeinstellung) ist, wird eine Warnung in das Protokoll eingegeben, es wird jedoch keine Ausnahme ausgelöst. |
|
|
Probieren Sie das Wertmuster aus.
|
TryValuePattern | boolean |
Bei Festlegung auf "true" (Standardeinstellung) versucht der IA-Connect Agent, ein UIA-Wertmuster zum Ausführen der Texteingabeaktion zu verwenden. Wenn das UIA-Wertmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Wertmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. |
|
|
Legacymuster ausprobieren
|
TryLegacyPattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Legacymuster zum Ausführen der Texteingabeaktion zu verwenden, wenn das Wertmuster nicht verfügbar ist (entweder weil es für das Element nicht vorhanden ist oder weil die Verwendung deaktiviert war). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Enthält das Win32-Fenster
Eine einfache und schnelle Win32-Aktion, die meldet, ob ein Prozess (mit Namen angegeben) über sichtbare Fenster verfügt. Das Fenster muss vorhanden sein: IA-Connect wartet nicht. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name des Suchvorgangs
|
SearchProcessName | True | string |
Der Name des zu suchden Prozesses, z. B. Editor. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Prozess hat Fenster
|
ProcessHasWindow | boolean |
Gibt true zurück, wenn der Prozess über ein sichtbares Fenster oder false verfügt, wenn dies nicht der Fall ist. |
Erweitern des UIA-Elements
Erweitert ein Element (in der Regel ein Menü/Dropdownelement). Wenn das Element bereits erweitert ist, geschieht nichts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Festlegen des Bildlaufprozentsatzes für UIA-Elemente
Legen Sie den horizontalen und/oder vertikalen Bildlaufprozentsatz des angegebenen Elements fest, wenn der Bildlauf von diesem Element unterstützt wird. Wenn das Element das Bildlaufmuster unterstützt, können Sie diese Aktion direkt auf das Element anwenden und entweder einen horizontalen oder vertikalen Bildlaufbetrag (oder beides) angeben. Wenn das Element das Muster "Scrollen" nicht unterstützt, fällt diese Aktion auf die Muster "Bereichswert" oder "Wert" zurück, aber Sie müssen diese direkt auf das Bildlaufleisten-Steuerelement(n) anwenden, nicht auf das Element selbst.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Horizontaler Bildlaufprozentsatz
|
HorizontalScrollPercentage | double |
Die Position zum horizontalen Scrollen des Elements (einschließlich 0 bis 100, dezimale Unterstützung) oder -1, um die horizontale Bildlaufposition unverändert zu lassen. |
|
|
Vertikaler Bildlaufprozentsatz
|
VerticalScrollPercentage | double |
Die Position, um das Element vertikal zu scrollen (einschließlich 0 bis 100, Dezimalstellen unterstützt) oder -1, um die vertikale Bildlaufposition unverändert zu lassen. |
|
|
Scrollmuster ausprobieren
|
TryScrollPattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Bildlaufmuster zum Ausführen der Bildlaufaktion zu verwenden. Wenn das UIA-Bildlaufmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere ausgewählte Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Bildlaufmuster zu verwenden, und fällt sofort auf andere ausgewählte Muster zurück. Die Reihenfolge der versuchten Muster (wenn sie über Eingaben für diese Aktion aktiviert werden) sind Bildlauf, Bereichswert und Wert. |
|
|
Testen des Bereichswertmusters
|
TryRangeValuePattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Bereichswertmuster zum Ausführen der Bildlaufaktion zu verwenden. Wenn das UIA-Bereichswertmuster im ausgewählten Element nicht verfügbar ist, wird der IA-Connect Agent auf andere ausgewählte Muster zurückgreifen (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Bereichswertmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. Die Reihenfolge der versuchten Muster (wenn sie über Eingaben für diese Aktion aktiviert werden) sind Bildlauf, Bereichswert und Wert. |
|
|
Probieren Sie das Wertmuster aus.
|
TryValuePattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Wertmuster zum Ausführen der Bildlaufaktion zu verwenden. Wenn das UIA-Wertmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere ausgewählte Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Wertmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. Die Reihenfolge der versuchten Muster (wenn sie über Eingaben für diese Aktion aktiviert werden) sind Bildlauf, Bereichswert und Wert. Warnung: Wenn Sie ein Wertmuster für ein Bearbeitungselement verwenden, geben Sie einfach den Wert in das Bearbeitungselement ein. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
UIASetElementScrollPercentageResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen des Timeouts für UIA-Transaktionen
Steuert, wie lange die UIA-API wartet, bis eine Anwendung die Informationen zu einem Element zurückgibt. Dieses Transaktionstimeout würde in der Regel nur erreicht werden, wenn die Anwendung nicht reaktionsfähig war.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Timeout in Sekunden
|
TimeoutInSeconds | True | double |
Die maximale Zeitdauer, die die UIA-API wartet, bis eine Anwendung die Informationen zu einem Element zurückgibt. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Festlegen des UIA-Elements auf einen numerischen Bereichswert
Legt den Wert des Elements fest, das einen numerischen Bereich aufweist, z. B. eine Bildlaufleiste.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Neuer Wert
|
NewValue | True | double |
Der numerische Bereichswert, auf den das Element festgelegt werden soll. |
|
Neuer Wert ist Prozentsatz
|
NewValueIsPercentage | boolean |
Ist der neue Wert ein Prozentsatz? |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Festlegen des UIA-Elements auf numerischen Wert
Legt den Wert des Elements fest, das eine numerische Eingabe aufweist, z. B. ein Textfeld oder eine Bildlaufleiste.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Neuer Wert
|
NewValue | True | integer |
Der numerische Wert, auf den das Element festgelegt werden soll. |
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Auslösen einer Ausnahme, wenn die Eingabeüberprüfung fehlschlägt
|
RaiseExceptionIfInputValidationFails | boolean |
Wenn diese Option aktiviert ist, überprüft der IA-Connect Agent den neuen Wert des Elements, nachdem der angeforderte Text eingegeben wurde. Wenn der neue Wert nicht mit dem erwarteten Wert übereinstimmt, wird eine Ausnahme ausgelöst. Wenn diese Eingabe "false" (Standardeinstellung) ist, wird eine Warnung in das Protokoll eingegeben, es wird jedoch keine Ausnahme ausgelöst. |
|
|
Probieren Sie das Wertmuster aus.
|
TryValuePattern | boolean |
Bei Festlegung auf "true" (Standardeinstellung) versucht der IA-Connect Agent, ein UIA-Wertmuster zum Ausführen der Texteingabeaktion zu verwenden. Wenn das UIA-Wertmuster im ausgewählten Element nicht verfügbar ist, fällt der IA-Connect Agent auf andere Muster zurück (aktiviert oder deaktiviert über andere Eingaben für diese Aktion). Wenn dieser Wert auf "false" festgelegt ist, versucht der IA-Connect Agent nicht, ein Wertmuster zu verwenden, und tritt sofort auf andere ausgewählte Muster zurück. |
|
|
Legacymuster ausprobieren
|
TryLegacyPattern | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht der IA-Connect Agent, ein UIA-Legacymuster zum Ausführen der Texteingabeaktion zu verwenden, wenn das Wertmuster nicht verfügbar ist (entweder weil es für das Element nicht vorhanden ist oder weil die Verwendung deaktiviert war). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Festlegen des UIA-Elementsuchmodus
Wählen Sie aus, welcher UIA-Elementsuchmodus vom IA-Connect Agent beim Ausführen von UIA-Aktionen verwendet werden soll. In der Regel wird diese Aktion nur verwendet, wenn Sie ein Problem mit dem Standardmodus haben (Alle suchen).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
UIA-Elementsuchmodus
|
UIAElementSearchMode | True | string |
Der zu verwendende UIA-Elementsuchmodus. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
SetUIAElementSearchModeResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen des UIA-Fensters auf "Normal"
Normalisiert das Fenster mit dem angegebenen UIA-Ziehpunkt (d. h. legt es auf ein normales Fenster fest, anstatt minimiert oder maximiert).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | True | integer |
Der UIA-Ziehpunkt für die Normalisierung des Fensters. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Focus UIA-Element
Konzentriert sich auf ein Element, das es zum aktiven Element für den Tastaturfokus macht und je nach Anwendung das Elementfenster in den Vordergrund bringen kann.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Global mouse click UIA element search color region
Verschiebt die Maus über einen Pixelbereich in einem UIA-Element, das den angegebenen Farbkriterien entspricht, und führt einen Mausklick aus. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Screenshot eine Kopie des Bildschirms an der Position der Elemente erstellt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Farbe suchen
|
SearchColour | True | string |
Suchfarbe im Format 0xAARRGGBB, #AARRGGBB, 0xRRGGBB oder #RRGGBB, wobei jeder Farbkanal ein Byte im Hexformat ist (00 ist voll deaktiviert, FF ist voll aktiviert). Beispiel: #FF0000 für Rot, #00FF00 für Blau, #0000000 für Schwarz, #FFFFFF für Weiß. |
|
Maximale Farbabweichung
|
MaxColourDeviation | True | integer |
Die maximale Elementfarbe kann von der Suchfarbe abweichen, bevor sie nicht als Übereinstimmung betrachtet wird. 0 für keine Abweichung. Die Abweichung wird in RGB-Werten gemessen. Beispiel: #FF0000 unterscheidet sich von #FE0102. Eine Abweichung von 15 wäre ein guter Ausgangspunkt. |
|
X-Offset für das linke Pixel
|
LeftPixelXOffset | integer |
Ein optionaler X-Offset für den linken Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Rechter Pixel X-Offset
|
RightPixelXOffset | integer |
Ein optionaler X-Offset für den rechten Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Y-Offset des oberen Pixels
|
TopPixelYOffset | integer |
Ein optionaler Y-Offset für den oberen Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Unterer Pixel-Y-Offset
|
BottomPixelYOffset | integer |
Ein optionaler Y-Offset für den unteren Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Maustaste
|
MouseButton | string |
Die Maustaste, die sie drücken soll (links, rechts, Mitte, Doppel links). |
|
|
Klicken Sie auf Offset X
|
ClickOffsetX | integer |
Die Anzahl der X-Pixel, um die die Klickaktion versetzt werden soll. Dieser Parameter unterstützt sowohl positive (rechte) als auch negative (linke) Offsetwerte. |
|
|
Klicken Sie auf Offset Y
|
ClickOffsetY | integer |
Die Anzahl der Y-Pixel, um die Klickaktion zu versatzen. Dieser Parameter unterstützt sowohl positive (negative) als auch negative (aufwärts) Offsetwerte. |
|
|
Offset relativ zu
|
OffsetRelativeTo | string |
Die relative Position des Farbbereichs, der versetzt werden soll (Mitte / Mitte / Mitte, Links, Rechts, Oben, Unten, Links, oben rechts, unten links, unten rechts, unten rechts). |
|
|
Verzögerung in Millisekunden
|
DelayInMilliseconds | integer |
Wenn Sie einen Doppelklick ausführen, wird die Verzögerung (in Millisekunden) zwischen den einzelnen Klicks verzögert. |
|
|
Agent ausblenden
|
HideAgent | boolean |
Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass es das zu analysierende Element nicht verdeckt. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Globale mittlere Mausklick auf das UIA-Element
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element und klickt auf die mittlere Maustaste.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Focus-Element zuerst
|
FocusElementFirst | boolean |
Soll IA-Connect versuchen, das Element vor dem globalen Klicken zu konzentrieren? |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Klicken Sie auf Offset X
|
ClickOffsetX | integer |
Die Anzahl der X-Pixel, um die die Klickaktion versetzt werden soll. Dieser Parameter unterstützt sowohl positive (rechte) als auch negative (linke) Offsetwerte. |
|
|
Klicken Sie auf Offset Y
|
ClickOffsetY | integer |
Die Anzahl der Y-Pixel, um die Klickaktion zu versatzen. Dieser Parameter unterstützt sowohl positive (negative) als auch negative (aufwärts) Offsetwerte. |
|
|
Offset relativ zu
|
OffsetRelativeTo | string |
Die relative Position des Elements, das versetzt werden soll (Mitte / Mitte / Mitte, Links, Rechts, Oben, Unten, Links, Oben rechts, Unten links, unten links, unten rechts). |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Globaler Doppelklick mit der linken Maustaste auf das UIA-Element
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element, und doppelklicken Sie auf die linke Maustaste.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Verzögerung in Millisekunden
|
DelayInMilliseconds | integer |
Die Verzögerung (in Millisekunden) zwischen jedem Klick. |
|
|
Focus-Element zuerst
|
FocusElementFirst | boolean |
Soll IA-Connect versuchen, das Element vor dem globalen Klicken zu konzentrieren? |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Klicken Sie auf Offset X
|
ClickOffsetX | integer |
Die Anzahl der X-Pixel, um die die Klickaktion versetzt werden soll. Dieser Parameter unterstützt sowohl positive (rechte) als auch negative (linke) Offsetwerte. |
|
|
Klicken Sie auf Offset Y
|
ClickOffsetY | integer |
Die Anzahl der Y-Pixel, um die Klickaktion zu versatzen. Dieser Parameter unterstützt sowohl positive (negative) als auch negative (aufwärts) Offsetwerte. |
|
|
Offset relativ zu
|
OffsetRelativeTo | string |
Die relative Position des Elements, das versetzt werden soll (Mitte / Mitte / Mitte, Links, Rechts, Oben, Unten, Links, Oben rechts, Unten links, unten links, unten rechts). |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Globaler Eingabetext in UIA-Element
Verschiebt die Maus in die Mitte des Elements, fokussiert es, klickt links und drückt die Tasten. Wird in der Regel mit einer Texteingabe verwendet, die keine systemeigenen UIA-Eingabemethoden akzeptiert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Focus-Element zuerst
|
FocusElement | boolean |
Soll IA-Connect versuchen, das Element vor dem globalen Klicken zu konzentrieren? |
|
|
Global left mouse click on element
|
GlobalMouseClickOnElement | boolean |
Soll ein globaler Mausklick an den Elementkoordinaten (um das Element zu fokussieren) ausgeführt werden, bevor Text eingegeben wird? |
|
|
Ersetzen eines vorhandenen Werts durch Löschen mit doppelter Maustaste
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Sollte ein vorhandener Wert durch Doppelklicken auf die Maus (zum Hervorheben) und dann durch Löschen ersetzt werden? |
|
|
Vorhandenen Wert durch löschen CTRL-A ersetzen
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Sollte ein vorhandener Wert durch Drücken der Ctrl-A ersetzt werden (um alle hervorzuheben) und dann zu löschen? Einige Elemente unterstützen möglicherweise keine Hervorhebung mit Ctrl-A in diesem Fall sollte die alternative Option "Vorhandenen Wert mithilfe von Doppelklick löschen" ausprobiert werden. |
|
|
Text, der eingegeben werden soll
|
TextToInput | string |
Der Textwert für die globale Eingabe mithilfe der Tastatur. |
|
|
Verwenden von Sendeschlüsselereignissen
|
SendKeyEvents | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden Schlüsselereignisse (eine API auf niedrigerer Ebene, die simulierte Tastenanschläge an das Betriebssystem sendet) verwendet. Wenn dieser Wert auf "false" festgelegt ist, werden stattdessen Schlüssel (eine API auf höherer Ebene, die Tastaturanschläge an das fokussierte Element sendet) verwendet. |
|
|
Intervall in Millisekunden
|
Interval | integer |
Die Anzahl der Millisekunden zwischen jedem Drücken der Taste. |
|
|
Symbole nicht interpretieren
|
DontInterpretSymbols | boolean |
Sollten Symbole in der Eingabe "Text für Eingabe" nicht als Sondertasten interpretiert werden (z. B. +für UMSCHALT, ^ für STRG)? Dies sollte auf "true" festgelegt werden, wenn Sie versuchen, die tatsächlichen Symbole einzugeben. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Globaler linker Mausklick auf das UIA-Element
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element und klickt auf die linke Maustaste.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Focus-Element zuerst
|
FocusElementFirst | boolean |
Soll IA-Connect versuchen, das Element vor dem globalen Klicken zu konzentrieren? |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Klicken Sie auf Offset X
|
ClickOffsetX | integer |
Die Anzahl der X-Pixel, um die die Klickaktion versetzt werden soll. Dieser Parameter unterstützt sowohl positive (rechte) als auch negative (linke) Offsetwerte. |
|
|
Klicken Sie auf Offset Y
|
ClickOffsetY | integer |
Die Anzahl der Y-Pixel, um die Klickaktion zu versatzen. Dieser Parameter unterstützt sowohl positive (negative) als auch negative (aufwärts) Offsetwerte. |
|
|
Offset relativ zu
|
OffsetRelativeTo | string |
Die relative Position des Elements, das versetzt werden soll (Mitte / Mitte / Mitte, Links, Rechts, Oben, Unten, Links, Oben rechts, Unten links, unten links, unten rechts). |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Globaler Rechtsklick auf das UIA-Element
Verschiebt die Maus in die Mitte oder einen ausgewählten Rand, eine Ecke oder einen Offset relativ zu einem UIA-Element und klickt auf die rechte Maustaste.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Focus-Element zuerst
|
FocusElementFirst | boolean |
Soll IA-Connect versuchen, das Element vor dem globalen Klicken zu konzentrieren? |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Klicken Sie auf Offset X
|
ClickOffsetX | integer |
Die Anzahl der X-Pixel, um die die Klickaktion versetzt werden soll. Dieser Parameter unterstützt sowohl positive (rechte) als auch negative (linke) Offsetwerte. |
|
|
Klicken Sie auf Offset Y
|
ClickOffsetY | integer |
Die Anzahl der Y-Pixel, um die Klickaktion zu versatzen. Dieser Parameter unterstützt sowohl positive (negative) als auch negative (aufwärts) Offsetwerte. |
|
|
Offset relativ zu
|
OffsetRelativeTo | string |
Die relative Position des Elements, das versetzt werden soll (Mitte / Mitte / Mitte, Links, Rechts, Oben, Unten, Links, Oben rechts, Unten links, unten links, unten rechts). |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Globales Eingabekennwort in das UIA-Element
Verschiebt die Maus in die Mitte des Elements, fokussiert es, klickt links und drückt die Tasten. Wird in der Regel mit einer Kennworteingabe verwendet, die systemeigene UIA-Eingabemethoden nicht akzeptiert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Focus-Element zuerst
|
FocusElement | boolean |
Soll IA-Connect versuchen, das Element vor dem globalen Klicken zu konzentrieren? |
|
|
Global left mouse click on element
|
GlobalMouseClickOnElement | boolean |
Soll ein globaler Mausklick an den Elementkoordinaten (um das Element zu fokussieren) ausgeführt werden, bevor Text eingegeben wird? |
|
|
Ersetzen eines vorhandenen Werts durch Löschen mit doppelter Maustaste
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Sollte ein vorhandener Wert durch Doppelklicken auf die Maus (zum Hervorheben) und dann durch Löschen ersetzt werden? |
|
|
Vorhandenen Wert durch löschen CTRL-A ersetzen
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Sollte ein vorhandener Wert durch Drücken der Ctrl-A ersetzt werden (um alle hervorzuheben) und dann zu löschen? Einige Elemente unterstützen möglicherweise keine Hervorhebung mit Ctrl-A in diesem Fall sollte die alternative Option "Vorhandenen Wert mithilfe von Doppelklick löschen" ausprobiert werden. |
|
|
Kennwort für eingabe
|
PasswordToInput | True | password |
Der Kennwortwert für die globale Eingabe mithilfe der Tastatur. |
|
Verwenden von Sendeschlüsselereignissen
|
SendKeyEvents | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden Schlüsselereignisse (eine API auf niedrigerer Ebene, die simulierte Tastenanschläge an das Betriebssystem sendet) verwendet. Wenn dieser Wert auf "false" festgelegt ist, werden stattdessen Schlüssel (eine API auf höherer Ebene, die Tastaturanschläge an das fokussierte Element sendet) verwendet. |
|
|
Intervall in Millisekunden
|
Interval | integer |
Die Anzahl der Millisekunden zwischen jedem Drücken der Taste. |
|
|
Symbole nicht interpretieren
|
DontInterpretSymbols | boolean |
Sollten Symbole in der Eingabe "Kennwort für Eingabe" nicht als Sondertasten interpretiert werden (z. B. +für UMSCHALT, ^ für STRG)? Dies sollte auf "true" festgelegt werden, wenn Sie versuchen, die tatsächlichen Symbole einzugeben. |
|
|
Kennwort enthält gespeichertes Kennwort
|
PasswordContainsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn das Kennwort einen IA-Connect gespeicherten Kennwortbezeichner enthält (oder vollständig), im Format {IAConnectPassword:StoredPasswordIdentifier} oder in einem IA-Connect Orchestrator generische Anmeldeinformationen im Format {OrchestratorCredential:FriendlyName}. Dieses gespeicherte Kennwort könnte beispielsweise durch die Aktion "Kennwort generieren" generiert oder vom IA-Connect Orchestrator gehalten werden. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Überprüfen des klickbaren Punkts innerhalb der Elementgrenze
|
ValidateClickablePointWithinElementBoundary | boolean |
Bei einigen Elementen ist UIA nicht mit einem klickbaren Punkt innerhalb des Elements nicht bewusst und gibt eine ungültige Koordinate (z. B. 0,0) anstelle der Mitte des Elements zurück. Wenn diese Eingabe auf "true" festgelegt ist, überprüft IA-Connect die Gültigkeit der von UIA bereitgestellten Koordinate, und wenn nicht innerhalb der Grenze des Elements, wird der von der UIA bereitgestellte Wert ignoriert und stattdessen die Mitte des Elements verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Ist das UIA-Desktopelement vorhanden
Gibt an, ob ein Desktopelement vorhanden ist und einige grundlegende Elementeigenschaften bereitstellt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Wenn angegeben (ein Wert von 1 oder höher) berücksichtigt die Suche nur Elemente, die einem Prozess mit dieser Prozess-ID (PID) gehören. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer (oder 0). |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess zurückgegeben, der der exakten "Suchprozess-ID" entspricht. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Element vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
|
Elementhandle
|
ElementHandle | integer |
Das UIA-Handle für das Element. Dies kann als Eingabe für weitere UIA-Aktionen verwendet werden, die auf dieses Element wirken. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
Ist das UIA-Element aktiviert
Diese Aktion gibt "true" oder "false" zurück, der angibt, ob ein Element (in der Regel ein Kontrollkästchen oder ein Optionsfeld) aktiviert ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist aktiviert
|
ElementIsChecked | boolean |
Gibt true zurück, wenn das Element aktiviert oder falsch ist, wenn dies nicht der Fall ist. |
Ist das Win32-Fenster der obersten Ebene vorhanden
Eine schnelle Win32-Aktion, die meldet, ob ein Win32-Fenster auf oberster Ebene vorhanden ist. Ein Fenster der obersten Ebene ist ein Fenster, das mit dem Desktop verbunden ist. Sie können nach Klassennamen oder Fenstertiteln suchen oder erweiterte Suchfilter angeben, einschließlich Wildcards. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Das Fenster muss vorhanden sein, IA-Connect wartet nicht. Es ist häufiger, die UIA-Aktion "Ist das UIA-Desktopelement vorhanden" zu verwenden, das leistungsfähiger ist, aber diese Win32-Aktion wird in der Regel schneller ausgeführt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchklassenname
|
SearchClassName | string |
Der Elementklassenname des Fensters der obersten Ebene, nach dem gesucht werden soll, z. B. "Editor". |
|
|
Titel des Suchfensters
|
SearchWindowTitle | string |
Der Titel des Fensters der obersten Ebene, nach dem gesucht werden soll. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Die optionale Prozess-ID des Prozesses, der das Fenster besitzt (z. B. wie durch die Ausgabe der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt). Auf 0 festgelegt, um nicht nach Prozess-ID zu suchen. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren auf verfügbare Fenstereigenschaften weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Titel] wie '*Excel' UND [IsMinimised] = False AND [IsResizeable] = True. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fenster ist vorhanden
|
WindowExists | boolean |
Gibt true zurück, wenn das Fenster vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
Ist UIA-Element vorhanden
Gibt an, ob ein Element vorhanden ist, und gibt einige grundlegende Elementeigenschaften zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Wenn angegeben (ein Wert von 1 oder höher) berücksichtigt die Suche nur Elemente, die einem Prozess mit dieser Prozess-ID (PID) gehören. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer (oder 0). |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess gesucht, der mit der genauen "Suchprozess-ID" übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Element vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
|
Elementhandle
|
ElementHandle | integer |
Das UIA-Handle für das Element. Dies kann als Eingabe für weitere UIA-Aktionen verwendet werden, die auf dieses Element wirken. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
Klicken Sie auf das UIA-Listenelementelement anhand des Namens.
Klickt auf das Listenelement mit dem angegebenen Namen. Dies wird in der Regel verwendet, um ein Element in einem Dropdown-/Menüelement auszuwählen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Zuerst erweitern
|
ExpandFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, die Liste zu erweitern, bevor nach den Listenelementelementen gesucht wird. Dies ist nützlich für dynamische Listen, da die Listenelementelemente möglicherweise erst erstellt werden, wenn die Liste erweitert wird. |
|
|
Reduzieren nach
|
CollapseAfter | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die Liste nach der Ausführung der Suche reduziert. |
|
|
Elementname
|
ItemName | string |
Der Name des Elementelements, auf das geklickt werden soll. |
|
|
Sekunden zwischen Erweitern und Reduzieren
|
SecondsBetweenExpandCollapse | double |
Die Anzahl der Sekunden, die zwischen den Aktionen zum Erweitern und Reduzieren warten sollen, wenn diese auf "true" festgelegt sind. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Klicken Sie nach Index auf UIA-Listenelementelement.
Klickt auf das Listenelement, das dem angegebenen Index entspricht. Dies wird in der Regel verwendet, um ein Element in einem Dropdown-/Menüelement auszuwählen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Zuerst erweitern
|
ExpandFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, die Liste zu erweitern, bevor nach den Listenelementelementen gesucht wird. Dies ist nützlich für dynamische Listen, da die Listenelementelemente möglicherweise erst erstellt werden, wenn die Liste erweitert wird. |
|
|
Reduzieren nach
|
CollapseAfter | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die Liste nach der Ausführung der Suche reduziert. |
|
|
Elementindex
|
ItemIndex | integer |
Der Index in der Liste des zu klickenden Elements. |
|
|
Sekunden zwischen Erweitern und Reduzieren
|
SecondsBetweenExpandCollapse | double |
Die Anzahl der Sekunden, die zwischen den Aktionen zum Erweitern und Reduzieren warten sollen, wenn diese auf "true" festgelegt sind. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Maximieren des UIA-Fensters
Maximiert das Fenster mit dem angegebenen UIA-Handle.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | True | integer |
Der UIA-Ziehpunkt für das Fenster wird maximiert. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Minimieren des UIA-Fensters
Minimiert das Fenster mit dem angegebenen UIA-Handle.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | True | integer |
Der UIA-Ziehpunkt für das Fenster soll minimiert werden. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Schließen des UIA-Elementfensters
Schließt das Elementfenster. Funktioniert in der Regel nur für Fenster oder Dialogfelder.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Screenshot des UIA-Elementspeicherorts erstellen
Erstellt einen Screenshot der Position eines Elements und gibt ein Bild zurück. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Screenshot eine Kopie des Bildschirms an der Position der Elemente erstellt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Bildformat
|
ImageFormat | string |
Das für den Screenshot zu verwendende Bildformat. Dies kann sich auf die Qualität und Größe der zurückgegebenen Daten auswirken. Unterstützte Formate sind PNG (Standard), JPG, BMP und GIF. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Agent ausblenden
|
HideAgent | boolean |
Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass der Screenshot nicht verdeckt wird. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Bildschirmbild als Base64
|
ScreenBitmapBase64 | string |
Das Bildschirmbild als base64-codierte Zeichenfolge. |
Suchbereich für UIA-Elemente abrufen
Gibt die Details des Bereichs von Pixeln innerhalb eines UIA-Elements zurück, die den angegebenen Farbkriterien entsprechen. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent Farben findet, indem er einen Screenshot an den Koordinaten des Elements erstellt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Farbe suchen
|
SearchColour | True | string |
Suchfarbe im Format 0xAARRGGBB, #AARRGGBB, 0xRRGGBB oder #RRGGBB, wobei jeder Farbkanal ein Byte im Hexformat ist (00 ist voll deaktiviert, FF ist voll aktiviert). Beispiel: #FF0000 für Rot, #00FF00 für Blau, #0000000 für Schwarz, #FFFFFF für Weiß. |
|
Maximale Farbabweichung
|
MaxColourDeviation | True | integer |
Die maximale Elementfarbe kann von der Suchfarbe abweichen, bevor sie nicht als Übereinstimmung betrachtet wird. 0 für keine Abweichung. Die Abweichung wird in RGB-Werten gemessen. Beispiel: #FF0000 unterscheidet sich von #FE0102. Eine Abweichung von 15 wäre ein guter Ausgangspunkt. |
|
X-Offset für das linke Pixel
|
LeftPixelXOffset | integer |
Ein optionaler X-Offset für den linken Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Rechter Pixel X-Offset
|
RightPixelXOffset | integer |
Ein optionaler X-Offset für den rechten Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Y-Offset des oberen Pixels
|
TopPixelYOffset | integer |
Ein optionaler Y-Offset für den oberen Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Unterer Pixel-Y-Offset
|
BottomPixelYOffset | integer |
Ein optionaler Y-Offset für den unteren Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Agent ausblenden
|
HideAgent | boolean |
Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass es das zu analysierende Element nicht verdeckt. |
|
|
Zurückgeben von Bildschirmkoordinaten als physisch
|
ReturnPhysicalCoordinates | boolean |
Wird auf "true" festgelegt, damit die Bildschirmkoordinaten als physische Koordinaten zurückgegeben werden. Auf "false" festgelegt, damit die Bildschirmkoordinaten als virtuelle Koordinaten zurückgegeben werden. Wenn die zugrunde liegende Anzeigeskalierung 100%ist, sind sowohl physische als auch virtuelle Koordinaten identisch. Elementkoordinaten werden immer als virtuelle Koordinaten zurückgegeben. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der Pixel, die der Farbe entsprechen
|
NumberOfPixelsMatchingColour | integer |
Die Anzahl der Pixel, die der angegebenen Farbe entsprechen. |
|
Farb match bounding box element left pixel
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
Die virtuelle X-Koordinate des linken Pixels entspricht der angegebenen Farbe relativ zum element virtual top-left. |
|
Farbausgleich umgebendes Feldelement rechts pixel
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
Die virtuelle X-Koordinate des rechtssten Pixels entspricht der angegebenen Farbe relativ zum element virtual top-left. |
|
Oberes Pixel der Farbausgleichung des umgebenden Feldelements
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
Die virtuelle Y-Koordinate des höchsten Pixels entspricht der angegebenen Farbe relativ zum virtuellen Element von oben links. |
|
Farb match bounding box element bottom pixel
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
Die virtuelle Y-Koordinate des unteren Pixels entspricht der angegebenen Farbe relativ zum virtuellen Element oben links. |
|
Farb match bounding box element center X pixel
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
Die virtuelle X-Koordinate der Mitte des Umgebenden Felds, die Pixel enthält, die der angegebenen Farbe entsprechen, relativ zum element virtual top-left. |
|
Farbe übereinstimmung begrenzungsfeld element zentriert Y pixel
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
Die virtuelle Y-Koordinate der Mitte des Umgebenden Felds, die Pixel enthält, die der angegebenen Farbe entsprechen, relativ zum element virtual top-left. |
|
Farb match bounding box screen left pixel
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels, die mit der angegebenen Farbe übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Farbausgleich begrenzungsfeldbildschirm rechts Pixel
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels, die mit der angegebenen Farbe übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Oberes Pixel der Farbausgleichung des umgebenden Feldbildschirms
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
Die Pixel-Y-Koordinate des Bildschirmpixels, die mit der angegebenen Farbe übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Farbausgleich, begrenzungsfeldbildschirm unteres Pixel
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
Die Y-Koordinate des Bildschirmpixels am unteren Rand entspricht der angegebenen Farbe. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Farbausgleich begrenzungsfeld Bildschirmmitte X Pixel
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels der Mitte des umgebenden Felds mit Pixeln, die der angegebenen Farbe entsprechen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Farb match bounding box screen center Y pixel
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
Die Y-Koordinate des Bildschirmpixels der Mitte des umgebenden Felds, das Pixel enthält, die der angegebenen Farbe entsprechen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
Suchen eines sichtbaren Suchbilds innerhalb des UIA-Elements
Gibt zurück, ob ein Suchbild, das als Eingabe für diese Aktion bereitgestellt wird, sichtbar innerhalb eines UIA-Elements auf dem Bildschirm gespeichert wurde. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent einen Screenshot an den Koordinaten des Elements erstellt und im Screenshot nach dem bereitgestellten Suchbild sucht.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Suchbildtyp
|
SearchImageType | string |
Definiert, was die Eingabe "Suchbild" darstellt. Bei Festlegung auf "Director-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Director zugreifen kann. Bei Festlegung auf "Agent-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Agent zugreifen kann. Bei Festlegung auf "Base64" ist das Suchbild eine Base64-Darstellung des Bilds. |
|
|
Suchbild
|
SearchImage | string |
Das Suchbild, das innerhalb des angegebenen UIA-Elements gefunden werden soll. Je nach dem angegebenen Suchbildtyp kann dies den Pfad zu einer Bilddatei (am Director- oder Agent-Ende) enthalten oder die Base64 (Textdarstellung) des zu suchnden Bilds enthalten. |
|
|
Alternativer Suchbildtyp
|
AltSearchImageType | string |
Definiert, was die Eingabe "Alternatives Suchbild" darstellt. Wenn dieser Wert auf "Keine" oder leer festgelegt ist, gibt es kein alternatives Suchbild. Bei Festlegung auf "Director-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Director zugreifen kann. Bei Festlegung auf "Agent-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Agent zugreifen kann. Bei Festlegung auf "Base64" ist das Suchbild eine Base64-Darstellung des Bilds. |
|
|
Alternatives Suchbild
|
AltSearchImage | string |
Ein optionales alternatives Suchbild, das innerhalb des angegebenen UIA-Elements gefunden werden soll. Je nach dem angegebenen "Alternativen Suchbildtyp" kann dies den Pfad zu einer Bilddatei (am Director- oder Agent-Ende) enthalten oder die base64 (Textdarstellung) des gesuchten Bilds enthalten. Wenn Sie ein alternatives Suchbild angeben, sucht der Agent entweder nach dem Such- oder alternativsuchbild und dem Bericht, der sich befindet. |
|
|
Maximale Farbabweichung
|
MaxColourDeviation | integer |
Die Pixelfarben eines Elements können von den Pixelfarben des Suchbilds abweichen, bevor es nicht als Übereinstimmung betrachtet wird. 0 für keine Abweichung. Die Abweichung wird in RGB-Werten gemessen. Beispiel: #FF0000 unterscheidet sich von #FE0102. Dadurch können geringfügige Farbunterschiede ignoriert werden. |
|
|
Max. Pixelunterschiede
|
MaxPixelDifferences | integer |
Die maximale Anzahl von Pixeln, die sich (oberhalb der maximalen Farbabweichung) über das gesamte Suchbild unterscheiden können, bevor ein Bild als nicht übereinstimmend betrachtet wird. Dadurch können geringfügige Unterschiede zwischen Bildern ignoriert werden, aber höhere Werte können die Zeit erhöhen, die zum Auffinden eines Bilds erforderlich ist. Es wird empfohlen, bei Bedarf auf 0 festzulegen und um kleine Mengen zu erhöhen. Wenn die Einstellung auf einen Wert über 0 festgelegt ist, müssen Sie auch "Max. aufeinanderfolgende Pixelunterschiede" festlegen. |
|
|
Max. aufeinander folgende Pixelunterschiede
|
MaxConsecutivePixelDifferences | integer |
Die maximale Anzahl aufeinander folgender Pixel, die sich (über der maximalen Farbabweichung) in jeder Zeile unterscheiden können, bevor ein Bild als nicht übereinstimmend betrachtet wird. Dadurch können geringfügige Unterschiede zwischen Bildern ignoriert werden, aber höhere Werte können die Zeit erhöhen, die zum Auffinden eines Bilds erforderlich ist. Es wird empfohlen, bei Bedarf auf 0 festzulegen und um kleine Mengen zu erhöhen. Wenn die Einstellung auf einen Wert über 0 festgelegt ist, müssen Sie auch "Max. Pixelunterschiede" festlegen. |
|
|
X-Offset für das linke Pixel
|
LeftPixelXOffset | integer |
Ein optionaler X-Offset für den linken Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Rechter Pixel X-Offset
|
RightPixelXOffset | integer |
Ein optionaler X-Offset für den rechten Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Y-Offset des oberen Pixels
|
TopPixelYOffset | integer |
Ein optionaler Y-Offset für den oberen Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Unterer Pixel-Y-Offset
|
BottomPixelYOffset | integer |
Ein optionaler Y-Offset für den unteren Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Pixel X-Offsetseinheit
|
PixelXOffsetsUnit | string |
Wird auf "Pixel" (Standardeinstellung) festgelegt, wenn links- und rechte Pixel X-Offsets in Pixeln gemessen werden. Wird auf "Prozent" festgelegt, wenn links- und rechte Pixel X-Offsets als Prozentsatz der Elementbreite gemessen werden. |
|
|
Pixel-Y-Offseteinheit
|
PixelYOffsetsUnit | string |
Wird auf "Pixel" (Standardeinstellung) festgelegt, wenn obere und untere Pixel-Y-Offsets in Pixeln gemessen werden. Wird auf "Prozent" festgelegt, wenn obere und untere Pixel-Y-Offsets als Prozentsatz der Elementhöhe gemessen werden. |
|
|
Suchbildindex
|
SearchImageIndex | integer |
Legen Sie den 1 fest, um die erste Instanz des Suchbilds (in Richtung der Suche) innerhalb des UIA-Elements zu finden. Legen Sie für die zweite Instanz , .... , N für die Nth-Instanz auf 2 fest. Wenn Sie auch nach einem alternativen Bild suchen, wird das UIA-Element zuerst nach dem Suchbild gescannt, und zweitens nach dem alternativen Bild, suchen Sie nach der angeforderten Instanz dieses bestimmten Bilds (d. h. der Agent erwartet ein oder das andere, nicht eine Mischung aus beiden Bildern). |
|
|
Bildsuchrichtung
|
ImageSearchDirection | string |
Die Suchrichtung. "Von oben" sucht nach Zeile von oben, scannt von links nach rechts innerhalb jeder Zeile. "Von unten" sucht nach Zeile von unten, scannt von links nach rechts innerhalb jeder Zeile. "Von links" sucht nach Spalte von links, und scannt von oben nach unten in jeder Spalte. "Von rechts" sucht nach Spalte von rechts, und scannt von oben nach unten in jeder Spalte. Dies kann in Verbindung mit "Suchbildindex" verwendet werden, um das Nth-Bild von oben, unten, links oder rechts zu suchen. Um die Leistung zu verbessern, wählen Sie die Suchrichtung aus, die Sie denken, dass Ihr Bild schneller gefunden wird. |
|
|
Agent ausblenden
|
HideAgent | boolean |
Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass es das zu analysierende Element nicht verdeckt. |
|
|
Zurückgeben von Bildschirmkoordinaten als physisch
|
ReturnPhysicalCoordinates | boolean |
Wird auf "true" festgelegt, damit die Bildschirmkoordinaten als physische Koordinaten zurückgegeben werden. Auf "false" festgelegt, damit die Bildschirmkoordinaten als virtuelle Koordinaten zurückgegeben werden. Wenn die zugrunde liegende Anzeigeskalierung 100%ist, sind sowohl physische als auch virtuelle Koordinaten identisch. Elementkoordinaten werden immer als virtuelle Koordinaten zurückgegeben. |
|
|
Hervorhebungsrechteck anzeigen
|
ShowHighlightRectangle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird das bild vom IA-Connect Agent auf dem Bildschirm hervorgehoben. Dies kann während der Entwicklung hilfreich sein, um zu visualisieren, dass das richtige Bild erkannt wird. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Suchbild befindet sich
|
SearchImageLocated | boolean |
Auf "true" festgelegt, wenn sich das Suchbild befindet. Auf "false" festgelegt, wenn das Suchbild nicht gefunden wurde. |
|
Welches Suchbild sich befindet
|
WhichSearchImageLocated | integer |
Wird auf 0 festgelegt, wenn keine Suchbilder gefunden wurden. Legen Sie auf 1 fest, wenn sich das Suchbild befindet. Legen Sie "2" fest, wenn sich das alternative Suchbild befindet. |
|
Bild match bounding box element left pixel
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Die virtuelle X-Koordinate des linken Pixels, das dem angegebenen Bild entspricht, relativ zum virtuellen Element oben links. |
|
Bild match bounding box element right pixel
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Die virtuelle X-Koordinate des rechten Pixels, das dem angegebenen Bild entspricht, relativ zum element virtual top-left. |
|
Bild match bounding box element top pixel
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Die virtuelle Y-Koordinate des obersten Pixels, das dem angegebenen Bild entspricht, relativ zum virtuellen Element oben links. |
|
Bildabgleich umgebendes Feldelement unteres Pixel
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Die virtuelle Y-Koordinate des unteren Pixels, das dem angegebenen Bild entspricht, relativ zum virtuellen Element oben links. |
|
Bildabgleich umgebendes Feldelement zentriert X Pixel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Die virtuelle X-Koordinate der Mitte des umgebenden Felds, die Pixel enthält, die dem angegebenen Bild entsprechen, relativ zum virtuellen Element oben links. |
|
Bild match bounding box element center Y pixel
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Die virtuelle Y-Koordinate der Mitte des umgebenden Felds, die Pixel enthält, die dem angegebenen Bild entsprechen, relativ zum virtuellen Element oben links. |
|
Bild match bounding box screen left pixel
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels, die mit dem angegebenen Bild übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen right pixel
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels, die mit dem angegebenen Bild übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen top pixel
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Die Y-Koordinate des Bildschirmpixels, die mit dem angegebenen Bild übereinstimmen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen bottom pixel
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Die Pixel-Y-Koordinate des Bildschirmpixels am unteren Rand, der dem angegebenen Bild entspricht. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen center X pixel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Die X-Koordinate des Bildschirmpixels der Mitte des umgebenden Felds, das Pixel enthält, die dem angegebenen Bild entsprechen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
|
Bild match bounding box screen center Y pixel
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Die Y-Koordinate des Bildschirmpixels der Mitte des umgebenden Felds, das Pixel enthält, die dem angegebenen Bild entsprechen. Dies ist entweder eine physische oder virtuelle Koordinate, abhängig von den Eingaben "Physische Koordinaten zurückgeben". |
Suchen nach dem ersten übergeordneten UIA-Element
Durchsucht die UIA-Strukturhierarchie nach dem ersten übergeordneten Element, das den Suchkriterien entspricht. Das übergeordnete Element wird als Element definiert, das sich auf der nächsten Ebene der UIA-Struktur befindet und fast immer ein enthaltenes Element ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Elementhandle
|
ElementHandle | True | integer |
Das UIA-Handle für das Zielelement. |
|
Lokalisierter Steuerelementtyp des übergeordneten Elements durchsuchen
|
SearchParentLocalizedControlType | string |
Der lokalisierte Steuerelementtyp des übergeordneten UIA-Elements, nach dem gesucht werden soll. Dies kann über Inspektion ermittelt werden. |
|
|
Steuerelementtyp des übergeordneten Elements durchsuchen
|
SearchParentControlType | integer |
Der übergeordnete UIA-Elementsteuerelementtyp (eine nicht lokalisierte ganze Zahl), nach der gesucht werden soll. Dies ist derselbe Wert in verschiedenen Sprachen. |
|
|
Max. Eltern, die verarbeitet werden sollen
|
MaxParentsToProcess | integer |
Die maximale Anzahl der zu verarbeitenden übergeordneten Elemente. Standardmäßig ist dies auf 50 festgelegt. |
|
|
Auslösen einer Ausnahme, wenn das übergeordnete Element nicht gefunden wurde
|
RaiseExceptionIfParentElementNotFound | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn sich das UIA-Suchelement nicht befindet? |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Übergeordnetes Element gefunden
|
ParentElementFound | boolean |
Gibt true zurück, wenn das übergeordnete UIA-Element der Suche gefunden wurde. |
|
Übergeordnetes Elementhandle
|
ParentElementHandle | integer |
Das UIA-Handle für das sich befindende übergeordnete Element. Dies kann als Eingabe für weitere UIA-Aktionen verwendet werden, die auf dieses Element wirken. |
|
Name des übergeordneten Elements
|
ParentElementName | string |
Der UIA-Name des übergeordneten Elements. |
|
Name der übergeordneten Elementklasse
|
ParentElementClassName | string |
Der UIA-Klassenname des übergeordneten Elements. |
|
Automatisierungs-ID des übergeordneten Elements
|
ParentElementAutomationId | string |
Die UIA-Automatisierungs-ID des übergeordneten Elements. |
|
Lokalisierter Steuerelementtyp des übergeordneten Elements
|
ParentElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des übergeordneten Elements. |
UIA-Element auswählen
Wählt ein Element aus (in der Regel ein Element in einer Liste oder Dropdownliste).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
UIA-Element umschalten
Schaltet ein Element um (in der Regel ein Kontrollkästchen oder ein Optionsfeld). Dadurch erhält das Element den entgegengesetzten Zustand zu seinem aktuellen Zustand (z. B. aktiviert und umgekehrt). Wenn Sie einen bestimmten Zustand festlegen möchten, verwenden Sie stattdessen die Aktion "Element überprüfen".
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
UIA-Element verschieben
Verschiebt ein UIA-Element an eine angegebene Position auf dem Bildschirm. Diese Aktion funktioniert in der Regel nur mit Fensterelementen (die das Transformationsmuster aufweisen).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Horizontaler Bewegungstyp
|
HorizontalMovementType | string |
Der Bewegungstyp: Absolut oder relativ. |
|
|
Horizontale Position
|
HorizontalPosition | True | integer |
Die neue horizontale Position für das Element. Der Bewegungstyp (z. B. absolut oder relativ) wird durch die Eingabe "Horizontaler Bewegungstyp" definiert. Um die horizontale Position unverändert zu lassen, wählen Sie den Wert 0 aus, und legen Sie "Horizontaler Bewegungstyp" auf "Relativ" fest. |
|
Vertikaler Bewegungstyp
|
VerticalMovementType | string |
Der Bewegungstyp: Absolut oder relativ. |
|
|
Vertikale Position
|
VerticalPosition | True | integer |
Die neue vertikale Position für das Element. Der Bewegungstyp (z. B. absolut oder relativ) wird durch die Eingabe "Vertikaler Bewegungstyp" definiert. Um die vertikale Position unverändert zu lassen, wählen Sie den Wert 0 aus, und legen Sie "Vertikaler Bewegungstyp" auf "Relativ" fest. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
UIAMoveElementResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
UIA-Handle für Desktop abrufen
Gibt ein Handle für den Desktop zurück. Dies ist eine veraltete Aktion, da das Handle "-2" verwendet werden kann, um auf das Desktopelement zu verweisen, aber auch weil es viele Aktionen gibt, die relativ zum Desktop suchen können (z. B. "Warten auf desktopelement").
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Der UIA-Handle für den Desktop. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Desktopelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Desktopelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Desktopelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Desktopelements. |
UIA-Handle für Prozess-Hauptfenster abrufen
Eine einfache und schnelle Win32-Aktion, die das Handle für ein beliebiges Hauptfenster eines Prozesses zurückgibt (mit Namen angegeben). Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Das Fenster muss vorhanden sein: IA-Connect wartet nicht. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name des Suchvorgangs
|
SearchProcessName | True | string |
Der Name des zu suchden Prozesses, z. B. Editor. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
UIA-Handle für Prozess-ID-Hauptfenster abrufen
Eine einfache und schnelle Win32-Aktion, die das Handle für ein beliebiges Hauptfenster eines Prozesses zurückgibt (angegeben durch Prozess-ID). Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchprozess-ID
|
ProcessId | True | integer |
Die ID des Prozesses, auf den gewartet werden soll (wie von der Aktion "Prozess ausführen" in den Aktionen IA-Connect Umgebung/Sitzung angegeben). |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
Vordergrund-UIA-Fenster festlegen
Bringt ein Fenster in den Vordergrund.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | True | integer |
Das UIA-Handle für das Fenster, das als Vordergrundfenster festgelegt werden soll. |
|
Fenster ein/aus
|
ToggleWindow | boolean |
Soll das Fenster umgeschaltet werden, indem Sie versuchen, den Fokus zu setzen oder darauf zu klicken? Dadurch wird sichergestellt, dass das Fenster zuverlässig in den Vordergrund gebracht wird. |
|
|
Umschalter verwendet den globalen Agent für linksklicks
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
Wenn Sie das Fenster umschalten möchten, gibt dies an, ob globale Mausklicks verwendet werden sollen, um zuerst den IA-Connect Agent zu konzentrieren. |
|
|
Verzögerung in Sekunden umschalten
|
ToggleDelay | double |
Wenn Sie das Fenster umschalten möchten, gibt dies die Pause nach dem Umschalten an. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Warten, bis das sichtbare Suchbild nicht innerhalb des UIA-Elements vorhanden ist
Wartet, bis ein Suchbild, das als Eingabe für diese Aktion bereitgestellt wird, nicht sichtbar innerhalb eines UIA-Elements auf dem Bildschirm gefunden werden kann oder der angegebene Zeitraum vergangen ist und das Bild noch vorhanden ist. Das Element sollte zuerst in den Vordergrund gebracht werden, da der Agent einen Screenshot an den Koordinaten des Elements erstellt und im Screenshot nach dem bereitgestellten Suchbild sucht. Das UIA-Element muss von Anfang an vorhanden sein. Die Aktion wird sofort abgeschlossen, sobald das Bild nicht mehr vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Suchbildtyp
|
SearchImageType | string |
Definiert, was die Eingabe "Suchbild" darstellt. Bei Festlegung auf "Director-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Director zugreifen kann. Bei Festlegung auf "Agent-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Agent zugreifen kann. Bei Festlegung auf "Base64" ist das Suchbild eine Base64-Darstellung des Bilds. |
|
|
Suchbild
|
SearchImage | string |
Das Suchbild, das innerhalb des angegebenen UIA-Elements gefunden werden soll. Je nach dem angegebenen Suchbildtyp kann dies den Pfad zu einer Bilddatei (am Director- oder Agent-Ende) enthalten oder die Base64 (Textdarstellung) des zu suchnden Bilds enthalten. |
|
|
Alternativer Suchbildtyp
|
AltSearchImageType | string |
Definiert, was die Eingabe "Alternatives Suchbild" darstellt. Wenn dieser Wert auf "Keine" oder leer festgelegt ist, gibt es kein alternatives Suchbild. Bei Festlegung auf "Director-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Director zugreifen kann. Bei Festlegung auf "Agent-Bilddatei" ist das Suchbild ein Pfad zu einer Datei, auf die der Agent zugreifen kann. Bei Festlegung auf "Base64" ist das Suchbild eine Base64-Darstellung des Bilds. |
|
|
Alternatives Suchbild
|
AltSearchImage | string |
Ein optionales alternatives Suchbild, das innerhalb des angegebenen UIA-Elements gefunden werden soll. Je nach dem angegebenen "Alternativen Suchbildtyp" kann dies den Pfad zu einer Bilddatei (am Director- oder Agent-Ende) enthalten oder die base64 (Textdarstellung) des gesuchten Bilds enthalten. Wenn Sie ein alternatives Suchbild angeben, sucht der Agent entweder nach dem Such- oder alternativsuchbild und dem Bericht, der sich befindet. |
|
|
Maximale Farbabweichung
|
MaxColourDeviation | integer |
Die Pixelfarben eines Elements können von den Pixelfarben des Suchbilds abweichen, bevor es nicht als Übereinstimmung betrachtet wird. 0 für keine Abweichung. Die Abweichung wird in RGB-Werten gemessen. Beispiel: #FF0000 unterscheidet sich von #FE0102. Dadurch können geringfügige Farbunterschiede ignoriert werden. |
|
|
Max. Pixelunterschiede
|
MaxPixelDifferences | integer |
Die maximale Anzahl von Pixeln, die sich (oberhalb der maximalen Farbabweichung) über das gesamte Suchbild unterscheiden können, bevor ein Bild als nicht übereinstimmend betrachtet wird. Dadurch können geringfügige Unterschiede zwischen Bildern ignoriert werden, aber höhere Werte können die Zeit erhöhen, die zum Auffinden eines Bilds erforderlich ist. Es wird empfohlen, bei Bedarf auf 0 festzulegen und um kleine Mengen zu erhöhen. Wenn die Einstellung auf einen Wert über 0 festgelegt ist, müssen Sie auch "Max. aufeinanderfolgende Pixelunterschiede" festlegen. |
|
|
Max. aufeinander folgende Pixelunterschiede
|
MaxConsecutivePixelDifferences | integer |
Die maximale Anzahl von Pixeln, die sich (über der maximalen Farbabweichung) unterscheiden können, in jeder Zeile, bevor ein Bild als nicht übereinstimmend betrachtet wird. Dadurch können geringfügige Unterschiede zwischen Bildern ignoriert werden, aber höhere Werte können die Zeit erhöhen, die zum Auffinden eines Bilds erforderlich ist. Es wird empfohlen, bei Bedarf auf 0 festzulegen und um kleine Mengen zu erhöhen. Wenn die Einstellung auf einen Wert über 0 festgelegt ist, müssen Sie auch "Max. Pixelunterschiede" festlegen. |
|
|
X-Offset für das linke Pixel
|
LeftPixelXOffset | integer |
Ein optionaler X-Offset für den linken Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Rechter Pixel X-Offset
|
RightPixelXOffset | integer |
Ein optionaler X-Offset für den rechten Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Y-Offset des oberen Pixels
|
TopPixelYOffset | integer |
Ein optionaler Y-Offset für den oberen Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit negativen Werten) vergrößern oder verkleinern (mit positiven Werten). |
|
|
Unterer Pixel-Y-Offset
|
BottomPixelYOffset | integer |
Ein optionaler Y-Offset für den unteren Rand des Suchbereichs. Auf diese Weise können Sie den Suchbereich (mit positiven Werten) vergrößern oder verkleinern (mit negativen Werten). |
|
|
Pixel X-Offsetseinheit
|
PixelXOffsetsUnit | string |
Wird auf "Pixel" (Standardeinstellung) festgelegt, wenn links- und rechte Pixel X-Offsets in Pixeln gemessen werden. Wird auf "Prozent" festgelegt, wenn links- und rechte Pixel X-Offsets als Prozentsatz der Elementbreite gemessen werden. |
|
|
Pixel-Y-Offseteinheit
|
PixelYOffsetsUnit | string |
Wird auf "Pixel" (Standardeinstellung) festgelegt, wenn obere und untere Pixel-Y-Offsets in Pixeln gemessen werden. Wird auf "Prozent" festgelegt, wenn obere und untere Pixel-Y-Offsets als Prozentsatz der Elementhöhe gemessen werden. |
|
|
Suchbildindex
|
SearchImageIndex | integer |
Legen Sie den 1 fest, um die erste Instanz des Suchbilds (in Richtung der Suche) innerhalb des UIA-Elements zu finden. Legen Sie für die zweite Instanz , .... , N für die Nth-Instanz auf 2 fest. Wenn Sie auch nach einem alternativen Bild suchen, wird das UIA-Element zuerst nach dem Suchbild gescannt, und zweitens nach dem alternativen Bild, suchen Sie nach der angeforderten Instanz dieses bestimmten Bilds (d. h. der Agent erwartet ein oder das andere, nicht eine Mischung aus beiden Bildern). |
|
|
Bildsuchrichtung
|
ImageSearchDirection | string |
Die Suchrichtung. "Von oben" sucht nach Zeile von oben, scannt von links nach rechts innerhalb jeder Zeile. "Von unten" sucht nach Zeile von unten, scannt von links nach rechts innerhalb jeder Zeile. "Von links" sucht nach Spalte von links, und scannt von oben nach unten in jeder Spalte. "Von rechts" sucht nach Spalte von rechts, und scannt von oben nach unten in jeder Spalte. Dies kann in Verbindung mit "Suchbildindex" verwendet werden, um das Nth-Bild von oben, unten, links oder rechts zu suchen. Um die Leistung zu verbessern, wählen Sie die Suchrichtung aus, die Sie denken, dass Ihr Bild schneller gefunden wird. |
|
|
Agent ausblenden
|
HideAgent | boolean |
Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass es das zu analysierende Element nicht verdeckt. |
|
|
Hervorhebungsrechteck anzeigen
|
ShowHighlightRectangle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird das bild vom IA-Connect Agent auf dem Bildschirm hervorgehoben. Dies kann während der Entwicklung hilfreich sein, um zu visualisieren, dass das richtige Bild erkannt wird. |
|
|
Sekunden, die warten, bis das Suchbild nicht vorhanden ist
|
SecondsToWait | integer |
Die Anzahl der Sekunden, bis das Suchbild nicht sichtbar innerhalb des UIA-Elements gespeichert ist. Wenn das Bild nach diesem Zeitpunkt noch vorhanden ist, wird eine Ausnahme ausgelöst, wenn "Ausnahme auslösen, wenn das Bild noch vorhanden ist" auf "true" festgelegt ist, andernfalls meldet die Aktion, dass das Bild noch vorhanden ist. |
|
|
Millisekunden zwischen Suchvorgängen
|
MillisecondsBetweenSearches | integer |
Die Anzahl der Millisekunden, die zwischen jedem UIA-Element auf dem Bildschirmscan gewartet werden sollen. Da die Bilderkennung CPU-kostenintensiv sein kann, kann eine Verzögerung sowohl dazu beitragen, die CPU-Auslastung zu verringern als auch auszudehnen. Beispiel: Wenn Sie davon ausgehen, dass ein Bild bis zu 1 Minute sichtbar sein kann, wird durch das Hinzufügen einer Pause von 5000 Millisekunden (5 Sekunden) zwischen Scans die CPU-Auslastung erheblich verringert (durch erhebliche Reduzierung der Anzahl der Scans), aber nur eine geringe Auswirkung auf die Reaktionszeit. Der zulässige Mindestwert beträgt 100 Millisekunden (1/10 Sekunde). |
|
|
Ausnahme auslösen, wenn das Bild weiterhin vorhanden ist
|
RaiseExceptionIfImageStillPresent | boolean |
Wird auf "true" festgelegt, wenn IA-Connect eine Ausnahme auslösen soll, wenn das Bild nach dem Wartezeitzeitraum noch vorhanden ist. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie zuvor "Auf Thread warten" auf "false" festgelegt haben (was bewirkt, dass der Agent die Wartezeit in einem Hintergrundthread ausführt), geben Sie die Agent-Thread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Andernfalls wird "0" (Standardeinstellung) festgelegt. |
|
|
Auf Thread warten
|
WaitForThread | boolean |
Auf "true" festlegen, bis der Agent-Thread abgeschlossen ist; Der Agent wartet so lange wie angegeben von "Sekunden, bis das Suchbild nicht vorhanden ist". Auf "false" festgelegt, um die Wartezeit zu umgehen; Der Agent führt weiterhin die Wartezeit in einem Hintergrundthread aus, ist aber auch für die nächste Aktion verfügbar. Sie können die Ergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis der Agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten, und führen Sie dann die Aktion "Auf sichtbares Suchbild warten, damit es nicht innerhalb des UIA-Elements vorhanden ist" aus, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Suchbild vor Dem Warten vorhanden
|
SearchImagePresentBeforeWait | boolean |
Diese Ausgabe wird auf "true" festgelegt, wenn das Suchbild zu Beginn des Wartezeitzeitraums vorhanden war. Diese Ausgabe wird auf "false" festgelegt, wenn das Suchbild von Anfang an nicht vorhanden war. |
|
Suchbild wird nach Dem Warten noch vorhanden
|
SearchImageStillPresentAfterWait | boolean |
Diese Ausgabe wird auf "true" festgelegt, wenn das Suchbild noch vorhanden ist, nach dem Wartezeitzeitraum. Diese Ausgabe wird auf "false" festgelegt, wenn das Suchbild nicht mehr vorhanden ist, während des Wartezeitzeitraums (die Aktion wird sofort abgeschlossen, sobald das Bild nicht mehr vorhanden ist). |
|
Welches Suchbild weiterhin vorhanden ist
|
WhichSearchImageStillPresent | integer |
Diese Ausgabe wird auf 0 festgelegt, wenn nach dem Wartezeitzeitraum noch keine Suchbilder vorhanden waren. Legen Sie "1" fest, wenn das Suchbild noch vorhanden war, nach dem Wartezeitraum. Legen Sie "2" fest, wenn das alternative Suchbild noch vorhanden war, nach dem Wartezeitraum. |
|
Thread-ID
|
ThreadId | integer |
Wenn Sie "Auf Thread warten" auf "false" festgelegt haben (was bewirkt, dass der Agent die Wartezeit in einem Hintergrundthread ausführt), enthält diese Ausgabe die Agentthread-ID, mit der der Prozess der Aktion überwacht und die Ergebnisse später abgerufen werden kann, wenn der Thread abgeschlossen wurde. |
Warten, bis das UIA-Desktopelement nicht vorhanden ist
Wartet, bis ein Desktopelement (in der Regel ein Fenster) nicht mehr vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Wenn angegeben (ein Wert von 1 oder höher) berücksichtigt die Suche nur Elemente, die einem Prozess mit dieser Prozess-ID (PID) gehören. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer (oder 0). |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, bis das Element nicht vorhanden ist. |
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess zurückgegeben, der der exakten "Suchprozess-ID" entspricht. |
|
|
Auslösen einer Ausnahme, wenn das Element noch vorhanden ist
|
RaiseExceptionIfElementStillExists | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn das UIA-Element nach der Wartezeit noch vorhanden ist? |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden, bevor gewartet wird
|
ElementExistsBeforeWait | boolean |
Gibt true zurück, wenn das Element vor dem Warten oder False vorhanden ist, wenn dies nicht der Fall ist. |
|
Element ist nach Wartezeit vorhanden.
|
ElementExistsAfterWait | boolean |
Gibt true zurück, wenn das Element nach dem Warten oder Falsch vorhanden ist, wenn dies nicht der Fall ist. |
Warten, bis das UIA-Element nicht vorhanden ist
Wartet auf ein Element (in der Regel ein einzelnes Element innerhalb eines Fensters, z. B. eine Schaltfläche oder einen Texteingabebereich), bis es nicht mehr vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Wenn angegeben (ein Wert von 1 oder höher) berücksichtigt die Suche nur Elemente, die einem Prozess mit dieser Prozess-ID (PID) gehören. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer (oder 0). |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, bis das Element nicht vorhanden ist. |
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess zurückgegeben, der der exakten "Suchprozess-ID" entspricht. |
|
|
Auslösen einer Ausnahme, wenn das Element noch vorhanden ist
|
RaiseExceptionIfElementStillExists | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn das UIA-Element nach der Wartezeit noch vorhanden ist? |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden, bevor gewartet wird
|
ElementExistsBeforeWait | boolean |
Gibt true zurück, wenn das Element vor dem Warten oder False vorhanden ist, wenn dies nicht der Fall ist. |
|
Element ist nach Wartezeit vorhanden.
|
ElementExistsAfterWait | boolean |
Gibt true zurück, wenn das Element nach dem Warten oder Falsch vorhanden ist, wenn dies nicht der Fall ist. |
Warten auf das Hauptfenster der UIA-Prozess-ID
Eine einfache und schnelle Win32-Aktion, die auf ein Hauptfenster eines Prozesses (angegeben durch Prozess-ID) wartet und ein Handle zurückgibt. Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchprozess-ID
|
ProcessId | True | integer |
Die ID des Prozesses, auf den gewartet werden soll (wie von der Aktion "Prozess ausführen" in den Aktionen IA-Connect Umgebung/Sitzung angegeben). |
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, die auf das Hauptfenster des Prozesses warten. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Element vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
Warten auf das Hauptfenster des UIA-Prozesses
Eine einfache und schnelle Win32-Aktion, die vor dem Zurückgeben eines Handles auf eine angegebene Zeit wartet, bis das Hauptfenster eines Prozesses (mit Dem Namen angegeben) vorhanden ist. Das Hauptfenster ist in der Regel das Hauptanwendungsfenster: Ein Anmeldedialogfeld oder Unterfenster ist im Allgemeinen nicht das Hauptfenster. Es wird empfohlen, die Aktion "Auf Desktopelement warten" zu verwenden, die leistungsstärker ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name des Suchvorgangs
|
SearchProcessName | True | string |
Der Name des zu suchden Prozesses, z. B. Editor. |
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, die auf das Hauptfenster des Prozesses warten. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Fenster vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
Warten auf das UIA-Desktopelement
Wartet, bis ein Desktopelement (in der Regel ein Fenster) vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Wenn angegeben (ein Wert von 1 oder höher) berücksichtigt die Suche nur Elemente, die einem Prozess mit dieser Prozess-ID (PID) gehören. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer (oder 0). |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, bis das Element vorhanden ist. |
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess zurückgegeben, der der exakten "Suchprozess-ID" entspricht. |
|
|
Auslösen einer Ausnahme, wenn das Element nicht gefunden wurde
|
RaiseExceptionIfElementNotFound | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn das UIA-Element nach dem Wartezeitraum nicht vorhanden ist? |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Element vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
|
Elementhandle
|
ElementHandle | integer |
Das UIA-Handle für das Element. Dies kann als Eingabe für weitere UIA-Aktionen verwendet werden, die auf dieses Element wirken. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
Warten auf das Win32-Fenster der obersten Ebene von UIA
Eine schnelle Win32-Aktion, die auf eine angegebene Zeit wartet, bis ein Win32-Fenster auf oberster Ebene vorhanden ist, bevor ein UIA-Handle zurückgegeben wird. Ein Fenster der obersten Ebene ist ein Fenster, das mit dem Desktop verbunden ist. Sie können nach Klassennamen oder Fenstertiteln suchen oder erweiterte Suchfilter angeben, einschließlich Wildcards. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Es ist häufiger, die UIA-Aktion "Auf Desktopelement warten" zu verwenden, was leistungsfähiger ist, aber diese Win32-Aktion wird in der Regel schneller ausgeführt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchklassenname
|
SearchClassName | string |
Der Elementklassenname des Fensters der obersten Ebene, nach dem gesucht werden soll, z. B. "Editor". |
|
|
Titel des Suchfensters
|
SearchWindowTitle | string |
Der Titel des Fensters der obersten Ebene, nach dem gesucht werden soll. |
|
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, bis das Fenster vorhanden ist. |
|
Suchprozess-ID
|
SearchProcessId | integer |
Die optionale Prozess-ID des Prozesses, der das Fenster besitzt (z. B. wie durch die Ausgabe der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt). Auf 0 festgelegt, um nicht nach Prozess-ID zu suchen. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren auf verfügbare Fenstereigenschaften weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Titel] wie '*Excel' UND [IsMinimised] = False AND [IsResizeable] = True. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Fenster mit der Suche übereinstimmen, können Sie angeben, nach welcher Fenstereigenschaft sortiert werden soll. Dies wird zusammen mit "Index abgleichen" verwendet, um das erforderliche Fenster zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Fenster zurückgegeben, das am oberen Rand des Bildschirms liegt. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Fenster mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Auslösen einer Ausnahme, wenn das Fenster nicht gefunden wurde
|
RaiseExceptionIfWindowNotFound | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn das Win32-Suchfenster nach dem Wartezeitzeitraum nicht vorhanden ist? |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fensterziehpunkt
|
WindowHandle | integer |
Das UIA-Handle für das Fenster. Dies kann als Eingabe für weitere UIA-Aktionen in diesem Fenster verwendet werden. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Fensterelements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Fensterelements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Fensterelements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Fensterelements. |
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Fenster vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
Warten auf UIA-Element
Wartet auf ein Element (in der Regel ein einzelnes Element innerhalb eines Fensters, z. B. eine Schaltfläche oder einen Texteingabebereich), um vorhanden zu sein.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Wenn angegeben (ein Wert von 1 oder höher) berücksichtigt die Suche nur Elemente, die einem Prozess mit dieser Prozess-ID (PID) gehören. Wenn IA-Connect den Prozess gestartet hat, wird die PID von der Aktion "Prozess ausführen" in den IA-Connect Umgebungs-/Sitzungsaktionen bereitgestellt. Wenn Sie die PID nicht kennen, lassen Sie dieses Feld leer (oder 0). |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Rückgabeelementhandle
|
ReturnElementHandle | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird ein Handle für das gefundene Element zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle zu fungieren. |
|
|
Sekunden, die gewartet werden sollen
|
SecondsToWait | True | integer |
Die maximale Anzahl von Sekunden, bis das Element vorhanden ist. |
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Einschließen untergeordneter Prozesse
|
IncludeChildProcesses | boolean |
Wenn "true" und eine "Suchprozess-ID" angegeben ist, werden auch untergeordnete Prozesse dieser Prozess-ID in die Suche einbezogen. Wenn dieser Wert auf "false" festgelegt ist, wird nur ein Prozess zurückgegeben, der der exakten "Suchprozess-ID" entspricht. |
|
|
Auslösen einer Ausnahme, wenn das Element nicht gefunden wurde
|
RaiseExceptionIfElementNotFound | boolean |
Sollte IA-Connect eine Ausnahme auslösen, wenn das UIA-Element nach dem Wartezeitraum nicht vorhanden ist? |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Element ist vorhanden
|
ElementExists | boolean |
Gibt true zurück, wenn das Element vorhanden oder falsch ist, wenn dies nicht der Fall ist. |
|
Elementhandle
|
ElementHandle | integer |
Das UIA-Handle für das Element. Dies kann als Eingabe für weitere UIA-Aktionen verwendet werden, die auf dieses Element wirken. |
|
Elementname
|
ElementName | string |
Der UIA-Name des Elements. |
|
Elementklassenname
|
ElementClassName | string |
Der UIA-Klassenname des Elements. |
|
Elementautomatisierungs-ID
|
ElementAutomationId | string |
Die UIA-Automatisierungs-ID des Elements. |
|
Lokalisierter Steuerelementtyp des Elements
|
ElementLocalizedControlType | string |
Der lokalisierte UIA-Steuerelementtyp des Elements. |
Win32-Fenster abrufen
Eine schnelle Win32-Aktion, die eine Liste aller Win32-Fenster zurückgibt, die optional den angegebenen Klassennamen oder Fenstertitel aufweisen, oder Sie können erweiterte Suchfilter angeben, einschließlich Wildcards. Obwohl diese Aktion Win32-APIs verwendet, kann sie Windows, Java, ModernUI und Webfenster erkennen. Win32 Windows kann unerwartete Elemente wie Taskleiste, Desktop, Startmenü, transparente Überlagerungen, Offscreen- oder ausgeblendete Fenster enthalten, sodass die zurückgegebene Liste möglicherweise mehr Ergebnisse als erwartet enthält.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchklassenname
|
SearchClassName | string |
Der optionale Klassenname des Fensters der obersten Ebene, nach dem gesucht werden soll, z. B. "Chrome_WidgetWin_1". |
|
|
Titel des Suchfensters
|
SearchWindowTitle | string |
Der optionale Titel des Fensters der obersten Ebene, nach dem gesucht werden soll. |
|
|
Nur Fenster der obersten Ebene abrufen
|
TopLevelWindowsOnly | boolean |
Legen Sie "true" fest, um nur Win32-Fenster abzurufen, die vom Betriebssystem als oberste Ebene betrachtet werden. Auf "false" festgelegt, um alle Win32-Fenster abzurufen. Beachten Sie, dass die Win32-Definition eines Fensters Elemente enthält, die Sie möglicherweise nicht als Fenster erkennen, und viele Dialogfelder und Meldungsfelder werden als oberste Ebene gekennzeichnet, obwohl sie ein untergeordnetes Element eines übergeordneten Fensters sind. |
|
|
Nur sichtbare Fenster abrufen
|
VisibleWindowsOnly | boolean |
Wird auf "true" festgelegt, um nur Win32-Fenster abzurufen, die vom Betriebssystem als sichtbar betrachtet werden. Auf "false" festgelegt, um sowohl sichtbare als auch nicht sichtbare Win32-Fenster abzurufen. Beachten Sie, dass offscreen- oder transparente Fenster möglicherweise als sichtbar gekennzeichnet sind, aber sie können nicht angezeigt werden. |
|
|
Nur Fenster mit einer Titelleiste abrufen
|
WindowsWithTitlebarOnly | boolean |
Auf "true" festlegen, um nur Win32-Fenster mit einer Titelleiste abzurufen. Legen Sie den Wert auf "false" fest, um Win32-Fenster abzurufen, unabhängig davon, ob sie über eine Titelleiste verfügen oder nicht. Beachten Sie, dass einige transparente Fenster Titelleisten aufweisen, aber sie können nicht angezeigt werden. |
|
|
Nur Fenster mit einem Titel abrufen
|
WindowsWithTitleOnly | boolean |
Legen Sie "true" fest, um nur Win32-Fenster mit einem Titel abzurufen (d. h. eine Titelleiste, die Text enthält). Legen Sie den Wert auf "false" fest, um Win32-Fenster abzurufen, unabhängig davon, ob sie über einen Titel verfügen. Beachten Sie, dass die Titelleiste der Streifen über dem oberen Rand des Fensters ist, während der Titel der Text darin ist. |
|
|
Transparente Fenster ignorieren
|
IgnoreTransparentWindows | boolean |
Legen Sie "true" fest, um nur Win32-Fenster abzurufen, die keine Transparenz aufweisen. Legen Sie "false" fest, um Win32-Fenster abzurufen, unabhängig davon, ob sie Transparenz festgelegt haben oder nicht. |
|
|
Suchprozess-ID
|
SearchProcessId | integer |
Die optionale Prozess-ID des Prozesses, der die Fenster besitzt (z. B. wie durch die Ausgabe der Aktion "Prozess ausführen" in der IA-Connect Umgebung /Sitzungsaktionen bereitgestellt). Auf 0 festgelegt, um nicht nach Prozess-ID zu suchen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Titel] wie '*Excel' UND [IsMinimised] = False AND [IsResizeable] = True. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Fenster mit der Suche übereinstimmen, können Sie angeben, nach welcher Fenstereigenschaft sortiert werden soll. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet, wird die Liste der Fenster nach oberer Kante sortiert. Wenn dieses Feld leer bleibt, werden Fenster in der Reihenfolge zurückgegeben, in der sie erkannt werden. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Fenster mit der Suche übereinstimmen und eine Sortierspalte angegeben ist, legen Sie auf "true" (Standardeinstellung) fest, um aufsteigend zu sortieren oder auf "false" festzulegen, um absteigend zu sortieren. |
|
|
Zurückgeben des UIA-Elementhandles
|
ReturnElementHandle | boolean |
Bei Festlegung auf "true" wird in der Ausgabeauflistung (in der Spalte "UIAHandle") ein UIA-Handle für jedes sich befindende Win32-Fenster zurückgegeben. Dieses Handle kann in weiteren Aktionen verwendet werden, um als "übergeordnetes" Handle in IA-Connect UIA-Aktionen zu fungieren. |
|
|
Erstes Element, das zurückgegeben werden soll
|
FirstItemToReturn | integer |
Der Index des ersten Fensters (Zeile), das zurückgegeben werden soll, beginnend mit 1. |
|
|
Max. Zurückzugebende Elemente
|
MaxItemsToReturn | integer |
Die maximale Anzahl von Fenstern, die zurückgegeben werden sollen, oder 0, um alle Elemente zurückzugeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Win32 windows JSON
|
Win32WindowsJSON | string |
Eine Liste von Win32-Fenstern, die den Suchkriterien im JSON-Format entsprechen. |
|
Anzahl der Win32-Fenster
|
NumberOfWin32Windows | integer |
Die Anzahl der zurückgegebenen Win32-Fenster. |
Zeichnen eines Rechtecks um das UIA-Element
Zeichnet ein Rechteck um den Umkreis eines Elements, um zu ermitteln, dass das gefundene Element die erforderliche ist. Das Rechteck wird nach 5 Sekunden automatisch entfernt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Stiftfarbe
|
PenColour | string |
Die Farbe des zu zeichnenden Rechtecks (z. B. Rot, Grün, Blau, Gelb, Lila oder Orange) oder ein Zeichenfolgen-Hexcode, z. B. #FF0000. |
|
|
Stiftstärke Pixel
|
PenThicknessPixels | integer |
Die Stärke (in Pixel) des Rands des Hervorhebungsrechtecks. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Zurücksetzen aller UIA-Elementhandles
Setzt alle UIA-Elementhandles zurück, die derzeit von IA-Connect gespeichert werden, was nützlich sein kann, wenn Sie viele Elemente identifizieren und eine große Anzahl von Elementhandles gespeichert haben. In Szenarien mit extrem hoher Anzahl von Elementhandles (100.000+) kann diese Aktion auch verwendet werden, um die RAM-Nutzung freizugeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Ändern der Größe des UIA-Elements
Ändert die Größe eines UIA-Elements. Diese Aktion funktioniert in der Regel nur mit Fensterelementen (die das Transformationsmuster aufweisen).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Größenänderungsbreitentyp
|
ResizeWidthType | string |
Der Typ der Breitenänderung: Absolut oder relativ. |
|
|
Neue Breite
|
NewWidth | True | integer |
Die neue Breite des Elements. Der Typ der Größenänderung (z. B. absolut oder relativ) wird durch die Eingabe "Größenänderungsbreitentyp" definiert. Um die Breite unverändert zu lassen, wählen Sie einen Wert von 0 aus, und legen Sie "Breitetyp ändern" auf "Relativ" fest. |
|
Höhentyp ändern
|
ResizeHeightType | string |
Der Typ der Höhenänderung: Absolut oder relativ. |
|
|
Neue Höhe
|
NewHeight | True | integer |
Die neue Höhe des Elements. Der Typ der Größenänderung (z. B. absolut oder relativ) wird durch die Eingabe "Höhentyp ändern" definiert. Um die Höhe unverändert zu lassen, wählen Sie einen Wert von 0 aus, und legen Sie "Höhentyp ändern" auf "Relativ" fest. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
UIAResizeElementResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Überprüfen des UIA-Elements
Legt den Status eines Elements (in der Regel ein Kontrollkästchen oder ein Optionsfeld) auf aktiviert oder deaktiviert fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziehpunkt für übergeordnete Fenster
|
ParentWindowHandle | True | integer |
Das übergeordnete UIA-Fensterhandle (ein Wert von 1 oder höher), der als Ausgangspunkt für die Suche fungiert. Dies kann mithilfe von Aktionen wie "Auf Desktopelement warten" oder "Auf Element warten" ermittelt werden. |
|
Name des Suchelements
|
SearchElementName | string |
Der optionale UIA-Elementname, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Name der Suchelementklasse
|
SearchElementClassName | string |
Der optionale Name der UIA-Elementklasse, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Automatisierungs-ID für Suchelemente
|
SearchElementAutomationId | string |
Die optionale Automatisierungs-ID für UIA-Elemente, nach der gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
Lokalisierter Steuerelementtyp des Suchelements
|
SearchLocalizedControlType | string |
Der optionale lokalisierte Steuerelementtyp des UIA-Elements, nach dem gesucht werden soll (beginnend mit dem übergeordneten Fensterhandle). Dies kann über Inspektion ermittelt werden. |
|
|
UIA-Unterstruktur durchsuchen
|
SearchSubTree | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird die gesamte UIA-Struktur unterhalb des übergeordneten Fensterhandles durchsucht. Dies ist gründlicher, kann aber länger dauern. Bei Festlegung auf "false" werden nur Elemente direkt unterhalb des übergeordneten Fensterhandles in der UIA-Struktur durchsucht. |
|
|
Check-Element
|
CheckElement | boolean |
Soll das Element aktiviert (true) oder deaktiviert werden (false)? |
|
|
Vergleichsindex
|
MatchIndex | integer |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte das Element (beginnend bei 1) übereinstimmen. Kann in Verbindung mit "Nach Spalte sortieren" verwendet werden, um die Sortierreihenfolge für den Abgleich auszuwählen. |
|
|
Suchfilter
|
SearchFilter | string |
Ein optionaler erweiterter Filter, um die Suche mithilfe bedingter Operatoren und eines beliebigen Elementfelds weiter einzuschränken. Beispiel 1: [Breite] < 200. Beispiel 2: [Name] wie 'Document*' UND [ClassName] wie 'Label*'. Weitere Beispiele finden Sie in der Dokumentation. |
|
|
Sortieren nach Spaltenname
|
SortByColumn | string |
Wenn mehrere Elemente mit der Suche übereinstimmen, können Sie angeben, nach welcher Elementeigenschaft sortiert werden soll. Dies wird in Verbindung mit "Index abgleichen" verwendet, um das erforderliche Element zu wählen. Beispiel: Wenn "Nach Spaltenname sortieren" [TopEdge] lautet und "Index übereinstimmen" 1 ist, wird das übereinstimmende Element, das am oberen Rand des Bildschirms am nächsten ist, abgeglichen. |
|
|
Vergleichsindex ist aufsteigend
|
MatchIndexAscending | boolean |
Wenn mehrere Elemente mit der Suche übereinstimmen, sollte "Index übereinstimmen" von oben in der sortierten Liste (true) oder vom Ende der sortierten Liste (false) übereinstimmen. |
|
|
Maximale Anzahl der zu durchsuchenden Elemente
|
MaxElementsToSearch | integer |
Die maximale Anzahl der Elemente, die beim Suchen nach dem Zielelement in der UIA-Struktur gesucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale relative Suchtiefe
|
MaxRelativeSearchDepth | integer |
Die maximale relative Strukturtiefe, um nach untergeordneten Elementen unter dem übergeordneten Element zu suchen. Direkte untergeordnete Elemente weisen einen Tiefenwert von 1 auf. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Legen Sie für eine unbegrenzte Suchtiefe auf 0 fest. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Maximale Anzahl untergeordneter Elemente, die pro Knoten durchsucht werden sollen
|
MaxChildElementsToSearchPerNode | integer |
Die maximale Anzahl untergeordneter Elemente, die beim Durchsuchen der UIA-Struktur für das Zielelement unter jedem Element durchsucht werden sollen. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Standardmäßig ist dies auf 0 (unbegrenzt) festgelegt. Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Lokalisierte Steuerelementtypen, die nicht durchlaufen werden sollen
|
ElementLocalizedControlTypesNotToTraverse | string |
Eine durch Trennzeichen getrennte Liste mit lokalisierten UIA-Element-Steuerelementtypen, die beim Durchsuchen der UIA-Struktur für das Zielelement nicht durchlaufen werden (Schritt in) Die Suche überprüft weiterhin, ob ein einzelnes Element den Suchkriterien entspricht. Es werden jedoch keine untergeordneten Elemente dieses Elements durchsucht, wenn sich der lokalisierte Steuerelementtyp in dieser Ausschlussliste befindet. Diese Eingabe funktioniert nur, wenn der UIA-Elementsuchmodus "Tree walk" ist (dies kann auf der Einstellungsseite im Inspektor aktiviert werden). Diese Eingabe wird in der Regel verwendet, um die Elementsuche zu optimieren. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Überprüfen mehrerer UIA-Elemente
Legt den Status mehrerer Elemente (in der Regel ein Kontrollkästchen oder ein Optionsfeld) auf aktiviert oder deaktiviert fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Eingabeelemente
|
InputElementsJSON | True | string |
Ein Array von UIA-Elementen, die im JSON-Format überprüft werden sollen. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |