Udostępnij przez


interfejs użytkownika IA-Connect

IA-Connect to platforma automatyzacji procesów robotycznych "RPA", która dodaje funkcje RPA z chmury do lokalnych maszyn wirtualnych lub za pośrednictwem połączeń usług pulpitu zdalnego firmy Citrix lub pulpitu zdalnego firmy Microsoft. Jest to moduł automatyzacji interfejsu użytkownika aplikacji systemu Windows "UIA".

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Ultima Labs
adres URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
Metadane łącznika
Publisher Ultima Business
Witryna internetowa https://www.ultima.com/ultima-labs
Zasady ochrony prywatności https://www.ultima.com/privacy-policy
Kategorie Operacje IT; Produktywność

IA-Connect to platforma automatyzacji procesów robotycznych (RPA), która dodaje funkcje RPA z przepływów chmury usługi Power Automate do lokalnych maszyn wirtualnych lub za pośrednictwem połączeń citrix lub pulpitu zdalnego (RDS). Łączniki IA-Connect udostępniają ponad 800 akcji, co pozwala zautomatyzować każdy typ aplikacji lokalnej bezpośrednio z usługi Power Automate Cloud Flow. Wszystkie akcje IA-Connect są dostępne bezpośrednio w usłudze Power Automate Cloud Flow, zapewniając łatwą integrację między aplikacjami chmurowymi i lokalnymi, możliwość korzystania z istniejących warunków, pętli usługi Power Automate, zawartości dynamicznej, wyrażeń i obsługi wyjątków w procesach RPA. Wykorzystanie łączników IA-Connect zapewnia również pełną historię wykonywania i inspekcję z historii uruchamiania usługi Flow, jednocześnie eliminując konieczność posiadania oddzielnej aplikacji/konsoli/studio do tworzenia procesów RPA.

Wymagania wstępne

Aby użyć dowolnego z łączników IA-Connect, należy zainstalować oprogramowanie IA-Connect. Jest to bezpłatne do testowania przez 30 dni, po którym będzie wymagana licencja IA-Connect.

Oprogramowanie IA-Connect składa się z dwóch głównych składników:

  • IA-Connect Orchestrator, który jest aplikacją internetową platformy Azure, która będzie hostowana we własnej dzierżawie platformy Azure. Umożliwia to obsługę routingu i zabezpieczeń przepływów RPA do co najmniej jednej lokalnej lub opartej na chmurze maszyn wirtualnych.

  • Agent i dyrektor IA-Connect instalowany na maszynach wirtualnych, na których oprogramowanie, które chcesz zautomatyzować, jest dostępne. Ponadto agent IA-Connect może działać w sesji usług pulpitu zdalnego (RDS) Citrix lub Microsoft, gdzie polecenia RPA są przekazywane w kanale wirtualnym do sesji zdalnej do wykonania. Agent IA-Connect można uruchomić z udziału sieciowego i nie wymaga instalacji.

Dostępne łączniki IA-Connect

Dostępne łączniki IA-Connect to:

  • IA-Connect kod dynamiczny
  • IA-Connect Java
  • IA-Connect JML
  • IA-Connect Mainframe
  • IA-Connect pakietu Microsoft Office
  • IA-Connect graficzny interfejs UŻYTKOWNIKA oprogramowania SAP
  • sesja IA-Connect
  • interfejs użytkownika IA-Connect
  • przeglądarka internetowa IA-Connect

Jak uzyskać poświadczenia

