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 |
| 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() |