Aby otrzymać licencję i rozpocząć 30-dniową bezpłatną wersję próbną, prześlij żądanie na naszej stronie internetowej (https://www.ultima.com/IA-Connect/Power-Automate).

Po otrzymaniu żądania wersji próbnej skontaktujemy się z Tobą za pośrednictwem adresu e-mail dostarczonego w celu ułatwienia konfigurowania oprogramowania IA-Connect i dostarczenia Ci licencji próbnej. Jest to w pełni funkcjonalna wersja próbna i umożliwi przetestowanie dowolnej z 800 akcji we wszystkich 9 łącznikach IA-Connect w ramach własnego środowiska w okresie próbnym.

Wprowadzenie do łącznika

Po przesłaniu żądania wersji próbnej programu IA-Connect będzie można pobrać plik ZIP zawierający oprogramowanie IA-Connect i dokumentację obejmującą instalację i instalację. Skontaktujemy się również z Tobą w celu zaoferowania pomocy technicznej i wskazówek w ramach procesu instalacji zgodnie z potrzebami.

Support

W okresie próbnym możesz skontaktować się z firmą Ultima Labs () wIAConnect@ultima.com celu uzyskania pomocy technicznej i pomocy.

Po zakupie licencji IA-Connect otrzymasz tokeny pomocy technicznej, które można zrealizować na potrzeby szkoleń lub wsparcia technicznego firmy Ultima z siedzibą w Wielkiej Brytanii (TSC).

Znane problemy, typowe błędy i często zadawane pytania

Nasza baza wiedzy zawiera szereg artykułów obejmujących znane problemy, typowe błędy, które mogą wystąpić podczas korzystania z łączników IA-Connect i często zadawanych pytań. Jest to dostępne w witrynie https://support.ultima.com/ultimalabs i konto, które ma dostęp do tych zasobów, jest udostępniane podczas IA-Connect wersji próbnej oraz podczas zakupu licencji IA-Connect.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API dla tego interfejsu API Prawda
adres IA-Connect Orchestrator ciąg Określ adres IA-Connect Orchestrator bez składnika HTTP(S) Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Czekaj na element pulpitu UIA

Czeka na istnienie elementu pulpitu (zazwyczaj okna).

Czekaj na element UIA

Czeka na istnienie elementu (zazwyczaj pojedynczego elementu w oknie, takiego jak przycisk lub obszar wprowadzania tekstu).

Czy element pulpitu UIA istnieje

Raportuje, czy element pulpitu istnieje i udostępnia niektóre podstawowe właściwości elementu.

Czy element UIA istnieje

Zgłasza, czy element istnieje i zwraca niektóre właściwości podstawowego elementu.

Czy istnieje okno Win32 najwyższego poziomu

Szybka akcja Win32, która zgłasza, czy istnieje okno Win32 najwyższego poziomu. Okno najwyższego poziomu to okno, które jest połączone z pulpitem. Możesz wyszukiwać według nazwy klasy lub tytułu okna albo określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. Okno musi istnieć, IA-Connect nie będzie czekać. Częściej używa się akcji UIA "Czy element pulpitu UIA istnieje", która jest bardziej zaawansowana, ale ta akcja Win32 zwykle wykonuje się szybciej.

Czy proces ma okno Win32

Prosta i szybka akcja Win32, która zgłasza, czy proces (określony przez nazwę) ma jakiekolwiek widoczne okna. Okno musi istnieć: IA-Connect nie będzie czekać. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Czy zaznaczono element UIA

Ta akcja zwraca wartość true lub false wskazującą, czy zaznaczono element (zazwyczaj pole wyboru lub pole radiowe).

Focus UIA, element

Skupia element, który sprawia, że jest aktywnym elementem fokusu klawiatury i, w zależności od aplikacji, może przenieść okno elementu na pierwszy plan.

Globalne dwukrotne kliknięcie lewej myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i dwukrotnie klika lewy przycisk myszy.

Globalne hasło wejściowe do elementu UIA

Przenosi mysz do środka elementu, fokusuje go, klika lewym przyciskiem myszy i naciska. Zazwyczaj używane z danymi wejściowymi haseł, które nie akceptują natywnych metod wejściowych interfejsu użytkownika.

Globalne kliknięcie lewej myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i klika lewy przycisk myszy.

Globalne kliknięcie prawym przyciskiem myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i klika prawy przycisk myszy.

Globalne kliknięcie środkowej myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i klika środkowy przycisk myszy.

Globalny region wyszukiwania elementów UIA kliknij myszą

Przenosi wskaźnik myszy na obszar pikseli w elemecie UIA, który spełnia określone kryteria kolorów i wykonuje kliknięcie myszą. Element powinien zostać przeniesiony na pierwszy front, ponieważ zrzut ekranu wykonuje kopię ekranu w lokalizacji elementów.

Globalny tekst wejściowy do elementu UIA

Przenosi mysz do środka elementu, fokusuje go, klika lewym przyciskiem myszy i naciska. Zazwyczaj używane z tekstem wejściowym, które nie akceptują natywnych metod wprowadzania danych wejściowych UIA.

Kliknij pozycję element listy UIA według indeksu

Klika element listy zgodny z określonym indeksem. Jest to zwykle używane do wybierania elementu w elemencie listy rozwijanej/menu.

Kliknij pozycję element listy UIA według nazwy

Klika element listy o określonej nazwie. Jest to zwykle używane do wybierania elementu w elemencie listy rozwijanej/menu.

Lokalizowanie widocznego obrazu wyszukiwania w elemecie UIA

Zwraca, czy obraz wyszukiwania podany jako dane wejściowe tej akcji został wyraźnie umieszczony w elemecie UIA na ekranie. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent wykonuje zrzut ekranu na współrzędnych elementu i wyszukuje podany obraz wyszukiwania na zrzucie ekranu.

Maksymalizowanie okna UIA

Maksymalizuje okno z określonym uchwytem UIA.

Naciśnij UIA, element

Naciska element (zazwyczaj przycisk).

Oczekiwanie na główne okno procesu UIA

Prosta i szybka akcja Win32, która czeka przez określony czas na istnienie głównego okna procesu (określonego przez nazwę) przed zwróceniem uchwytu. Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Oczekiwanie na okno główne identyfikatora procesu UIA

Prosta i szybka akcja Win32, która czeka na główne okno procesu (określone przez identyfikator procesu) istnieje i zwraca uchwyt. Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Oczekiwanie na okno win32 najwyższego poziomu interfejsu użytkownika

Szybka akcja Win32, która czeka przez określony czas na istnienie okna Win32 najwyższego poziomu przed zwróceniem uchwytu UIA. Okno najwyższego poziomu to okno, które jest połączone z pulpitem. Możesz wyszukiwać według nazwy klasy lub tytułu okna albo określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. Częściej używasz akcji UIA "Czekaj na element pulpitu", która jest bardziej zaawansowana, ale ta akcja Win32 jest zwykle wykonywana szybciej.

Oczekiwanie na widoczny obraz wyszukiwania w elemecie UIA

Czeka, aż obraz wyszukiwania, podany jako dane wejściowe tej akcji, został wyraźnie umieszczony w elemecie UIA na ekranie lub upływa określony czas. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent wykonuje zrzut ekranu na współrzędnych elementu i wyszukuje podany obraz wyszukiwania na zrzucie ekranu. Element UIA musi istnieć od początku. Akcja jest wykonywana natychmiast po zlokalizowaniu obrazu.

Pobieranie dojścia interfejsu użytkownika dla okna głównego identyfikatora procesu

Prosta i szybka akcja Win32, która zwraca uchwyt dla dowolnego głównego okna procesu (określonego przez identyfikator procesu). Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Pobieranie dojścia UIA dla okna głównego procesu

Prosta i szybka akcja Win32, która zwraca uchwyt dla dowolnego głównego okna procesu (określonego przez nazwę). Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Okno musi istnieć: IA-Connect nie będzie czekać. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Pobieranie dojścia UIA dla okna Win32 najwyższego poziomu

Szybka akcja Win32 zwracająca uchwyt UIA dla dowolnego okna Win32 najwyższego poziomu z określoną nazwą klasy lub tytułem okna lub można określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Okno najwyższego poziomu to okno, które jest połączone z pulpitem. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. Okno musi istnieć, IA-Connect nie będzie czekać. Częściej używa się akcji UIA "Czy element pulpitu UIA istnieje", która jest bardziej zaawansowana, ale ta akcja Win32 zwykle wykonuje się szybciej.

Pobieranie elementu UIA na współrzędnych ekranu

Zwraca element UIA znajdujący się na podanych współrzędnych ekranu.

Pobieranie elementów listy UIA

Zwraca listę elementów podrzędnych znalezionych w ramach określonego elementu (zazwyczaj listy rozwijanej / elementów menu).

Pobieranie elementów pulpitu UIA

Zwraca listę wszystkich okien i okien dialogowych na pulpicie.

Pobieranie okien Win32

Szybka akcja Win32, która zwraca listę wszystkich okien Win32, które opcjonalnie mają określoną nazwę klasy lub tytuł okna, lub można określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. System Windows Win32 może zawierać nieoczekiwane elementy, w tym pasek zadań, pulpit, menu Start, przezroczyste nakładki, okna wyłączone lub ukryte, dzięki czemu zwracana lista może zawierać więcej wyników niż oczekiwano.

Pobieranie regionu wyszukiwania elementów UIA

Zwraca szczegóły regionu pikseli w elemecie UIA, który spełnia określone kryteria kolorów. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent lokalizuje kolory, wykonując zrzut ekranu na współrzędnych elementu.

Pobieranie uchwytu elementu nadrzędnego UIA

Zwraca uchwyt elementu nadrzędnego określonego elementu. Element nadrzędny jest definiowany jako element, który znajduje się na następnym poziomie w górę "drzewo" interfejsu użytkownika i jest prawie zawsze elementem zawierającym.

Pobieranie wartości elementu UIA

Zwraca wartość elementu. Wartość jest zwykle skojarzona z obszarem wprowadzania tekstu, ale wiele elementów może mieć tę właściwość.

Pobieranie wartości etykiety elementu UIA

Zwraca wartość etykiety na elemecie .

Pobieranie wartości tekstowej elementu UIA

Zwraca wartość tekstową elementu. Wartość tekstowa jest zwykle skojarzona z etykietą, ale wiele elementów może mieć tę właściwość.

Pobieranie wielu elementów interfejsu użytkownika jako tabeli

Wylicza wartości elementów podrzędnych określonego elementu nadrzędnego i zwraca je w formacie tabeli. Może to służyć do zwracania wierszy i kolumn danych z elementów, które nie są tabelami technicznie, ale zostały ułożone razem w strukturę tabeli. Za pomocą tej akcji można również pobrać wyniki z poprzedniego wykonania tej akcji, uruchomić jako wątek agenta.

Pobieranie wielu właściwości elementu nadrzędnego UIA

Zwraca drzewo hierarchiczne elementów nadrzędnych określonego elementu aż do pulpitu (poziom główny). Element nadrzędny jest definiowany jako element, który znajduje się na następnym poziomie w górę "drzewo" interfejsu użytkownika i jest prawie zawsze elementem zawierającym.

Pobieranie wielu właściwości elementu UIA

Zwraca właściwości wielu elementów. Może to być przydatne, jeśli nie masz pewności, które pola zawierają wymagane wartości właściwości.

Pobieranie wzorców elementów UIA

Pobierz, które wzorce UIA są dostępne dla elementu UIA, a tym samym, które IA-Connect akcje UIA mogą mieć wpływ na element.

Pobieranie właściwości elementu datagrid interfejsu użytkownika

Zwraca właściwości tabeli elementu DataGrid. Jest to element z wierszami, kolumnami, nagłówkiem i komórkami (tj. tabelą).

Pobieranie właściwości elementu UIA

Zwraca wszystkie właściwości elementu. Może to być przydatne, jeśli nie masz pewności, które pole zawiera wymagane wartości właściwości.

Pobieranie właściwości elementu UIA jako listy

Zwraca właściwości elementu jako pojedynczej listy wierszy (jednowierszowej kolekcji / tabeli danych) zamiast pojedynczych elementów, może to być przydatne w zależności od tego, jak zamierzasz używać danych.

Pobieranie zawartości elementu datagrid UIA

Zwraca zawartość elementu datagrid. Jest to element z wierszami, kolumnami, nagłówkiem i komórkami (tj. tabelą). Za pomocą tej akcji można również pobrać wyniki z poprzedniego wykonania tej akcji, uruchomić jako wątek agenta.

Poczekaj, aż element pulpitu UIA nie istnieje

Czeka na element pulpitu (zazwyczaj okno) nie istnieje.

Poczekaj, aż element UIA nie istnieje

Czeka na element (zazwyczaj pojedynczy element w oknie, taki jak przycisk lub obszar wprowadzania tekstu), aby już nie istniał.

Poczekaj, aż widoczny obraz wyszukiwania nie istnieje w elemecie UIA

Czeka, aż obraz wyszukiwania, podany jako dane wejściowe tej akcji, nie może być widoczny (lub nigdy nie znajduje się) w elemecie UIA na ekranie lub określony czas minął, a obraz jest nadal obecny. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent wykonuje zrzut ekranu na współrzędnych elementu i wyszukuje podany obraz wyszukiwania na zrzucie ekranu. Element UIA musi istnieć od początku. Akcja jest wykonywana natychmiast po tym, jak obraz nie jest już obecny.

Powrót danych wejściowych do elementu UIA

Wprowadza zwracany/nowy wiersz systemu Windows do elementu (zazwyczaj pole wprowadzania tekstu), zastępując istniejący tekst lub wstawiając zwracany w określonej pozycji.

Przenieś element UIA

Przenosi element UIA do określonej pozycji na ekranie. Ta akcja będzie zwykle działać tylko z elementami okna (które mają wzorzec przekształcania).

Przełącz element UIA

Przełącza element (zazwyczaj pole wyboru lub pole radiowe). Daje to elementowi przeciwny stan bieżącego (np. zaznaczone staje się niezaznaczone i odwrotnie). Jeśli chcesz ustawić określony stan, zamiast tego użyj akcji "Sprawdź element".

Resetuj wszystkie uchwyty elementów UIA

Resetuje wszystkie uchwyty elementów UIA przechowywane obecnie przez IA-Connect, co może być przydatne, jeśli zidentyfikowano wiele elementów i ma dużą liczbę uchwytów elementów przechowywanych. W scenariuszach z bardzo dużą liczbą uchwytów elementów (100 000+) można również użyć tej akcji do zwolnienia użycia pamięci RAM.

Rozwiń element UIA

Rozwija element (zazwyczaj element menu/menu rozwijanego). Jeśli element został już rozszerzony, nic się nie stanie.

Rysuj prostokąt wokół elementu UIA

Rysuje prostokąt wokół obwodu elementu, aby pomóc w zidentyfikowaniu, że znaleziony element jest wymagany. Prostokąt jest automatycznie usuwany po 5 sekundach.

Sprawdzanie elementu UIA

Ustawia stan elementu (zazwyczaj pole wyboru lub pole radiowe) na zaznaczone lub niezaznaczone.

Sprawdzanie wielu elementów interfejsu użytkownika

Ustawia stan wielu elementów (zazwyczaj pole wyboru lub pole radiowe) na zaznaczone lub niezaznaczone.

Ustaw element UIA na wartość liczbową

Ustawia wartość elementu, który ma dane wejściowe liczbowe, na przykład pole tekstowe lub pasek przewijania.

Ustaw element UIA na wartość zakresu liczbowego

Ustawia wartość elementu, który ma zakres liczbowy, na przykład pasek przewijania.

Ustawianie limitu czasu transakcji UIA

Określa, jak długo interfejs API UIA będzie czekać na zwrócenie przez aplikację informacji na temat elementu. Ten limit czasu transakcji zazwyczaj jest osiągany tylko wtedy, gdy aplikacja nie odpowiada.

Ustawianie okna interfejsu użytkownika na wartość normalną

Normalizuje okno z określonym uchwytem UIA (tj. ustawia go na normalne okno, a nie zminimalizowane lub zmaksymalizowane).

Ustawianie okna pierwszego planu UIA

Przenosi okno na pierwszy plan.

Ustawianie procentu przewijania elementu UIA

Ustaw wartość procentową przewijania w poziomie i /lub w pionie określonego elementu, jeśli przewijanie jest obsługiwane przez ten element. Jeśli element obsługuje wzorzec przewijania, możesz zastosować tę akcję bezpośrednio do elementu i określić poziomą lub pionową ilość przewijania (lub oba). Jeśli element nie obsługuje wzorca przewijania, ta akcja powróci do wzorców "wartość zakresu" lub "wartość", ale musisz zastosować je bezpośrednio do kontrolek paska przewijania, a nie samego elementu.

Ustawianie trybu wyszukiwania elementów UIA

Wybierz tryb wyszukiwania elementów UIA, który ma być używany przez agenta IA-Connect podczas wykonywania akcji UIA. Zazwyczaj ta akcja będzie używana tylko wtedy, gdy masz problem z trybem domyślnym (Znajdź wszystko).

Uzyskiwanie dojścia interfejsu użytkownika dla głównego okna elementu fokusu

Zwraca uchwyt dla głównego okna aktualnie ukierunkowanego elementu UIA. Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym.

Uzyskiwanie dojścia interfejsu użytkownika dla komputerów stacjonarnych

Zwraca uchwyt dla pulpitu. Jest to przestarzała akcja, ponieważ uchwyt "-2" może służyć do odwoływania się do elementu pulpitu, ale także dlatego, że istnieje wiele akcji, które mogą wyszukiwać względem pulpitu (np. "czekaj na element pulpitu").

Uzyskiwanie dojścia UIA dla elementu fokusu

Zwraca uchwyt dla aktualnie ukierunkowanego elementu UIA.

Uzyskiwanie trybu wyszukiwania elementów UIA

Pobiera tryb wyszukiwania elementów UIA używany przez IA-Connect Agent dla akcji UIA.

Wprowadzanie hasła do elementu UIA

Akcja UIA, która wprowadza hasło do elementu (zazwyczaj pole wprowadzania hasła), zastępując istniejący tekst.

Wprowadzanie tekstu do elementu UIA

Akcja UIA, która wprowadza tekst do elementu (zazwyczaj pole wprowadzania tekstu), zastępując istniejący tekst lub wstawiając nową wartość w określonej pozycji.

Wprowadzanie tekstu do wielu elementów interfejsu użytkownika

Akcja UIA, która wprowadza różne fragmenty tekstu do wielu elementów (zazwyczaj pól wprowadzania tekstu), zastępując istniejący tekst lub wstawiając nową wartość w określonej pozycji.

Wybierz element UIA

Wybiera element (zazwyczaj element na liście lub liście rozwijanej).

Wyszukiwanie pierwszego elementu nadrzędnego UIA

Wyszukuje hierarchię drzewa UIA dla pierwszego elementu nadrzędnego zgodnego z kryteriami wyszukiwania. Element nadrzędny jest definiowany jako element, który znajduje się na następnym poziomie w górę "drzewo" interfejsu użytkownika i jest prawie zawsze elementem zawierającym.

Zamknij okno elementu UIA

Zamyka okno elementu. Zazwyczaj działa tylko w oknach lub oknach dialogowych.

Zmienianie rozmiaru elementu UIA

Zmienia rozmiar elementu UIA. Ta akcja będzie zwykle działać tylko z elementami okna (które mają wzorzec przekształcania).

Zminimalizowanie okna interfejsu użytkownika

Minimalizuje okno z określonym uchwytem interfejsu użytkownika.

Zrzut ekranu przedstawiający lokalizację elementu UIA

Tworzy zrzut ekranu przedstawiający lokalizację elementu i zwraca obraz. Element powinien zostać przeniesiony na pierwszy front, ponieważ zrzut ekranu wykonuje kopię ekranu w lokalizacji elementów.

Zwiń element UIA

Zwija element (zazwyczaj element menu/listy rozwijanej). Jeśli element jest już zwinięty, nic się nie stanie.

Czekaj na element pulpitu UIA

Czeka na istnienie elementu pulpitu (zazwyczaj okna).

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Jeśli zostanie określona (wartość 1 lub wyższa), wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste (lub 0).

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na istnienie elementu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, zostanie zwrócony tylko proces pasujący do dokładnego identyfikatora procesu wyszukiwania.

Zgłoś wyjątek, jeśli nie znaleziono elementu
RaiseExceptionIfElementNotFound boolean

Czy IA-Connect zgłosić wyjątek, jeśli element UIA nie istnieje po okresie oczekiwania?

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli element istnieje lub fałsz, jeśli nie.

Uchwyt elementu
ElementHandle integer

Uchwyt interfejsu użytkownika dla elementu. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika działających na tym elemecie.

Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Czekaj na element UIA

Czeka na istnienie elementu (zazwyczaj pojedynczego elementu w oknie, takiego jak przycisk lub obszar wprowadzania tekstu).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Jeśli zostanie określona (wartość 1 lub wyższa), wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste (lub 0).

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na istnienie elementu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, zostanie zwrócony tylko proces pasujący do dokładnego identyfikatora procesu wyszukiwania.

Zgłoś wyjątek, jeśli nie znaleziono elementu
RaiseExceptionIfElementNotFound boolean

Czy IA-Connect zgłosić wyjątek, jeśli element UIA nie istnieje po okresie oczekiwania?

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli element istnieje lub fałsz, jeśli nie.

Uchwyt elementu
ElementHandle integer

Uchwyt interfejsu użytkownika dla elementu. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika działających na tym elemecie.

Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Czy element pulpitu UIA istnieje

Raportuje, czy element pulpitu istnieje i udostępnia niektóre podstawowe właściwości elementu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Jeśli zostanie określona (wartość 1 lub wyższa), wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste (lub 0).

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, zostanie zwrócony tylko proces pasujący do dokładnego identyfikatora procesu wyszukiwania.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli element istnieje lub fałsz, jeśli nie.

Uchwyt elementu
ElementHandle integer

Uchwyt interfejsu użytkownika dla elementu. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika działających na tym elemecie.

Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Czy element UIA istnieje

Zgłasza, czy element istnieje i zwraca niektóre właściwości podstawowego elementu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Jeśli zostanie określona (wartość 1 lub wyższa), wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste (lub 0).

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, przeszukiwany będzie tylko proces odpowiadający dokładnemu identyfikatorowi procesu wyszukiwania.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli element istnieje lub fałsz, jeśli nie.

Uchwyt elementu
ElementHandle integer

Uchwyt interfejsu użytkownika dla elementu. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika działających na tym elemecie.

Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Czy istnieje okno Win32 najwyższego poziomu

Szybka akcja Win32, która zgłasza, czy istnieje okno Win32 najwyższego poziomu. Okno najwyższego poziomu to okno, które jest połączone z pulpitem. Możesz wyszukiwać według nazwy klasy lub tytułu okna albo określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. Okno musi istnieć, IA-Connect nie będzie czekać. Częściej używa się akcji UIA "Czy element pulpitu UIA istnieje", która jest bardziej zaawansowana, ale ta akcja Win32 zwykle wykonuje się szybciej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa klasy wyszukiwania
SearchClassName string

Nazwa klasy elementu okna najwyższego poziomu do wyszukania, np. "Notatnik".

Tytuł okna wyszukiwania
SearchWindowTitle string

Tytuł okna najwyższego poziomu do wyszukania.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Opcjonalny identyfikator procesu, który jest właścicielem okna (na przykład podane przez dane wyjściowe akcji "Uruchom proces" w akcjach IA-Connect Środowisko/sesja). Ustaw wartość 0, aby nie wyszukiwać według identyfikatora procesu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych względem dostępnych właściwości okna. Przykład 1: [Szerokość] < 200. Przykład 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Więcej przykładów można znaleźć w dokumentacji.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Okno istnieje
WindowExists boolean

Zwraca wartość true, jeśli okno istnieje lub fałsz, jeśli nie.

Czy proces ma okno Win32

Prosta i szybka akcja Win32, która zgłasza, czy proces (określony przez nazwę) ma jakiekolwiek widoczne okna. Okno musi istnieć: IA-Connect nie będzie czekać. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa procesu wyszukiwania
SearchProcessName True string

Nazwa procesu do wyszukania, np. Notatnik.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Proces zawiera okno
ProcessHasWindow boolean

Zwraca wartość true, jeśli proces ma widoczne okno lub wartość false, jeśli nie.

Czy zaznaczono element UIA

Ta akcja zwraca wartość true lub false wskazującą, czy zaznaczono element (zazwyczaj pole wyboru lub pole radiowe).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Zaznaczono element
ElementIsChecked boolean

Zwraca wartość true, jeśli element jest sprawdzany lub fałsz, jeśli nie.

Focus UIA, element

Skupia element, który sprawia, że jest aktywnym elementem fokusu klawiatury i, w zależności od aplikacji, może przenieść okno elementu na pierwszy plan.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Globalne dwukrotne kliknięcie lewej myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i dwukrotnie klika lewy przycisk myszy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Opóźnienie w milisekundach
DelayInMilliseconds integer

Opóźnienie (w milisekundach) między każdym kliknięciem.

Najpierw element fokusu
FocusElementFirst boolean

Czy IA-Connect spróbować skoncentrować element przed kliknięciem globalnym?

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Kliknij przesunięcie X
ClickOffsetX integer

Liczba pikseli X do przesunięcia akcji kliknięcia według. Ten parametr obsługuje zarówno dodatnie (po prawej), jak i ujemne (po lewej) wartości przesunięcia.

Kliknij przesunięcie Y
ClickOffsetY integer

Liczba pikseli Y do przesunięcia akcji kliknięcia według. Ten parametr obsługuje wartości przesunięcia dodatniego (w dół) i ujemnego (w górę).

Przesunięcie względem
OffsetRelativeTo string

Względna pozycja elementu do przesunięcia od (Środkowe / Środkowe / Środkowe, Lewe, Prawe, Góra, Dolna, Lewa górna, Prawy górny, Prawy górny, Dolny lewy dolny, Dolny prawy).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Globalne hasło wejściowe do elementu UIA

Przenosi mysz do środka elementu, fokusuje go, klika lewym przyciskiem myszy i naciska. Zazwyczaj używane z danymi wejściowymi haseł, które nie akceptują natywnych metod wejściowych interfejsu użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Najpierw element fokusu
FocusElement boolean

Czy IA-Connect spróbować skoncentrować element przed kliknięciem globalnym?

Globalne kliknięcie lewym przyciskiem myszy na elemecie
GlobalMouseClickOnElement boolean

Czy globalne kliknięcie myszy powinno być wykonywane na współrzędnych elementu (aby skoncentrować element) przed wprowadzeniem tekstu?

Zastąp istniejącą wartość dwukrotnym kliknięciem myszy usuń
ReplaceExistingValueUsingDoubleClickDelete boolean

Czy dowolna istniejąca wartość powinna zostać zastąpiona dwukrotnie kliknięciem myszy (aby ją wyróżnić), a następnie usunięciem?

Zamień istniejącą wartość przy użyciu CTRL-A delete
ReplaceExistingValueUsingCTRLADelete boolean

Czy dowolna istniejąca wartość powinna zostać zamienina przez naciśnięcie Ctrl-A (aby wyróżnić wszystkie), a następnie usunięcie? Niektóre elementy mogą nie obsługiwać wyróżniania przy użyciu Ctrl-A w tym przypadku należy wypróbować alternatywną opcję "Zamień istniejącą wartość przy użyciu podwójnego kliknięcia myszy".

Hasło do danych wejściowych
PasswordToInput True password

Wartość hasła do danych wejściowych globalnych przy użyciu klawiatury.

Używanie zdarzeń wysyłania kluczy
SendKeyEvents boolean

W przypadku ustawienia wartości true zostaną użyte zdarzenia klucza (interfejs API niższego poziomu, który wysyła symulowane naciśnięcia do systemu operacyjnego). Jeśli ustawiono wartość false, zamiast tego zostaną użyte klucze (interfejs API wyższego poziomu, który wysyła naciśnięcia do elementu ukierunkowanego).

Interwał w milisekundach
Interval integer

Liczba milisekund między każdym naciśnięciem.

Nie interpretuj symboli
DontInterpretSymbols boolean

Czy symbole w ciągu "Hasło do danych wejściowych" nie powinny być interpretowane jako klucze specjalne (np. + dla Shift, ^ dla ctrl)? Ta wartość powinna być ustawiona na true, jeśli próbujesz wprowadzić rzeczywiste symbole.

Hasło zawiera przechowywane hasło
PasswordContainsStoredPassword boolean

Ustaw wartość true, jeśli hasło zawiera (lub jest całkowicie) przechowywanym identyfikatorem hasła IA-Connect w formacie {IAConnectPassword:StoredPasswordIdentifier} lub poświadczenie ogólne IA-Connect Orchestrator w formacie {OrchestratorCredential:FriendlyName}. To zapisane hasło mogło zostać wygenerowane przez akcję "Generuj hasło", na przykład lub przechowywane przez IA-Connect Orchestrator.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Globalne kliknięcie lewej myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i klika lewy przycisk myszy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Najpierw element fokusu
FocusElementFirst boolean

Czy IA-Connect spróbować skoncentrować element przed kliknięciem globalnym?

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Kliknij przesunięcie X
ClickOffsetX integer

Liczba pikseli X do przesunięcia akcji kliknięcia według. Ten parametr obsługuje zarówno dodatnie (po prawej), jak i ujemne (po lewej) wartości przesunięcia.

Kliknij przesunięcie Y
ClickOffsetY integer

Liczba pikseli Y do przesunięcia akcji kliknięcia według. Ten parametr obsługuje wartości przesunięcia dodatniego (w dół) i ujemnego (w górę).

Przesunięcie względem
OffsetRelativeTo string

Względna pozycja elementu do przesunięcia od (Środkowe / Środkowe / Środkowe, Lewe, Prawe, Góra, Dolna, Lewa górna, Prawy górny, Prawy górny, Dolny lewy dolny, Dolny prawy).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Globalne kliknięcie prawym przyciskiem myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i klika prawy przycisk myszy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Najpierw element fokusu
FocusElementFirst boolean

Czy IA-Connect spróbować skoncentrować element przed kliknięciem globalnym?

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Kliknij przesunięcie X
ClickOffsetX integer

Liczba pikseli X do przesunięcia akcji kliknięcia według. Ten parametr obsługuje zarówno dodatnie (po prawej), jak i ujemne (po lewej) wartości przesunięcia.

Kliknij przesunięcie Y
ClickOffsetY integer

Liczba pikseli Y do przesunięcia akcji kliknięcia według. Ten parametr obsługuje wartości przesunięcia dodatniego (w dół) i ujemnego (w górę).

Przesunięcie względem
OffsetRelativeTo string

Względna pozycja elementu do przesunięcia od (Środkowe / Środkowe / Środkowe, Lewe, Prawe, Góra, Dolna, Lewa górna, Prawy górny, Prawy górny, Dolny lewy dolny, Dolny prawy).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Globalne kliknięcie środkowej myszy na elemecie UIA

Przenosi mysz do środka lub wybranej krawędzi, rogu lub przesunięcia względem elementu UIA i klika środkowy przycisk myszy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Najpierw element fokusu
FocusElementFirst boolean

Czy IA-Connect spróbować skoncentrować element przed kliknięciem globalnym?

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Kliknij przesunięcie X
ClickOffsetX integer

Liczba pikseli X do przesunięcia akcji kliknięcia według. Ten parametr obsługuje zarówno dodatnie (po prawej), jak i ujemne (po lewej) wartości przesunięcia.

Kliknij przesunięcie Y
ClickOffsetY integer

Liczba pikseli Y do przesunięcia akcji kliknięcia według. Ten parametr obsługuje wartości przesunięcia dodatniego (w dół) i ujemnego (w górę).

Przesunięcie względem
OffsetRelativeTo string

Względna pozycja elementu do przesunięcia od (Środkowe / Środkowe / Środkowe, Lewe, Prawe, Góra, Dolna, Lewa górna, Prawy górny, Prawy górny, Dolny lewy dolny, Dolny prawy).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Globalny region wyszukiwania elementów UIA kliknij myszą

Przenosi wskaźnik myszy na obszar pikseli w elemecie UIA, który spełnia określone kryteria kolorów i wykonuje kliknięcie myszą. Element powinien zostać przeniesiony na pierwszy front, ponieważ zrzut ekranu wykonuje kopię ekranu w lokalizacji elementów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Kolor wyszukiwania
SearchColour True string

Kolor wyszukiwania w formacie 0xAARRGGBB, #AARRGGBB, 0xRRGGBB lub #RRGGBB, gdzie każdy kanał kolorów jest bajtem w formacie szesnastkowym (00 jest w pełni wyłączony, FF jest w pełni włączony). Na przykład: #FF0000 dla czerwonego, #00FF00 dla niebieskiego, #0000000 dla czarnego, #FFFFFF dla białych.

Maksymalne odchylenie koloru
MaxColourDeviation True integer

Maksymalny kolor elementu może odbiegać od koloru wyszukiwania, zanim nie zostanie uznany za dopasowanie. 0 bez odchylenia. Odchylenie jest mierzone w wartościach RGB. Na przykład: #FF0000 różni się od #FE0102 4. Odchylenie 15 byłoby dobrym punktem wyjścia.

Przesunięcie lewego piksela X
LeftPixelXOffset integer

Opcjonalne przesunięcie X lewej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie X w prawym pikselu
RightPixelXOffset integer

Opcjonalne przesunięcie X dla prawej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Przesunięcie górnego piksela Y
TopPixelYOffset integer

Opcjonalne przesunięcie Y dla górnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie Y dolnego piksela
BottomPixelYOffset integer

Opcjonalne przesunięcie Y dla dolnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Przycisk myszy
MouseButton string

Przycisk myszy do naciśnięcia (Lewy, Prawy, Środkowy, Podwójny w lewo).

Kliknij przesunięcie X
ClickOffsetX integer

Liczba pikseli X do przesunięcia akcji kliknięcia według. Ten parametr obsługuje zarówno dodatnie (po prawej), jak i ujemne (po lewej) wartości przesunięcia.

Kliknij przesunięcie Y
ClickOffsetY integer

Liczba pikseli Y do przesunięcia akcji kliknięcia według. Ten parametr obsługuje wartości przesunięcia dodatniego (w dół) i ujemnego (w górę).

Przesunięcie względem
OffsetRelativeTo string

Względna pozycja regionu koloru do przesunięcia od (Środek / Środek / Środkowy, Lewy, Prawy, Górny, Dolny, Lewy Górny, Prawy Górny, Prawy Górny, Dolny Lewy, Dolny Prawy Dolny).

Opóźnienie w milisekundach
DelayInMilliseconds integer

W przypadku dwukrotnego kliknięcia opóźnienie (w milisekundach) między każdym kliknięciem.

Ukryj agenta
HideAgent boolean

Ustaw wartość true, aby automatycznie ukryć agenta (jeśli jest widoczny), aby upewnić się, że nie ukrywa analizowanego elementu.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wynik polecenia
UIAGlobalMouseClickElementSearchColourRegionResult boolean

Wynik polecenia (powodzenie lub niepowodzenie).

Komunikat o błędzie
ErrorMessage string

Jeśli polecenie nie powiodło się, będzie zawierać zwrócony komunikat o błędzie.

Globalny tekst wejściowy do elementu UIA

Przenosi mysz do środka elementu, fokusuje go, klika lewym przyciskiem myszy i naciska. Zazwyczaj używane z tekstem wejściowym, które nie akceptują natywnych metod wprowadzania danych wejściowych UIA.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Najpierw element fokusu
FocusElement boolean

Czy IA-Connect spróbować skoncentrować element przed kliknięciem globalnym?

Globalne kliknięcie lewym przyciskiem myszy na elemecie
GlobalMouseClickOnElement boolean

Czy globalne kliknięcie myszy powinno być wykonywane na współrzędnych elementu (aby skoncentrować element) przed wprowadzeniem tekstu?

Zastąp istniejącą wartość dwukrotnym kliknięciem myszy usuń
ReplaceExistingValueUsingDoubleClickDelete boolean

Czy dowolna istniejąca wartość powinna zostać zastąpiona dwukrotnie kliknięciem myszy (aby ją wyróżnić), a następnie usunięciem?

Zamień istniejącą wartość przy użyciu CTRL-A delete
ReplaceExistingValueUsingCTRLADelete boolean

Czy dowolna istniejąca wartość powinna zostać zamienina przez naciśnięcie Ctrl-A (aby wyróżnić wszystkie), a następnie usunięcie? Niektóre elementy mogą nie obsługiwać wyróżniania przy użyciu Ctrl-A w tym przypadku należy wypróbować alternatywną opcję "Zamień istniejącą wartość przy użyciu podwójnego kliknięcia myszy".

Tekst do danych wejściowych
TextToInput string

Wartość tekstowa globalnego wprowadzania danych wejściowych przy użyciu klawiatury.

Używanie zdarzeń wysyłania kluczy
SendKeyEvents boolean

W przypadku ustawienia wartości true zostaną użyte zdarzenia klucza (interfejs API niższego poziomu, który wysyła symulowane naciśnięcia do systemu operacyjnego). Jeśli ustawiono wartość false, zamiast tego zostaną użyte klucze (interfejs API wyższego poziomu, który wysyła naciśnięcia do elementu ukierunkowanego).

Interwał w milisekundach
Interval integer

Liczba milisekund między każdym naciśnięciem.

Nie interpretuj symboli
DontInterpretSymbols boolean

Czy symbole w ciągu "Tekst do wprowadzania" nie powinny być interpretowane jako klucze specjalne (np. + dla Shift, ^ dla ctrl)? Ta wartość powinna być ustawiona na true, jeśli próbujesz wprowadzić rzeczywiste symbole.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Kliknij pozycję element listy UIA według indeksu

Klika element listy zgodny z określonym indeksem. Jest to zwykle używane do wybierania elementu w elemencie listy rozwijanej/menu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Rozwiń najpierw
ExpandFirst boolean

Jeśli ustawiono wartość true, IA-Connect spróbuje rozwinąć listę przed wyszukaniem elementów elementu listy. Jest to przydatne w przypadku list dynamicznych, ponieważ elementy elementu listy mogą nie zostać utworzone do momentu rozwinięcia listy.

Zwiń po
CollapseAfter boolean

Jeśli ustawiono wartość true, lista zostanie zwinięta po wykonaniu wyszukiwania.

Indeks elementów
ItemIndex integer

Indeks na liście elementu do kliknięcia.

Sekundy między rozwijaniem i zwijaniem
SecondsBetweenExpandCollapse double

Liczba sekund oczekiwania między akcjami rozwijania i zwijania, jeśli są one ustawione na wartość true.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Kliknij pozycję element listy UIA według nazwy

Klika element listy o określonej nazwie. Jest to zwykle używane do wybierania elementu w elemencie listy rozwijanej/menu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Rozwiń najpierw
ExpandFirst boolean

Jeśli ustawiono wartość true, IA-Connect spróbuje rozwinąć listę przed wyszukaniem elementów elementu listy. Jest to przydatne w przypadku list dynamicznych, ponieważ elementy elementu listy mogą nie zostać utworzone do momentu rozwinięcia listy.

Zwiń po
CollapseAfter boolean

Jeśli ustawiono wartość true, lista zostanie zwinięta po wykonaniu wyszukiwania.

Nazwa elementu
ItemName string

Nazwa elementu do kliknięcia.

Sekundy między rozwijaniem i zwijaniem
SecondsBetweenExpandCollapse double

Liczba sekund oczekiwania między akcjami rozwijania i zwijania, jeśli są one ustawione na wartość true.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Lokalizowanie widocznego obrazu wyszukiwania w elemecie UIA

Zwraca, czy obraz wyszukiwania podany jako dane wejściowe tej akcji został wyraźnie umieszczony w elemecie UIA na ekranie. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent wykonuje zrzut ekranu na współrzędnych elementu i wyszukuje podany obraz wyszukiwania na zrzucie ekranu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Typ obrazu wyszukiwania
SearchImageType string

Określa, jakie dane wejściowe "Wyszukaj obraz" reprezentuje. Jeśli ustawiono wartość "Plik obrazu reżysera", obraz wyszukiwania jest ścieżką do pliku dostępnego dla katalogu. Jeśli ustawiono wartość "Plik obrazu agenta", obraz wyszukiwania jest ścieżką do pliku dostępnego dla agenta. W przypadku ustawienia wartości "Base64" obraz wyszukiwania jest reprezentacją obrazu base64.

Wyszukaj obraz
SearchImage string

Obraz wyszukiwania do zlokalizowania w określonym elemecie UIA. W zależności od określonego typu "Wyszukaj typ obrazu" może on przechowywać ścieżkę do pliku obrazu (na końcu dyrektora lub agenta) lub zawierać base64 (reprezentację tekstową) obrazu do wyszukania.

Alternatywny typ obrazu wyszukiwania
AltSearchImageType string

Definiuje dane wejściowe "Alternatywny obraz wyszukiwania". Jeśli jest ustawiona wartość "Brak" lub pusta, nie ma alternatywnego obrazu wyszukiwania. Jeśli ustawiono wartość "Plik obrazu reżysera", obraz wyszukiwania jest ścieżką do pliku dostępnego dla katalogu. Jeśli ustawiono wartość "Plik obrazu agenta", obraz wyszukiwania jest ścieżką do pliku dostępnego dla agenta. W przypadku ustawienia wartości "Base64" obraz wyszukiwania jest reprezentacją obrazu base64.

Alternatywny obraz wyszukiwania
AltSearchImage string

Opcjonalny alternatywny obraz wyszukiwania do zlokalizowania w ramach określonego elementu UIA. W zależności od określonego "Alternatywnego typu obrazu wyszukiwania" może to zawierać ścieżkę do pliku obrazu (na końcu dyrektora lub agenta) lub zawierać base64 (reprezentację tekstową) obrazu do wyszukania. Jeśli określisz alternatywny obraz wyszukiwania, agent wyszuka wyszukiwany lub alternatywny obraz wyszukiwania i raport, który się znajdował.

Maksymalne odchylenie koloru
MaxColourDeviation integer

Maksymalna liczba kolorów pikseli elementu może odbiegać od kolorów pikseli obrazu wyszukiwania, zanim nie zostanie uznana za dopasowanie. 0 bez odchylenia. Odchylenie jest mierzone w wartościach RGB. Na przykład: #FF0000 różni się od #FE0102 4. Pozwala to na ignorowanie drobnych różnic kolorowych.

Maksymalna różnica pikseli
MaxPixelDifferences integer

Maksymalna liczba pikseli, które mogą się różnić (powyżej maksymalnego odchylenia koloru) w całym obrazie wyszukiwania, zanim obraz zostanie uznany za niezgodny. Pozwala to na ignorowanie drobnych różnic między obrazami, ale wyższe wartości mogą zwiększyć czas wymagany do zlokalizowania obrazu. Zaleca się ustawienie wartości 0 i zwiększenie o niewielkie kwoty w razie potrzeby. W przypadku ustawienia wartości powyżej 0 należy również ustawić wartość "Maksymalna liczba kolejnych różnic pikseli".

Maksymalna liczba kolejnych różnic pikseli
MaxConsecutivePixelDifferences integer

Maksymalna liczba kolejnych pikseli, które mogą się różnić (powyżej maksymalnego odchylenia koloru) w każdym wierszu, zanim obraz zostanie uznany za niezgodny. Pozwala to na ignorowanie drobnych różnic między obrazami, ale wyższe wartości mogą zwiększyć czas wymagany do zlokalizowania obrazu. Zaleca się ustawienie wartości 0 i zwiększenie o niewielkie kwoty w razie potrzeby. W przypadku ustawienia wartości powyżej 0 należy również ustawić wartość "Maksymalna różnica pikseli".

Przesunięcie lewego piksela X
LeftPixelXOffset integer

Opcjonalne przesunięcie X lewej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie X w prawym pikselu
RightPixelXOffset integer

Opcjonalne przesunięcie X dla prawej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Przesunięcie górnego piksela Y
TopPixelYOffset integer

Opcjonalne przesunięcie Y dla górnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie Y dolnego piksela
BottomPixelYOffset integer

Opcjonalne przesunięcie Y dla dolnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Jednostka przesunięcia Pixel X
PixelXOffsetsUnit string

Ustaw wartość "Pixel" (wartość domyślna), jeśli przesunięcia lewego i prawego piksela X są mierzone w pikselach. Ustaw wartość "Percent", jeśli przesunięcia lewego i prawego piksela X są mierzone jako procent szerokości elementu.

Jednostka przesunięcia pikseli Y
PixelYOffsetsUnit string

Ustaw wartość "Pixel" (wartość domyślna), jeśli przesunięcia górnego i dolnego piksela Y są mierzone w pikselach. Ustaw wartość "Percent", jeśli przesunięcia górnego i dolnego piksela Y są mierzone jako procent wysokości elementu.

Indeks obrazu wyszukiwania
SearchImageIndex integer

Ustaw wartość 1, aby zlokalizować pierwsze wystąpienie obrazu wyszukiwania (w kierunku wyszukiwania) w elemecie UIA. Dla drugiego wystąpienia ustaw wartość 2, .... , N dla wystąpienia N. Jeśli szukasz również alternatywnego obrazu, element UIA jest skanowany najpierw pod kątem obrazu wyszukiwania, a po drugie dla alternatywnego obrazu, wyszukując żądane wystąpienie tego konkretnego obrazu (tj. agent oczekuje jednego lub drugiego, a nie kombinacji obu obrazów).

Kierunek wyszukiwania obrazów
ImageSearchDirection string

Kierunek wyszukiwania. Wyszukiwanie "Od góry" według wiersza od góry, skanowanie od lewej do prawej w każdym wierszu. Wyszukiwanie "Od dołu" według wiersza od dołu, skanowanie od lewej do prawej w każdym wierszu. Wyszukiwanie "Od lewej" według kolumny po lewej stronie, skanowanie od góry do dołu w każdej kolumnie. Wyszukiwanie "Od prawej" według kolumny z prawej strony, skanowanie od góry do dołu w każdej kolumnie. Może to być używane w połączeniu z indeksem obrazów wyszukiwania w celu zlokalizowania Nth obrazu z górnej, dolnej, lewej lub prawej. Aby poprawić wydajność, wybierz kierunek wyszukiwania, który twoim zdaniem pozwoli szybciej zlokalizować obraz.

Ukryj agenta
HideAgent boolean

Ustaw wartość true, aby automatycznie ukryć agenta (jeśli jest widoczny), aby upewnić się, że nie ukrywa analizowanego elementu.

Współrzędne ekranu powrotnego jako fizyczne
ReturnPhysicalCoordinates boolean

Ustaw wartość true dla współrzędnych ekranu, które mają być zwracane jako współrzędne fizyczne. Ustaw wartość false dla współrzędnych ekranu, które mają być zwracane jako współrzędne wirtualne. Jeśli bazowe skalowanie wyświetlania wynosi 100%, współrzędne fizyczne i wirtualne są takie same. Współrzędne elementu są zawsze zwracane jako współrzędne wirtualne.

Pokaż prostokąt wyróżnienia
ShowHighlightRectangle boolean

W przypadku ustawienia wartości true agent IA-Connect wyróżni znajdujący się na ekranie obraz. Może to być przydatne podczas opracowywania, aby ułatwić wizualizację wykrytego poprawnego obrazu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wyszukaj obraz znajdujący się
SearchImageLocated boolean

Ustaw wartość true, jeśli znajduje się obraz wyszukiwania. Ustaw wartość false, jeśli obraz wyszukiwania nie został zlokalizowany.

Który obraz wyszukiwania znajduje się
WhichSearchImageLocated integer

Ustaw wartość 0, jeśli nie znajdują się żadne obrazy wyszukiwania. Ustaw wartość 1, jeśli znajduje się obraz wyszukiwania. Ustaw wartość 2, jeśli znajduje się alternatywny obraz wyszukiwania.

Lewy piksel elementu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxElementLeftPixelXCoord integer

Wirtualna współrzędna X najbardziej lewego piksela pasująca do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dopasuj element pola ograniczenia obrazu do prawej piksela
SearchImageBoundingBoxElementRightPixelXCoord integer

Wirtualna współrzędna X najwięcej pikseli pasujących do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dopasuj element pola ograniczenia obrazu do górnego piksela
SearchImageBoundingBoxElementTopPixelYCoord integer

Wirtualna współrzędna Y najwyższego piksela pasującego do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dolny piksel pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxElementBottomPixelYCoord integer

Wirtualna współrzędna Y najwięcej pikseli pasująca do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dopasowanie obrazu do środka elementu pola ograniczenia X pikseli
SearchImageBoundingBoxElementCenterPixelXCoord integer

Wirtualna współrzędna X środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu względem elementu wirtualnego lewego górnego rogu.

Dopasowanie obrazu do pola ograniczenia— środek Y pikseli
SearchImageBoundingBoxElementCenterPixelYCoord integer

Wirtualna współrzędna Y środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu względem elementu wirtualnego lewego górnego rogu.

Lewy piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenLeftPixelXCoord integer

Współrzędna X pikseli ekranu z lewej większości pikseli pasującą do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Prawy piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenRightPixelXCoord integer

Współrzędna X piksela ekranu z prawej strony pasującą do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Górny piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenTopPixelYCoord integer

Współrzędna Y piksela ekranu najwyższego poziomu pasującego do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dolny piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenBottomPixelYCoord integer

Współrzędna Y pikseli ekranu z najbardziej u dołu pasującą do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dopasowanie obrazu do środka ekranu pola ograniczenia X pikseli
SearchImageBoundingBoxScreenCenterPixelXCoord integer

Współrzędna X pikseli ekranu środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dopasowanie obrazu do środka ekranu pola ograniczenia Y pikseli
SearchImageBoundingBoxScreenCenterPixelYCoord integer

Współrzędna Y pikseli ekranu środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Maksymalizowanie okna UIA

Maksymalizuje okno z określonym uchwytem UIA.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna
WindowHandle True integer

Uchwyt UIA dla okna, który ma zostać zmaksymalizowany.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Naciśnij UIA, element

Naciska element (zazwyczaj przycisk).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Poczekaj na zakończenie zdarzenia przycisku
Wait boolean

Przed kontynuowaniem automatyzacji należy poczekać na ukończenie zdarzenia przycisku. Jeśli ustawiono wartość true, może to spowodować przekroczenie limitu czasu, jeśli przycisk otworzy modalne okno dialogowe.

Przycisk kliknięcia win32
Win32ClickButton boolean

W przypadku ustawienia wartości true jest używane zdarzenie kliknięcia Win32 zamiast używania interfejsu użytkownika. Jest to zdarzenie kliknięcia "fire and forget", które może być przydatne podczas pracy z modalnymi oknami dialogowymi, które są prezentowane po kliknięciu lub elementach, które nie mają wzorca wywołania interfejsu użytkownika.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Wypróbuj wzorzec wywołania
TryInvokePattern boolean

Jeśli ustawiono wartość true (wartość domyślna), agent IA-Connect podejmie próbę użycia wzorca wywołania interfejsu użytkownika w celu wykonania akcji naciśnięcia (chyba że dla opcji "Przycisk kliknięcia Win32" ustawiono wartość true). Jeśli wzorzec wywołania interfejsu użytkownika jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wywołania i natychmiast powróci do innych wybranych wzorców.

Wypróbuj starszy wzorzec
TryLegacyPattern boolean

Jeśli ustawiono wartość true, agent IA-Connect spróbuje użyć starszego wzorca interfejsu użytkownika do wykonania akcji naciśnięcia, jeśli wzorzec wywołania jest niedostępny (ponieważ nie jest obecny w elemecie lub ponieważ jego użycie zostało wyłączone) i jeśli przycisk "Kliknij win32" ma wartość false.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Oczekiwanie na główne okno procesu UIA

Prosta i szybka akcja Win32, która czeka przez określony czas na istnienie głównego okna procesu (określonego przez nazwę) przed zwróceniem uchwytu. Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa procesu wyszukiwania
SearchProcessName True string

Nazwa procesu do wyszukania, np. Notatnik.

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na główne okno procesu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli okno istnieje lub fałsz, jeśli nie.

Oczekiwanie na okno główne identyfikatora procesu UIA

Prosta i szybka akcja Win32, która czeka na główne okno procesu (określone przez identyfikator procesu) istnieje i zwraca uchwyt. Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator procesu wyszukiwania
ProcessId True integer

Identyfikator procesu oczekiwania (zgodnie z akcją "Uruchom proces" w akcjach środowiska/sesji IA-Connect).

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na główne okno procesu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli element istnieje lub fałsz, jeśli nie.

Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Oczekiwanie na okno win32 najwyższego poziomu interfejsu użytkownika

Szybka akcja Win32, która czeka przez określony czas na istnienie okna Win32 najwyższego poziomu przed zwróceniem uchwytu UIA. Okno najwyższego poziomu to okno, które jest połączone z pulpitem. Możesz wyszukiwać według nazwy klasy lub tytułu okna albo określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. Częściej używasz akcji UIA "Czekaj na element pulpitu", która jest bardziej zaawansowana, ale ta akcja Win32 jest zwykle wykonywana szybciej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa klasy wyszukiwania
SearchClassName string

Nazwa klasy elementu okna najwyższego poziomu do wyszukania, np. "Notatnik".

Tytuł okna wyszukiwania
SearchWindowTitle string

Tytuł okna najwyższego poziomu do wyszukania.

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na istnienie okna.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Opcjonalny identyfikator procesu, który jest właścicielem okna (na przykład podane przez dane wyjściowe akcji "Uruchom proces" w akcjach IA-Connect Środowisko/sesja). Ustaw wartość 0, aby nie wyszukiwać według identyfikatora procesu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych względem dostępnych właściwości okna. Przykład 1: [Szerokość] < 200. Przykład 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma oknami, umożliwia to określenie właściwości okna do sortowania. Będzie to używane w połączeniu z "Dopasuj indeks", aby wybrać wymagane okno. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Uwzględnij indeks" wynosi 1, zostanie zwrócone pasujące okno najbliżej górnej części ekranu.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma oknami, należy dopasować wartość "Dopasuj indeks" z góry posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Zgłoś wyjątek, jeśli okno nie zostanie znalezione
RaiseExceptionIfWindowNotFound boolean

Czy IA-Connect zgłosić wyjątek, jeśli okno wyszukiwania Win32 nie istnieje po okresie oczekiwania?

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Element istnieje
ElementExists boolean

Zwraca wartość true, jeśli okno istnieje lub fałsz, jeśli nie.

Oczekiwanie na widoczny obraz wyszukiwania w elemecie UIA

Czeka, aż obraz wyszukiwania, podany jako dane wejściowe tej akcji, został wyraźnie umieszczony w elemecie UIA na ekranie lub upływa określony czas. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent wykonuje zrzut ekranu na współrzędnych elementu i wyszukuje podany obraz wyszukiwania na zrzucie ekranu. Element UIA musi istnieć od początku. Akcja jest wykonywana natychmiast po zlokalizowaniu obrazu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Typ obrazu wyszukiwania
SearchImageType string

Określa, jakie dane wejściowe "Wyszukaj obraz" reprezentuje. Jeśli ustawiono wartość "Plik obrazu reżysera", obraz wyszukiwania jest ścieżką do pliku dostępnego dla katalogu. Jeśli ustawiono wartość "Plik obrazu agenta", obraz wyszukiwania jest ścieżką do pliku dostępnego dla agenta. W przypadku ustawienia wartości "Base64" obraz wyszukiwania jest reprezentacją obrazu base64.

Wyszukaj obraz
SearchImage string

Obraz wyszukiwania do zlokalizowania w określonym elemecie UIA. W zależności od określonego typu "Wyszukaj typ obrazu" może on przechowywać ścieżkę do pliku obrazu (na końcu dyrektora lub agenta) lub zawierać base64 (reprezentację tekstową) obrazu do wyszukania.

Alternatywny typ obrazu wyszukiwania
AltSearchImageType string

Definiuje dane wejściowe "Alternatywny obraz wyszukiwania". Jeśli jest ustawiona wartość "Brak" lub pusta, nie ma alternatywnego obrazu wyszukiwania. Jeśli ustawiono wartość "Plik obrazu reżysera", obraz wyszukiwania jest ścieżką do pliku dostępnego dla katalogu. Jeśli ustawiono wartość "Plik obrazu agenta", obraz wyszukiwania jest ścieżką do pliku dostępnego dla agenta. W przypadku ustawienia wartości "Base64" obraz wyszukiwania jest reprezentacją obrazu base64.

Alternatywny obraz wyszukiwania
AltSearchImage string

Opcjonalny alternatywny obraz wyszukiwania do zlokalizowania w ramach określonego elementu UIA. W zależności od określonego "Alternatywnego typu obrazu wyszukiwania" może to zawierać ścieżkę do pliku obrazu (na końcu dyrektora lub agenta) lub zawierać base64 (reprezentację tekstową) obrazu do wyszukania. Jeśli określisz alternatywny obraz wyszukiwania, agent wyszuka wyszukiwany lub alternatywny obraz wyszukiwania i raport, który się znajdował.

Maksymalne odchylenie koloru
MaxColourDeviation integer

Maksymalna liczba kolorów pikseli elementu może odbiegać od kolorów pikseli obrazu wyszukiwania, zanim nie zostanie uznana za dopasowanie. 0 bez odchylenia. Odchylenie jest mierzone w wartościach RGB. Na przykład: #FF0000 różni się od #FE0102 4. Pozwala to na ignorowanie drobnych różnic kolorowych.

Maksymalna różnica pikseli
MaxPixelDifferences integer

Maksymalna liczba pikseli, które mogą się różnić (powyżej maksymalnego odchylenia koloru) w całym obrazie wyszukiwania, zanim obraz zostanie uznany za niezgodny. Pozwala to na ignorowanie drobnych różnic między obrazami, ale wyższe wartości mogą zwiększyć czas wymagany do zlokalizowania obrazu. Zaleca się ustawienie wartości 0 i zwiększenie o niewielkie kwoty w razie potrzeby. W przypadku ustawienia wartości powyżej 0 należy również ustawić wartość "Maksymalna liczba kolejnych różnic pikseli".

Maksymalna liczba kolejnych różnic pikseli
MaxConsecutivePixelDifferences integer

Maksymalna liczba pikseli, które mogą się różnić (powyżej maksymalnego odchylenia koloru), w każdym wierszu, zanim obraz zostanie uznany za niezgodny. Pozwala to na ignorowanie drobnych różnic między obrazami, ale wyższe wartości mogą zwiększyć czas wymagany do zlokalizowania obrazu. Zaleca się ustawienie wartości 0 i zwiększenie o niewielkie kwoty w razie potrzeby. W przypadku ustawienia wartości powyżej 0 należy również ustawić wartość "Maksymalna różnica pikseli".

Przesunięcie lewego piksela X
LeftPixelXOffset integer

Opcjonalne przesunięcie X lewej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie X w prawym pikselu
RightPixelXOffset integer

Opcjonalne przesunięcie X dla prawej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Przesunięcie górnego piksela Y
TopPixelYOffset integer

Opcjonalne przesunięcie Y dla górnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie Y dolnego piksela
BottomPixelYOffset integer

Opcjonalne przesunięcie Y dla dolnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Jednostka przesunięcia Pixel X
PixelXOffsetsUnit string

Ustaw wartość "Pixel" (wartość domyślna), jeśli przesunięcia lewego i prawego piksela X są mierzone w pikselach. Ustaw wartość "Percent", jeśli przesunięcia lewego i prawego piksela X są mierzone jako procent szerokości elementu.

Jednostka przesunięcia pikseli Y
PixelYOffsetsUnit string

Ustaw wartość "Pixel" (wartość domyślna), jeśli przesunięcia górnego i dolnego piksela Y są mierzone w pikselach. Ustaw wartość "Percent", jeśli przesunięcia górnego i dolnego piksela Y są mierzone jako procent wysokości elementu.

Indeks obrazu wyszukiwania
SearchImageIndex integer

Ustaw wartość 1, aby zlokalizować pierwsze wystąpienie obrazu wyszukiwania (w kierunku wyszukiwania) w elemecie UIA. Dla drugiego wystąpienia ustaw wartość 2, .... , N dla wystąpienia N. Jeśli szukasz również alternatywnego obrazu, element UIA jest skanowany najpierw pod kątem obrazu wyszukiwania, a po drugie dla alternatywnego obrazu, wyszukując żądane wystąpienie tego konkretnego obrazu (tj. agent oczekuje jednego lub drugiego, a nie kombinacji obu obrazów).

Kierunek wyszukiwania obrazów
ImageSearchDirection string

Kierunek wyszukiwania. Wyszukiwanie "Od góry" według wiersza od góry, skanowanie od lewej do prawej w każdym wierszu. Wyszukiwanie "Od dołu" według wiersza od dołu, skanowanie od lewej do prawej w każdym wierszu. Wyszukiwanie "Od lewej" według kolumny po lewej stronie, skanowanie od góry do dołu w każdej kolumnie. Wyszukiwanie "Od prawej" według kolumny z prawej strony, skanowanie od góry do dołu w każdej kolumnie. Może to być używane w połączeniu z indeksem obrazów wyszukiwania w celu zlokalizowania Nth obrazu z górnej, dolnej, lewej lub prawej. Aby poprawić wydajność, wybierz kierunek wyszukiwania, który twoim zdaniem pozwoli szybciej zlokalizować obraz.

Ukryj agenta
HideAgent boolean

Ustaw wartość true, aby automatycznie ukryć agenta (jeśli jest widoczny), aby upewnić się, że nie ukrywa analizowanego elementu.

Współrzędne ekranu powrotnego jako fizyczne
ReturnPhysicalCoordinates boolean

Ustaw wartość true dla współrzędnych ekranu, które mają być zwracane jako współrzędne fizyczne. Ustaw wartość false dla współrzędnych ekranu, które mają być zwracane jako współrzędne wirtualne. Jeśli bazowe skalowanie wyświetlania wynosi 100%, współrzędne fizyczne i wirtualne są takie same. Współrzędne elementu są zawsze zwracane jako współrzędne wirtualne.

Pokaż prostokąt wyróżnienia
ShowHighlightRectangle boolean

W przypadku ustawienia wartości true agent IA-Connect wyróżni znajdujący się na ekranie obraz. Może to być przydatne podczas opracowywania, aby ułatwić wizualizację wykrytego poprawnego obrazu.

Sekundy oczekiwania na obraz wyszukiwania
SecondsToWait integer

Liczba sekund oczekiwania na zlokalizowanie obrazu wyszukiwania w elemecie UIA. Jeśli obraz nie znajduje się, zostanie zgłoszony wyjątek w przypadku ustawienia "Zgłoś wyjątek, jeśli nie znaleziono obrazu", w przeciwnym razie akcja zgłosi, że obraz nie znajduje się.

Liczba milisekund między wyszukiwaniami
MillisecondsBetweenSearches integer

Liczba milisekund oczekiwania między poszczególnymi elementami UIA na ekranie. Ponieważ rozpoznawanie obrazów może być kosztowne, opóźnienie może pomóc zarówno obniżyć, jak i rozłożyć wykorzystanie procesora CPU. Na przykład: Jeśli spodziewasz się, że obraz może potrwać do 1 minuty, dodanie 5000 milisekund (5 sekund) wstrzymania między skanowaniami znacznie obniży wykorzystanie procesora CPU (przez znaczne zmniejszenie liczby skanowań), ale będzie miało niewielki wpływ na czas odpowiedzi. Minimalna dozwolona wartość to 100 milisekund (1/10 sekund).

Zgłoś wyjątek, jeśli nie znaleziono obrazu
RaiseExceptionIfImageNotFound boolean

Ustaw wartość true, jeśli IA-Connect powinna zgłosić wyjątek, jeśli nie można znaleźć obrazu po okresie oczekiwania.

Pobieranie danych wyjściowych dla identyfikatora wątku
RetrieveOutputDataFromThreadId integer

Jeśli wcześniej ustawiono wartość false "Czekaj na wątek" (co powoduje, że agent wykonuje oczekiwanie w wątku w tle), podaj identyfikator wątku agenta, aby pobrać wyniki. Ten identyfikator wątku agenta zostanie dostarczony przez wcześniejsze wywołanie tej akcji. W przeciwnym razie ustaw wartość 0 (wartość domyślna).

Czekaj na wątek
WaitForThread boolean

Ustaw wartość true, aby poczekać na zakończenie wątku agenta; Agent będzie czekać tak długo, jak określono w ciągu "Sekundy oczekiwania na obraz wyszukiwania". Ustaw wartość false, aby pominąć oczekiwanie; Agent będzie nadal wykonywać oczekiwanie w tle, ale także będzie dostępny dla następnej akcji. Następnie możesz pobrać wyniki w późniejszym czasie, używając akcji "Zaczekaj, aż wątek agenta zakończy się pomyślnie", aby poczekać na zakończenie wątku agenta, a następnie ponownie uruchomić tę akcję "Zaczekaj na widoczny obraz wyszukiwania w elemecie UIA" z danymi wejściowymi "Pobierz dane wyjściowe dla identyfikatora wątku" ustawionym na identyfikator wątku agenta.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wyszukaj obraz znajdujący się
SearchImageLocated boolean

Te dane wyjściowe zostaną ustawione na wartość true, jeśli znajduje się obraz wyszukiwania. Te dane wyjściowe zostaną ustawione na wartość false, jeśli obraz wyszukiwania nie został zlokalizowany.

Który obraz wyszukiwania znajduje się
WhichSearchImageLocated integer

Te dane wyjściowe zostaną ustawione na 0, jeśli nie znajdują się żadne obrazy wyszukiwania. Ustaw wartość 1, jeśli znajduje się obraz wyszukiwania. Ustaw wartość 2, jeśli znajduje się alternatywny obraz wyszukiwania.

Lewy piksel elementu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxElementLeftPixelXCoord integer

Wirtualna współrzędna X najbardziej lewego piksela pasująca do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dopasuj element pola ograniczenia obrazu do prawej piksela
SearchImageBoundingBoxElementRightPixelXCoord integer

Wirtualna współrzędna X najwięcej pikseli pasujących do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dopasuj element pola ograniczenia obrazu do górnego piksela
SearchImageBoundingBoxElementTopPixelYCoord integer

Wirtualna współrzędna Y najwyższego piksela pasującego do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dolny piksel pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxElementBottomPixelYCoord integer

Wirtualna współrzędna Y najwięcej pikseli pasująca do określonego obrazu względem elementu wirtualnego w lewym górnym rogu.

Dopasowanie obrazu do środka elementu pola ograniczenia X pikseli
SearchImageBoundingBoxElementCenterPixelXCoord integer

Wirtualna współrzędna X środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu względem elementu wirtualnego lewego górnego rogu.

Dopasowanie obrazu do pola ograniczenia— środek Y pikseli
SearchImageBoundingBoxElementCenterPixelYCoord integer

Wirtualna współrzędna Y środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu względem elementu wirtualnego lewego górnego rogu.

Lewy piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenLeftPixelXCoord integer

Współrzędna X pikseli ekranu z lewej większości pikseli pasującą do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Prawy piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenRightPixelXCoord integer

Współrzędna X piksela ekranu z prawej strony pasującą do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Górny piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenTopPixelYCoord integer

Współrzędna Y piksela ekranu najwyższego poziomu pasującego do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dolny piksel ekranu pola ograniczenia dopasowania obrazu
SearchImageBoundingBoxScreenBottomPixelYCoord integer

Współrzędna Y pikseli ekranu z najbardziej u dołu pasującą do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dopasowanie obrazu do środka ekranu pola ograniczenia X pikseli
SearchImageBoundingBoxScreenCenterPixelXCoord integer

Współrzędna X pikseli ekranu środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dopasowanie obrazu do środka ekranu pola ograniczenia Y pikseli
SearchImageBoundingBoxScreenCenterPixelYCoord integer

Współrzędna Y pikseli ekranu środka pola ograniczenia zawierającego piksele pasujące do określonego obrazu. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Identyfikator wątku
ThreadId integer

Jeśli ustawiono wartość false "Czekaj na wątek" (co powoduje, że agent wykonuje oczekiwanie w wątku w tle), te dane wyjściowe będą zawierać identyfikator wątku agenta, który może służyć do monitorowania procesu akcji i pobierania wyników później, po zakończeniu wątku.

Pobieranie dojścia interfejsu użytkownika dla okna głównego identyfikatora procesu

Prosta i szybka akcja Win32, która zwraca uchwyt dla dowolnego głównego okna procesu (określonego przez identyfikator procesu). Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator procesu wyszukiwania
ProcessId True integer

Identyfikator procesu oczekiwania (zgodnie z akcją "Uruchom proces" w akcjach środowiska/sesji IA-Connect).

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Pobieranie dojścia UIA dla okna głównego procesu

Prosta i szybka akcja Win32, która zwraca uchwyt dla dowolnego głównego okna procesu (określonego przez nazwę). Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym. Okno musi istnieć: IA-Connect nie będzie czekać. Zaleca się użycie akcji "Czekaj na element pulpitu", która jest bardziej zaawansowana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa procesu wyszukiwania
SearchProcessName True string

Nazwa procesu do wyszukania, np. Notatnik.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Pobieranie dojścia UIA dla okna Win32 najwyższego poziomu

Szybka akcja Win32 zwracająca uchwyt UIA dla dowolnego okna Win32 najwyższego poziomu z określoną nazwą klasy lub tytułem okna lub można określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Okno najwyższego poziomu to okno, które jest połączone z pulpitem. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. Okno musi istnieć, IA-Connect nie będzie czekać. Częściej używa się akcji UIA "Czy element pulpitu UIA istnieje", która jest bardziej zaawansowana, ale ta akcja Win32 zwykle wykonuje się szybciej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa klasy wyszukiwania
SearchClassName string

Nazwa klasy elementu okna najwyższego poziomu do wyszukania, np. "Notatnik".

Tytuł okna wyszukiwania
SearchWindowTitle string

Tytuł okna najwyższego poziomu do wyszukania.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Opcjonalny identyfikator procesu, który jest właścicielem okna (na przykład podane przez dane wyjściowe akcji "Uruchom proces" w akcjach IA-Connect Środowisko/sesja). Ustaw wartość 0, aby nie wyszukiwać według identyfikatora procesu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych względem dostępnych właściwości okna. Przykład 1: [Szerokość] < 200. Przykład 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma oknami, umożliwia to określenie właściwości okna do sortowania. Będzie to używane w połączeniu z "Dopasuj indeks", aby wybrać wymagane okno. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Uwzględnij indeks" wynosi 1, zostanie zwrócone pasujące okno najbliżej górnej części ekranu.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma oknami, należy dopasować wartość "Dopasuj indeks" z góry posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Pobieranie elementu UIA na współrzędnych ekranu

Zwraca element UIA znajdujący się na podanych współrzędnych ekranu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Współrzędna X
XCoord integer

Wartość współrzędnych ekranu X (w pikselach), w której należy wyszukać element UIA.

Współrzędna Y
YCoord integer

Wartość współrzędnych ekranu Y (w pikselach), w której należy wyszukać element UIA.

Zgłoś wyjątek, jeśli nie znaleziono elementu
RaiseExceptionIfElementNotFound boolean

Czy IA-Connect zgłosić wyjątek, jeśli element UIA nie znajduje się w określonej lokalizacji?

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Znaleziono element
ElementFound boolean

Zwraca wartość true, jeśli element UIA został znaleziony w określonej lokalizacji.

Uchwyt elementu
ElementHandle integer

Uchwyt interfejsu użytkownika dla elementu. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika działających na tym elemecie.

Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Pobieranie elementów listy UIA

Zwraca listę elementów podrzędnych znalezionych w ramach określonego elementu (zazwyczaj listy rozwijanej / elementów menu).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Rozwiń najpierw
ExpandFirst boolean

Jeśli ustawiono wartość true, IA-Connect spróbuje rozwinąć listę przed wyszukaniem elementów elementu listy. Jest to przydatne w przypadku list dynamicznych, ponieważ elementy elementu listy mogą nie zostać utworzone do momentu rozwinięcia listy.

Zwiń po
CollapseAfter boolean

Jeśli ustawiono wartość true, lista zostanie zwinięta po wykonaniu wyszukiwania.

Sprawdzanie wybranych elementów
CheckForSelectedItems boolean

Jeśli ustawiono wartość true, kolekcja danych wyjściowych będzie zawierać dodatkową właściwość wskazującą, czy element listy jest aktualnie zaznaczony.

Sekundy między rozwijaniem i zwijaniem
SecondsBetweenExpandCollapse double

Liczba sekund oczekiwania między akcjami rozwijania i zwijania, jeśli są one ustawione na wartość true.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba elementów listy
NumberOfListItems integer

Liczba elementów na liście.

Kod JSON elementów listy
ListItemsJSON string

Właściwości elementów na liście w formacie JSON.

Liczba zaznaczonych elementów
NumberOfSelectedItems integer

Liczba wybranych elementów na liście.

Indeks pierwszego wybranego elementu
IndexOfFirstSelectedItem integer

Indeks na liście pierwszego wybranego elementu.

Nazwa wybranego elementu
SelectedItemName string

Nazwa wybranego elementu.

Pobieranie elementów pulpitu UIA

Zwraca listę wszystkich okien i okien dialogowych na pulpicie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Wyszukaj element zlokalizowany typ kontrolki
SearchElementLocalizedControlType string

Filtruj wyniki według zlokalizowanego typu kontrolki elementu.

Identyfikator procesu wyszukiwania
SearchProcessID integer

Jeśli zostanie określony, wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Pierwszy element do zwrócenia
FirstItemToReturn integer

Indeks elementu pierwszego elementu, który ma być zwracany, począwszy od 1. Jeśli chcesz zwrócić elementy w odwrotnej kolejności (od dołu drzewa UIA), możesz również określić indeks ujemny rozpoczynający się od -1.

Maksymalna liczba elementów do zwrócenia
MaxItemsToReturn integer

Maksymalna liczba elementów do zwrócenia lub 0 w celu zwrócenia wszystkich elementów.

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, zostanie zwrócony tylko proces pasujący do dokładnego identyfikatora procesu wyszukiwania.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba znalezionych elementów
NumberOfElementsFound integer

Liczba elementów pulpitu znalezionych, które są zgodne z kryteriami wyszukiwania.

Liczba zwracanych elementów
NumberOfElementsReturned integer

Liczba zwracanych elementów pulpitu (może to być mniejsza niż liczba znalezionych elementów, jeśli określono maksymalną liczbę elementów do zwrócenia).

Właściwości elementu
ElementProperties array of object

Właściwości elementu elementów pulpitu wykazały, że są zgodne z kryteriami wyszukiwania.

items
ElementProperties object

Pobieranie okien Win32

Szybka akcja Win32, która zwraca listę wszystkich okien Win32, które opcjonalnie mają określoną nazwę klasy lub tytuł okna, lub można określić bardziej zaawansowane filtry wyszukiwania, w tym symbole wieloznaczne. Mimo że ta akcja korzysta z interfejsów API Win32, może wykrywać okna Windows, Java, ModernUI i Web. System Windows Win32 może zawierać nieoczekiwane elementy, w tym pasek zadań, pulpit, menu Start, przezroczyste nakładki, okna wyłączone lub ukryte, dzięki czemu zwracana lista może zawierać więcej wyników niż oczekiwano.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa klasy wyszukiwania
SearchClassName string

Opcjonalna nazwa klasy okna najwyższego poziomu do wyszukania, np. "Chrome_WidgetWin_1".

Tytuł okna wyszukiwania
SearchWindowTitle string

Opcjonalny tytuł okna najwyższego poziomu do wyszukania.

Pobieranie tylko okien najwyższego poziomu
TopLevelWindowsOnly boolean

Ustaw wartość true, aby pobrać tylko okna Win32, które system operacyjny uważa za najwyższego poziomu. Ustaw wartość false, aby pobrać wszystkie okna Win32. Należy pamiętać, że definicja win32 okna będzie zawierać elementy, które mogą nie być rozpoznawane jako okno, a wiele okien dialogowych i okien komunikatów jest oznaczonych jako najwyższego poziomu, mimo że są elementem podrzędnym okna nadrzędnego.

Pobieranie tylko widocznych okien
VisibleWindowsOnly boolean

Ustaw wartość true, aby pobrać tylko okna Win32, które system operacyjny uważa za widoczny. Ustaw wartość false, aby pobrać zarówno widoczne, jak i niewidoczne okna Win32. Należy pamiętać, że okna offscreen lub przezroczyste mogą być oznaczone jako widoczne, ale ich nie widać.

Pobieranie tylko okien z paskiem tytułu
WindowsWithTitlebarOnly boolean

Ustaw wartość true, aby pobrać tylko okna Win32 z paskiem tytułu. Ustaw wartość false, aby pobrać okna Win32 niezależnie od tego, czy mają pasek tytułu, czy nie. Należy pamiętać, że niektóre przezroczyste okna mają paski tytułu, ale ich nie widać.

Pobieranie tylko okien z tytułem
WindowsWithTitleOnly boolean

Ustaw wartość true, aby pobrać tylko okna Win32 z tytułem (tj. pasek tytułu zawierający jakiś tekst). Ustaw wartość false, aby pobrać okna Win32 niezależnie od tego, czy mają tytuł. Pamiętaj, że pasek tytułu jest paskiem u góry okna, natomiast tytuł jest tekstem w nim.

Ignoruj przezroczyste okna
IgnoreTransparentWindows boolean

Ustaw wartość true, aby pobrać tylko okna Win32, które nie mają przezroczystości. Ustaw wartość false, aby pobrać okna Win32 niezależnie od tego, czy mają ustawioną przezroczystość, czy nie.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Opcjonalny identyfikator procesu, który jest właścicielem okien (na przykład podany przez dane wyjściowe akcji "Uruchom proces" w akcjach IA-Connect Środowisko/sesja). Ustaw wartość 0, aby nie wyszukiwać według identyfikatora procesu.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma oknami, umożliwia to określenie właściwości okna do sortowania. Na przykład: Jeśli "Sortuj według nazwy kolumny" to [TopEdge], lista okien zostanie zwrócona według górnej krawędzi. Jeśli to pole pozostanie puste, okna zostaną zwrócone w kolejności, w której zostaną wykryte.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli istnieje wiele okien pasujących do wyszukiwania i określono kolumnę sortowania, ustaw wartość true (wartość domyślna), aby sortować rosnąco lub ustawiać wartość false na sortowanie malejące.

Zwracanie uchwytu elementu UIA
ReturnElementHandle boolean

W przypadku ustawienia wartości true w kolekcji wyjściowej (w kolumnie UIAHandle) zostanie zwrócona obsługa interfejsu użytkownika dla każdego zlokalizowanego okna Win32. Ten uchwyt może być używany w dalszych akcjach, aby działać jako uchwyt "nadrzędny" w IA-Connect akcjach UIA.

Pierwszy element do zwrócenia
FirstItemToReturn integer

Indeks pierwszego okna (wiersza) do zwrócenia, począwszy od 1.

Maksymalna liczba elementów do zwrócenia
MaxItemsToReturn integer

Maksymalna liczba okien do zwrócenia lub 0, aby zwrócić wszystkie elementy.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Win32 windows JSON
Win32WindowsJSON string

Lista okien Win32 pasujących do kryteriów wyszukiwania w formacie JSON.

Liczba okien Win32
NumberOfWin32Windows integer

Liczba zwróconych okien Win32.

Pobieranie regionu wyszukiwania elementów UIA

Zwraca szczegóły regionu pikseli w elemecie UIA, który spełnia określone kryteria kolorów. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent lokalizuje kolory, wykonując zrzut ekranu na współrzędnych elementu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Kolor wyszukiwania
SearchColour True string

Kolor wyszukiwania w formacie 0xAARRGGBB, #AARRGGBB, 0xRRGGBB lub #RRGGBB, gdzie każdy kanał kolorów jest bajtem w formacie szesnastkowym (00 jest w pełni wyłączony, FF jest w pełni włączony). Na przykład: #FF0000 dla czerwonego, #00FF00 dla niebieskiego, #0000000 dla czarnego, #FFFFFF dla białych.

Maksymalne odchylenie koloru
MaxColourDeviation True integer

Maksymalny kolor elementu może odbiegać od koloru wyszukiwania, zanim nie zostanie uznany za dopasowanie. 0 bez odchylenia. Odchylenie jest mierzone w wartościach RGB. Na przykład: #FF0000 różni się od #FE0102 4. Odchylenie 15 byłoby dobrym punktem wyjścia.

Przesunięcie lewego piksela X
LeftPixelXOffset integer

Opcjonalne przesunięcie X lewej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie X w prawym pikselu
RightPixelXOffset integer

Opcjonalne przesunięcie X dla prawej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Przesunięcie górnego piksela Y
TopPixelYOffset integer

Opcjonalne przesunięcie Y dla górnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie Y dolnego piksela
BottomPixelYOffset integer

Opcjonalne przesunięcie Y dla dolnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Ukryj agenta
HideAgent boolean

Ustaw wartość true, aby automatycznie ukryć agenta (jeśli jest widoczny), aby upewnić się, że nie ukrywa analizowanego elementu.

Współrzędne ekranu powrotnego jako fizyczne
ReturnPhysicalCoordinates boolean

Ustaw wartość true dla współrzędnych ekranu, które mają być zwracane jako współrzędne fizyczne. Ustaw wartość false dla współrzędnych ekranu, które mają być zwracane jako współrzędne wirtualne. Jeśli bazowe skalowanie wyświetlania wynosi 100%, współrzędne fizyczne i wirtualne są takie same. Współrzędne elementu są zawsze zwracane jako współrzędne wirtualne.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba pikseli pasujących do koloru
NumberOfPixelsMatchingColour integer

Liczba pikseli, które pasują do określonego koloru.

Lewy piksel elementu pola ograniczenia dopasowania koloru
ColourMatchBoundingBoxElementLeftPixelXCoord integer

Wirtualna współrzędna X najbardziej lewego piksela pasująca do określonego koloru względem elementu wirtualnego lewego górnego rogu.

Dopasuj kolor elementu pola ograniczenia do prawej piksela
ColourMatchBoundingBoxElementRightPixelXCoord integer

Wirtualna współrzędna X najwięcej pikseli pasująca do określonego koloru względem elementu wirtualnego lewego górnego rogu.

Kolor pasuje do elementu pola ograniczenia górnego piksela
ColourMatchBoundingBoxElementTopPixelYCoord integer

Wirtualna współrzędna Y najwyższego piksela pasującego do określonego koloru względem wirtualnego górnego rogu elementu.

Kolor pasuje do elementu pola ograniczenia dolnego piksela
ColourMatchBoundingBoxElementBottomPixelYCoord integer

Wirtualna współrzędna Y najwięcej pikseli pasujących do określonego koloru względem elementu wirtualnego lewego górnego rogu.

Kolor dopasuj do środka pola ograniczenia X pikseli
ColourMatchBoundingBoxElementCenterPixelXCoord integer

Wirtualna współrzędna X środka pola ograniczenia zawierającego piksele pasujące do określonego koloru względem elementu wirtualnego lewego górnego rogu.

Kolor dopasuj do pola ograniczenia, w środku Y pikseli
ColourMatchBoundingBoxElementCenterPixelYCoord integer

Wirtualna współrzędna Y środka pola ograniczenia zawierającego piksele pasujące do określonego koloru względem elementu wirtualnego lewego górnego rogu.

Lewy piksel ekranu pola ograniczenia dopasowania koloru
ColourMatchBoundingBoxScreenLeftPixelXCoord integer

Współrzędna X pikseli ekranu najwięcej pikseli pasujących do określonego koloru. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Kolorowy ekran pola ograniczenia z prawej strony
ColourMatchBoundingBoxScreenRightPixelXCoord integer

Współrzędna X piksela ekranu z prawej strony pasującą do określonego koloru. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Górny piksel ekranu pola ograniczenia dopasowania koloru
ColourMatchBoundingBoxScreenTopPixelYCoord integer

Współrzędna Y piksela ekranu najwyższego rozmiaru pasującego do określonego koloru. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Dolny piksel ekranu pola ograniczenia dopasowania koloru
ColourMatchBoundingBoxScreenBottomPixelYCoord integer

Współrzędna Y na ekranie najwięcej pikseli pasujących do określonego koloru. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Kolor dopasuj do środka ekranu pola ograniczenia X pikseli
ColourMatchBoundingBoxScreenCenterPixelXCoord integer

Współrzędna X pikseli ekranu środka pola ograniczenia zawierającego piksele pasujące do określonego koloru. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Kolor dopasuj do środka ekranu pola ograniczenia Y pikseli
ColourMatchBoundingBoxScreenCenterPixelYCoord integer

Współrzędna Y pikseli ekranu środka pola ograniczenia zawierającego piksele pasujące do określonego koloru. Jest to współrzędna fizyczna lub wirtualna w zależności od danych wejściowych "Zwracaj współrzędne fizyczne".

Pobieranie uchwytu elementu nadrzędnego UIA

Zwraca uchwyt elementu nadrzędnego określonego elementu. Element nadrzędny jest definiowany jako element, który znajduje się na następnym poziomie w górę "drzewo" interfejsu użytkownika i jest prawie zawsze elementem zawierającym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt elementu
ElementHandle True integer

Uchwyt interfejsu użytkownika dla elementu docelowego.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt elementu nadrzędnego
ParentElementHandle integer

Uchwyt interfejsu użytkownika dla elementu nadrzędnego.

Pobieranie wartości elementu UIA

Zwraca wartość elementu. Wartość jest zwykle skojarzona z obszarem wprowadzania tekstu, ale wiele elementów może mieć tę właściwość.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wartość elementu
ElementValue string

Wartość elementu.

Pobieranie wartości etykiety elementu UIA

Zwraca wartość etykiety na elemecie .

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wartość etykiety elementu
ElementLabelValue string

Wartość etykiety elementu.

Pobieranie wartości tekstowej elementu UIA

Zwraca wartość tekstową elementu. Wartość tekstowa jest zwykle skojarzona z etykietą, ale wiele elementów może mieć tę właściwość.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wartość tekstowa elementu
ElementTextValue string

Wartość tekstowa elementu.

Pobieranie wielu elementów interfejsu użytkownika jako tabeli

Wylicza wartości elementów podrzędnych określonego elementu nadrzędnego i zwraca je w formacie tabeli. Może to służyć do zwracania wierszy i kolumn danych z elementów, które nie są tabelami technicznie, ale zostały ułożone razem w strukturę tabeli. Za pomocą tej akcji można również pobrać wyniki z poprzedniego wykonania tej akcji, uruchomić jako wątek agenta.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Podelement nagłówka komórki wyszukiwania zlokalizowany typ kontrolki
SearchCellHeaderSubElementLocalizedControlType string

Podelement nagłówka komórki zlokalizowany typ kontrolki do wyszukania. Pozostaw wartość pustą, jeśli nie wyszukuje nagłówków komórek.

Typ kontrolki podelementu nagłówka komórki wyszukiwania
SearchCellHeaderSubElementControlType integer

Typ kontrolki podelementu nagłówka komórki (nielokalizowanej liczby całkowitej) do wyszukania. Jest to ta sama wartość w różnych językach. Pozostaw wartość 0, jeśli nie wyszukuj nagłówków komórek.

Typ kontrolki zlokalizowanej podelementu komórki wyszukiwania
SearchCellSubElementLocalizedControlType string

Podelement komórki zlokalizowany typ kontrolki do wyszukania.

Typ kontrolki podelementu komórki wyszukiwania
SearchCellSubElementControlType integer

Typ kontrolki podelementu komórki (nielokalizowanej liczby całkowitej) do wyszukania. Jest to ta sama wartość w różnych językach.

Wyszukiwanie elementów podrzędnych dla podelementów komórek
SearchDescendantsForCellSubElements boolean

Jeśli ustawisz wartość true, drzewo UIA poniżej zlokalizowanego elementu zostanie wyszukane podelementami komórek i nagłówka komórki (tj. wartości elementu, które wypełnią komórki w tabeli wyjściowej). Jest to bardziej dokładne, ale może trwać dłużej. Możesz ustawić wartość false, jeśli interesuje Cię tylko elementy bezpośrednio pod elementem.

Podelement nagłówka pierwszej komórki, który ma być zwracany
FirstCellHeaderSubElementToReturn integer

Indeks pierwszego podelementu nagłówka komórki, który ma być zwracany, począwszy od 1. Jeśli chcesz zwrócić elementy w odwrotnej kolejności (od dołu drzewa UIA), możesz również określić indeks ujemny rozpoczynający się od -1.

Maksymalna liczba podelementów nagłówka komórki do zwrócenia
MaxCellHeaderSubElementsToReturn integer

Maksymalna liczba elementów podrzędnych nagłówka komórki do zwrócenia lub 0, aby zwrócić wszystkie podelementy.

Pierwszy podelement komórki, który ma być zwracany
FirstCellSubElementToReturn integer

Indeks pierwszego podelementu komórki do zwrócenia, począwszy od 1. Jeśli chcesz zwrócić elementy w odwrotnej kolejności (od dołu drzewa UIA), możesz również określić indeks ujemny rozpoczynający się od -1.

Maksymalna liczba podelementów komórek do zwrócenia
MaxCellSubElementsToReturn integer

Maksymalna liczba podelementów komórek do zwrócenia lub 0 w celu zwrócenia wszystkich podelementów.

Żądana liczba kolumn
RequestedNumberOfColumns integer

Liczba kolumn, które mają być w tabeli wyjściowej. Ta wartość musi być poprawna dla odczytywanego elementu lub otrzymasz nieoczekiwane wyniki.

Priorytet wartości podelementu komórki
CellSubElementValuePriority integer

Priorytet użycia wartości podelementu komórki jako wartości do użycia w tabeli wyjściowej. 1 jest najwyższym priorytetem. 2 jest drugim priorytetem. 3 jest trzecim priorytetem. Wartość 0 nie jest używana.

Priorytet wartości tekstowej podelementu komórki
CellSubElementTextValuePriority integer

Priorytet użycia wartości tekstowej podelementu komórki jako wartości do użycia w tabeli wyjściowej. 1 jest najwyższym priorytetem. 2 jest drugim priorytetem. 3 jest trzecim priorytetem. Wartość 0 nie jest używana.

Priorytet wartości nazwy podelementu komórki
CellSubElementNameValuePriority integer

Priorytet użycia nazwy podelementu komórki (wspólne dla etykiet) jako wartości do użycia w tabeli wyjściowej. 1 jest najwyższym priorytetem. 2 jest drugim priorytetem. 3 jest trzecim priorytetem. Wartość 0 nie jest używana.

Minimalna szerokość podelementu komórki
MinimumCellSubElementWidth integer

Minimalna szerokość w pikselach podelementu komórki, która ma zostać uwzględniona w tabeli.

Minimalna wysokość podelementu komórki
MinimumCellSubElementHeight integer

Minimalna wysokość w pikselach podelementu komórki, która ma zostać uwzględniona w tabeli.

Pole ograniczenia podelementu komórki wyszukiwania w lewo
SearchCellSubElementBoundingBoxLeft integer

Uwzględnij tylko podelementy komórek, które są w pełni zawarte w polu ograniczenia. Domyślnie pole ograniczenia jest ogromne, aby uwzględnić wszystkie elementy.

Pole ograniczenia podelementu komórki wyszukiwania po prawej stronie
SearchCellSubElementBoundingBoxRight integer

Uwzględnij tylko podelementy komórek, które są w pełni zawarte w polu ograniczenia. Domyślnie pole ograniczenia jest ogromne, aby uwzględnić wszystkie elementy.

Pole ograniczenia podelementu komórki wyszukiwania u góry
SearchCellSubElementBoundingBoxTop integer

Uwzględnij tylko podelementy komórek, które są w pełni zawarte w polu ograniczenia. Domyślnie pole ograniczenia jest ogromne, aby uwzględnić wszystkie elementy.

Pole ograniczenia podelementu komórki wyszukiwania
SearchCellSubElementBoundingBoxBottom integer

Uwzględnij tylko podelementy komórek, które są w pełni zawarte w polu ograniczenia. Domyślnie pole ograniczenia jest ogromne, aby uwzględnić wszystkie elementy.

Odczytywanie tabeli jako wątku
ReadTableAsThread boolean

Jeśli zostanie ustawiona wartość false (wartość domyślna), agent IA-Connect odczytuje tabelę natychmiast i zwróci zawartość do dyrektora. W przypadku odczytywania dużych tabel ta akcja może upłynął limit czasu. Jeśli ustawiono wartość true, agent IA-Connect odczytuje tabelę jako wątek agenta i dyrektor IA-Connect (lub orchestrator, moduł Programu PowerShell, niebieski prism) może monitorować stan tego wątku agenta, czekając na jego ukończenie. Dzięki temu duże tabele mogą być odczytywane bez limitów czasu. IA-Connect Agenci w wersji 9.3 i starszych mogą od razu odczytywać tylko tabele, a nie jako wątek agenta.

Pobieranie danych wyjściowych dla identyfikatora wątku
RetrieveOutputDataFromThreadId integer

Jeśli wcześniej uruchomiono tę akcję jako wątek agenta i ustaw wartość "Sekundy oczekiwania na wątek" na 0, podaj identyfikator wątku agenta, aby pobrać wyniki. Ten identyfikator wątku agenta zostanie dostarczony przez wcześniejsze wywołanie tej akcji. Ustaw wartość 0 (wartość domyślna), jeśli czytasz tabelę (i dlatego nie pobierasz wyników poprzedniego uruchomienia zapytania jako wątek agenta).

Sekundy oczekiwania na wątek
SecondsToWaitForThread integer

Jeśli wartość "Odczytaj tabelę jako wątek" ma wartość true, ile sekund czeka na zakończenie wątku agenta. Jeśli w tym czasie wątek agenta odczytu tabeli nie został ukończony, zostanie zgłoszony wyjątek. Ustaw wartość 0, aby pominąć oczekiwanie: Agent będzie nadal odczytywał tabelę, ale także będzie dostępny dla następnej akcji. Następnie możesz pobrać wyniki (zawartość tabeli) później, używając akcji "Zaczekaj na pomyślne zakończenie wątku agenta", aby poczekać na zakończenie wątku agenta, a następnie ponownie uruchomić tę akcję "Pobierz wiele elementów interfejsu użytkownika jako tabelę" z danymi wejściowymi "Pobierz dane wyjściowe dla identyfikatora wątku" ustawioną na identyfikator wątku agenta.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba znalezionych podelementów komórek
NumberOfCellSubElementsFound integer

Liczba podelementów komórek (nie nagłówków) wykazała, że jest zgodna z kryteriami wyszukiwania.

Liczba zwróconych podelementów komórek
NumberOfCellSubElementsReturned integer

Zwrócona liczba podelementów komórek (nie nagłówków) (może to być mniejsza niż liczba znalezionych elementów, jeśli określisz pierwszą lub maksymalną liczbę elementów do zwrócenia).

Kod JSON spisu treści
TableContentsJSON string

Tabela utworzona na podstawie zawartości wielu elementów w formacie JSON.

Liczba wierszy w tabeli
NumberOfRowsInTable integer

Liczba wierszy w tabeli wyjściowej.

Liczba kolumn w tabeli
NumberOfColumnsInTable integer

Liczba kolumn w tabeli wyjściowej.

Identyfikator wątku
ThreadId integer

Jeśli ta akcja jest uruchamiana jako wątek agenta, dane wyjściowe będą zawierać identyfikator wątku agenta, który może służyć do monitorowania procesu akcji i pobierania zawartości tabeli po zakończeniu wątku.

Pobieranie wielu właściwości elementu nadrzędnego UIA

Zwraca drzewo hierarchiczne elementów nadrzędnych określonego elementu aż do pulpitu (poziom główny). Element nadrzędny jest definiowany jako element, który znajduje się na następnym poziomie w górę "drzewo" interfejsu użytkownika i jest prawie zawsze elementem zawierającym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt elementu
ElementHandle True integer

Uchwyt interfejsu użytkownika dla elementu docelowego.

Maksymalna liczba elementów nadrzędnych do przetworzenia
MaxParentsToProcess integer

Maksymalna liczba elementów nadrzędnych do przetworzenia. Domyślnie jest to wartość 50.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Elementy nadrzędne UIA
UIAParentElements array of object

Lista wszystkich zlokalizowanych elementów nadrzędnych (i ich właściwości). Zwrócone właściwości są takie same jak te zwracane przez akcję "Pobierz wiele właściwości elementu".

items
UIAParentElements object
Liczba zwracanych elementów nadrzędnych
NumberOfParentElementsReturned integer

Liczba elementów nadrzędnych zwróconych z wyszukiwania.

Pobieranie wielu właściwości elementu UIA

Zwraca właściwości wielu elementów. Może to być przydatne, jeśli nie masz pewności, które pola zawierają wymagane wartości właściwości.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Wyszukaj element zlokalizowany typ kontrolki
SearchElementLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj elementy podrzędne
SearchDescendants boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Zwracanie wartości elementu
ReturnElementValue boolean

Jeśli zostanie ustawiona wartość true niż wartość zlokalizowanego elementu, zostanie zwrócona.

Pierwszy element do zwrócenia
FirstItemToReturn integer

Indeks elementu pierwszego elementu, który ma być zwracany, począwszy od 1. Jeśli chcesz zwrócić elementy w odwrotnej kolejności (od dołu drzewa UIA), możesz również określić indeks ujemny rozpoczynający się od -1.

Maksymalna liczba elementów do zwrócenia
MaxItemsToReturn integer

Maksymalna liczba elementów do zwrócenia lub 0 w celu zwrócenia wszystkich elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba znalezionych elementów
NumberOfElementsFound integer

Liczba znalezionych elementów spełniających kryteria wyszukiwania.

Liczba zwracanych elementów
NumberOfElementsReturned integer

Liczba zwracanych elementów (może to być mniejsza niż liczba znalezionych elementów, jeśli określi maksymalną liczbę elementów do zwrócenia).

Właściwości elementu
ElementProperties array of object

Właściwości elementu elementów wykazały, że są zgodne z kryteriami wyszukiwania.

items
ElementProperties object

Pobieranie wzorców elementów UIA

Pobierz, które wzorce UIA są dostępne dla elementu UIA, a tym samym, które IA-Connect akcje UIA mogą mieć wpływ na element.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Dostępny wzorzec zwijania
ExpandCollapsePatternAvailable boolean

Wzorzec zwijania rozwijania interfejsu użytkownika jest dostępny i dlatego akcje, które rozszerzają lub zwijają element (na przykład menu rozwijane) prawdopodobnie będą działać.

Dostępny wzorzec wywołania
InvokePatternAvailable boolean

Wzorzec wywołania interfejsu użytkownika jest dostępny i dlatego akcje, które naciskają element lub klikają element listy, prawdopodobnie będą działać.

Dostępny wzorzec wartości zakresu
RangeValuePatternAvailable boolean

Wzorzec wartości zakresu UIA jest dostępny i dlatego akcje, które przewijają element lub suwak, prawdopodobnie będą działać.

Dostępny wzorzec przewijania
ScrollPatternAvailable boolean

Wzorzec przewijania interfejsu użytkownika jest dostępny i dlatego akcje, które przewijają element, prawdopodobnie będą działać.

Dostępny wzorzec elementu zaznaczenia
SelectionItemPatternAvailable boolean

Wzorzec elementu wyboru interfejsu użytkownika jest dostępny i dlatego akcje, które prawdopodobnie spowodują wybranie elementu.

Dostępny wzorzec tekstu
TextPatternAvailable boolean

Wzorzec tekstu UIA jest dostępny i dlatego akcje, które odczytują wartość tekstową elementu, prawdopodobnie będą działać.

Dostępny wzorzec przełączania
TogglePatternAvailable boolean

Wzorzec przełącznika interfejsu użytkownika jest dostępny i dlatego akcje sprawdzające, co spowoduje anulowanie zaznaczenia lub przełączenie elementu, prawdopodobnie zadziała.

Dostępny wzorzec wartości
ValuePatternAvailable boolean

Wzorzec wartości interfejsu użytkownika jest dostępny i dlatego akcje, które mogą pracować w tekście wejściowym do elementu lub odczytywać wartość elementu. Paski przewijania mogą również reagować na wzorzec wartości.

Dostępny wzorzec okna
WindowPatternAvailable boolean

Wzorzec okna interfejsu użytkownika jest dostępny i dlatego działania, które zamykają, maksymalizują lub minimalizują działanie elementu.

Dostępny wzorzec siatki
GridPatternAvailable boolean

Dostępny jest wzorzec siatki UIA. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec elementu siatki
GridItemPatternAvailable boolean

Dostępny jest wzorzec elementu siatki UIA. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny starszy wzorzec IAccessible
LegacyIAccessiblePatternAvailable boolean

Dostępny jest starszy wzorzec IAccessible interfejsu użytkownika. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec zaznaczenia
SelectionPatternAvailable boolean

Dostępny jest wzorzec wyboru interfejsu użytkownika. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec arkusza kalkulacyjnego
SpreadsheetPatternAvailable boolean

Dostępny jest wzorzec arkusza kalkulacyjnego UIA. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec elementu arkusza kalkulacyjnego
SpreadsheetItemPatternAvailable boolean

Dostępny jest wzorzec elementu arkusza kalkulacyjnego UIA. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec tabeli
TablePatternAvailable boolean

Wzorzec tabeli UIA jest dostępny. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec elementu tabeli
TableItemPatternAvailable boolean

Wzorzec elementu tabeli UIA jest dostępny. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec tekstu 2
TextPattern2Available boolean

Dostępny jest wzorzec tekstu UIA 2. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec edycji tekstu
TextEditPatternAvailable boolean

Dostępny jest wzorzec edycji tekstu UIA. Ten wzorzec nie jest używany przez program IA-Connect.

Dostępny wzorzec przekształcania
TransformPatternAvailable boolean

Dostępny jest wzorzec przekształcania UIA. Ten wzorzec nie jest używany przez program IA-Connect.

Pobieranie właściwości elementu datagrid interfejsu użytkownika

Zwraca właściwości tabeli elementu DataGrid. Jest to element z wierszami, kolumnami, nagłówkiem i komórkami (tj. tabelą).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Alternatywna nazwa wiersza nagłówka
AlternativeHeaderRowName string

Domyślnie wiersz nagłówka w usłudze DataGrid ma nazwę UIA "Górny wiersz". Jeśli wiersz nagłówka ma inną nazwę, określ tę nazwę tutaj.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba kolumn
NumberOfColumns integer

Liczba kolumn w usłudze datagrid.

Liczba widocznych kolumn
NumberOfVisibleColumns integer

Liczba widocznych kolumn w usłudze datagrid.

Liczba wierszy
NumberOfRows integer

Liczba wierszy w usłudze datagrid.

Liczba widocznych wierszy
NumberOfVisibleRows integer

Liczba widocznych wierszy w usłudze datagrid.

Pierwszy widoczny wiersz
FirstVisibleRow integer

Indeks pierwszego widocznego wiersza w usłudze datagrid.

Ostatni widoczny wiersz
LastVisibleRow integer

Indeks ostatniego widocznego wiersza w usłudze datagrid.

Liczba pasków przewijania
NumberOfScrollbars integer

Liczba pasków przewijania, które ma datagrid.

Nazwy pasków przewijania
ScrollbarNames string

Rozdzielona przecinkami lista nazw pasków przewijania (np. pozioma, pionowa).

Pobieranie właściwości elementu UIA

Zwraca wszystkie właściwości elementu. Może to być przydatne, jeśli nie masz pewności, które pole zawiera wymagane wartości właściwości.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Zwracanie uchwytu elementu
ReturnElementHandle boolean

W przypadku ustawienia wartości true zostanie zwrócony uchwyt elementu zlokalizowanego. Tego uchwytu można użyć w dalszych akcjach, aby działać jako uchwyt "nadrzędny".

Zwracanie wartości elementu
ReturnElementValue boolean

Jeśli zostanie ustawiona wartość true niż wartość zlokalizowanego elementu, zostanie zwrócona.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Weryfikowanie punktu możliwego do kliknięcia w granicach elementu
ValidateClickablePointWithinElementBoundary boolean

W przypadku niektórych elementów funkcja UIA nie zna punktu, który można kliknąć w elemecie i zwróci nieprawidłową współrzędną (na przykład 0,0) zamiast środka elementu. Jeśli te dane wejściowe mają wartość true, IA-Connect sprawdzi ważność współrzędnej dostarczonej przez UIA i, jeśli nie znajduje się w granicach elementu, zignoruje wartość podaną przez UIA i zamiast tego użyje środka elementu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Identyfikator struktury elementu
ElementFrameworkId string

Identyfikator struktury UIA elementu.

Typ kontrolki elementu
ElementControlType string

Typ kontrolki UIA jako liczba. Jest to podobne do zlokalizowanego typu kontrolki, ale nie jest specyficzne dla języka.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Element jest włączony
ElementIsEnabled boolean

Zwraca, czy element jest włączony, czy nie.

Element jest wyłączony
ElementIsOffscreen boolean

Zwraca, czy element jest wyłączony, czy nie.

Element to fokus klawiatury
ElementIsKeyboardFocusable boolean

Zwraca, czy element może być skoncentrowany na klawiaturze.

Element ma fokus klawiatury
ElementHasKeyboardFocus boolean

Zwraca, czy element aktualnie ma fokus klawiatury.

Element jest polem hasła
ElementIsPasswordField boolean

Zwraca, czy element jest polem wejściowym hasła.

Klucz akceleratora elementów
ElementAcceleratorKey string

Zwraca hotkey, który można nacisnąć, aby aktywować element.

Klucz dostępu elementu
ElementAccessKey string

Zwraca klucz dostępu, który można nacisnąć, aby aktywować element menu.

Lewa krawędź elementu
ElementLeftEdge integer

Odległość w pikselach między lewą krawędzią elementu lub okna a lewą krawędzią ekranu.

Prawa krawędź elementu
ElementRightEdge integer

Odległość w pikselach między prawą krawędzią elementu lub okna a lewą krawędzią ekranu.

Górna krawędź elementu
ElementTopEdge integer

Odległość w pikselach między górną krawędzią elementu lub okna a górną krawędzią ekranu.

Krawędź dolna elementu
ElementBottomEdge integer

Odległość w pikselach między dolną krawędzią elementu lub okna a górną krawędzią ekranu.

Punkt X z możliwością kliknięcia elementu
ElementClickablePointX integer

Współrzędna X w pikselach centralnego punktu klikniętego w elemecie względem lewej krawędzi ekranu zwróconego przez aplikację bazową.

Element klikalny punkt Y
ElementClickablePointY integer

Współrzędna Y w pikselach centralnego punktu klikniętego w elemecie względem górnej krawędzi ekranu zwróconej przez aplikację bazową.

Identyfikator procesu elementu
ElementProcessId integer

Identyfikator procesu (PID) procesu, który jest właścicielem tego elementu.

Uchwyt elementu
ElementHandle integer

Jeśli dla danych wejściowych "Return element handle" ustawiono wartość true, będzie to zawierać uchwyt elementu liczbowego, który może być używany w dalszych akcjach do działania jako uchwyt "nadrzędny" dla dalszych akcji.

Wartość elementu
ElementValue string

Jeśli wartość wejściowa "Zwracana wartość elementu" została ustawiona na wartość true, a jeśli element ma wzorzec wartości, będzie to przechowywać tę wartość.

Wartość tekstowa elementu
ElementTextValue string

Jeśli wartość wejściowa "Zwracana wartość elementu" została ustawiona na wartość true, a jeśli element ma wzorzec wartości tekstowej, będzie to zawierać tę wartość tekstową.

Pobieranie właściwości elementu UIA jako listy

Zwraca właściwości elementu jako pojedynczej listy wierszy (jednowierszowej kolekcji / tabeli danych) zamiast pojedynczych elementów, może to być przydatne w zależności od tego, jak zamierzasz używać danych.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt elementu
ElementHandle True integer

Uchwyt interfejsu użytkownika dla elementu docelowego.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Liczba znalezionych elementów
NumberOfElementsFound integer

Liczba znalezionych elementów.

Liczba zwracanych elementów
NumberOfElementsReturned integer

Liczba zwracanych elementów.

UIA, właściwości elementu JSON
UIAElementPropertiesJSON string

Właściwości UIA elementu w formacie JSON.

Pobieranie zawartości elementu datagrid UIA

Zwraca zawartość elementu datagrid. Jest to element z wierszami, kolumnami, nagłówkiem i komórkami (tj. tabelą). Za pomocą tej akcji można również pobrać wyniki z poprzedniego wykonania tej akcji, uruchomić jako wątek agenta.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Pobieranie tylko kolumn na ekranie
OnScreenColumnsOnly boolean

Jeśli ustawiono wartość true, zostaną zwrócone tylko kolumny ekranowe.

Pobieranie tylko wierszy na ekranie
OnScreenRowsOnly boolean

Jeśli ustawiono wartość true, zwracane będą tylko wiersze na ekranie.

Zwracanie wartości null jako pustych
ReturnNullValuesAsBlank boolean

W przypadku ustawienia wartości true wartości null zostaną zwrócone jako "" (tj. puste). W przypadku ustawienia wartości false wartości null są zwykle zwracane jako "(null)".

Alternatywna nazwa wiersza nagłówka
AlternativeHeaderRowName string

Domyślnie wiersz nagłówka w usłudze DataGrid ma nazwę elementu UIA "Górny wiersz". Jeśli wiersz nagłówka ma inną nazwę, określ tę nazwę tutaj.

Zwracanie nazwy interfejsu użytkownika wiersza
ReturnRowUIAName boolean

Jeśli te dane wejściowe zostaną ustawione na wartość , nazwa interfejsu użytkownika wiersza będzie przechowywana w kolumnie w kolekcji danych wyjściowych. Nazwa kolumny jest definiowana przez dane wejściowe "Nazwa kolumny do przechowywania nazwy UIA wiersza".

Nazwa kolumny do przechowywania nazwy interfejsu użytkownika wiersza
NameOfColumnToStoreRowUIAName string

Jeśli dla danych wejściowych "Return row UIA name" jest ustawiona wartość true, dane wejściowe określają nazwę kolumny w kolekcji danych wyjściowych do przechowywania nazwy UIA wiersza.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Pierwszy element do zwrócenia
FirstItemToReturn integer

Indeks elementu pierwszego elementu (wiersz), który ma być zwracany, począwszy od 1.

Maksymalna liczba elementów do zwrócenia
MaxItemsToReturn integer

Maksymalna liczba elementów (wierszy) do zwrócenia lub 0 w celu zwrócenia wszystkich elementów (wierszy).

Skanuj pierwsze N wierszy pod kątem pustych wierszy
ScanFirstNRowsForEmptyRows integer

Niektóre elementy datagrids mają kilka pustych/null elementów wiersza w drzewie UIA (zwykle u góry), a IA-Connect automatycznie pomija te elementy wiersza, ponieważ nie reprezentują niczego w tabeli, która jest widoczna w interfejsie użytkownika. Jeśli te dane wejściowe są ustawione na 0 (wartość domyślna), agent IA-Connect zawsze skanuje elementy wierszy z pierwszego wiersza do wewnątrz, nawet jeśli opcja "Pierwszy element do zwrócenia" jest ustawiona w celu pobrania wierszy głębiej w tabeli. Zapewnia to spójność z liczbami indeksów wierszy, ale ma wpływ na wydajność, ponieważ wszystkie wiersze z pierwszego wiersza do żądanych wierszy muszą być skanowane. Jeśli masz pewność, że jedynymi pustymi/ null elementami wiersza w tabeli znajdują się pierwsze N (np. 10) wierszy, możesz ustawić tę wartość na N (np. 10), aby potencjalnie zwiększyć wydajność. Nie ustawiaj wartości innej niż 0, chyba że wiesz, co robisz.

Odczytywanie tabeli jako wątku
ReadTableAsThread boolean

Jeśli zostanie ustawiona wartość false (wartość domyślna), agent IA-Connect odczytuje tabelę natychmiast i zwróci zawartość do dyrektora. W przypadku odczytywania dużych tabel ta akcja może upłynął limit czasu. Jeśli ustawiono wartość true, agent IA-Connect odczytuje tabelę jako wątek agenta i dyrektor IA-Connect (lub orchestrator, moduł Programu PowerShell, niebieski prism) może monitorować stan tego wątku agenta, czekając na jego ukończenie. Dzięki temu duże tabele mogą być odczytywane bez limitów czasu. IA-Connect Agenci w wersji 9.3 i starszych mogą od razu odczytywać tylko tabele, a nie jako wątek agenta.

Pobieranie danych wyjściowych dla identyfikatora wątku
RetrieveOutputDataFromThreadId integer

Jeśli wcześniej uruchomiono tę akcję jako wątek agenta i ustaw wartość "Sekundy oczekiwania na wątek" na 0, podaj identyfikator wątku agenta, aby pobrać wyniki. Ten identyfikator wątku agenta zostanie dostarczony przez wcześniejsze wywołanie tej akcji. Ustaw wartość 0 (wartość domyślna), jeśli odczytujesz element datagrid (i dlatego nie pobierasz wyników poprzedniego uruchomienia zapytania jako wątek agenta).

Sekundy oczekiwania na wątek
SecondsToWaitForThread integer

Jeśli wartość "Odczytaj tabelę jako wątek" ma wartość true, ile sekund czeka na zakończenie wątku agenta. Jeśli w tym czasie wątek agenta odczytu tabeli nie został ukończony, zostanie zgłoszony wyjątek. Ustaw wartość 0, aby pominąć oczekiwanie: Agent będzie nadal odczytywał usługę datagrid, ale także będzie dostępny dla następnej akcji. Następnie możesz pobrać wyniki (zawartość elementu datagrid) później, używając akcji "Zaczekaj na pomyślne zakończenie wątku agenta", aby poczekać na zakończenie wątku agenta, a następnie ponownie uruchomić tę akcję "Pobierz zawartość elementu datagrid UIA" z danymi wejściowymi "Pobierz dane wyjściowe dla identyfikatora wątku" ustawioną na identyfikator wątku agenta.

Przewijaj dane w pionie co N procent
ScrollDataGridVerticallyEveryNPercent integer

Wydajność odczytywania niektórych dużych zestawów danych (na przykład: z tysiącami wierszy) została zaobserwowana, aby poprawić, jeśli okresowo przewijasz dane do (lub w pobliżu) przewijanej lokalizacji. Jeśli ustawiono wartość 0 (wartość domyślna), usługa Datagrid nie będzie przewijana podczas odczytywania zawartości. Jeśli ustawiono wartość z zakresu od 1 do 100, usługa Datagrid będzie okresowo przewijana (co N procent całkowitej liczby wierszy) podczas odczytywania zawartości. Na przykład: Jeśli ustawiono wartość 20, datagrid będzie przewijana z wartością 0, 20, 40, 60, 80 procent. Alternatywnie użyj polecenia "Przewiń datagrid w pionie co N wierszy", aby przewijać każdy N wierszy zamiast co N procent.

Przewijanie wartości datagrid w pionie co N wierszy
ScrollDataGridVerticallyEveryNRows integer

Wydajność odczytywania niektórych dużych zestawów danych (na przykład: z tysiącami wierszy) została zaobserwowana, aby poprawić, jeśli okresowo przewijasz dane do (lub w pobliżu) przewijanej lokalizacji. Jeśli ustawiono wartość 0 (wartość domyślna), usługa Datagrid nie będzie przewijana podczas odczytywania zawartości. Jeśli zostanie ustawiona wartość 1 lub wyższa, usługa Datagrid będzie przewijana co N wierszy podczas odczytywania zawartości. Na przykład: jeśli ustawiono wartość 5, datagrid będzie przewijana co 5 wierszy. Alternatywnie użyj opcji "Przewiń datagrid w pionie co N procent", aby przewijać każdy N procent wierszy zamiast każdego N wierszy.

Przewijanie uchwytu elementu datagrid w pionie
ScrollDataGridVerticallyElementHandle integer

Jeśli przewijanie elementu datagrid w pionie podczas odczytywania zawartości powoduje zdefiniowanie sposobu, w jaki IA-Connect zlokalizować pionowy pasek przewijania. Jeśli ustawiono wartość 0, IA-Connect spróbuje przewinąć bezpośrednio usługę datagrid, używając wzorca "scroll" (jeśli usługa datagrid obsługuje) lub wyszukując pionowy pasek przewijania zawarty w usłudze datagrid. Alternatywnie można określić uchwyt IA-Connect UIA elementu pionowego paska przewijania (sam element paska przewijania, a nie przyciski wewnątrz), który jest wartością 1 lub wyższą.

Minimalna liczba wierszy usługi Datagrid do przewijania
MinimumDataGridRowsForScrolling integer

Jeśli przewijanie elementu datagrid w pionie podczas odczytywania zawartości, dane wejściowe określają minimalną liczbę wierszy wymaganych w tabeli przed IA-Connect wykona przewijanie. Jeśli ustawiono wartość 0, IA-Connect będzie przewijać niezależnie od liczby wierszy. Jeśli zostanie ustawiona liczba dodatnia, IA-Connect będzie wykonywać przewijanie tylko wtedy, gdy datagrid ma tę liczbę wierszy lub więcej.

Zgłoś wyjątek, jeśli nie można przewinąć
RaiseExceptionIfCannotScroll boolean

Jeśli przewijanie elementu datagrid w pionie podczas odczytywania zawartości: ustaw tę wartość danych wejściowych na wartość true, jeśli nie można przewijać, należy uznać za wyjątek lub ustawić wartość false (wartość domyślna), jeśli nie ma potrzeby przewijania. Typowe błędy przewijania obejmują niepowodzenie lokalizowania pasków przewijania lub paski przewijania nie mają wzorca UIA odpowiedniego do przewijania ("scroll", "rangevalue" lub "value").

Alternatywna nazwa pionowego paska przewijania
AlternativeVerticalScrollbarName string

Domyślnie pionowy pasek przewijania "wiersz" w usłudze datagrid ma nazwę elementu UIA "Pionowy pasek przewijania". Jeśli pionowy pasek przewijania ma inną nazwę, określ tę nazwę tutaj. Będzie to używane, jeśli chcesz, aby IA-Connect okresowo przewijać wartość datagrid podczas odczytywania zawartości, pole "Przewiń dojście elementu w pionie" jest ustawione na 0 (określając, że IA-Connect powinien przewijać bezpośrednio datagrid), ale usługa datagrid nie implementuje wzorca "przewiń".

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Dane JSON zawartości usługi Datagrid
DataGridContentsJSON string

Zawartość elementu datagrid w formacie JSON.

Liczba wierszy w tabeli
NumberOfRowsInTable integer

Liczba wierszy w tabeli wyjściowej, jeśli tabela została odczytany natychmiast.

Liczba kolumn w tabeli
NumberOfColumnsInTable integer

Liczba kolumn w tabeli wyjściowej, jeśli tabela została odczytany natychmiast.

Identyfikator wątku
ThreadId integer

Jeśli ta akcja jest uruchamiana jako wątek agenta, dane wyjściowe będą zawierać identyfikator wątku agenta, który może służyć do monitorowania procesu akcji i pobierania zawartości datagrid po zakończeniu wątku.

Poczekaj, aż element pulpitu UIA nie istnieje

Czeka na element pulpitu (zazwyczaj okno) nie istnieje.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Jeśli zostanie określona (wartość 1 lub wyższa), wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste (lub 0).

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na brak istnienia elementu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, zostanie zwrócony tylko proces pasujący do dokładnego identyfikatora procesu wyszukiwania.

Zgłoś wyjątek, jeśli element nadal istnieje
RaiseExceptionIfElementStillExists boolean

Czy IA-Connect zgłosić wyjątek, jeśli element UIA nadal istnieje po okresie oczekiwania?

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje przed oczekiwaniem
ElementExistsBeforeWait boolean

Zwraca wartość true, jeśli element istniał przed oczekiwaniem lub fałszem, jeśli nie.

Element istnieje po oczekiwaniu
ElementExistsAfterWait boolean

Zwraca wartość true, jeśli element istniał po oczekiwaniu lub fałsz, jeśli nie.

Poczekaj, aż element UIA nie istnieje

Czeka na element (zazwyczaj pojedynczy element w oknie, taki jak przycisk lub obszar wprowadzania tekstu), aby już nie istniał.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator procesu wyszukiwania
SearchProcessId integer

Jeśli zostanie określona (wartość 1 lub wyższa), wyszukiwanie będzie uwzględniać tylko elementy należące do procesu z tym identyfikatorem procesu (PID). Jeśli IA-Connect uruchomiony proces, identyfikator PID jest dostarczany przez akcję "Uruchom proces" w akcjach środowiska/sesji IA-Connect. Jeśli nie znasz identyfikatora PID, pozostaw to pole puste (lub 0).

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Czas oczekiwania w sekundach
SecondsToWait True integer

Maksymalna liczba sekund oczekiwania na brak istnienia elementu.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Uwzględnij procesy podrzędne
IncludeChildProcesses boolean

Jeśli ustawiono wartość true i określono wartość "Identyfikator procesu wyszukiwania", procesy podrzędne tego identyfikatora procesu są również uwzględniane w wyszukiwaniu. Jeśli ustawiono wartość false, zostanie zwrócony tylko proces pasujący do dokładnego identyfikatora procesu wyszukiwania.

Zgłoś wyjątek, jeśli element nadal istnieje
RaiseExceptionIfElementStillExists boolean

Czy IA-Connect zgłosić wyjątek, jeśli element UIA nadal istnieje po okresie oczekiwania?

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Element istnieje przed oczekiwaniem
ElementExistsBeforeWait boolean

Zwraca wartość true, jeśli element istniał przed oczekiwaniem lub fałszem, jeśli nie.

Element istnieje po oczekiwaniu
ElementExistsAfterWait boolean

Zwraca wartość true, jeśli element istniał po oczekiwaniu lub fałsz, jeśli nie.

Poczekaj, aż widoczny obraz wyszukiwania nie istnieje w elemecie UIA

Czeka, aż obraz wyszukiwania, podany jako dane wejściowe tej akcji, nie może być widoczny (lub nigdy nie znajduje się) w elemecie UIA na ekranie lub określony czas minął, a obraz jest nadal obecny. Element powinien zostać przeniesiony na pierwszy front, ponieważ agent wykonuje zrzut ekranu na współrzędnych elementu i wyszukuje podany obraz wyszukiwania na zrzucie ekranu. Element UIA musi istnieć od początku. Akcja jest wykonywana natychmiast po tym, jak obraz nie jest już obecny.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Typ obrazu wyszukiwania
SearchImageType string

Określa, jakie dane wejściowe "Wyszukaj obraz" reprezentuje. Jeśli ustawiono wartość "Plik obrazu reżysera", obraz wyszukiwania jest ścieżką do pliku dostępnego dla katalogu. Jeśli ustawiono wartość "Plik obrazu agenta", obraz wyszukiwania jest ścieżką do pliku dostępnego dla agenta. W przypadku ustawienia wartości "Base64" obraz wyszukiwania jest reprezentacją obrazu base64.

Wyszukaj obraz
SearchImage string

Obraz wyszukiwania do zlokalizowania w określonym elemecie UIA. W zależności od określonego typu "Wyszukaj typ obrazu" może on przechowywać ścieżkę do pliku obrazu (na końcu dyrektora lub agenta) lub zawierać base64 (reprezentację tekstową) obrazu do wyszukania.

Alternatywny typ obrazu wyszukiwania
AltSearchImageType string

Definiuje dane wejściowe "Alternatywny obraz wyszukiwania". Jeśli jest ustawiona wartość "Brak" lub pusta, nie ma alternatywnego obrazu wyszukiwania. Jeśli ustawiono wartość "Plik obrazu reżysera", obraz wyszukiwania jest ścieżką do pliku dostępnego dla katalogu. Jeśli ustawiono wartość "Plik obrazu agenta", obraz wyszukiwania jest ścieżką do pliku dostępnego dla agenta. W przypadku ustawienia wartości "Base64" obraz wyszukiwania jest reprezentacją obrazu base64.

Alternatywny obraz wyszukiwania
AltSearchImage string

Opcjonalny alternatywny obraz wyszukiwania do zlokalizowania w ramach określonego elementu UIA. W zależności od określonego "Alternatywnego typu obrazu wyszukiwania" może to zawierać ścieżkę do pliku obrazu (na końcu dyrektora lub agenta) lub zawierać base64 (reprezentację tekstową) obrazu do wyszukania. Jeśli określisz alternatywny obraz wyszukiwania, agent wyszuka wyszukiwany lub alternatywny obraz wyszukiwania i raport, który się znajdował.

Maksymalne odchylenie koloru
MaxColourDeviation integer

Maksymalna liczba kolorów pikseli elementu może odbiegać od kolorów pikseli obrazu wyszukiwania, zanim nie zostanie uznana za dopasowanie. 0 bez odchylenia. Odchylenie jest mierzone w wartościach RGB. Na przykład: #FF0000 różni się od #FE0102 4. Pozwala to na ignorowanie drobnych różnic kolorowych.

Maksymalna różnica pikseli
MaxPixelDifferences integer

Maksymalna liczba pikseli, które mogą się różnić (powyżej maksymalnego odchylenia koloru) w całym obrazie wyszukiwania, zanim obraz zostanie uznany za niezgodny. Pozwala to na ignorowanie drobnych różnic między obrazami, ale wyższe wartości mogą zwiększyć czas wymagany do zlokalizowania obrazu. Zaleca się ustawienie wartości 0 i zwiększenie o niewielkie kwoty w razie potrzeby. W przypadku ustawienia wartości powyżej 0 należy również ustawić wartość "Maksymalna liczba kolejnych różnic pikseli".

Maksymalna liczba kolejnych różnic pikseli
MaxConsecutivePixelDifferences integer

Maksymalna liczba pikseli, które mogą się różnić (powyżej maksymalnego odchylenia koloru), w każdym wierszu, zanim obraz zostanie uznany za niezgodny. Pozwala to na ignorowanie drobnych różnic między obrazami, ale wyższe wartości mogą zwiększyć czas wymagany do zlokalizowania obrazu. Zaleca się ustawienie wartości 0 i zwiększenie o niewielkie kwoty w razie potrzeby. W przypadku ustawienia wartości powyżej 0 należy również ustawić wartość "Maksymalna różnica pikseli".

Przesunięcie lewego piksela X
LeftPixelXOffset integer

Opcjonalne przesunięcie X lewej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie X w prawym pikselu
RightPixelXOffset integer

Opcjonalne przesunięcie X dla prawej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Przesunięcie górnego piksela Y
TopPixelYOffset integer

Opcjonalne przesunięcie Y dla górnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami ujemnymi) lub zmniejszyć (z wartościami dodatnimi) w obszarze wyszukiwania.

Przesunięcie Y dolnego piksela
BottomPixelYOffset integer

Opcjonalne przesunięcie Y dla dolnej krawędzi obszaru wyszukiwania. Pozwala to zwiększyć (z wartościami dodatnimi) lub zmniejszyć (z wartościami ujemnymi) obszaru wyszukiwania.

Jednostka przesunięcia Pixel X
PixelXOffsetsUnit string

Ustaw wartość "Pixel" (wartość domyślna), jeśli przesunięcia lewego i prawego piksela X są mierzone w pikselach. Ustaw wartość "Percent", jeśli przesunięcia lewego i prawego piksela X są mierzone jako procent szerokości elementu.

Jednostka przesunięcia pikseli Y
PixelYOffsetsUnit string

Ustaw wartość "Pixel" (wartość domyślna), jeśli przesunięcia górnego i dolnego piksela Y są mierzone w pikselach. Ustaw wartość "Percent", jeśli przesunięcia górnego i dolnego piksela Y są mierzone jako procent wysokości elementu.

Indeks obrazu wyszukiwania
SearchImageIndex integer

Ustaw wartość 1, aby zlokalizować pierwsze wystąpienie obrazu wyszukiwania (w kierunku wyszukiwania) w elemecie UIA. Dla drugiego wystąpienia ustaw wartość 2, .... , N dla wystąpienia N. Jeśli szukasz również alternatywnego obrazu, element UIA jest skanowany najpierw pod kątem obrazu wyszukiwania, a po drugie dla alternatywnego obrazu, wyszukując żądane wystąpienie tego konkretnego obrazu (tj. agent oczekuje jednego lub drugiego, a nie kombinacji obu obrazów).

Kierunek wyszukiwania obrazów
ImageSearchDirection string

Kierunek wyszukiwania. Wyszukiwanie "Od góry" według wiersza od góry, skanowanie od lewej do prawej w każdym wierszu. Wyszukiwanie "Od dołu" według wiersza od dołu, skanowanie od lewej do prawej w każdym wierszu. Wyszukiwanie "Od lewej" według kolumny po lewej stronie, skanowanie od góry do dołu w każdej kolumnie. Wyszukiwanie "Od prawej" według kolumny z prawej strony, skanowanie od góry do dołu w każdej kolumnie. Może to być używane w połączeniu z indeksem obrazów wyszukiwania w celu zlokalizowania Nth obrazu z górnej, dolnej, lewej lub prawej. Aby poprawić wydajność, wybierz kierunek wyszukiwania, który twoim zdaniem pozwoli szybciej zlokalizować obraz.

Ukryj agenta
HideAgent boolean

Ustaw wartość true, aby automatycznie ukryć agenta (jeśli jest widoczny), aby upewnić się, że nie ukrywa analizowanego elementu.

Pokaż prostokąt wyróżnienia
ShowHighlightRectangle boolean

W przypadku ustawienia wartości true agent IA-Connect wyróżni znajdujący się na ekranie obraz. Może to być przydatne podczas opracowywania, aby ułatwić wizualizację wykrytego poprawnego obrazu.

Sekundy oczekiwania na brak obrazu wyszukiwania
SecondsToWait integer

Liczba sekund oczekiwania na niewidoczne zlokalizowanie obrazu wyszukiwania w elemecie UIA. Jeśli obraz jest nadal obecny po tym czasie, zostanie zgłoszony wyjątek, jeśli wartość "Zgłoś wyjątek, jeśli obraz jest nadal obecny", w przeciwnym razie akcja zgłosi, że obraz jest nadal obecny.

Liczba milisekund między wyszukiwaniami
MillisecondsBetweenSearches integer

Liczba milisekund oczekiwania między poszczególnymi elementami UIA na ekranie. Ponieważ rozpoznawanie obrazów może być kosztowne, opóźnienie może pomóc zarówno obniżyć, jak i rozłożyć wykorzystanie procesora CPU. Na przykład: Jeśli spodziewasz się, że obraz może potrwać do 1 minuty, dodanie 5000 milisekund (5 sekund) wstrzymania między skanowaniami znacznie obniży wykorzystanie procesora CPU (przez znaczne zmniejszenie liczby skanowań), ale będzie miało niewielki wpływ na czas odpowiedzi. Minimalna dozwolona wartość to 100 milisekund (1/10 sekund).

Zgłoś wyjątek, jeśli obraz jest nadal obecny
RaiseExceptionIfImageStillPresent boolean

Ustaw wartość true, jeśli IA-Connect powinna zgłosić wyjątek, jeśli obraz jest nadal obecny po okresie oczekiwania.

Pobieranie danych wyjściowych dla identyfikatora wątku
RetrieveOutputDataFromThreadId integer

Jeśli wcześniej ustawiono wartość false "Czekaj na wątek" (co powoduje, że agent wykonuje oczekiwanie w wątku w tle), podaj identyfikator wątku agenta, aby pobrać wyniki. Ten identyfikator wątku agenta zostanie dostarczony przez wcześniejsze wywołanie tej akcji. W przeciwnym razie ustaw wartość 0 (wartość domyślna).

Czekaj na wątek
WaitForThread boolean

Ustaw wartość true, aby poczekać na zakończenie wątku agenta; Agent będzie czekać tak długo, jak określono w ciągu "Sekundy, aby poczekać, aż obraz wyszukiwania nie istnieje". Ustaw wartość false, aby pominąć oczekiwanie; Agent będzie nadal wykonywać oczekiwanie w wątku w tle, ale także będzie dostępny dla następnej akcji. Następnie możesz pobrać wyniki w późniejszym czasie, używając akcji "Zaczekaj, aż wątek agenta zakończy się pomyślnie", aby poczekać na ukończenie wątku agenta, a następnie ponownie uruchomić tę akcję "Zaczekaj, aby widoczny obraz wyszukiwania nie istniał w elemecie UIA" z danymi wejściowymi "Pobierz dane wyjściowe dla identyfikatora wątku" ustawionym na identyfikator wątku agenta.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Obraz wyszukiwania przed oczekiwaniem
SearchImagePresentBeforeWait boolean

Te dane wyjściowe zostaną ustawione na wartość true, jeśli obraz wyszukiwania był obecny na początku okresu oczekiwania. Te dane wyjściowe zostaną ustawione na wartość false, jeśli obraz wyszukiwania nie był obecny od początku.

Obraz wyszukiwania jest nadal obecny po oczekiwaniu
SearchImageStillPresentAfterWait boolean

Te dane wyjściowe zostaną ustawione na wartość true, jeśli obraz wyszukiwania jest nadal obecny, po upływie okresu oczekiwania. Te dane wyjściowe zostaną ustawione na wartość false, jeśli obraz wyszukiwania nie jest już obecny, w okresie oczekiwania (akcja zostanie ukończona natychmiast po tym, jak obraz nie jest już obecny).

Który obraz wyszukiwania jest nadal obecny
WhichSearchImageStillPresent integer

Te dane wyjściowe zostaną ustawione na 0, jeśli żadne obrazy wyszukiwania nie były jeszcze obecne, po okresie oczekiwania. Ustaw wartość 1, jeśli obraz wyszukiwania był nadal obecny, po okresie oczekiwania. Ustaw wartość 2, jeśli alternatywny obraz wyszukiwania był nadal obecny, po okresie oczekiwania.

Identyfikator wątku
ThreadId integer

Jeśli ustawiono wartość false "Czekaj na wątek" (co powoduje, że agent wykonuje oczekiwanie w wątku w tle), te dane wyjściowe będą zawierać identyfikator wątku agenta, który może służyć do monitorowania procesu akcji i pobierania wyników później, po zakończeniu wątku.

Powrót danych wejściowych do elementu UIA

Wprowadza zwracany/nowy wiersz systemu Windows do elementu (zazwyczaj pole wprowadzania tekstu), zastępując istniejący tekst lub wstawiając zwracany w określonej pozycji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Zamień istniejącą wartość
ReplaceExistingValue boolean

Jeśli w elemecie znajduje się istniejący tekst, należy go zamienić?

Wstaw położenie
InsertPosition integer

Pozycja (indeks), aby rozpocząć wstawianie tekstu. Jeśli istnieje tekst, pozycja wstawiania może służyć do wstawiania w określonej pozycji w istniejącym tekście.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zgłaszanie wyjątku w przypadku niepowodzenia walidacji danych wejściowych
RaiseExceptionIfInputValidationFails boolean

Jeśli to ustawienie jest włączone, agent IA-Connect sprawdzi nową wartość elementu po wprowadzeniu żądanego tekstu. Jeśli nowa wartość nie jest zgodna z oczekiwaną wartością, zostanie zgłoszony wyjątek. Jeśli te dane wejściowe są fałszywe (wartość domyślna), zostanie wprowadzone ostrzeżenie w dzienniku, ale nie zostanie zgłoszony żaden wyjątek.

Wzorzec try value
TryValuePattern boolean

Jeśli ustawiono wartość true (wartość domyślna), agent IA-Connect podejmie próbę użycia wzorca wartości UIA w celu wykonania akcji wprowadzania tekstu. Jeśli wzorzec wartości interfejsu użytkownika jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wartości i natychmiast powróci do innych wybranych wzorców.

Wypróbuj starszy wzorzec
TryLegacyPattern boolean

Jeśli ustawiono wartość true, agent IA-Connect podejmie próbę użycia starszego wzorca interfejsu użytkownika w celu wykonania akcji wprowadzania tekstu, jeśli wzorzec wartości jest niedostępny (ponieważ nie jest obecny w elemecie lub jego użycie zostało wyłączone).

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Przenieś element UIA

Przenosi element UIA do określonej pozycji na ekranie. Ta akcja będzie zwykle działać tylko z elementami okna (które mają wzorzec przekształcania).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Typ ruchu poziomego
HorizontalMovementType string

Typ ruchu: bezwzględny lub względny.

Położenie w poziomie
HorizontalPosition True integer

Nowa pozycja pozioma elementu. Typ ruchu (na przykład bezwzględny lub względny) jest definiowany przez dane wejściowe "Typ ruchu poziomego". Aby pozostawić położenie poziome bez zmian, wybierz wartość 0 i ustaw wartość "Typ ruchu poziomego" na wartość "Względna".

Typ ruchu w pionie
VerticalMovementType string

Typ ruchu: bezwzględny lub względny.

Położenie w pionie
VerticalPosition True integer

Nowe położenie w pionie elementu. Typ ruchu (na przykład bezwzględny lub względny) jest definiowany przez wejście "Typ ruchu pionowego". Aby pozostawić pozycję pionową bez zmian, wybierz wartość 0 i ustaw wartość "Typ ruchu pionowego" na wartość "Względna".

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wynik polecenia
UIAMoveElementResult boolean

Wynik polecenia (powodzenie lub niepowodzenie).

Komunikat o błędzie
ErrorMessage string

Jeśli polecenie nie powiodło się, będzie zawierać zwrócony komunikat o błędzie.

Przełącz element UIA

Przełącza element (zazwyczaj pole wyboru lub pole radiowe). Daje to elementowi przeciwny stan bieżącego (np. zaznaczone staje się niezaznaczone i odwrotnie). Jeśli chcesz ustawić określony stan, zamiast tego użyj akcji "Sprawdź element".

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Resetuj wszystkie uchwyty elementów UIA

Resetuje wszystkie uchwyty elementów UIA przechowywane obecnie przez IA-Connect, co może być przydatne, jeśli zidentyfikowano wiele elementów i ma dużą liczbę uchwytów elementów przechowywanych. W scenariuszach z bardzo dużą liczbą uchwytów elementów (100 000+) można również użyć tej akcji do zwolnienia użycia pamięci RAM.

Parametry

Nazwa Klucz Wymagane Typ Opis
Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Rozwiń element UIA

Rozwija element (zazwyczaj element menu/menu rozwijanego). Jeśli element został już rozszerzony, nic się nie stanie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Rysuj prostokąt wokół elementu UIA

Rysuje prostokąt wokół obwodu elementu, aby pomóc w zidentyfikowaniu, że znaleziony element jest wymagany. Prostokąt jest automatycznie usuwany po 5 sekundach.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Kolor pióra
PenColour string

Kolor prostokąta do narysowania (np. czerwony, zielony, niebieski, żółty, fioletowy lub pomarańczowy) lub kod szesnastkowy ciągu, np. #FF0000.

Piksele grubości pióra
PenThicknessPixels integer

Grubość (w pikselach) obramowania prostokąta wyróżnienia.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Sprawdzanie elementu UIA

Ustawia stan elementu (zazwyczaj pole wyboru lub pole radiowe) na zaznaczone lub niezaznaczone.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Check, element
CheckElement boolean

Czy element powinien być sprawdzany (prawda) lub niezaznaczone (fałsz)?

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Sprawdzanie wielu elementów interfejsu użytkownika

Ustawia stan wielu elementów (zazwyczaj pole wyboru lub pole radiowe) na zaznaczone lub niezaznaczone.

Parametry

Nazwa Klucz Wymagane Typ Opis
Elementy wejściowe
InputElementsJSON True string

Tablica elementów UIA do sprawdzenia w formacie JSON.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Ustaw element UIA na wartość liczbową

Ustawia wartość elementu, który ma dane wejściowe liczbowe, na przykład pole tekstowe lub pasek przewijania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Nowa wartość
NewValue True integer

Wartość liczbowa do ustawienia elementu na .

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zgłaszanie wyjątku w przypadku niepowodzenia walidacji danych wejściowych
RaiseExceptionIfInputValidationFails boolean

Jeśli to ustawienie jest włączone, agent IA-Connect sprawdzi nową wartość elementu po wprowadzeniu żądanego tekstu. Jeśli nowa wartość nie jest zgodna z oczekiwaną wartością, zostanie zgłoszony wyjątek. Jeśli te dane wejściowe są fałszywe (wartość domyślna), zostanie wprowadzone ostrzeżenie w dzienniku, ale nie zostanie zgłoszony żaden wyjątek.

Wzorzec try value
TryValuePattern boolean

Jeśli ustawiono wartość true (wartość domyślna), agent IA-Connect podejmie próbę użycia wzorca wartości UIA w celu wykonania akcji wprowadzania tekstu. Jeśli wzorzec wartości interfejsu użytkownika jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wartości i natychmiast powróci do innych wybranych wzorców.

Wypróbuj starszy wzorzec
TryLegacyPattern boolean

Jeśli ustawiono wartość true, agent IA-Connect podejmie próbę użycia starszego wzorca interfejsu użytkownika w celu wykonania akcji wprowadzania tekstu, jeśli wzorzec wartości jest niedostępny (ponieważ nie jest obecny w elemecie lub jego użycie zostało wyłączone).

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Ustaw element UIA na wartość zakresu liczbowego

Ustawia wartość elementu, który ma zakres liczbowy, na przykład pasek przewijania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Nowa wartość
NewValue True double

Wartość zakresu liczbowego, aby ustawić element na .

Nowa wartość to wartość procentowa
NewValueIsPercentage boolean

Czy nowa wartość jest wartością procentową?

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Ustawianie limitu czasu transakcji UIA

Określa, jak długo interfejs API UIA będzie czekać na zwrócenie przez aplikację informacji na temat elementu. Ten limit czasu transakcji zazwyczaj jest osiągany tylko wtedy, gdy aplikacja nie odpowiada.

Parametry

Nazwa Klucz Wymagane Typ Opis
Czas zakończenia w sekundach
TimeoutInSeconds True double

Maksymalny czas oczekiwania na zwrócenie przez aplikację informacji na temat elementu przez interfejs API UIA.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Ustawianie okna interfejsu użytkownika na wartość normalną

Normalizuje okno z określonym uchwytem UIA (tj. ustawia go na normalne okno, a nie zminimalizowane lub zmaksymalizowane).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna
WindowHandle True integer

Uchwyt UIA okna do normalizacji.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Ustawianie okna pierwszego planu UIA

Przenosi okno na pierwszy plan.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna
WindowHandle True integer

Uchwyt interfejsu użytkownika okna, który powinien być ustawiony jako okno pierwszego planu.

Przełącz okno
ToggleWindow boolean

Czy okno powinno zostać przełączone, próbując skupić się lub kliknąć go? Pomaga to zapewnić niezawodne przywiezienie okna na pierwszym planie.

Przełącznik używa agenta globalnego kliknięcia lewym przyciskiem myszy
ToggleUsesGlobalLeftMouseClickAgent boolean

Jeśli zdecydujesz się przełączyć okno, określa, czy użyj globalnych kliknięć myszy, aby najpierw skoncentrować IA-Connect agenta.

Przełącz opóźnienie w sekundach
ToggleDelay double

Jeśli zdecydujesz się przełączyć okno, określa to wstrzymanie po przełączeniu.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Ustawianie procentu przewijania elementu UIA

Ustaw wartość procentową przewijania w poziomie i /lub w pionie określonego elementu, jeśli przewijanie jest obsługiwane przez ten element. Jeśli element obsługuje wzorzec przewijania, możesz zastosować tę akcję bezpośrednio do elementu i określić poziomą lub pionową ilość przewijania (lub oba). Jeśli element nie obsługuje wzorca przewijania, ta akcja powróci do wzorców "wartość zakresu" lub "wartość", ale musisz zastosować je bezpośrednio do kontrolek paska przewijania, a nie samego elementu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Procent przewijania poziomego
HorizontalScrollPercentage double

Pozycja do przewijania w poziomie elementu (od 0 do 100 włącznie, obsługiwana liczba dziesiętna) lub -1, aby pozostawić położenie przewijania poziomego bez zmian.

Procent przewijania w pionie
VerticalScrollPercentage double

Położenie w pionie przewiń element (od 0 do 100 włącznie, obsługiwane liczby dziesiętne) lub -1, aby pozostawić pionową pozycję przewijania bez zmian.

Wypróbuj wzorzec przewijania
TryScrollPattern boolean

W przypadku ustawienia wartości true agent IA-Connect podejmie próbę użycia wzorca przewijania interfejsu użytkownika w celu wykonania akcji przewijania. Jeśli wzorzec przewijania interfejsu użytkownika jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wybranych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca przewijania i natychmiast powróci do innych wybranych wzorców. Kolejność prób wzorców (jeśli jest włączona za pośrednictwem danych wejściowych do tej akcji) to przewijanie, wartość zakresu i wartość.

Wzorzec wartości zakresu try
TryRangeValuePattern boolean

Jeśli ustawiono wartość true, agent IA-Connect spróbuje użyć wzorca wartości zakresu UIA do wykonania akcji przewijania. Jeśli wzorzec wartości zakresu UIA jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wybranych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wartości zakresu i natychmiast powróci do innych wybranych wzorców. Kolejność prób wzorców (jeśli jest włączona za pośrednictwem danych wejściowych do tej akcji) to przewijanie, wartość zakresu i wartość.

Wzorzec try value
TryValuePattern boolean

Jeśli ustawiono wartość true, agent IA-Connect podejmie próbę użycia wzorca wartości UIA w celu wykonania akcji przewijania. Jeśli wzorzec wartości UIA jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wybranych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wartości i natychmiast powróci do innych wybranych wzorców. Kolejność prób wzorców (jeśli jest włączona za pośrednictwem danych wejściowych do tej akcji) to przewijanie, wartość zakresu i wartość. Ostrzeżenie: Użycie wzorca wartości w elemedycie edycji spowoduje po prostu wprowadzenie wartości do elementu edit.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wynik polecenia
UIASetElementScrollPercentageResult boolean

Wynik polecenia (powodzenie lub niepowodzenie).

Komunikat o błędzie
ErrorMessage string

Jeśli polecenie nie powiodło się, będzie zawierać zwrócony komunikat o błędzie.

Ustawianie trybu wyszukiwania elementów UIA

Wybierz tryb wyszukiwania elementów UIA, który ma być używany przez agenta IA-Connect podczas wykonywania akcji UIA. Zazwyczaj ta akcja będzie używana tylko wtedy, gdy masz problem z trybem domyślnym (Znajdź wszystko).

Parametry

Nazwa Klucz Wymagane Typ Opis
Tryb wyszukiwania elementów UIA
UIAElementSearchMode True string

Tryb wyszukiwania elementu UIA do użycia.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wynik polecenia
SetUIAElementSearchModeResult boolean

Wynik polecenia (powodzenie lub niepowodzenie).

Komunikat o błędzie
ErrorMessage string

Jeśli polecenie nie powiodło się, będzie zawierać zwrócony komunikat o błędzie.

Uzyskiwanie dojścia interfejsu użytkownika dla głównego okna elementu fokusu

Zwraca uchwyt dla głównego okna aktualnie ukierunkowanego elementu UIA. Okno "Main" jest zazwyczaj głównym oknem aplikacji: okno logowania lub okno podrzędne nie jest zazwyczaj oknem głównym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu okna.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu okna.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu okna.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu okna.

Uzyskiwanie dojścia interfejsu użytkownika dla komputerów stacjonarnych

Zwraca uchwyt dla pulpitu. Jest to przestarzała akcja, ponieważ uchwyt "-2" może służyć do odwoływania się do elementu pulpitu, ale także dlatego, że istnieje wiele akcji, które mogą wyszukiwać względem pulpitu (np. "czekaj na element pulpitu").

Parametry

Nazwa Klucz Wymagane Typ Opis
Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla pulpitu. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa interfejsu użytkownika elementu pulpitu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu pulpitu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu pulpitu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu pulpitu.

Uzyskiwanie dojścia UIA dla elementu fokusu

Zwraca uchwyt dla aktualnie ukierunkowanego elementu UIA.

Parametry

Nazwa Klucz Wymagane Typ Opis
Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Uchwyt okna
WindowHandle integer

Uchwyt interfejsu użytkownika dla okna. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika w tym oknie.

Nazwa elementu
ElementName string

Nazwa UIA elementu.

Nazwa klasy elementu
ElementClassName string

Nazwa klasy UIA elementu.

Identyfikator automatyzacji elementów
ElementAutomationId string

Identyfikator automatyzacji interfejsu użytkownika elementu.

Zlokalizowany typ kontrolki elementu
ElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu.

Uzyskiwanie trybu wyszukiwania elementów UIA

Pobiera tryb wyszukiwania elementów UIA używany przez IA-Connect Agent dla akcji UIA.

Parametry

Nazwa Klucz Wymagane Typ Opis
Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Tryb wyszukiwania elementów UIA
UIAElementSearchMode string

Bieżący tryb wyszukiwania elementu UIA używany przez agenta IA-Connect.

Wprowadzanie hasła do elementu UIA

Akcja UIA, która wprowadza hasło do elementu (zazwyczaj pole wprowadzania hasła), zastępując istniejący tekst.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Hasło do danych wejściowych
PasswordToInput True password

Wartość hasła do danych wejściowych.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Hasło zawiera przechowywane hasło
PasswordContainsStoredPassword boolean

Ustaw wartość true, jeśli hasło zawiera (lub jest całkowicie) przechowywanym identyfikatorem hasła IA-Connect w formacie {IAConnectPassword:StoredPasswordIdentifier} lub poświadczenie ogólne IA-Connect Orchestrator w formacie {OrchestratorCredential:FriendlyName}. To zapisane hasło mogło zostać wygenerowane przez akcję "Generuj hasło", na przykład lub przechowywane przez IA-Connect Orchestrator.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Wzorzec try value
TryValuePattern boolean

Jeśli ustawiono wartość true (wartość domyślna), agent IA-Connect podejmie próbę użycia wzorca wartości UIA w celu wykonania akcji wprowadzania tekstu. Jeśli wzorzec wartości interfejsu użytkownika jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wartości i natychmiast powróci do innych wybranych wzorców.

Wypróbuj starszy wzorzec
TryLegacyPattern boolean

Jeśli ustawiono wartość true, agent IA-Connect podejmie próbę użycia starszego wzorca interfejsu użytkownika w celu wykonania akcji wprowadzania tekstu, jeśli wzorzec wartości jest niedostępny (ponieważ nie jest obecny w elemecie lub jego użycie zostało wyłączone).

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Wprowadzanie tekstu do elementu UIA

Akcja UIA, która wprowadza tekst do elementu (zazwyczaj pole wprowadzania tekstu), zastępując istniejący tekst lub wstawiając nową wartość w określonej pozycji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Tekst do danych wejściowych
TextToInput string

Wartość tekstowa do wprowadzania.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Zamień istniejącą wartość
ReplaceExistingValue boolean

Jeśli w elemecie znajduje się istniejący tekst, należy go zamienić?

Wstaw położenie
InsertPosition integer

Pozycja (indeks), aby rozpocząć wstawianie tekstu. Jeśli istnieje tekst, pozycja wstawiania może służyć do wstawiania w określonej pozycji w istniejącym tekście.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zgłaszanie wyjątku w przypadku niepowodzenia walidacji danych wejściowych
RaiseExceptionIfInputValidationFails boolean

Jeśli to ustawienie jest włączone, agent IA-Connect sprawdzi nową wartość elementu po wprowadzeniu żądanego tekstu. Jeśli nowa wartość nie jest zgodna z oczekiwaną wartością, zostanie zgłoszony wyjątek. Jeśli te dane wejściowe są fałszywe (wartość domyślna), zostanie wprowadzone ostrzeżenie w dzienniku, ale nie zostanie zgłoszony żaden wyjątek.

Wzorzec try value
TryValuePattern boolean

Jeśli ustawiono wartość true (wartość domyślna), agent IA-Connect podejmie próbę użycia wzorca wartości UIA w celu wykonania akcji wprowadzania tekstu. Jeśli wzorzec wartości interfejsu użytkownika jest niedostępny w wybranym elemecie, agent IA-Connect powróci do innych wzorców (włączone lub wyłączone za pośrednictwem innych danych wejściowych do tej akcji). Jeśli ustawiono wartość false, agent IA-Connect nie podejmie próby użycia wzorca wartości i natychmiast powróci do innych wybranych wzorców.

Wypróbuj starszy wzorzec
TryLegacyPattern boolean

Jeśli ustawiono wartość true, agent IA-Connect podejmie próbę użycia starszego wzorca interfejsu użytkownika w celu wykonania akcji wprowadzania tekstu, jeśli wzorzec wartości jest niedostępny (ponieważ nie jest obecny w elemecie lub jego użycie zostało wyłączone).

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Wprowadzanie tekstu do wielu elementów interfejsu użytkownika

Akcja UIA, która wprowadza różne fragmenty tekstu do wielu elementów (zazwyczaj pól wprowadzania tekstu), zastępując istniejący tekst lub wstawiając nową wartość w określonej pozycji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Elementy wejściowe
InputElementsJSON True string

Tablica elementów interfejsu użytkownika do wprowadzania tekstu w formacie JSON.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Wybierz element UIA

Wybiera element (zazwyczaj element na liście lub liście rozwijanej).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Wyszukiwanie pierwszego elementu nadrzędnego UIA

Wyszukuje hierarchię drzewa UIA dla pierwszego elementu nadrzędnego zgodnego z kryteriami wyszukiwania. Element nadrzędny jest definiowany jako element, który znajduje się na następnym poziomie w górę "drzewo" interfejsu użytkownika i jest prawie zawsze elementem zawierającym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt elementu
ElementHandle True integer

Uchwyt interfejsu użytkownika dla elementu docelowego.

Wyszukaj element nadrzędny zlokalizowany typ kontrolki
SearchParentLocalizedControlType string

Nadrzędny typ kontrolki UIA zlokalizowany typ kontrolki do wyszukania. Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj typ kontrolki elementu nadrzędnego
SearchParentControlType integer

Nadrzędny typ kontrolki elementu UIA (nielokalizowanej liczby całkowitej) do wyszukania. Jest to ta sama wartość w różnych językach.

Maksymalna liczba elementów nadrzędnych do przetworzenia
MaxParentsToProcess integer

Maksymalna liczba elementów nadrzędnych do przetworzenia. Domyślnie jest to wartość 50.

Zgłoś wyjątek, jeśli nie znaleziono elementu nadrzędnego
RaiseExceptionIfParentElementNotFound boolean

Czy IA-Connect zgłosić wyjątek, jeśli element wyszukiwania UIA nie znajduje się?

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Znaleziono element nadrzędny
ParentElementFound boolean

Zwraca wartość true, jeśli odnaleziono element nadrzędnego interfejsu użytkownika wyszukiwania.

Uchwyt elementu nadrzędnego
ParentElementHandle integer

Uchwyt interfejsu użytkownika dla zlokalizowanego elementu nadrzędnego. Może to służyć jako dane wejściowe do dalszych akcji interfejsu użytkownika działających na tym elemecie.

Nazwa elementu nadrzędnego
ParentElementName string

Nazwa UIA zlokalizowanego elementu nadrzędnego.

Nazwa klasy elementu nadrzędnego
ParentElementClassName string

Nazwa klasy UIA zlokalizowanego elementu nadrzędnego.

Identyfikator automatyzacji elementów nadrzędnych
ParentElementAutomationId string

Identyfikator automatyzacji UIA zlokalizowanego elementu nadrzędnego.

Typ kontrolki zlokalizowanej elementu nadrzędnego
ParentElementLocalizedControlType string

Zlokalizowany typ kontrolki interfejsu użytkownika elementu nadrzędnego.

Zamknij okno elementu UIA

Zamyka okno elementu. Zazwyczaj działa tylko w oknach lub oknach dialogowych.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zmienianie rozmiaru elementu UIA

Zmienia rozmiar elementu UIA. Ta akcja będzie zwykle działać tylko z elementami okna (które mają wzorzec przekształcania).

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zmienianie rozmiaru typu szerokości
ResizeWidthType string

Typ zmiany szerokości: bezwzględny lub względny.

Nowa szerokość
NewWidth True integer

Nowa szerokość elementu. Typ zmiany rozmiaru (na przykład bezwzględny lub względny) jest definiowany przez dane wejściowe "Zmień rozmiar typu szerokości". Aby pozostawić szerokość bez zmian, wybierz wartość 0 i ustaw wartość "Zmień rozmiar typu szerokości" na "Względna".

Zmienianie rozmiaru typu wysokości
ResizeHeightType string

Typ zmiany wysokości: bezwzględny lub względny.

Nowa wysokość
NewHeight True integer

Nowa wysokość elementu. Typ zmiany rozmiaru (na przykład bezwzględny lub względny) jest definiowany przez dane wejściowe "Zmień rozmiar typu wysokości". Aby pozostawić wysokość bez zmian, wybierz wartość 0 i ustaw wartość "Zmień rozmiar typu wysokości" na "Względna".

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Wynik polecenia
UIAResizeElementResult boolean

Wynik polecenia (powodzenie lub niepowodzenie).

Komunikat o błędzie
ErrorMessage string

Jeśli polecenie nie powiodło się, będzie zawierać zwrócony komunikat o błędzie.

Zminimalizowanie okna interfejsu użytkownika

Minimalizuje okno z określonym uchwytem interfejsu użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna
WindowHandle True integer

Uchwyt UIA okna do zminimalizowania.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zrzut ekranu przedstawiający lokalizację elementu UIA

Tworzy zrzut ekranu przedstawiający lokalizację elementu i zwraca obraz. Element powinien zostać przeniesiony na pierwszy front, ponieważ zrzut ekranu wykonuje kopię ekranu w lokalizacji elementów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Format obrazu
ImageFormat string

Format obrazu do użycia na zrzucie ekranu. Może to mieć wpływ na jakość i rozmiar zwracanych danych. Obsługiwane formaty to PNG (wartość domyślna), JPG, BMP i GIF.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Ukryj agenta
HideAgent boolean

Ustaw wartość true, aby automatycznie ukryć agenta (jeśli jest widoczny), aby upewnić się, że nie ukrywa zrzutu ekranu.

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()

Zwraca

Nazwa Ścieżka Typ Opis
Obraz ekranu jako Base64
ScreenBitmapBase64 string

Obraz ekranu jako ciąg zakodowany w formacie Base64.

Zwiń element UIA

Zwija element (zazwyczaj element menu/listy rozwijanej). Jeśli element jest już zwinięty, nic się nie stanie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uchwyt okna nadrzędnego
ParentWindowHandle True integer

Nadrzędny uchwyt okna interfejsu użytkownika (wartość 1 lub wyższa) do działania jako punkt początkowy wyszukiwania. Można to odnaleźć za pomocą funkcji Inspekcja przy użyciu akcji, takich jak "Czekaj na element pulpitu" lub "Czekaj na element".

Nazwa elementu wyszukiwania
SearchElementName string

Opcjonalna nazwa elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Nazwa klasy elementu wyszukiwania
SearchElementClassName string

Opcjonalna nazwa klasy elementu UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Identyfikator automatyzacji elementu wyszukiwania
SearchElementAutomationId string

Opcjonalny identyfikator automatyzacji elementów UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj element zlokalizowany typ kontrolki
SearchLocalizedControlType string

Opcjonalny typ kontrolki zlokalizowanej przez element UIA do wyszukania (począwszy od uchwytu okna nadrzędnego). Można to odnaleźć za pośrednictwem inspekcji.

Wyszukaj poddrzewo UIA
SearchSubTree boolean

Jeśli ustawiono wartość true, całe drzewo UIA poniżej dojścia okna nadrzędnego zostanie przeszukane. Jest to bardziej dokładne, ale może trwać dłużej. Jeśli ustawiono wartość false, przeszukiwane będą tylko elementy bezpośrednio poniżej uchwytu okna nadrzędnego w drzewie UIA.

Dopasuj indeks
MatchIndex integer

Jeśli wiele elementów pasuje do wyszukiwania, który element (począwszy od 1) powinien być dopasowany. Można użyć w połączeniu z kolumną "Sortuj według", aby wybrać kolejność sortowania w celu dopasowania.

Filtr wyszukiwania
SearchFilter string

Opcjonalny filtr zaawansowany umożliwiający dalsze ograniczanie wyszukiwania przy użyciu operatorów warunkowych i dowolnego pola elementu. Przykład 1: [Szerokość] < 200. Przykład 2: [Name] na przykład "Document*" AND [ClassName] jak "Label*". Więcej przykładów można znaleźć w dokumentacji.

Sortuj według nazwy kolumny
SortByColumn string

Jeśli wyszukiwanie jest zgodne z wieloma elementami, umożliwia określenie właściwości elementu do sortowania. Zostanie użyta w połączeniu z elementem "Dopasuj indeks", aby wybrać wymagany element. Na przykład: Jeśli wartość "Sortuj według nazwy kolumny" to [TopEdge], a wartość "Dopasuj indeks" wynosi 1, pasujący element najbliższy górnej części ekranu zostanie dopasowany.

Dopasowywanie indeksu rośnie
MatchIndexAscending boolean

Jeśli wyszukiwanie jest zgodne z wieloma elementami, należy dopasować wartość "Uwzględnij indeks" w górnej części posortowanej listy (true) lub z dolnej części posortowanej listy (false).

Maksymalna liczba elementów do wyszukania
MaxElementsToSearch integer

Maksymalna liczba elementów do wyszukania elementu docelowego w drzewie UIA. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna względna głębokość wyszukiwania
MaxRelativeSearchDepth integer

Maksymalna głębokość względnego drzewa do wyszukiwania elementów podrzędnych pod elementem nadrzędnym. Bezpośrednie elementy podrzędne będą miały wartość głębokości 1. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Ustaw wartość 0 dla nieograniczonej głębokości wyszukiwania. Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Maksymalna liczba elementów podrzędnych do wyszukania na węzeł
MaxChildElementsToSearchPerNode integer

Maksymalna liczba elementów podrzędnych do wyszukania pod każdym elementem podczas przeszukiwania drzewa UIA dla elementu docelowego. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Domyślnie jest ustawiona wartość 0 (nieograniczona). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Zlokalizowane typy kontrolek, których nie należy przechodzić
ElementLocalizedControlTypesNotToTraverse string

Rozdzielona przecinkami lista zlokalizowanych typów kontrolek elementu UIA, aby nie przechodzić (krok do) podczas przeszukiwania drzewa UIA dla elementu docelowego. Wyszukiwanie nadal będzie sprawdzać, czy pojedynczy element jest zgodny z kryteriami wyszukiwania, ale nie będzie przeszukiwać żadnych elementów podrzędnych tego elementu, jeśli jego zlokalizowany typ kontrolki znajduje się na tej liście wykluczeń. Te dane wejściowe działają tylko wtedy, gdy tryb wyszukiwania elementu UIA to "Spacer drzewa" (można to włączyć na stronie ustawień w Inspektorze). Te dane wejściowe są zwykle używane do optymalizacji wyszukiwania elementów.

Workflow
Workflow True string

Dodaj następujące wyrażenie tutaj: workflow()