Пользовательский интерфейс IA-Connect
IA-Connect — это платформа автоматизации роботизированных процессов RPA, которая добавляет функции RPA из облака в локальные виртуальные машины или через подключения Citrix или Microsoft Remote Desktop RDS. Это модуль для автоматизации пользовательского интерфейса приложения Windows "UIA".
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| Адрес электронной почты | IAConnect@ultima.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Ultima Business |
| Веб-сайт | https://www.ultima.com/ultima-labs |
| Политика конфиденциальности | https://www.ultima.com/privacy-policy |
| Категории | ИТ-операции; Продуктивность |
IA-Connect — это платформа автоматизации роботизированных процессов (RPA), которая добавляет функции RPA из Облачных потоков Power Automate в локальные виртуальные машины или через подключения Citrix или Microsoft Remote Desktop (RDS). Соединители IA-Connect предоставляют более 800 действий, что позволяет автоматизировать каждый тип локального приложения непосредственно из Power Automate Cloud Flow. Все действия IA-Connect доступны непосредственно из Power Automate Cloud Flow, обеспечивая простую интеграцию между облачными и локальными приложениями, возможность использовать существующие условия Power Automate, циклы, динамическое содержимое, выражения и обработку исключений в процессах RPA. Использование соединителей IA-Connect также обеспечивает полную историю выполнения и возможность аудита из журнала выполнения потока, а также удаление необходимости в отдельном приложении, консоли или студии для разработки процессов RPA.
Предпосылки
Чтобы использовать любой из соединителей IA-Connect, необходимо установить программное обеспечение IA-Connect. Это бесплатно для тестирования в течение 30 дней, после чего вам потребуется лицензия IA-Connect.
Программное обеспечение IA-Connect состоит из двух основных компонентов:
IA-Connect Orchestrator, который является Azure WebApp, который будет размещаться в собственном клиенте Azure. Это обрабатывает маршрутизацию и безопасность потоков RPA на одну или несколько локальных или облачных виртуальных машин.
Агент IA-Connect и директор, установленный на виртуальных машинах, где программное обеспечение, которое требуется автоматизировать, доступно. Кроме того, агент IA-Connect может выполняться в сеансе Citrix или Microsoft Remote Desktop Services (RDS), где команды RPA передаются по виртуальному каналу в удаленный сеанс для выполнения. Агент IA-Connect можно запустить из общей сетевой папки и не требует установки.
Доступные соединители IA-Connect
Доступные соединители IA-Connect:
- динамический код IA-Connect
- IA-Connect Java
- JML IA-Connect
- IA-Connect Мейнфрейм
- IA-Connect Microsoft Office
- IA-Connect SAP GUI
- сеанс IA-Connect
- Пользовательский интерфейс IA-Connect
- веб-браузер IA-Connect
Получение учетных данных
Чтобы получить лицензию и начать 30-дневную бесплатную пробную версию, отправьте запрос на наш веб-сайт (https://www.ultima.com/IA-Connect/Power-Automate).
После получения пробного запроса мы свяжемся с вами по адресу электронной почты, предоставленному для настройки IA-Connect программного обеспечения и предоставления пробной лицензии. Это полностью многофункциональная пробная версия и позволит протестировать любые из 800 действий во всех 9 IA-Connect соединителях в пределах собственной среды в течение пробного периода.
Начало работы с соединителем
После отправки пробного запроса на IA-Connect вы сможете скачать ZIP-файл, содержащий IA-Connect программное обеспечение и документацию по установке и настройке. Мы также обратитесь к вам, чтобы предложить поддержку и рекомендации по процессу установки по мере необходимости.
Support
В течение пробного периода вы можете обратиться в Ultima Labs (IAConnect@ultima.com) за поддержкой и помощью.
При покупке IA-Connect лицензии вы получите маркеры поддержки, которые можно активировать для обучения или поддержки в Центре технической службы на основе Великобритании (TSC).
Известные проблемы, распространенные ошибки и часто задаваемые вопросы
Наша база знаний содержит ряд статей, охватывающих все известные проблемы, распространенные ошибки, которые могут возникать при использовании соединителей IA-Connect и часто задаваемых вопросов. Это доступно https://support.ultima.com/ultimalabs и учетная запись для доступа к этим ресурсам предоставляется во время IA-Connect пробной версии и при приобретении лицензии IA-Connect.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API для этого API | True |
| адрес оркестратора IA-Connect | струна | Укажите адрес оркестратора IA-Connect без компонента HTTP(S) | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Ввод текста в несколько элементов UIA |
Действие UIA, которое вводит различные фрагменты текста в несколько элементов (обычно поля ввода текста), заменяя существующий текст или вставляя новое значение по определенной позиции. |
| Ввод текста в элемент UIA |
Действие UIA, которое вводит текст в элемент (обычно поле ввода текста), заменяя существующий текст или вставляя новое значение по определенной позиции. |
| Входной пароль в элемент UIA |
Действие UIA, которое вводит пароль в элемент (обычно поле ввода пароля), заменяя существующий текст. |
| Входные данные возвращаются в элемент UIA |
Вводит возвращаемую строку Или новую строку Windows в элемент (обычно текстовое поле записи), заменяя существующий текст или вставляя возвращаемый объект по определенной позиции. |
| Выбор элемента UIA |
Выбирает элемент (обычно элемент в списке или раскрывающемся списке). |
| Глобальный входной пароль в элемент UIA |
Перемещает мышь в центр элемента, фокусирует его, щелкает слева и нажимает клавиши. Обычно используется с вводом пароля, который не принимает собственные методы ввода UIA. |
| Глобальный входной текст в элемент UIA |
Перемещает мышь в центр элемента, фокусирует его, щелкает слева и нажимает клавиши. Обычно используется с текстовыми входными данными, которые не принимают собственные методы ввода UIA. |
| Глобальный двойной левый мыши щелкните элемент UIA |
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и дважды щелкает левую кнопку мыши. |
| Глобальный левый щелчок мыши на элементе UIA |
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и нажимает левую кнопку мыши. |
| Глобальный средний мыши щелкните элемент UIA |
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и щелкает среднюю кнопку мыши. |
| Глобальный щелчок мыши область поиска элементов UIA |
Перемещает указатель мыши по области пикселей в элементЕ UIA, который соответствует указанным критериям цвета и выполняет щелчк мыши. Элемент должен быть доставлен на передний план, так как снимок экрана принимает копию экрана в расположении элементов. |
| Глобальный щелчок правой кнопкой мыши на элементЕ UIA |
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и нажимает правую кнопку мыши. |
| Дождитесь, пока элемент UIA не существует |
Ожидает, что элемент (обычно отдельный элемент в окне, например кнопка или область ввода текста) больше не существует. |
| Дождитесь завершения окна Win32 верхнего уровня UIA |
Быстрое действие Win32, которое ожидает указанного времени, пока не будет существовать окно Win32 верхнего уровня, прежде чем возвращать дескриптор UIA. Окно верхнего уровня — это окно, подключенное к рабочему столу. Можно выполнить поиск по имени класса или заголовку окна или указать более сложные фильтры поиска, включая подстановочные знаки. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Чаще всего используется действие UIA "Ожидание классического элемента", которое является более мощным, но это действие Win32 обычно выполняется быстрее. |
| Дождитесь того, чтобы видимый образ поиска не существовал в элементе UIA |
Ожидает, пока изображение поиска, предоставленное в качестве входных данных для этого действия, не может быть видимо расположено (или никогда не было расположено) в элементе UIA на экране или указанное время прошло, и изображение по-прежнему присутствует. Элемент должен быть доставлен на передний план, так как агент принимает снимок экрана с координатами элемента и выполняет поиск предоставленного изображения поиска на снимках экрана. Элемент UIA должен существовать с начала. Действие завершается сразу после того, как изображение больше не присутствует. |
| Задайте для элемента UIA значение числового диапазона |
Задает значение элемента с числовым диапазоном, например полосой прокрутки. |
| Задайте для элемента UIA числовое значение |
Задает значение элемента, имеющего числовые входные данные, например текстовое поле или полосу прокрутки. |
| Задать процент прокрутки элемента UIA |
Задайте горизонтальный и /или вертикальный процент прокрутки указанного элемента, если прокрутка поддерживается этим элементом. Если элемент поддерживает шаблон прокрутки, можно применить это действие непосредственно к элементу и указать горизонтальное или вертикальное количество прокрутки (или оба). Если элемент не поддерживает шаблон прокрутки, то это действие возвращается к шаблонам "диапазон" или "значение", но их необходимо применить непосредственно к элементам управления полосы прокрутки, а не к самому элементу. |
| Закрыть окно элемента UIA |
Закрывает окно элемента. Обычно работает только в окнах или диалоговых окнах. |
| Изменение размера элемента UIA |
Изменяет размер элемента UIA. Обычно это действие будет работать только с элементами Окна (которые имеют шаблон преобразования). |
| Имеет ли процесс окно Win32 |
Простое и быстрое действие Win32, которое сообщает, имеет ли процесс (указанный по имени) любые видимые окна. Окно должно существовать: IA-Connect не будет ждать. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным. |
| Максимальное увеличение окна UIA |
Максимизирует окно с указанным дескриптором UIA. |
| Нажмите элемент UIA |
Нажимает элемент (обычно кнопка). |
| Настройка окна UIA переднего плана |
Переносит окно на передний план. |
| Настройка режима поиска элементов UIA |
Выберите режим поиска элементов UIA, который должен использоваться агентом IA-Connect при выполнении действий UIA. Как правило, это действие будет использоваться только в том случае, если у вас возникла проблема с режимом по умолчанию (найти все). |
| Ожидание видимого изображения поиска в элементе UIA |
Ожидает, пока изображение поиска, предоставленное в качестве входных данных для этого действия, явно находится в элементе UIA на экране или указанное время прошло. Элемент должен быть доставлен на передний план, так как агент принимает снимок экрана с координатами элемента и выполняет поиск предоставленного изображения поиска на снимках экрана. Элемент UIA должен существовать с начала. Действие завершается сразу после того, как изображение будет расположено. |
| Ожидание главного окна идентификатора процесса UIA |
Простое и быстрое действие Win32, которое ожидает существования основного окна процесса (указанного идентификатором процесса) и возвращает дескриптор. Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным. |
| Ожидание главного окна процесса UIA |
Простое и быстрое действие Win32, которое ожидает указанного времени для главного окна процесса (указанного по имени) перед возвратом дескриптора. Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным. |
| Ожидание классического элемента UIA |
Ожидает, пока элемент рабочего стола (обычно окно) будет существовать. |
| Ожидание элемента UIA |
Ожидает, пока элемент (обычно отдельный элемент в окне, например кнопка или область ввода текста) будет существовать. |
| Переключение элемента UIA |
Переключает элемент (обычно флажок или переключатель). Это дает элементу противоположное состояние текущего состояния (например, проверка становится снятой и наоборот). Если вы хотите задать определенное состояние, используйте действие Check element. |
| Перемещение элемента UIA |
Перемещает элемент UIA в указанную позицию на экране. Обычно это действие будет работать только с элементами Окна (которые имеют шаблон преобразования). |
| Подождите, пока классический элемент UIA не существует |
Ожидает, что элемент рабочего стола (обычно окно) больше не существует. |
| Поиск видимого изображения поиска в элементе UIA |
Возвращает значение, указывающее, находится ли изображение поиска, предоставленное в качестве входных данных для этого действия, видимо, в элементе UIA на экране. Элемент должен быть доставлен на передний план, так как агент принимает снимок экрана с координатами элемента и выполняет поиск предоставленного изображения поиска на снимках экрана. |
| Поиск первого родительского элемента UIA |
Выполняет поиск по иерархии дерева UIA для первого родительского элемента, соответствующего условиям поиска. Родительский элемент определяется как элемент, который находится на следующем уровне вверх по дереву UIA и почти всегда является содержащим элементом. |
| Получение дескриптора UIA для главного окна идентификатора процесса |
Простое и быстрое действие Win32, которое возвращает дескриптор для любого основного окна процесса (указанного идентификатором процесса). Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным. |
| Получение дескриптора UIA для главного окна процесса |
Простое и быстрое действие Win32, которое возвращает дескриптор для любого основного окна процесса (указанного по имени). Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Окно должно существовать: IA-Connect не будет ждать. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным. |
| Получение дескриптора UIA для окна Win32 верхнего уровня |
Быстрое действие Win32, которое возвращает дескриптор UIA для любого окна Win32 верхнего уровня с указанным именем класса или заголовком окна, или можно указать более сложные фильтры поиска, включая подстановочные знаки. Окно верхнего уровня — это окно, подключенное к рабочему столу. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Окно должно существовать, IA-Connect не будет ждать. Чаще всего используется действие UIA "Существует ли классический элемент UIA", которое является более мощным, но это действие Win32 обычно выполняется быстрее. |
| Получение дескриптора UIA для основного окна фокусированного элемента |
Возвращает дескриптор основного окна текущего элемента UIA. Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. |
| Получение дескриптора UIA для рабочего стола |
Возвращает дескриптор для рабочего стола. Это устаревшее действие, так как дескриптор "-2" можно использовать для ссылки на элемент рабочего стола, но и потому, что есть много действий, которые могут выполнять поиск относительно рабочего стола (например, ожидание элемента рабочего стола). |
| Получение дескриптора UIA для фокусированного элемента |
Возвращает дескриптор для текущего элемента UIA. |
| Получение дескриптора родительского элемента UIA |
Возвращает дескриптор родительского элемента указанного элемента. Родительский элемент определяется как элемент, который находится на следующем уровне вверх по дереву UIA и почти всегда является содержащим элементом. |
| Получение значения метки элемента UIA |
Возвращает значение метки в элементе. |
| Получение значения элемента UIA |
Возвращает значение элемента. Значение обычно связано с областью ввода текста, но многие элементы могут иметь это свойство. |
| Получение классических элементов UIA |
Возвращает список всех окон и диалоговых окон на рабочем столе. |
| Получение нескольких свойств родительского элемента UIA |
Возвращает иерархическое дерево родительских элементов указанного элемента вплоть до рабочего стола (корневого уровня). Родительский элемент определяется как элемент, который находится на следующем уровне вверх по дереву UIA и почти всегда является содержащим элементом. |
| Получение нескольких свойств элемента UIA |
Возвращает свойства нескольких элементов. Это может быть полезно, если вы не уверены, какие поля содержат необходимые значения свойств. |
| Получение нескольких элементов UIA в виде таблицы |
Перечисляет значения дочерних элементов указанного родительского элемента и возвращается в формате таблицы. Это можно использовать для возврата строк и столбцов данных из элементов, которые не являются технически таблицами, но были организованы вместе в структуру таблицы. Это действие также можно использовать для получения результатов из предыдущего выполнения этого действия, запускаемого в качестве потока агента. |
| Получение окон Win32 |
Быстрое действие Win32, которое возвращает список всех окон Win32, которые при необходимости имеют указанное имя класса или название окна, или можно указать более расширенные фильтры поиска, включая подстановочные знаки. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Windows Win32 может включать непредвиденные элементы, включая панель задач, рабочий стол, меню "Пуск", прозрачные наложения, внеэкранные или скрытые окна, поэтому возвращенный список может содержать больше результатов, чем ожидалось. |
| Получение режима поиска элементов UIA |
Извлекает режим поиска элементов UIA, используемый агентом IA-Connect для действий UIA. |
| Получение свойств элемента datagrid UIA |
Возвращает свойства таблицы элемента DataGrid. Это элемент со строками, столбцами, заголовками и ячейками (т. е. таблицей). |
| Получение свойств элемента UIA |
Возвращает все свойства элемента. Это может быть полезно, если вы не уверены, какое поле содержит необходимые значения свойств. |
| Получение свойств элемента UIA в виде списка |
Возвращает свойства элемента в виде одного списка строк (одна коллекция строк или таблица данных) вместо отдельных элементов, это может быть полезно в зависимости от способа использования данных. |
| Получение содержимого элемента datagrid UIA |
Возвращает содержимое элемента datagrid. Это элемент со строками, столбцами, заголовками и ячейками (т. е. таблицей). Это действие также можно использовать для получения результатов из предыдущего выполнения этого действия, запускаемого в качестве потока агента. |
| Получение текстового значения элемента UIA |
Возвращает текстовое значение элемента. Текстовое значение обычно связано с меткой, но многие элементы могут иметь это свойство. |
| Получение цветовой области поиска элементов UIA |
Возвращает сведения о области пикселей в элементе UIA, удовлетворяющем указанным критериям цвета. Элемент должен быть доставлен на передний план, так как агент находит цвета, принимая снимок экрана с координатами элемента. |
| Получение шаблонов элементов UIA |
Извлекает, какие шаблоны UIA доступны для элемента UIA, поэтому IA-Connect действия UIA могут повлиять на элемент. |
| Получение элемента UIA в координатах экрана |
Возвращает элемент UIA, расположенный в заданных координатах экрана. |
| Получение элементов списка UIA |
Возвращает список дочерних элементов, найденных под указанным элементом (обычно раскрывающийся список или элементы меню). |
| Проверен элемент UIA |
Это действие возвращает значение true или false, указывающее, установлен ли элемент (обычно флажок или переключатель). |
| Проверка нескольких элементов UIA |
Задает состояние нескольких элементов (обычно флажок или переключатель) флажком или снят. |
| Проверка элемента UIA |
Задает состояние элемента (обычно флажок или переключатель) флажком или снятым. |
| Развернуть элемент UIA |
Развертывает элемент (обычно меню или раскрывающийся элемент). Если элемент уже развернут, ничего не произойдет. |
| Рисование прямоугольника вокруг элемента UIA |
Рисует прямоугольник вокруг периметра элемента, помогающего определить, что найденный элемент является обязательным. Прямоугольник автоматически удаляется через 5 секунд. |
| Сброс всех дескрипторов элементов UIA |
Сбрасывает все дескриптор элемента UIA, хранящиеся в настоящее время IA-Connect которые могут быть полезны, если вы определили много элементов и имеет большое количество дескрипторов элементов. В сценариях с чрезвычайно большим количеством дескрипторов элементов (100 000+) это действие также можно использовать для освобождения использования ОЗУ. |
| Свести к минимуму окно UIA |
Минимизирует окно с указанным дескриптором UIA. |
| Снимок экрана: расположение элемента UIA |
Снимок экрана: расположение элемента и возвращает изображение. Элемент должен быть доставлен на передний план, так как снимок экрана принимает копию экрана в расположении элементов. |
| Существует ли классический элемент UIA |
Сообщает, существует ли классический элемент и предоставляет некоторые базовые свойства элементов. |
| Существует ли окно Win32 верхнего уровня |
Быстрое действие Win32, указывающее, существует ли окно Win32 верхнего уровня. Окно верхнего уровня — это окно, подключенное к рабочему столу. Можно выполнить поиск по имени класса или заголовку окна или указать более сложные фильтры поиска, включая подстановочные знаки. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Окно должно существовать, IA-Connect не будет ждать. Чаще всего используется действие UIA "Существует ли классический элемент UIA", которое является более мощным, но это действие Win32 обычно выполняется быстрее. |
| Существует ли элемент UIA |
Сообщает, существует ли элемент и возвращает некоторые базовые свойства элемента. |
| Установка времени ожидания транзакции UIA |
Определяет, сколько времени API UIA будет ждать, пока приложение вернет сведения об элементе. Это время ожидания транзакции обычно достигается только в том случае, если приложение не отвечает. |
| Установка нормального окна UIA |
Нормализация окна с заданным дескриптором UIA (т. е. устанавливает его в нормальное окно размера, а не минимизировано или максимизировано). |
| Щелкните элемент списка UIA по имени |
Щелкает элемент списка с указанным именем. Обычно это используется для выбора элемента в раскрывающемся списке или элементе меню. |
| Щелкните элемент списка UIA по индексу |
Щелкает элемент списка, соответствующий указанному индексу. Обычно это используется для выбора элемента в раскрывающемся списке или элементе меню. |
| Элемент Focus UIA |
Фокусирует элемент, который делает его активным элементом для фокуса клавиатуры, и в зависимости от приложения может привести окно элемента к переднему плану. |
| Элемент Свернуть UIA |
Свернут элемент (обычно меню или раскрывающийся элемент). Если элемент уже свернут, ничего не произойдет. |
Ввод текста в несколько элементов UIA
Действие UIA, которое вводит различные фрагменты текста в несколько элементов (обычно поля ввода текста), заменяя существующий текст или вставляя новое значение по определенной позиции.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Входные элементы
|
InputElementsJSON | True | string |
Массив элементов UIA для ввода текста в формате JSON. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Ввод текста в элемент UIA
Действие UIA, которое вводит текст в элемент (обычно поле ввода текста), заменяя существующий текст или вставляя новое значение по определенной позиции.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Текст для ввода
|
TextToInput | string |
Текстовое значение для ввода. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Замена существующего значения
|
ReplaceExistingValue | boolean |
Если в элементе есть существующий текст, его следует заменить? |
|
|
Вставка позиции
|
InsertPosition | integer |
Позиция (индекс) для начала вставки текста. Если существует текст, позиция вставки может использоваться для вставки в определенной позиции в существующем тексте. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Вызов исключения, если проверка входных данных завершается ошибкой
|
RaiseExceptionIfInputValidationFails | boolean |
Если этот параметр включен, агент IA-Connect проверяет новое значение элемента после ввода запрошенного текста. Если новое значение не соответствует ожидаемому значению, создается исключение. Если этот вход имеет значение false (по умолчанию), в журнал будет введено предупреждение, но исключение не будет создано. |
|
|
Пример шаблона значений
|
TryValuePattern | boolean |
Если задано значение true (по умолчанию), агент IA-Connect попытается использовать шаблон значения UIA для выполнения действия ввода текста. Если шаблон значения UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон значений и немедленно возвращается к другим выбранным шаблонам. |
|
|
Попробуйте использовать устаревший шаблон
|
TryLegacyPattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать устаревший шаблон UIA для выполнения действия ввода текста, если шаблон значения недоступен (либо потому, что он отсутствует в элементе, либо из-за отключения его использования). |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Входной пароль в элемент UIA
Действие UIA, которое вводит пароль в элемент (обычно поле ввода пароля), заменяя существующий текст.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Пароль для ввода
|
PasswordToInput | True | password |
Значение пароля для ввода. |
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Пароль содержит сохраненный пароль
|
PasswordContainsStoredPassword | boolean |
Установите значение true, если пароль содержит (или полностью) IA-Connect хранимый идентификатор пароля в формате {IAConnectPassword:StoredPasswordIdentifier} или универсальные учетные данные Orchestrator IA-Connect Orchestrator в формате {OrchestratorCredential:FriendlyName}. Этот сохраненный пароль может быть создан действием "Создать пароль", например, или быть удерживаемым IA-Connect Orchestrator. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Пример шаблона значений
|
TryValuePattern | boolean |
Если задано значение true (по умолчанию), агент IA-Connect попытается использовать шаблон значения UIA для выполнения действия ввода текста. Если шаблон значения UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон значений и немедленно возвращается к другим выбранным шаблонам. |
|
|
Попробуйте использовать устаревший шаблон
|
TryLegacyPattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать устаревший шаблон UIA для выполнения действия ввода текста, если шаблон значения недоступен (либо потому, что он отсутствует в элементе, либо из-за отключения его использования). |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Входные данные возвращаются в элемент UIA
Вводит возвращаемую строку Или новую строку Windows в элемент (обычно текстовое поле записи), заменяя существующий текст или вставляя возвращаемый объект по определенной позиции.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Замена существующего значения
|
ReplaceExistingValue | boolean |
Если в элементе есть существующий текст, его следует заменить? |
|
|
Вставка позиции
|
InsertPosition | integer |
Позиция (индекс) для начала вставки текста. Если существует текст, позиция вставки может использоваться для вставки в определенной позиции в существующем тексте. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Вызов исключения, если проверка входных данных завершается ошибкой
|
RaiseExceptionIfInputValidationFails | boolean |
Если этот параметр включен, агент IA-Connect проверяет новое значение элемента после ввода запрошенного текста. Если новое значение не соответствует ожидаемому значению, создается исключение. Если этот вход имеет значение false (по умолчанию), в журнал будет введено предупреждение, но исключение не будет создано. |
|
|
Пример шаблона значений
|
TryValuePattern | boolean |
Если задано значение true (по умолчанию), агент IA-Connect попытается использовать шаблон значения UIA для выполнения действия ввода текста. Если шаблон значения UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон значений и немедленно возвращается к другим выбранным шаблонам. |
|
|
Попробуйте использовать устаревший шаблон
|
TryLegacyPattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать устаревший шаблон UIA для выполнения действия ввода текста, если шаблон значения недоступен (либо потому, что он отсутствует в элементе, либо из-за отключения его использования). |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Выбор элемента UIA
Выбирает элемент (обычно элемент в списке или раскрывающемся списке).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Глобальный входной пароль в элемент UIA
Перемещает мышь в центр элемента, фокусирует его, щелкает слева и нажимает клавиши. Обычно используется с вводом пароля, который не принимает собственные методы ввода UIA.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Первый элемент Focus
|
FocusElement | boolean |
Следует ли IA-Connect попытаться сосредоточить элемент перед глобальным щелчком? |
|
|
Глобальный левый щелчок мыши по элементу
|
GlobalMouseClickOnElement | boolean |
Должен ли глобальный щелчок мыши выполняться по координатам элемента (для фокусировки элемента) перед вводом текста? |
|
|
Замена существующего значения с помощью двойного щелчка мыши delete
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Следует ли заменить любое существующее значение, дважды щелкнув мышь (чтобы выделить ее), а затем удалить? |
|
|
Замена существующего значения с помощью удаления CTRL-A
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Следует ли заменить любое существующее значение путем нажатия клавиши Ctrl-A (чтобы выделить все), а затем удалить? Некоторые элементы могут не поддерживать выделение с помощью Ctrl-A в этом случае следует попробовать альтернативный вариант "Заменить существующее значение с помощью двойного щелчка мыши удалить". |
|
|
Пароль для ввода
|
PasswordToInput | True | password |
Значение пароля для глобальных входных данных с помощью клавиатуры. |
|
Использование событий отправки ключей
|
SendKeyEvents | boolean |
Если задано значение true, то будут использоваться события ключей (API нижнего уровня, который отправляет имитированные нажатия клавиш в операционную систему). Если задано значение false, то вместо этого будет использоваться api отправки ключей (API более высокого уровня, который отправляет нажатия клавиш в элемент с фокусом). |
|
|
Интервал в миллисекундах
|
Interval | integer |
Количество миллисекунда между каждым нажатием клавиши. |
|
|
Не интерпретируемые символы
|
DontInterpretSymbols | boolean |
Должны ли символы в поле "Пароль для ввода" не интерпретироваться как специальные ключи (например, +для SHIFT, ^ для CTRL)? Это значение должно иметь значение true, если вы пытаетесь ввести фактические символы. |
|
|
Пароль содержит сохраненный пароль
|
PasswordContainsStoredPassword | boolean |
Установите значение true, если пароль содержит (или полностью) IA-Connect хранимый идентификатор пароля в формате {IAConnectPassword:StoredPasswordIdentifier} или универсальные учетные данные Orchestrator IA-Connect Orchestrator в формате {OrchestratorCredential:FriendlyName}. Этот сохраненный пароль может быть создан действием "Создать пароль", например, или быть удерживаемым IA-Connect Orchestrator. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Глобальный входной текст в элемент UIA
Перемещает мышь в центр элемента, фокусирует его, щелкает слева и нажимает клавиши. Обычно используется с текстовыми входными данными, которые не принимают собственные методы ввода UIA.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Первый элемент Focus
|
FocusElement | boolean |
Следует ли IA-Connect попытаться сосредоточить элемент перед глобальным щелчком? |
|
|
Глобальный левый щелчок мыши по элементу
|
GlobalMouseClickOnElement | boolean |
Должен ли глобальный щелчок мыши выполняться по координатам элемента (для фокусировки элемента) перед вводом текста? |
|
|
Замена существующего значения с помощью двойного щелчка мыши delete
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Следует ли заменить любое существующее значение, дважды щелкнув мышь (чтобы выделить ее), а затем удалить? |
|
|
Замена существующего значения с помощью удаления CTRL-A
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Следует ли заменить любое существующее значение путем нажатия клавиши Ctrl-A (чтобы выделить все), а затем удалить? Некоторые элементы могут не поддерживать выделение с помощью Ctrl-A в этом случае следует попробовать альтернативный вариант "Заменить существующее значение с помощью двойного щелчка мыши удалить". |
|
|
Текст для ввода
|
TextToInput | string |
Текстовое значение для глобальных входных данных с помощью клавиатуры. |
|
|
Использование событий отправки ключей
|
SendKeyEvents | boolean |
Если задано значение true, то будут использоваться события ключей (API нижнего уровня, который отправляет имитированные нажатия клавиш в операционную систему). Если задано значение false, то вместо этого будет использоваться api отправки ключей (API более высокого уровня, который отправляет нажатия клавиш в элемент с фокусом). |
|
|
Интервал в миллисекундах
|
Interval | integer |
Количество миллисекунда между каждым нажатием клавиши. |
|
|
Не интерпретируемые символы
|
DontInterpretSymbols | boolean |
Не следует ли интерпретировать символы в текстовом поле "Текст для ввода" как специальные ключи (например, +для shift, ^ для CTRL)? Это значение должно иметь значение true, если вы пытаетесь ввести фактические символы. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Глобальный двойной левый мыши щелкните элемент UIA
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и дважды щелкает левую кнопку мыши.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Задержка в миллисекундах
|
DelayInMilliseconds | integer |
Задержка (в миллисекундах) между каждым щелчком мыши. |
|
|
Первый элемент Focus
|
FocusElementFirst | boolean |
Следует ли IA-Connect попытаться сосредоточить элемент перед глобальным щелчком? |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Щелкните смещение X
|
ClickOffsetX | integer |
Количество пикселей X для смещения действия щелчка по. Этот параметр поддерживает как положительные (справа), так и отрицательные (слева) значения смещения. |
|
|
Щелкните смещение Y
|
ClickOffsetY | integer |
Количество пикселей Y для смещения действия щелчка. Этот параметр поддерживает как положительные (вниз), так и отрицательные (вверх) значения смещения. |
|
|
Смещение относительно
|
OffsetRelativeTo | string |
Относительное положение элемента для смещения от (центр / центр / средний, левый, правый, верхний, нижний, верхний левый, нижний левый, нижний правый). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Глобальный левый щелчок мыши на элементе UIA
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и нажимает левую кнопку мыши.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Первый элемент Focus
|
FocusElementFirst | boolean |
Следует ли IA-Connect попытаться сосредоточить элемент перед глобальным щелчком? |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Щелкните смещение X
|
ClickOffsetX | integer |
Количество пикселей X для смещения действия щелчка по. Этот параметр поддерживает как положительные (справа), так и отрицательные (слева) значения смещения. |
|
|
Щелкните смещение Y
|
ClickOffsetY | integer |
Количество пикселей Y для смещения действия щелчка. Этот параметр поддерживает как положительные (вниз), так и отрицательные (вверх) значения смещения. |
|
|
Смещение относительно
|
OffsetRelativeTo | string |
Относительное положение элемента для смещения от (центр / центр / средний, левый, правый, верхний, нижний, верхний левый, нижний левый, нижний правый). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Глобальный средний мыши щелкните элемент UIA
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и щелкает среднюю кнопку мыши.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Первый элемент Focus
|
FocusElementFirst | boolean |
Следует ли IA-Connect попытаться сосредоточить элемент перед глобальным щелчком? |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Щелкните смещение X
|
ClickOffsetX | integer |
Количество пикселей X для смещения действия щелчка по. Этот параметр поддерживает как положительные (справа), так и отрицательные (слева) значения смещения. |
|
|
Щелкните смещение Y
|
ClickOffsetY | integer |
Количество пикселей Y для смещения действия щелчка. Этот параметр поддерживает как положительные (вниз), так и отрицательные (вверх) значения смещения. |
|
|
Смещение относительно
|
OffsetRelativeTo | string |
Относительное положение элемента для смещения от (центр / центр / средний, левый, правый, верхний, нижний, верхний левый, нижний левый, нижний правый). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Глобальный щелчок мыши область поиска элементов UIA
Перемещает указатель мыши по области пикселей в элементЕ UIA, который соответствует указанным критериям цвета и выполняет щелчк мыши. Элемент должен быть доставлен на передний план, так как снимок экрана принимает копию экрана в расположении элементов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Цвет поиска
|
SearchColour | True | string |
Цвет поиска в формате 0xAARRGGBB, #AARRGGBB, 0xRRGGBB или #RRGGBB, где каждый канал цвета является байтом в шестнадцатеричном формате (00 полностью отключен, FF полностью включен). Например: #FF0000 для красного, #00FF00 для синего, #00000 для черного, #FFFFFF для белого. |
|
Максимальное отклонение цвета
|
MaxColourDeviation | True | integer |
Максимальный цвет элемента может отклоняться от цвета поиска, прежде чем он не считается совпадением. 0 для отсутствия отклонения. Отклонение измеряется в значениях RGB. Например, #FF0000 отличается от #FE0102. Отклонение от 15 было бы хорошим отправной точкой. |
|
Смещение X влево
|
LeftPixelXOffset | integer |
Необязательное смещение X для левого края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение по правому пикселю X
|
RightPixelXOffset | integer |
Необязательное смещение X для правого края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Смещение верхнего пикселя Y
|
TopPixelYOffset | integer |
Необязательное смещение Y для верхнего края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение нижнего пикселя Y
|
BottomPixelYOffset | integer |
Необязательное смещение Y для нижнего края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Кнопка мыши
|
MouseButton | string |
Нажмите кнопку мыши (слева, вправо, в середине, влево). |
|
|
Щелкните смещение X
|
ClickOffsetX | integer |
Количество пикселей X для смещения действия щелчка по. Этот параметр поддерживает как положительные (справа), так и отрицательные (слева) значения смещения. |
|
|
Щелкните смещение Y
|
ClickOffsetY | integer |
Количество пикселей Y для смещения действия щелчка. Этот параметр поддерживает как положительные (вниз), так и отрицательные (вверх) значения смещения. |
|
|
Смещение относительно
|
OffsetRelativeTo | string |
Относительное положение области цвета для смещения от (центр / центр / средний, левый, правый, верхний, нижний, верхний левый, нижний, нижний правый). |
|
|
Задержка в миллисекундах
|
DelayInMilliseconds | integer |
При выполнении двойного щелчка задержка (в миллисекундах) между каждым щелчком мыши. |
|
|
Скрыть агент
|
HideAgent | boolean |
Установите значение true, чтобы автоматически скрыть агент (если видимый), чтобы убедиться, что он не скрывает анализируемый элемент. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Результат команды
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
Результат команды (успешное выполнение или сбой). |
|
Сообщение об ошибке
|
ErrorMessage | string |
Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке. |
Глобальный щелчок правой кнопкой мыши на элементЕ UIA
Перемещает мышь в центр или выбранный край, угол или смещение относительно элемента UIA и нажимает правую кнопку мыши.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Первый элемент Focus
|
FocusElementFirst | boolean |
Следует ли IA-Connect попытаться сосредоточить элемент перед глобальным щелчком? |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Щелкните смещение X
|
ClickOffsetX | integer |
Количество пикселей X для смещения действия щелчка по. Этот параметр поддерживает как положительные (справа), так и отрицательные (слева) значения смещения. |
|
|
Щелкните смещение Y
|
ClickOffsetY | integer |
Количество пикселей Y для смещения действия щелчка. Этот параметр поддерживает как положительные (вниз), так и отрицательные (вверх) значения смещения. |
|
|
Смещение относительно
|
OffsetRelativeTo | string |
Относительное положение элемента для смещения от (центр / центр / средний, левый, правый, верхний, нижний, верхний левый, нижний левый, нижний правый). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Дождитесь, пока элемент UIA не существует
Ожидает, что элемент (обычно отдельный элемент в окне, например кнопка или область ввода текста) больше не существует.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Если задано (значение 1 или выше), поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым (или 0). |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, дожидающегося, пока элемент не существует. |
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, возвращается только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Вызов исключения, если элемент по-прежнему существует
|
RaiseExceptionIfElementStillExists | boolean |
Следует ли IA-Connect вызывать исключение, если элемент UIA по-прежнему существует после периода ожидания? |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует до ожидания
|
ElementExistsBeforeWait | boolean |
Возвращает значение true, если элемент существовал перед ожиданием или значением false, если нет. |
|
Элемент существует после ожидания
|
ElementExistsAfterWait | boolean |
Возвращает значение true, если элемент существовал после ожидания или false, если нет. |
Дождитесь завершения окна Win32 верхнего уровня UIA
Быстрое действие Win32, которое ожидает указанного времени, пока не будет существовать окно Win32 верхнего уровня, прежде чем возвращать дескриптор UIA. Окно верхнего уровня — это окно, подключенное к рабочему столу. Можно выполнить поиск по имени класса или заголовку окна или указать более сложные фильтры поиска, включая подстановочные знаки. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Чаще всего используется действие UIA "Ожидание классического элемента", которое является более мощным, но это действие Win32 обычно выполняется быстрее.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя класса поиска
|
SearchClassName | string |
Имя класса элемента окна верхнего уровня для поиска, например "Блокнот". |
|
|
Заголовок окна поиска
|
SearchWindowTitle | string |
Заголовок окна верхнего уровня для поиска. |
|
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, дожидающегося существования окна. |
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Необязательный идентификатор процесса, который владеет окном (например, как показано в выходных данных действия "Запуск процесса" в действиях IA-Connect среды или сеанса). Установите значение 0, чтобы не выполнять поиск по идентификатору процесса. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов для доступных свойств окна. Пример 1: [ширина] < 200. Пример 2. [Заголовок], например "*Excel" AND [IsMinimize] = False AND [IsResizeable] = True. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько окон соответствуют поиску, это позволяет указать свойство окна для сортировки по. Это будет использоваться в сочетании с "Индекс соответствия" для выбора требуемого окна. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Индекс сопоставления" равно 1, то будет возвращено окно сопоставления, ближайшее к верхней части экрана. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько окон соответствуют поиску, должно совпадать со значением "Совпадение индекса" в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Вызов исключения, если окно не найдено
|
RaiseExceptionIfWindowNotFound | boolean |
Следует ли IA-Connect вызвать исключение, если окно поиска Win32 не существует после периода ожидания? |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если окно существует или значение false, если нет. |
Дождитесь того, чтобы видимый образ поиска не существовал в элементе UIA
Ожидает, пока изображение поиска, предоставленное в качестве входных данных для этого действия, не может быть видимо расположено (или никогда не было расположено) в элементе UIA на экране или указанное время прошло, и изображение по-прежнему присутствует. Элемент должен быть доставлен на передний план, так как агент принимает снимок экрана с координатами элемента и выполняет поиск предоставленного изображения поиска на снимках экрана. Элемент UIA должен существовать с начала. Действие завершается сразу после того, как изображение больше не присутствует.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Тип изображения поиска
|
SearchImageType | string |
Определяет, что представляет входные данные "Поиск изображения". Если задано значение "Файл образа директора", то образ поиска — это путь к файлу, доступному директору. Если задано значение "Файл образа агента", то образ поиска — это путь к файлу, доступному агенту. Если задано значение Base64, то изображение поиска представляет собой представление изображения base64. |
|
|
Изображение поиска
|
SearchImage | string |
Изображение поиска, найдите в указанном элементе UIA. В зависимости от указанного типа изображения поиска это может содержать путь к файлу изображения (в конце директора или агента) или содержать base64 (текстовое представление) изображения для поиска. |
|
|
Альтернативный тип изображения поиска
|
AltSearchImageType | string |
Определяет, что представляет входной элемент "Альтернативный образ поиска". Если задано значение "Нет" или пустое, альтернативный образ поиска отсутствует. Если задано значение "Файл образа директора", то образ поиска — это путь к файлу, доступному директору. Если задано значение "Файл образа агента", то образ поиска — это путь к файлу, доступному агенту. Если задано значение Base64, то изображение поиска представляет собой представление изображения base64. |
|
|
Альтернативный образ поиска
|
AltSearchImage | string |
Необязательный альтернативный образ поиска для поиска в указанном элементе UIA. В зависимости от указанного типа изображения альтернативного поиска это может содержать путь к файлу изображения (в конце директора или агента) или содержать base64 (текстовое представление) изображения для поиска. Если указать альтернативный образ поиска, агент будет искать либо поиск, либо альтернативный образ поиска, и сообщить, какой из них был расположен. |
|
|
Максимальное отклонение цвета
|
MaxColourDeviation | integer |
Максимальное количество цветов пикселей элемента может отклоняться от цветов пикселей изображения поиска, прежде чем он не считается совпадением. 0 для отсутствия отклонения. Отклонение измеряется в значениях RGB. Например, #FF0000 отличается от #FE0102. Это позволяет игнорировать незначительные различия цвета. |
|
|
Максимальные различия пикселей
|
MaxPixelDifferences | integer |
Максимальное количество пикселей, которое может отличаться (выше максимального отклонения цвета), по всему изображению поиска, прежде чем изображение считается не соответствующим. Это позволяет игнорировать незначительные различия между изображениями, но более высокие значения могут увеличить время, необходимое для поиска изображения. При необходимости рекомендуется задать значение 0 и увеличить на небольшие суммы. Если задано значение выше 0, необходимо также задать значение Max последовательные различия пикселей. |
|
|
Максимальное число последовательных различий пикселей
|
MaxConsecutivePixelDifferences | integer |
Максимальное число пикселей, которое может отличаться (выше максимального отклонения цвета), в любой строке, прежде чем изображение считается не соответствующим. Это позволяет игнорировать незначительные различия между изображениями, но более высокие значения могут увеличить время, необходимое для поиска изображения. При необходимости рекомендуется задать значение 0 и увеличить на небольшие суммы. Если для параметра задано значение выше 0, необходимо также задать значение "Максимальное различие пикселей". |
|
|
Смещение X влево
|
LeftPixelXOffset | integer |
Необязательное смещение X для левого края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение по правому пикселю X
|
RightPixelXOffset | integer |
Необязательное смещение X для правого края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Смещение верхнего пикселя Y
|
TopPixelYOffset | integer |
Необязательное смещение Y для верхнего края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение нижнего пикселя Y
|
BottomPixelYOffset | integer |
Необязательное смещение Y для нижнего края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Единица смещения пикселей X
|
PixelXOffsetsUnit | string |
Установите значение Pixel (по умолчанию), если смещения X влево и вправо измеряются в пикселях. Задайте значение "Процент", если смещение x влево и вправо пикселя измеряется в процентах от ширины элемента. |
|
|
Единица смещения пикселей Y
|
PixelYOffsetsUnit | string |
Установите значение "Пиксель" (по умолчанию), если смещения верхнего и нижнего пикселей Y измеряются в пикселях. Если смещение верхнего и нижнего пикселей Y измеряется в процентах от высоты элемента. |
|
|
Индекс изображения поиска
|
SearchImageIndex | integer |
Установите значение 1, чтобы найти первый экземпляр изображения поиска (в направлении поиска) в элементе UIA. Установите значение 2 для второго экземпляра , .... , N для экземпляра Nth. Если вы также ищете альтернативное изображение, элемент UIA сканируется сначала для изображения поиска, а во-вторых, для альтернативного изображения, поиск запрошенного экземпляра этого конкретного изображения (т. е. агент ожидает один или другой, а не сочетание обоих изображений). |
|
|
Направление поиска изображений
|
ImageSearchDirection | string |
Направление поиска. "Сверху" выполняет поиск по строке сверху, сканируя слева направо в каждой строке. "Снизу" выполняет поиск по строке снизу, сканируя слева направо в каждой строке. "Слева" выполняет поиск по столбцу слева, сканируя сверху вниз в каждом столбце. "Справа" выполняет поиск по столбцу справа, сканируя сверху вниз в каждом столбце. Это можно использовать в сочетании с индексом изображений поиска, чтобы найти Nth изображение из верхней, нижней, левой или правой. Чтобы повысить производительность, выберите направление поиска, которое вы считаете, будет быстрее находить изображение. |
|
|
Скрыть агент
|
HideAgent | boolean |
Установите значение true, чтобы автоматически скрыть агент (если видимый), чтобы убедиться, что он не скрывает анализируемый элемент. |
|
|
Показать прямоугольник выделения
|
ShowHighlightRectangle | boolean |
Если задано значение true, агент IA-Connect будет выделять изображение на экране. Это может быть полезно во время разработки, чтобы визуализировать обнаружение правильного изображения. |
|
|
Секунды, чтобы ожидать, пока изображение поиска не существует
|
SecondsToWait | integer |
Количество секунд, дожидающегося, пока изображение поиска не будет видимо расположено в элементе UIA. Если изображение по-прежнему присутствует после этого времени, исключение будет возникать, если значение "Создать исключение, если изображение по-прежнему присутствует", имеет значение true, в противном случае действие будет сообщать о том, что изображение по-прежнему присутствует. |
|
|
Миллисекунда между поисками
|
MillisecondsBetweenSearches | integer |
Количество миллисекунда, ожидающего между каждым элементом UIA на экране. Так как распознавание изображений может быть дорогостоящим, задержка может помочь как снизить, так и распространить использование ЦП. Например, если вы ожидаете, что изображение может занять до 1 минуты, добавив 5000 миллисекунд (5 секунд) приостановку между проверками значительно уменьшит использование ЦП (значительно уменьшая количество проверок), но только небольшое влияние на время отклика. Минимально допустимое значение — 100 миллисекунд (1/10 секунд). |
|
|
Вызов исключения, если изображение по-прежнему присутствует
|
RaiseExceptionIfImageStillPresent | boolean |
Установите значение true, если IA-Connect должен вызвать исключение, если изображение по-прежнему присутствует после периода ожидания. |
|
|
Получение выходных данных для идентификатора потока
|
RetrieveOutputDataFromThreadId | integer |
Если ранее для параметра "Ожидание потока" задано значение false (что приводит к тому, что агент выполняет ожидание в фоновом потоке), укажите идентификатор потока агента для получения результатов. Этот идентификатор потока агента будет предоставлен предыдущим вызовом этого действия. В противном случае задайте значение 0 (значение по умолчанию). |
|
|
Ожидание потока
|
WaitForThread | boolean |
Задайте значение true, чтобы ожидать завершения потока агента; Агент будет ждать до тех пор, пока указано "Секунды, чтобы ждать, пока образ поиска не существует". Установите значение false, чтобы обойти ожидание; Агент будет продолжать ждать в фоновом потоке, но также будет доступен для следующего действия. Затем вы можете получить результаты позже с помощью действия "Ожидание успешного завершения потока агента", чтобы дождаться завершения потока агента, а затем повторно запустить это действие "Ожидание того, чтобы видимый образ поиска не существовал в элементе UIA" с входным параметром "Получение выходных данных для идентификатора потока" для идентификатора потока агента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Поиск изображения перед ожиданием
|
SearchImagePresentBeforeWait | boolean |
Для этого выходных данных задано значение true, если изображение поиска присутствовало в начале периода ожидания. Для этого выходных данных задано значение false, если изображение поиска не было представлено с самого начала. |
|
Изображение поиска по-прежнему присутствует после ожидания
|
SearchImageStillPresentAfterWait | boolean |
Для этого выходных данных задано значение true, если изображение поиска по-прежнему присутствует после периода ожидания. Для этого выходных данных задано значение false, если изображение поиска больше не присутствует, в течение периода ожидания (действие завершается сразу после того, как изображение больше не присутствует). |
|
Какой образ поиска по-прежнему присутствует
|
WhichSearchImageStillPresent | integer |
Для этого выходных данных задано значение 0, если изображения поиска по-прежнему отсутствуют, после периода ожидания. Установите значение 1, если изображение поиска по-прежнему присутствует, после периода ожидания. Установите значение 2, если альтернативный образ поиска по-прежнему присутствует после периода ожидания. |
|
Идентификатор потока
|
ThreadId | integer |
Если задано значение false "Ожидание потока" (что приводит к тому, что агент будет выполнять ожидание в фоновом потоке), этот результат будет содержать идентификатор потока агента, который можно использовать для мониторинга процесса действия и получения результатов позже, когда поток завершился. |
Задайте для элемента UIA значение числового диапазона
Задает значение элемента с числовым диапазоном, например полосой прокрутки.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Новое значение
|
NewValue | True | double |
Числовое значение диапазона для задания элемента. |
|
Новое значение — процент
|
NewValueIsPercentage | boolean |
Является ли новое значение процентом? |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Задайте для элемента UIA числовое значение
Задает значение элемента, имеющего числовые входные данные, например текстовое поле или полосу прокрутки.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Новое значение
|
NewValue | True | integer |
Числовое значение для задания элемента. |
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Вызов исключения, если проверка входных данных завершается ошибкой
|
RaiseExceptionIfInputValidationFails | boolean |
Если этот параметр включен, агент IA-Connect проверяет новое значение элемента после ввода запрошенного текста. Если новое значение не соответствует ожидаемому значению, создается исключение. Если этот вход имеет значение false (по умолчанию), в журнал будет введено предупреждение, но исключение не будет создано. |
|
|
Пример шаблона значений
|
TryValuePattern | boolean |
Если задано значение true (по умолчанию), агент IA-Connect попытается использовать шаблон значения UIA для выполнения действия ввода текста. Если шаблон значения UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон значений и немедленно возвращается к другим выбранным шаблонам. |
|
|
Попробуйте использовать устаревший шаблон
|
TryLegacyPattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать устаревший шаблон UIA для выполнения действия ввода текста, если шаблон значения недоступен (либо потому, что он отсутствует в элементе, либо из-за отключения его использования). |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Задать процент прокрутки элемента UIA
Задайте горизонтальный и /или вертикальный процент прокрутки указанного элемента, если прокрутка поддерживается этим элементом. Если элемент поддерживает шаблон прокрутки, можно применить это действие непосредственно к элементу и указать горизонтальное или вертикальное количество прокрутки (или оба). Если элемент не поддерживает шаблон прокрутки, то это действие возвращается к шаблонам "диапазон" или "значение", но их необходимо применить непосредственно к элементам управления полосы прокрутки, а не к самому элементу.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Процент горизонтальной прокрутки
|
HorizontalScrollPercentage | double |
Положение для горизонтальной прокрутки элемента (от 0 до 100 включительно, десятичных знаков, поддерживаемых) или -1, чтобы оставить позицию горизонтальной прокрутки без изменений. |
|
|
Процент вертикальной прокрутки
|
VerticalScrollPercentage | double |
Позиция для вертикальной прокрутки элемента (от 0 до 100 включительно, десятичных знаков, поддерживаемых) или -1, чтобы оставить позицию вертикальной прокрутки без изменений. |
|
|
Попробуйте прокрутить шаблон прокрутки
|
TryScrollPattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать шаблон прокрутки UIA для выполнения действия прокрутки. Если шаблон прокрутки UIA недоступен в выбранном элементе, агент IA-Connect откатится к другим выбранным шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон прокрутки и немедленно откатится к другим выбранным шаблонам. Порядок попыток шаблонов (если включен с помощью входных данных для этого действия) — прокрутка, значение диапазона и значение. |
|
|
Попробуйте использовать шаблон значения диапазона
|
TryRangeValuePattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать шаблон диапазона UIA для выполнения действия прокрутки. Если шаблон значения диапазона UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим выбранным шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон значения диапазона и немедленно возвращается к другим выбранным шаблонам. Порядок попыток шаблонов (если включен с помощью входных данных для этого действия) — прокрутка, значение диапазона и значение. |
|
|
Пример шаблона значений
|
TryValuePattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать шаблон значения UIA для выполнения действия прокрутки. Если шаблон значения UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим выбранным шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон значений и немедленно возвращается к другим выбранным шаблонам. Порядок попыток шаблонов (если включен с помощью входных данных для этого действия) — прокрутка, значение диапазона и значение. Предупреждение. Использование шаблона значений в элементе редактирования просто введет значение в элемент edit. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Результат команды
|
UIASetElementScrollPercentageResult | boolean |
Результат команды (успешное выполнение или сбой). |
|
Сообщение об ошибке
|
ErrorMessage | string |
Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке. |
Закрыть окно элемента UIA
Закрывает окно элемента. Обычно работает только в окнах или диалоговых окнах.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Изменение размера элемента UIA
Изменяет размер элемента UIA. Обычно это действие будет работать только с элементами Окна (которые имеют шаблон преобразования).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Изменение размера ширины
|
ResizeWidthType | string |
Тип размера ширины: Абсолютный или относительный. |
|
|
Новая ширина
|
NewWidth | True | integer |
Новая ширина элемента. Тип изменения размера (например, абсолютный или относительный) определяется входным типом "Изменить ширину". Чтобы оставить ширину без изменений, выберите значение 0 и задайте для параметра "Изменить размер ширины" значение "Относительный". |
|
Изменение размера высоты
|
ResizeHeightType | string |
Тип размера высоты: Абсолютный или относительный. |
|
|
Новая высота
|
NewHeight | True | integer |
Новая высота элемента. Тип изменения размера (например, абсолютный или относительный) определяется входным типом "Изменить высоту". Чтобы оставить высоту без изменений, выберите значение 0 и задайте для параметра "Изменить размер высоты" значение "Относительный". |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Результат команды
|
UIAResizeElementResult | boolean |
Результат команды (успешное выполнение или сбой). |
|
Сообщение об ошибке
|
ErrorMessage | string |
Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке. |
Имеет ли процесс окно Win32
Простое и быстрое действие Win32, которое сообщает, имеет ли процесс (указанный по имени) любые видимые окна. Окно должно существовать: IA-Connect не будет ждать. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя процесса поиска
|
SearchProcessName | True | string |
Имя процесса для поиска, например блокнота. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
В процессе есть окно
|
ProcessHasWindow | boolean |
Возвращает значение true, если процесс имеет видимое окно или значение false, если нет. |
Максимальное увеличение окна UIA
Максимизирует окно с указанным дескриптором UIA.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | True | integer |
Дескриптор UIA для окна, который будет максимизирован. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Нажмите элемент UIA
Нажимает элемент (обычно кнопка).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дождитесь завершения события кнопки
|
Wait | boolean |
Если служба автоматизации ожидает завершения события кнопки перед продолжением. Если задано значение true, это может привести к истечении времени ожидания, если кнопка открывает модальное диалоговое окно. |
|
|
Кнопка нажатия Win32
|
Win32ClickButton | boolean |
Если задано значение true, событие щелчка Win32 используется вместо использования UIA. Это событие щелчка "огонь и забыть", которое может быть полезно при работе с модальными диалогами, которые представлены после щелчка или элементов, которые не имеют шаблона вызова UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Попробуйте вызвать шаблон
|
TryInvokePattern | boolean |
Если задано значение true (по умолчанию), агент IA-Connect попытается использовать шаблон вызова UIA для выполнения действия нажатия (если для параметра "Кнопка нажатия Win32" не задано значение true). Если шаблон вызова UIA недоступен в выбранном элементе, агент IA-Connect возвращается к другим шаблонам (включен или отключен через другие входные данные этого действия). Если задано значение false, агент IA-Connect не будет пытаться использовать шаблон вызова и немедленно возвращается к другим выбранным шаблонам. |
|
|
Попробуйте использовать устаревший шаблон
|
TryLegacyPattern | boolean |
Если задано значение true, агент IA-Connect попытается использовать устаревший шаблон UIA для выполнения действия нажатия, если шаблон вызова недоступен (либо потому, что он отсутствует в элементе, либо из-за отключения его использования) и если "Кнопка нажатия Win32" имеет значение false. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Настройка окна UIA переднего плана
Переносит окно на передний план.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | True | integer |
Дескриптор UIA для окна, которое должно быть задано в качестве окна переднего плана. |
|
Окно переключения
|
ToggleWindow | boolean |
Следует ли переключать окно, пытаясь сосредоточиться или щелкнуть его? Это помогает убедиться, что окно надежно доставлено на передний план. |
|
|
Переключатель использует глобальный агент щелчка мыши слева
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
Если вы выбираете переключатель окна, это указывает, следует ли использовать глобальные щелчки мыши, чтобы сначала сосредоточиться на агенте IA-Connect. |
|
|
Переключение задержки в секундах
|
ToggleDelay | double |
Если выбрать переключатель окна, это указывает паузу после переключения. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Настройка режима поиска элементов UIA
Выберите режим поиска элементов UIA, который должен использоваться агентом IA-Connect при выполнении действий UIA. Как правило, это действие будет использоваться только в том случае, если у вас возникла проблема с режимом по умолчанию (найти все).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Режим поиска элементов UIA
|
UIAElementSearchMode | True | string |
Используемый режим поиска элементов UIA. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Результат команды
|
SetUIAElementSearchModeResult | boolean |
Результат команды (успешное выполнение или сбой). |
|
Сообщение об ошибке
|
ErrorMessage | string |
Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке. |
Ожидание видимого изображения поиска в элементе UIA
Ожидает, пока изображение поиска, предоставленное в качестве входных данных для этого действия, явно находится в элементе UIA на экране или указанное время прошло. Элемент должен быть доставлен на передний план, так как агент принимает снимок экрана с координатами элемента и выполняет поиск предоставленного изображения поиска на снимках экрана. Элемент UIA должен существовать с начала. Действие завершается сразу после того, как изображение будет расположено.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Тип изображения поиска
|
SearchImageType | string |
Определяет, что представляет входные данные "Поиск изображения". Если задано значение "Файл образа директора", то образ поиска — это путь к файлу, доступному директору. Если задано значение "Файл образа агента", то образ поиска — это путь к файлу, доступному агенту. Если задано значение Base64, то изображение поиска представляет собой представление изображения base64. |
|
|
Изображение поиска
|
SearchImage | string |
Изображение поиска, найдите в указанном элементе UIA. В зависимости от указанного типа изображения поиска это может содержать путь к файлу изображения (в конце директора или агента) или содержать base64 (текстовое представление) изображения для поиска. |
|
|
Альтернативный тип изображения поиска
|
AltSearchImageType | string |
Определяет, что представляет входной элемент "Альтернативный образ поиска". Если задано значение "Нет" или пустое, альтернативный образ поиска отсутствует. Если задано значение "Файл образа директора", то образ поиска — это путь к файлу, доступному директору. Если задано значение "Файл образа агента", то образ поиска — это путь к файлу, доступному агенту. Если задано значение Base64, то изображение поиска представляет собой представление изображения base64. |
|
|
Альтернативный образ поиска
|
AltSearchImage | string |
Необязательный альтернативный образ поиска для поиска в указанном элементе UIA. В зависимости от указанного типа изображения альтернативного поиска это может содержать путь к файлу изображения (в конце директора или агента) или содержать base64 (текстовое представление) изображения для поиска. Если указать альтернативный образ поиска, агент будет искать либо поиск, либо альтернативный образ поиска, и сообщить, какой из них был расположен. |
|
|
Максимальное отклонение цвета
|
MaxColourDeviation | integer |
Максимальное количество цветов пикселей элемента может отклоняться от цветов пикселей изображения поиска, прежде чем он не считается совпадением. 0 для отсутствия отклонения. Отклонение измеряется в значениях RGB. Например, #FF0000 отличается от #FE0102. Это позволяет игнорировать незначительные различия цвета. |
|
|
Максимальные различия пикселей
|
MaxPixelDifferences | integer |
Максимальное количество пикселей, которое может отличаться (выше максимального отклонения цвета), по всему изображению поиска, прежде чем изображение считается не соответствующим. Это позволяет игнорировать незначительные различия между изображениями, но более высокие значения могут увеличить время, необходимое для поиска изображения. При необходимости рекомендуется задать значение 0 и увеличить на небольшие суммы. Если задано значение выше 0, необходимо также задать значение Max последовательные различия пикселей. |
|
|
Максимальное число последовательных различий пикселей
|
MaxConsecutivePixelDifferences | integer |
Максимальное число пикселей, которое может отличаться (выше максимального отклонения цвета), в любой строке, прежде чем изображение считается не соответствующим. Это позволяет игнорировать незначительные различия между изображениями, но более высокие значения могут увеличить время, необходимое для поиска изображения. При необходимости рекомендуется задать значение 0 и увеличить на небольшие суммы. Если для параметра задано значение выше 0, необходимо также задать значение "Максимальное различие пикселей". |
|
|
Смещение X влево
|
LeftPixelXOffset | integer |
Необязательное смещение X для левого края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение по правому пикселю X
|
RightPixelXOffset | integer |
Необязательное смещение X для правого края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Смещение верхнего пикселя Y
|
TopPixelYOffset | integer |
Необязательное смещение Y для верхнего края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение нижнего пикселя Y
|
BottomPixelYOffset | integer |
Необязательное смещение Y для нижнего края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Единица смещения пикселей X
|
PixelXOffsetsUnit | string |
Установите значение Pixel (по умолчанию), если смещения X влево и вправо измеряются в пикселях. Задайте значение "Процент", если смещение x влево и вправо пикселя измеряется в процентах от ширины элемента. |
|
|
Единица смещения пикселей Y
|
PixelYOffsetsUnit | string |
Установите значение "Пиксель" (по умолчанию), если смещения верхнего и нижнего пикселей Y измеряются в пикселях. Если смещение верхнего и нижнего пикселей Y измеряется в процентах от высоты элемента. |
|
|
Индекс изображения поиска
|
SearchImageIndex | integer |
Установите значение 1, чтобы найти первый экземпляр изображения поиска (в направлении поиска) в элементе UIA. Установите значение 2 для второго экземпляра , .... , N для экземпляра Nth. Если вы также ищете альтернативное изображение, элемент UIA сканируется сначала для изображения поиска, а во-вторых, для альтернативного изображения, поиск запрошенного экземпляра этого конкретного изображения (т. е. агент ожидает один или другой, а не сочетание обоих изображений). |
|
|
Направление поиска изображений
|
ImageSearchDirection | string |
Направление поиска. "Сверху" выполняет поиск по строке сверху, сканируя слева направо в каждой строке. "Снизу" выполняет поиск по строке снизу, сканируя слева направо в каждой строке. "Слева" выполняет поиск по столбцу слева, сканируя сверху вниз в каждом столбце. "Справа" выполняет поиск по столбцу справа, сканируя сверху вниз в каждом столбце. Это можно использовать в сочетании с индексом изображений поиска, чтобы найти Nth изображение из верхней, нижней, левой или правой. Чтобы повысить производительность, выберите направление поиска, которое вы считаете, будет быстрее находить изображение. |
|
|
Скрыть агент
|
HideAgent | boolean |
Установите значение true, чтобы автоматически скрыть агент (если видимый), чтобы убедиться, что он не скрывает анализируемый элемент. |
|
|
Возвращать координаты экрана как физические
|
ReturnPhysicalCoordinates | boolean |
Задайте значение true для возвращаемых координат экрана в виде физических координат. Задайте значение false для координат экрана, возвращаемых как виртуальные координаты. Если базовое масштабирование дисплея равно 100%, физические и виртуальные координаты одинаковы. Координаты элементов всегда возвращаются в виде виртуальных координат. |
|
|
Показать прямоугольник выделения
|
ShowHighlightRectangle | boolean |
Если задано значение true, агент IA-Connect будет выделять изображение на экране. Это может быть полезно во время разработки, чтобы визуализировать обнаружение правильного изображения. |
|
|
Секунды ожидания изображения поиска
|
SecondsToWait | integer |
Количество секунд, дожидающегося расположения изображения поиска в элементе UIA. Если изображение не расположено, исключение будет возникать, если значение "Создать исключение, если изображение не найдено", имеет значение true, в противном случае действие сообщает о том, что изображение не найдено. |
|
|
Миллисекунда между поисками
|
MillisecondsBetweenSearches | integer |
Количество миллисекунда, ожидающего между каждым элементом UIA на экране. Так как распознавание изображений может быть дорогостоящим, задержка может помочь как снизить, так и распространить использование ЦП. Например, если вы ожидаете, что изображение может занять до 1 минуты, добавив 5000 миллисекунд (5 секунд) приостановку между проверками значительно уменьшит использование ЦП (значительно уменьшая количество проверок), но только небольшое влияние на время отклика. Минимально допустимое значение — 100 миллисекунд (1/10 секунд). |
|
|
Вызов исключения, если изображение не найдено
|
RaiseExceptionIfImageNotFound | boolean |
Задайте значение true, если IA-Connect должен вызвать исключение, если изображение не удалось найти после периода ожидания. |
|
|
Получение выходных данных для идентификатора потока
|
RetrieveOutputDataFromThreadId | integer |
Если ранее для параметра "Ожидание потока" задано значение false (что приводит к тому, что агент выполняет ожидание в фоновом потоке), укажите идентификатор потока агента для получения результатов. Этот идентификатор потока агента будет предоставлен предыдущим вызовом этого действия. В противном случае задайте значение 0 (значение по умолчанию). |
|
|
Ожидание потока
|
WaitForThread | boolean |
Задайте значение true, чтобы ожидать завершения потока агента; Агент будет ждать до тех пор, пока указано значение "Секунды, чтобы ждать изображения поиска". Установите значение false, чтобы обойти ожидание; Агент будет продолжать ждать в фоновом режиме, но также будет доступен для следующего действия. Затем можно получить результаты позже с помощью действия "Ожидание успешного завершения потока агента", чтобы дождаться завершения потока агента, а затем повторно запустить это действие "Ожидание видимого изображения поиска в элементе UIA" с входным значением "Получение выходных данных для идентификатора потока" агента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Поиск изображения
|
SearchImageLocated | boolean |
Для этого выходных данных будет задано значение true, если изображение поиска было расположено. Для этого выходных данных будет задано значение false, если изображение поиска не было расположено. |
|
Какой образ поиска расположен
|
WhichSearchImageLocated | integer |
Для этого выходных данных задано значение 0, если изображения поиска не были расположены. Установите значение 1, если изображение поиска было расположено. Установите значение 2, если был расположен альтернативный образ поиска. |
|
Изображение совпадает с ограничивающим прямоугольним элементом слева от пикселя
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Виртуальная координата X левого пикселя, соответствующего указанному изображению, относительно виртуального верхнего верхнего слева элемента. |
|
Изображение совпадает с ограничивающим прямоугольним элементом справа
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Виртуальная координата X правого пикселя, соответствующего указанному изображению, относительно виртуального верхнего верхнего слева элемента. |
|
Изображение сопоставления ограничивающих прямоугольник элемента верхнего пикселя
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Виртуальная координата Y верхнего пикселя, соответствующего указанному изображению, относительно элемента виртуального верхнего верхнего слева. |
|
Пиксель нижнего элемента ограничивающего прямоугольника с сопоставлением изображения
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Виртуальная координата Y нижнего большинства пикселей, соответствующих указанному изображению, относительно виртуального верхнего верхнего края элемента. |
|
Изображение совпадает с ограничивающим прямоугольним элементом в центре X пикселей
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Виртуальная координата X центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению, относительно виртуального верхнего верхнего края элемента. |
|
Изображение совпадает с ограничивающим прямоугольним элементом в центре Y пикселей
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Виртуальная координата Y центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению, относительно виртуального верхнего верхнего края элемента. |
|
Экран левого экрана с ограничивающим полем сопоставления изображений
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Пиксель экрана X-координата левого пикселя, соответствующего указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение совпадает с ограничивающим прямоугольним экраном вправо
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Пиксель экрана X-координаты правого пикселя, соответствующего указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение сопоставления ограничивающего прямоугольного экрана верхнего пикселя
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Координата пикселя Y в верхней части экрана, соответствующего указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение соответствует ограничивающим прямоугольнику снизу пикселя
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Координата пикселя экрана Y нижнего большинства пикселей, соответствующих указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение совпадает с ограничивающим полем экрана в центре X пикселей
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Пиксель экрана X-координата центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение сопоставления ограничивающих прямоугольник экранного центра Y пикселей
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Координата пикселя экрана Y центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Идентификатор потока
|
ThreadId | integer |
Если задано значение false "Ожидание потока" (что приводит к тому, что агент будет выполнять ожидание в фоновом потоке), этот результат будет содержать идентификатор потока агента, который можно использовать для мониторинга процесса действия и получения результатов позже, когда поток завершился. |
Ожидание главного окна идентификатора процесса UIA
Простое и быстрое действие Win32, которое ожидает существования основного окна процесса (указанного идентификатором процесса) и возвращает дескриптор. Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор процесса поиска
|
ProcessId | True | integer |
Идентификатор процесса ожидания (как указано действием "Запуск процесса" в действиях IA-Connect среды или сеанса). |
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, ожидающего главного окна процесса. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если элемент существует или false, если нет. |
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
Ожидание главного окна процесса UIA
Простое и быстрое действие Win32, которое ожидает указанного времени для главного окна процесса (указанного по имени) перед возвратом дескриптора. Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя процесса поиска
|
SearchProcessName | True | string |
Имя процесса для поиска, например блокнота. |
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, ожидающего главного окна процесса. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если окно существует или значение false, если нет. |
Ожидание классического элемента UIA
Ожидает, пока элемент рабочего стола (обычно окно) будет существовать.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Если задано (значение 1 или выше), поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым (или 0). |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, дожидающегося существования элемента. |
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, возвращается только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Вызов исключения, если элемент не найден
|
RaiseExceptionIfElementNotFound | boolean |
Следует ли IA-Connect вызывать исключение, если элемент UIA не существует после периода ожидания? |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если элемент существует или false, если нет. |
|
Дескриптор элемента
|
ElementHandle | integer |
Дескриптор UIA для элемента. Это можно использовать в качестве входных данных для дальнейших действий UIA, действующих в этом элементе. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
Ожидание элемента UIA
Ожидает, пока элемент (обычно отдельный элемент в окне, например кнопка или область ввода текста) будет существовать.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Если задано (значение 1 или выше), поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым (или 0). |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, дожидающегося существования элемента. |
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, возвращается только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Вызов исключения, если элемент не найден
|
RaiseExceptionIfElementNotFound | boolean |
Следует ли IA-Connect вызывать исключение, если элемент UIA не существует после периода ожидания? |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если элемент существует или false, если нет. |
|
Дескриптор элемента
|
ElementHandle | integer |
Дескриптор UIA для элемента. Это можно использовать в качестве входных данных для дальнейших действий UIA, действующих в этом элементе. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
Переключение элемента UIA
Переключает элемент (обычно флажок или переключатель). Это дает элементу противоположное состояние текущего состояния (например, проверка становится снятой и наоборот). Если вы хотите задать определенное состояние, используйте действие Check element.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Перемещение элемента UIA
Перемещает элемент UIA в указанную позицию на экране. Обычно это действие будет работать только с элементами Окна (которые имеют шаблон преобразования).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Горизонтальный тип перемещения
|
HorizontalMovementType | string |
Тип перемещения: Абсолютный или относительный. |
|
|
Горизонтальное положение
|
HorizontalPosition | True | integer |
Новая горизонтальная позиция элемента. Тип перемещения (например, абсолютный или относительный) определяется входным типом горизонтального перемещения. Чтобы оставить горизонтальное положение без изменений, выберите значение 0 и задайте для параметра "Горизонтальный тип перемещения" значение "Относительный". |
|
Тип вертикального перемещения
|
VerticalMovementType | string |
Тип перемещения: Абсолютный или относительный. |
|
|
Вертикальное положение
|
VerticalPosition | True | integer |
Новая вертикальная позиция элемента. Тип перемещения (например, абсолютный или относительный) определяется входным типом вертикального перемещения. Чтобы оставить вертикальное положение без изменений, выберите значение 0 и задайте для параметра "Вертикальный тип перемещения" значение "Относительный". |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Результат команды
|
UIAMoveElementResult | boolean |
Результат команды (успешное выполнение или сбой). |
|
Сообщение об ошибке
|
ErrorMessage | string |
Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке. |
Подождите, пока классический элемент UIA не существует
Ожидает, что элемент рабочего стола (обычно окно) больше не существует.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Если задано (значение 1 или выше), поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым (или 0). |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Секунды ожидания
|
SecondsToWait | True | integer |
Максимальное количество секунд, дожидающегося, пока элемент не существует. |
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, возвращается только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Вызов исключения, если элемент по-прежнему существует
|
RaiseExceptionIfElementStillExists | boolean |
Следует ли IA-Connect вызывать исключение, если элемент UIA по-прежнему существует после периода ожидания? |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует до ожидания
|
ElementExistsBeforeWait | boolean |
Возвращает значение true, если элемент существовал перед ожиданием или значением false, если нет. |
|
Элемент существует после ожидания
|
ElementExistsAfterWait | boolean |
Возвращает значение true, если элемент существовал после ожидания или false, если нет. |
Поиск видимого изображения поиска в элементе UIA
Возвращает значение, указывающее, находится ли изображение поиска, предоставленное в качестве входных данных для этого действия, видимо, в элементе UIA на экране. Элемент должен быть доставлен на передний план, так как агент принимает снимок экрана с координатами элемента и выполняет поиск предоставленного изображения поиска на снимках экрана.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Тип изображения поиска
|
SearchImageType | string |
Определяет, что представляет входные данные "Поиск изображения". Если задано значение "Файл образа директора", то образ поиска — это путь к файлу, доступному директору. Если задано значение "Файл образа агента", то образ поиска — это путь к файлу, доступному агенту. Если задано значение Base64, то изображение поиска представляет собой представление изображения base64. |
|
|
Изображение поиска
|
SearchImage | string |
Изображение поиска, найдите в указанном элементе UIA. В зависимости от указанного типа изображения поиска это может содержать путь к файлу изображения (в конце директора или агента) или содержать base64 (текстовое представление) изображения для поиска. |
|
|
Альтернативный тип изображения поиска
|
AltSearchImageType | string |
Определяет, что представляет входной элемент "Альтернативный образ поиска". Если задано значение "Нет" или пустое, альтернативный образ поиска отсутствует. Если задано значение "Файл образа директора", то образ поиска — это путь к файлу, доступному директору. Если задано значение "Файл образа агента", то образ поиска — это путь к файлу, доступному агенту. Если задано значение Base64, то изображение поиска представляет собой представление изображения base64. |
|
|
Альтернативный образ поиска
|
AltSearchImage | string |
Необязательный альтернативный образ поиска для поиска в указанном элементе UIA. В зависимости от указанного типа изображения альтернативного поиска это может содержать путь к файлу изображения (в конце директора или агента) или содержать base64 (текстовое представление) изображения для поиска. Если указать альтернативный образ поиска, агент будет искать либо поиск, либо альтернативный образ поиска, и сообщить, какой из них был расположен. |
|
|
Максимальное отклонение цвета
|
MaxColourDeviation | integer |
Максимальное количество цветов пикселей элемента может отклоняться от цветов пикселей изображения поиска, прежде чем он не считается совпадением. 0 для отсутствия отклонения. Отклонение измеряется в значениях RGB. Например, #FF0000 отличается от #FE0102. Это позволяет игнорировать незначительные различия цвета. |
|
|
Максимальные различия пикселей
|
MaxPixelDifferences | integer |
Максимальное количество пикселей, которое может отличаться (выше максимального отклонения цвета), по всему изображению поиска, прежде чем изображение считается не соответствующим. Это позволяет игнорировать незначительные различия между изображениями, но более высокие значения могут увеличить время, необходимое для поиска изображения. При необходимости рекомендуется задать значение 0 и увеличить на небольшие суммы. Если задано значение выше 0, необходимо также задать значение Max последовательные различия пикселей. |
|
|
Максимальное число последовательных различий пикселей
|
MaxConsecutivePixelDifferences | integer |
Максимальное число последовательных пикселей, которое может отличаться (выше максимального отклонения цвета), в любой строке, прежде чем изображение считается не соответствующим. Это позволяет игнорировать незначительные различия между изображениями, но более высокие значения могут увеличить время, необходимое для поиска изображения. При необходимости рекомендуется задать значение 0 и увеличить на небольшие суммы. Если для параметра задано значение выше 0, необходимо также задать значение "Максимальное различие пикселей". |
|
|
Смещение X влево
|
LeftPixelXOffset | integer |
Необязательное смещение X для левого края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение по правому пикселю X
|
RightPixelXOffset | integer |
Необязательное смещение X для правого края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Смещение верхнего пикселя Y
|
TopPixelYOffset | integer |
Необязательное смещение Y для верхнего края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение нижнего пикселя Y
|
BottomPixelYOffset | integer |
Необязательное смещение Y для нижнего края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Единица смещения пикселей X
|
PixelXOffsetsUnit | string |
Установите значение Pixel (по умолчанию), если смещения X влево и вправо измеряются в пикселях. Задайте значение "Процент", если смещение x влево и вправо пикселя измеряется в процентах от ширины элемента. |
|
|
Единица смещения пикселей Y
|
PixelYOffsetsUnit | string |
Установите значение "Пиксель" (по умолчанию), если смещения верхнего и нижнего пикселей Y измеряются в пикселях. Если смещение верхнего и нижнего пикселей Y измеряется в процентах от высоты элемента. |
|
|
Индекс изображения поиска
|
SearchImageIndex | integer |
Установите значение 1, чтобы найти первый экземпляр изображения поиска (в направлении поиска) в элементе UIA. Установите значение 2 для второго экземпляра , .... , N для экземпляра Nth. Если вы также ищете альтернативное изображение, элемент UIA сканируется сначала для изображения поиска, а во-вторых, для альтернативного изображения, поиск запрошенного экземпляра этого конкретного изображения (т. е. агент ожидает один или другой, а не сочетание обоих изображений). |
|
|
Направление поиска изображений
|
ImageSearchDirection | string |
Направление поиска. "Сверху" выполняет поиск по строке сверху, сканируя слева направо в каждой строке. "Снизу" выполняет поиск по строке снизу, сканируя слева направо в каждой строке. "Слева" выполняет поиск по столбцу слева, сканируя сверху вниз в каждом столбце. "Справа" выполняет поиск по столбцу справа, сканируя сверху вниз в каждом столбце. Это можно использовать в сочетании с индексом изображений поиска, чтобы найти Nth изображение из верхней, нижней, левой или правой. Чтобы повысить производительность, выберите направление поиска, которое вы считаете, будет быстрее находить изображение. |
|
|
Скрыть агент
|
HideAgent | boolean |
Установите значение true, чтобы автоматически скрыть агент (если видимый), чтобы убедиться, что он не скрывает анализируемый элемент. |
|
|
Возвращать координаты экрана как физические
|
ReturnPhysicalCoordinates | boolean |
Задайте значение true для возвращаемых координат экрана в виде физических координат. Задайте значение false для координат экрана, возвращаемых как виртуальные координаты. Если базовое масштабирование дисплея равно 100%, физические и виртуальные координаты одинаковы. Координаты элементов всегда возвращаются в виде виртуальных координат. |
|
|
Показать прямоугольник выделения
|
ShowHighlightRectangle | boolean |
Если задано значение true, агент IA-Connect будет выделять изображение на экране. Это может быть полезно во время разработки, чтобы визуализировать обнаружение правильного изображения. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Поиск изображения
|
SearchImageLocated | boolean |
Установите значение true, если изображение поиска было расположено. Установите значение false, если изображение поиска не было расположено. |
|
Какой образ поиска расположен
|
WhichSearchImageLocated | integer |
Установите значение 0, если не было расположено изображений поиска. Установите значение 1, если изображение поиска было расположено. Установите значение 2, если был расположен альтернативный образ поиска. |
|
Изображение совпадает с ограничивающим прямоугольним элементом слева от пикселя
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Виртуальная координата X левого пикселя, соответствующего указанному изображению, относительно виртуального верхнего верхнего слева элемента. |
|
Изображение совпадает с ограничивающим прямоугольним элементом справа
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Виртуальная координата X правого пикселя, соответствующего указанному изображению, относительно виртуального верхнего верхнего слева элемента. |
|
Изображение сопоставления ограничивающих прямоугольник элемента верхнего пикселя
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Виртуальная координата Y верхнего пикселя, соответствующего указанному изображению, относительно элемента виртуального верхнего верхнего слева. |
|
Пиксель нижнего элемента ограничивающего прямоугольника с сопоставлением изображения
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Виртуальная координата Y нижнего большинства пикселей, соответствующих указанному изображению, относительно виртуального верхнего верхнего края элемента. |
|
Изображение совпадает с ограничивающим прямоугольним элементом в центре X пикселей
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Виртуальная координата X центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению, относительно виртуального верхнего верхнего края элемента. |
|
Изображение совпадает с ограничивающим прямоугольним элементом в центре Y пикселей
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Виртуальная координата Y центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению, относительно виртуального верхнего верхнего края элемента. |
|
Экран левого экрана с ограничивающим полем сопоставления изображений
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Пиксель экрана X-координата левого пикселя, соответствующего указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение совпадает с ограничивающим прямоугольним экраном вправо
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Пиксель экрана X-координаты правого пикселя, соответствующего указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение сопоставления ограничивающего прямоугольного экрана верхнего пикселя
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Координата пикселя Y в верхней части экрана, соответствующего указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение соответствует ограничивающим прямоугольнику снизу пикселя
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Координата пикселя экрана Y нижнего большинства пикселей, соответствующих указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение совпадает с ограничивающим полем экрана в центре X пикселей
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Пиксель экрана X-координата центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Изображение сопоставления ограничивающих прямоугольник экранного центра Y пикселей
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Координата пикселя экрана Y центра ограничивающего поля, содержащего пиксели, соответствующие указанному изображению. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
Поиск первого родительского элемента UIA
Выполняет поиск по иерархии дерева UIA для первого родительского элемента, соответствующего условиям поиска. Родительский элемент определяется как элемент, который находится на следующем уровне вверх по дереву UIA и почти всегда является содержащим элементом.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор элемента
|
ElementHandle | True | integer |
Дескриптор UIA для целевого элемента. |
|
Поиск родительского элемента локализованного типа элемента управления
|
SearchParentLocalizedControlType | string |
Родительский элемент UIA локализованный тип элемента управления для поиска. Это можно обнаружить с помощью проверки. |
|
|
Поиск типа элемента управления родительским элементом
|
SearchParentControlType | integer |
Родительский тип элемента управления UIA (не локализованное целое число) для поиска. Это одно и то же значение на разных языках. |
|
|
Максимальное число родителей для обработки
|
MaxParentsToProcess | integer |
Максимальное количество родительских элементов для обработки. По умолчанию это значение равно 50. |
|
|
Вызов исключения, если родительский элемент не найден
|
RaiseExceptionIfParentElementNotFound | boolean |
Следует ли IA-Connect вызывать исключение, если элемент UIA поиска не расположен? |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Найденный родительский элемент
|
ParentElementFound | boolean |
Возвращает значение true, если найден родительский элемент UIA поиска. |
|
Дескриптор родительского элемента
|
ParentElementHandle | integer |
Дескриптор UIA для расположенного родительского элемента. Это можно использовать в качестве входных данных для дальнейших действий UIA, действующих в этом элементе. |
|
Имя родительского элемента
|
ParentElementName | string |
Имя UIA расположенного родительского элемента. |
|
Имя класса родительского элемента
|
ParentElementClassName | string |
Имя класса UIA расположенного родительского элемента. |
|
Идентификатор автоматизации родительского элемента
|
ParentElementAutomationId | string |
Идентификатор автоматизации UIA расположенного родительского элемента. |
|
Локализованный тип элемента родительского элемента управления
|
ParentElementLocalizedControlType | string |
Локализованный тип элемента управления UIA расположенного родительского элемента. |
Получение дескриптора UIA для главного окна идентификатора процесса
Простое и быстрое действие Win32, которое возвращает дескриптор для любого основного окна процесса (указанного идентификатором процесса). Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор процесса поиска
|
ProcessId | True | integer |
Идентификатор процесса ожидания (как указано действием "Запуск процесса" в действиях IA-Connect среды или сеанса). |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
Получение дескриптора UIA для главного окна процесса
Простое и быстрое действие Win32, которое возвращает дескриптор для любого основного окна процесса (указанного по имени). Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main. Окно должно существовать: IA-Connect не будет ждать. Рекомендуется использовать действие "Ожидание классического элемента", которое является более мощным.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя процесса поиска
|
SearchProcessName | True | string |
Имя процесса для поиска, например блокнота. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
Получение дескриптора UIA для окна Win32 верхнего уровня
Быстрое действие Win32, которое возвращает дескриптор UIA для любого окна Win32 верхнего уровня с указанным именем класса или заголовком окна, или можно указать более сложные фильтры поиска, включая подстановочные знаки. Окно верхнего уровня — это окно, подключенное к рабочему столу. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Окно должно существовать, IA-Connect не будет ждать. Чаще всего используется действие UIA "Существует ли классический элемент UIA", которое является более мощным, но это действие Win32 обычно выполняется быстрее.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя класса поиска
|
SearchClassName | string |
Имя класса элемента окна верхнего уровня для поиска, например "Блокнот". |
|
|
Заголовок окна поиска
|
SearchWindowTitle | string |
Заголовок окна верхнего уровня для поиска. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Необязательный идентификатор процесса, который владеет окном (например, как показано в выходных данных действия "Запуск процесса" в действиях IA-Connect среды или сеанса). Установите значение 0, чтобы не выполнять поиск по идентификатору процесса. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов для доступных свойств окна. Пример 1: [ширина] < 200. Пример 2. [Заголовок], например "*Excel" AND [IsMinimize] = False AND [IsResizeable] = True. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько окон соответствуют поиску, это позволяет указать свойство окна для сортировки по. Это будет использоваться в сочетании с "Индекс соответствия" для выбора требуемого окна. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Индекс сопоставления" равно 1, то будет возвращено окно сопоставления, ближайшее к верхней части экрана. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько окон соответствуют поиску, должно совпадать со значением "Совпадение индекса" в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
Получение дескриптора UIA для основного окна фокусированного элемента
Возвращает дескриптор основного окна текущего элемента UIA. Окно Main обычно является основным окном приложения: диалоговое окно входа или вложенное окно обычно не является окном Main.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента окна. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента окна. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента окна. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA элемента окна. |
Получение дескриптора UIA для рабочего стола
Возвращает дескриптор для рабочего стола. Это устаревшее действие, так как дескриптор "-2" можно использовать для ссылки на элемент рабочего стола, но и потому, что есть много действий, которые могут выполнять поиск относительно рабочего стола (например, ожидание элемента рабочего стола).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для рабочего стола. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента desktop. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента desktop. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента desktop. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA для классического элемента. |
Получение дескриптора UIA для фокусированного элемента
Возвращает дескриптор для текущего элемента UIA.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | integer |
Дескриптор UIA для окна. Это можно использовать в качестве входных данных для дальнейших действий UIA в этом окне. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
Получение дескриптора родительского элемента UIA
Возвращает дескриптор родительского элемента указанного элемента. Родительский элемент определяется как элемент, который находится на следующем уровне вверх по дереву UIA и почти всегда является содержащим элементом.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор элемента
|
ElementHandle | True | integer |
Дескриптор UIA для целевого элемента. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Дескриптор родительского элемента
|
ParentElementHandle | integer |
Дескриптор UIA для родительского элемента. |
Получение значения метки элемента UIA
Возвращает значение метки в элементе.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Значение метки элемента
|
ElementLabelValue | string |
Значение метки в элементе. |
Получение значения элемента UIA
Возвращает значение элемента. Значение обычно связано с областью ввода текста, но многие элементы могут иметь это свойство.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Значение элемента
|
ElementValue | string |
Значение элемента. |
Получение классических элементов UIA
Возвращает список всех окон и диалоговых окон на рабочем столе.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Локализованный тип элемента поиска
|
SearchElementLocalizedControlType | string |
Отфильтруйте результаты по локализованным типу элемента управления. |
|
|
Идентификатор процесса поиска
|
SearchProcessID | integer |
Если задано, поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Первый элемент для возврата
|
FirstItemToReturn | integer |
Индекс элемента первого элемента, возвращаемого начиная с 1. Если вы хотите вернуть элементы в обратном порядке (с нижней части дерева UIA), можно также указать отрицательный индекс, начиная с -1. |
|
|
Максимальное количество возвращаемых элементов
|
MaxItemsToReturn | integer |
Максимальное количество возвращаемых элементов или 0 для возврата всех элементов. |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, возвращается только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Количество найденных элементов
|
NumberOfElementsFound | integer |
Количество элементов рабочего стола, которые соответствуют критериям поиска. |
|
Количество возвращаемых элементов
|
NumberOfElementsReturned | integer |
Количество возвращаемых классических элементов (это может быть меньше числа элементов, найденных при указании максимального числа возвращаемых элементов). |
|
Свойства элемента
|
ElementProperties | array of object |
Свойства элементов классических элементов обнаружили, что соответствуют критериям поиска. |
|
items
|
ElementProperties | object |
Получение нескольких свойств родительского элемента UIA
Возвращает иерархическое дерево родительских элементов указанного элемента вплоть до рабочего стола (корневого уровня). Родительский элемент определяется как элемент, который находится на следующем уровне вверх по дереву UIA и почти всегда является содержащим элементом.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор элемента
|
ElementHandle | True | integer |
Дескриптор UIA для целевого элемента. |
|
Максимальное число родителей для обработки
|
MaxParentsToProcess | integer |
Максимальное количество родительских элементов для обработки. По умолчанию это значение равно 50. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Родительские элементы UIA
|
UIAParentElements | array of object |
Список всех расположенных родительских элементов (и их свойств). Возвращаемые свойства совпадают с значениями, возвращаемыми действием "Получение нескольких свойств элемента". |
|
items
|
UIAParentElements | object | |
|
Количество возвращаемых родительских элементов
|
NumberOfParentElementsReturned | integer |
Количество родительских элементов, возвращаемых из поиска. |
Получение нескольких свойств элемента UIA
Возвращает свойства нескольких элементов. Это может быть полезно, если вы не уверены, какие поля содержат необходимые значения свойств.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Локализованный тип элемента поиска
|
SearchElementLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск потомков
|
SearchDescendants | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Возвращаемое значение элемента
|
ReturnElementValue | boolean |
Если задано значение true, чем значение расположенного элемента, будет возвращено. |
|
|
Первый элемент для возврата
|
FirstItemToReturn | integer |
Индекс элемента первого элемента, возвращаемого начиная с 1. Если вы хотите вернуть элементы в обратном порядке (с нижней части дерева UIA), можно также указать отрицательный индекс, начиная с -1. |
|
|
Максимальное количество возвращаемых элементов
|
MaxItemsToReturn | integer |
Максимальное количество возвращаемых элементов или 0 для возврата всех элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Количество найденных элементов
|
NumberOfElementsFound | integer |
Количество элементов, которые соответствуют критериям поиска. |
|
Количество возвращаемых элементов
|
NumberOfElementsReturned | integer |
Количество возвращаемых элементов (это может быть меньше числа элементов, найденных при указании максимального числа возвращаемых элементов). |
|
Свойства элемента
|
ElementProperties | array of object |
Свойства элементов, найденные в соответствии с критериями поиска. |
|
items
|
ElementProperties | object |
Получение нескольких элементов UIA в виде таблицы
Перечисляет значения дочерних элементов указанного родительского элемента и возвращается в формате таблицы. Это можно использовать для возврата строк и столбцов данных из элементов, которые не являются технически таблицами, но были организованы вместе в структуру таблицы. Это действие также можно использовать для получения результатов из предыдущего выполнения этого действия, запускаемого в качестве потока агента.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Поиск подэлемента заголовка ячейки локализованного типа элемента управления
|
SearchCellHeaderSubElementLocalizedControlType | string |
Подэлемент заголовка ячейки локализованный тип элемента управления для поиска. Оставьте пустым, если не ищет заголовки ячеек. |
|
|
Тип элемента управления подэлемента заголовка ячейки поиска
|
SearchCellHeaderSubElementControlType | integer |
Тип элемента управления подэлемента заголовка ячейки (не локализованное целое число) для поиска. Это одно и то же значение на разных языках. Оставьте значение 0, если не ищет заголовки ячеек. |
|
|
Поиск локализованного типа элемента управления в ячейке
|
SearchCellSubElementLocalizedControlType | string |
Локализованный тип элемента управления ячейки для поиска. |
|
|
Тип элемента управления "Поиск вложенной ячейки"
|
SearchCellSubElementControlType | integer |
Тип элемента управления подэлемента ячейки (не локализованное целое число) для поиска. Это одно и то же значение на разных языках. |
|
|
Поиск потомков подэлементов ячеек
|
SearchDescendantsForCellSubElements | boolean |
Если задано значение true, то дерево UIA под расположенным элементом будет искать подэлементы заголовков ячеек и ячеек (т. е. значения элементов, заполняющие ячейки в выходной таблице). Это более тщательно, но может занять больше времени. Возможно, вы хотите задать значение false, если вы заинтересованы только в элементах непосредственно под элементом. |
|
|
Первый подэлемент заголовка ячейки для возврата
|
FirstCellHeaderSubElementToReturn | integer |
Индекс возвращаемого подэлемента первого заголовка ячейки, начиная с 1. Если вы хотите вернуть элементы в обратном порядке (с нижней части дерева UIA), можно также указать отрицательный индекс, начиная с -1. |
|
|
Максимальное количество вложенных элементов заголовка ячейки для возврата
|
MaxCellHeaderSubElementsToReturn | integer |
Максимальное число подэлементов заголовка ячейки, возвращаемых или 0 для возврата всех подэлементов. |
|
|
Первый подэлемент ячейки для возврата
|
FirstCellSubElementToReturn | integer |
Индекс первой подэлемента ячейки, возвращаемой начиная с 1. Если вы хотите вернуть элементы в обратном порядке (с нижней части дерева UIA), можно также указать отрицательный индекс, начиная с -1. |
|
|
Максимальное количество вложенных элементов ячейки для возврата
|
MaxCellSubElementsToReturn | integer |
Максимальное количество возвращаемых подэлементов ячеек или 0 для возврата всех подэлементов. |
|
|
Запрошенный номер столбцов
|
RequestedNumberOfColumns | integer |
Количество столбцов, которые вы хотите использовать в выходной таблице. Это значение должно быть правильным для считываемого элемента или вы получите непредвиденные результаты. |
|
|
Приоритет значения подэлемента ячейки
|
CellSubElementValuePriority | integer |
Приоритет использования значения подэлемента ячейки в качестве значения, используемого в выходной таблице. 1 является самым высоким приоритетом. 2 является вторым приоритетом. 3 является третьим приоритетом. 0 не используется. |
|
|
Приоритет значения текстового значения подэлемента ячейки
|
CellSubElementTextValuePriority | integer |
Приоритет использования текстового значения подэлемента ячейки в качестве значения, используемого в выходной таблице. 1 является самым высоким приоритетом. 2 является вторым приоритетом. 3 является третьим приоритетом. 0 не используется. |
|
|
Приоритет значения имени подэлемента ячейки
|
CellSubElementNameValuePriority | integer |
Приоритет использования имени подэлемента ячейки (обычно для меток) в качестве значения, используемого в выходной таблице. 1 является самым высоким приоритетом. 2 является вторым приоритетом. 3 является третьим приоритетом. 0 не используется. |
|
|
Минимальная ширина подэлемента ячейки
|
MinimumCellSubElementWidth | integer |
Минимальная ширина в пикселях подэлемента ячейки, включаемой в таблицу. |
|
|
Минимальная высота подэлемента ячейки
|
MinimumCellSubElementHeight | integer |
Минимальная высота в пикселях подэлемента ячейки, включаемой в таблицу. |
|
|
Поиск вложенной ячейки ограничивающий прямоугольник слева
|
SearchCellSubElementBoundingBoxLeft | integer |
Включают только подэлементы ячеек, которые полностью содержатся в ограничивающем поле. По умолчанию ограничивающий прямоугольник является огромным для включения всех элементов. |
|
|
Поиск вложенной ячейки ограничивающий прямоугольник справа
|
SearchCellSubElementBoundingBoxRight | integer |
Включают только подэлементы ячеек, которые полностью содержатся в ограничивающем поле. По умолчанию ограничивающий прямоугольник является огромным для включения всех элементов. |
|
|
Поиск вложенной ячейки ограничивающий прямоугольник сверху
|
SearchCellSubElementBoundingBoxTop | integer |
Включают только подэлементы ячеек, которые полностью содержатся в ограничивающем поле. По умолчанию ограничивающий прямоугольник является огромным для включения всех элементов. |
|
|
Поиск вложенной ячейки ограничивающий прямоугольник внизу
|
SearchCellSubElementBoundingBoxBottom | integer |
Включают только подэлементы ячеек, которые полностью содержатся в ограничивающем поле. По умолчанию ограничивающий прямоугольник является огромным для включения всех элементов. |
|
|
Чтение таблицы в виде потока
|
ReadTableAsThread | boolean |
Если задано значение false (по умолчанию), агент IA-Connect немедленно считывает таблицу и возвращает содержимое директору. При чтении больших таблиц это действие может истекает. Если задано значение true, агент IA-Connect будет читать таблицу как поток агента, а директор IA-Connect (или оркестратор, модуль PowerShell, Blue Prism) может отслеживать состояние этого потока агента, ожидая завершения. Это позволяет считывать большие таблицы без времени ожидания. IA-Connect Агенты 9.3 и более ранних версий могли сразу считывать таблицы, а не как поток агента. |
|
|
Получение выходных данных для идентификатора потока
|
RetrieveOutputDataFromThreadId | integer |
Если вы ранее выполнили это действие в качестве потока агента и задайте значение "Секунды ожидания потока" значение 0, укажите идентификатор потока агента для получения результатов. Этот идентификатор потока агента будет предоставлен предыдущим вызовом этого действия. Установите значение 0 (по умолчанию), если вы читаете таблицу (и, следовательно, не извлекая результаты предыдущего запроса в качестве потока агента). |
|
|
Секунды ожидания потока
|
SecondsToWaitForThread | integer |
Если для параметра "Чтение таблицы как потока" задано значение true, сколько секунд ожидает завершения потока агента. Если поток агента, считывающий таблицу, не завершен в это время, будет вызвано исключение. Установите значение 0, чтобы обойти ожидание: агент продолжит читать таблицу, но также будет доступен для следующего действия. Затем можно получить результаты (содержимое таблицы) позже с помощью действия "Ожидание успешного завершения потока агента", чтобы дождаться завершения потока агента, а затем повторно запустить это действие "Получение нескольких элементов UIA в виде таблицы" с входным значением "Получение выходных данных для идентификатора потока" для агента. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Число найденных подэлементов ячеек
|
NumberOfCellSubElementsFound | integer |
Число подэлементов ячеек (не заголовков) показало, что соответствует условиям поиска. |
|
Число возвращаемых подэлементов ячеек
|
NumberOfCellSubElementsReturned | integer |
Число возвращаемых подэлементов ячеек (не заголовков) (это может быть меньше числа элементов, найденных при указании первого или максимального числа возвращаемых элементов). |
|
JSON содержимого таблицы
|
TableContentsJSON | string |
Таблица, созданная из содержимого нескольких элементов в формате JSON. |
|
Количество строк в таблице
|
NumberOfRowsInTable | integer |
Количество строк в выходной таблице. |
|
Количество столбцов в таблице
|
NumberOfColumnsInTable | integer |
Количество столбцов в выходной таблице. |
|
Идентификатор потока
|
ThreadId | integer |
Если это действие выполняется в качестве потока агента, этот вывод будет содержать идентификатор потока агента, который можно использовать для мониторинга процесса действия и получения содержимого таблицы при завершении потока. |
Получение окон Win32
Быстрое действие Win32, которое возвращает список всех окон Win32, которые при необходимости имеют указанное имя класса или название окна, или можно указать более расширенные фильтры поиска, включая подстановочные знаки. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Windows Win32 может включать непредвиденные элементы, включая панель задач, рабочий стол, меню "Пуск", прозрачные наложения, внеэкранные или скрытые окна, поэтому возвращенный список может содержать больше результатов, чем ожидалось.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя класса поиска
|
SearchClassName | string |
Необязательное имя класса окна верхнего уровня для поиска, например "Chrome_WidgetWin_1". |
|
|
Заголовок окна поиска
|
SearchWindowTitle | string |
Необязательное название окна верхнего уровня для поиска. |
|
|
Получение только окон верхнего уровня
|
TopLevelWindowsOnly | boolean |
Задайте значение true, чтобы получить только окна Win32, которые ОС считает топ-уровнем. Установите значение false, чтобы получить все окна Win32. Обратите внимание, что определение Окна Win32 будет содержать элементы, которые могут не распознаваться как окно, и многие диалоговые окна и поля сообщений помечены как верхний уровень, даже если они являются дочерним элементом родительского окна. |
|
|
Получение только видимых окон
|
VisibleWindowsOnly | boolean |
Установите значение true, чтобы получить только окна Win32, которые ос считает видимыми. Установите значение false, чтобы получить видимые и невидимые окна Win32. Обратите внимание, что экранные или прозрачные окна могут быть помечены как видимые, но их нельзя увидеть. |
|
|
Получение окон только с строкой заголовка
|
WindowsWithTitlebarOnly | boolean |
Задайте значение true, чтобы получить только окна Win32 с заголовком. Установите значение false, чтобы получить окна Win32 независимо от того, есть ли у них строка заголовка или нет. Обратите внимание, что некоторые прозрачные окна имеют заголовки, но их нельзя увидеть. |
|
|
Получение окон только с заголовком
|
WindowsWithTitleOnly | boolean |
Задайте значение true, чтобы получить только окна Win32 с заголовком (т. е. строкой заголовка, содержащей текст). Установите значение false, чтобы получить окна Win32 независимо от того, есть ли у них заголовок. Обратите внимание, что заголовок является полосой в верхней части окна, а заголовок — текст внутри него. |
|
|
Игнорировать прозрачные окна
|
IgnoreTransparentWindows | boolean |
Задайте значение true, чтобы получить только окна Win32, которые не имеют прозрачности. Установите значение false, чтобы получить окна Win32 независимо от того, имеют ли они набор прозрачности или нет. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Необязательный идентификатор процесса, который владеет окнами (например, как указано в выходных данных действия "Запуск процесса" в действиях IA-Connect среды или сеанса). Установите значение 0, чтобы не выполнять поиск по идентификатору процесса. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Заголовок], например "*Excel" AND [IsMinimize] = False AND [IsResizeable] = True. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько окон соответствуют поиску, это позволяет указать свойство окна для сортировки по. Например, если "Сортировка по имени столбца" имеет значение [TopEdge], то список окон будет возвращен по верхнему краю. Если это поле остается пустым, окна будут возвращены в том порядке, в который они обнаружены. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько окон соответствуют поиску и столбцу сортировки, установите значение true (по умолчанию) для сортировки по возрастанию или присвоению значения false для сортировки по убыванию. |
|
|
Возврат дескриптора элемента UIA
|
ReturnElementHandle | boolean |
Если задано значение true, то дескриптор UIA для каждого расположенного окна Win32 будет возвращен в выходной коллекции (в столбце UIAHandle). Этот дескриптор можно использовать в дальнейших действиях, чтобы выступать в качестве родительского дескриптора в IA-Connect действиях UIA. |
|
|
Первый элемент для возврата
|
FirstItemToReturn | integer |
Индекс первого окна (строки), возвращаемого начиная с 1. |
|
|
Максимальное количество возвращаемых элементов
|
MaxItemsToReturn | integer |
Максимальное количество возвращаемых окон или 0 для возврата всех элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Win32 windows JSON
|
Win32WindowsJSON | string |
Список окон Win32, соответствующих критериям поиска в формате JSON. |
|
Количество окон Win32
|
NumberOfWin32Windows | integer |
Количество возвращенных окон Win32. |
Получение режима поиска элементов UIA
Извлекает режим поиска элементов UIA, используемый агентом IA-Connect для действий UIA.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Режим поиска элементов UIA
|
UIAElementSearchMode | string |
Текущий режим поиска элементов UIA, используемый агентом IA-Connect. |
Получение свойств элемента datagrid UIA
Возвращает свойства таблицы элемента DataGrid. Это элемент со строками, столбцами, заголовками и ячейками (т. е. таблицей).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Альтернативное имя строки заголовка
|
AlternativeHeaderRowName | string |
По умолчанию строка заголовка в DataGrid имеет имя UIA "Верхняя строка". Если строка заголовка имеет другое имя, укажите это имя здесь. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Число столбцов
|
NumberOfColumns | integer |
Количество столбцов в datagrid. |
|
Число видимых столбцов
|
NumberOfVisibleColumns | integer |
Количество видимых столбцов в datagrid. |
|
Количество строк
|
NumberOfRows | integer |
Количество строк в datagrid. |
|
Количество видимых строк
|
NumberOfVisibleRows | integer |
Количество видимых строк в datagrid. |
|
Первая видимая строка
|
FirstVisibleRow | integer |
Индекс первой видимой строки в datagrid. |
|
Последняя видимая строка
|
LastVisibleRow | integer |
Индекс последней видимой строки в datagrid. |
|
Количество полос прокрутки
|
NumberOfScrollbars | integer |
Количество полос прокрутки, которые имеет datagrid. |
|
Имена полос прокрутки
|
ScrollbarNames | string |
Разделенный запятыми список имен полос прокрутки (например, по горизонтали, вертикали). |
Получение свойств элемента UIA
Возвращает все свойства элемента. Это может быть полезно, если вы не уверены, какое поле содержит необходимые значения свойств.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Возвращаемое значение элемента
|
ReturnElementValue | boolean |
Если задано значение true, чем значение расположенного элемента, будет возвращено. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Проверка точки щелчка в пределах границы элемента
|
ValidateClickablePointWithinElementBoundary | boolean |
Для некоторых элементов UIA не знает о точке щелчка в элементе и вернет недопустимую координату (например, 0,0) вместо центра элемента. Если для этих входных данных задано значение true, IA-Connect проверит допустимость координаты, предоставленной UIA, и, если он не находится в пределах границ элемента, будет игнорировать значение, предоставленное UIA, и использовать центр элемента. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Идентификатор платформы элементов
|
ElementFrameworkId | string |
Идентификатор платформы UIA элемента. |
|
Тип элемента управления
|
ElementControlType | string |
Тип элемента управления UIA в виде числа. Это похоже на локализованный тип элемента управления, но не является языком. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
|
Элемент включен
|
ElementIsEnabled | boolean |
Возвращает значение, включено ли элемент. |
|
Элемент находится вне экрана
|
ElementIsOffscreen | boolean |
Возвращает значение, является ли элемент внеэкранным или нет. |
|
Элемент — это фокусируемая клавиатура
|
ElementIsKeyboardFocusable | boolean |
Возвращает, можно ли фокусировать элемент клавиатурой. |
|
Элемент имеет фокус клавиатуры
|
ElementHasKeyboardFocus | boolean |
Возвращает значение, имеет ли элемент фокус клавиатуры. |
|
Элемент — поле пароля
|
ElementIsPasswordField | boolean |
Возвращает значение, является ли элемент полем ввода пароля. |
|
Ключ акселератора элементов
|
ElementAcceleratorKey | string |
Возвращает горячий ключ, который можно нажать, чтобы активировать элемент. |
|
Ключ доступа к элементу
|
ElementAccessKey | string |
Возвращает горячий ключ, который можно нажать, чтобы активировать элемент меню. |
|
Левый край элемента
|
ElementLeftEdge | integer |
Расстояние в пикселях между левым краем элемента или окна и левым краем дисплея. |
|
Правый край элемента
|
ElementRightEdge | integer |
Расстояние в пикселях между правым краем элемента или окна и левым краем дисплея. |
|
Верхний край элемента
|
ElementTopEdge | integer |
Расстояние в пикселях между верхним краем элемента или окна и верхним краем дисплея. |
|
Нижний край элемента
|
ElementBottomEdge | integer |
Расстояние в пикселях между нижним краем элемента или окна и верхним краем дисплея. |
|
Элемент clickable point X
|
ElementClickablePointX | integer |
Координата X в пикселях центрального щелчка в элементе относительно левого края дисплея, возвращаемого базовым приложением. |
|
Элемент, на который можно щелкнуть точку Y
|
ElementClickablePointY | integer |
Координата Y в пикселях центрального щелчка в элементе относительно верхнего края дисплея, возвращаемого базовым приложением. |
|
Идентификатор процесса элемента
|
ElementProcessId | integer |
Идентификатор процесса (PID) процесса, которому принадлежит этот элемент. |
|
Дескриптор элемента
|
ElementHandle | integer |
Если для входного дескриптора элемента Return задано значение true, он будет содержать числовые дескриптор элемента, который можно использовать в дальнейших действиях для действия в качестве родительского дескриптора для дальнейших действий. |
|
Значение элемента
|
ElementValue | string |
Если для входного значения элемента Return задано значение true, а если элемент имеет шаблон значения, это значение будет содержать это значение. |
|
Текстовое значение элемента
|
ElementTextValue | string |
Если для входного значения элемента Return задано значение true, а если элемент имеет шаблон текстового значения, он будет содержать это текстовое значение. |
Получение свойств элемента UIA в виде списка
Возвращает свойства элемента в виде одного списка строк (одна коллекция строк или таблица данных) вместо отдельных элементов, это может быть полезно в зависимости от способа использования данных.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор элемента
|
ElementHandle | True | integer |
Дескриптор UIA для целевого элемента. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Количество найденных элементов
|
NumberOfElementsFound | integer |
Количество найденных элементов. |
|
Количество возвращаемых элементов
|
NumberOfElementsReturned | integer |
Количество возвращаемых элементов. |
|
Свойства элемента UIA JSON
|
UIAElementPropertiesJSON | string |
Свойства UIA элемента в формате JSON. |
Получение содержимого элемента datagrid UIA
Возвращает содержимое элемента datagrid. Это элемент со строками, столбцами, заголовками и ячейками (т. е. таблицей). Это действие также можно использовать для получения результатов из предыдущего выполнения этого действия, запускаемого в качестве потока агента.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Получение только столбцов на экране
|
OnScreenColumnsOnly | boolean |
Если задано значение true, то будут возвращены только столбцы экрана. |
|
|
Получение только строк на экране
|
OnScreenRowsOnly | boolean |
Если задано значение true, будут возвращены только строки экрана. |
|
|
Возврат значений NULL в виде пустых
|
ReturnNullValuesAsBlank | boolean |
Если задано значение true, значения NULL будут возвращены как "" (т. е. пустые). Если задано значение false, значения NULL обычно возвращаются как "(null)". |
|
|
Альтернативное имя строки заголовка
|
AlternativeHeaderRowName | string |
По умолчанию строка заголовка в DataGrid имеет имя элемента UIA Top Row. Если строка заголовка имеет другое имя, укажите это имя здесь. |
|
|
Возврат имени UIA строки
|
ReturnRowUIAName | boolean |
Если для этого параметра задано значение, имя UIA строки будет храниться в столбце в выходной коллекции. Имя столбца определяется входным именем "Имя столбца для хранения имени UIA строки". |
|
|
Имя столбца для хранения имени UIA строки
|
NameOfColumnToStoreRowUIAName | string |
Если для входного значения "Имя возвращаемой строки UIA" задано значение true, то этот вход указывает имя столбца в выходной коллекции для хранения имени UIA строки. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Первый элемент для возврата
|
FirstItemToReturn | integer |
Индекс элемента первого элемента (строка), возвращаемый начиная с 1. |
|
|
Максимальное количество возвращаемых элементов
|
MaxItemsToReturn | integer |
Максимальное количество возвращаемых элементов (строк) или 0 для возврата всех элементов (строк). |
|
|
Сканирование первых N строк для пустых строк
|
ScanFirstNRowsForEmptyRows | integer |
Некоторые данные имеют несколько пустых или null строк в дереве UIA (обычно в верхней части) и IA-Connect автоматически пропускают эти элементы строки, так как они не представляют ничего в таблице, которая отображается в пользовательском интерфейсе. Если для этого входного значения задано значение 0 (по умолчанию), агент IA-Connect всегда сканирует элементы строк из первой строки, даже если для получения строк в таблице задано значение "Первый элемент для возврата". Это гарантирует согласованность с номерами индексов строк, но влияет на производительность, так как все строки из первой строки в запрошенные строки должны быть проверены. Если вы уверены, что только пустые или пустые элементы строки в таблице находятся в первых N (например, 10) строк, можно задать значение N (например, 10), чтобы повысить производительность. Не устанавливайте значение, отличное от 0, если вы не знаете, что делаете. |
|
|
Чтение таблицы в виде потока
|
ReadTableAsThread | boolean |
Если задано значение false (по умолчанию), агент IA-Connect немедленно считывает таблицу и возвращает содержимое директору. При чтении больших таблиц это действие может истекает. Если задано значение true, агент IA-Connect будет читать таблицу как поток агента, а директор IA-Connect (или оркестратор, модуль PowerShell, Blue Prism) может отслеживать состояние этого потока агента, ожидая завершения. Это позволяет считывать большие таблицы без времени ожидания. IA-Connect Агенты 9.3 и более ранних версий могли сразу считывать таблицы, а не как поток агента. |
|
|
Получение выходных данных для идентификатора потока
|
RetrieveOutputDataFromThreadId | integer |
Если вы ранее выполнили это действие в качестве потока агента и задайте значение "Секунды ожидания потока" значение 0, укажите идентификатор потока агента для получения результатов. Этот идентификатор потока агента будет предоставлен предыдущим вызовом этого действия. Установите значение 0 (значение по умолчанию), если вы читаете datagrid (и, следовательно, не извлекая результаты предыдущего запроса в качестве потока агента). |
|
|
Секунды ожидания потока
|
SecondsToWaitForThread | integer |
Если для параметра "Чтение таблицы как потока" задано значение true, сколько секунд ожидает завершения потока агента. Если поток агента, считывающий таблицу, не завершен в это время, будет вызвано исключение. Установите значение 0, чтобы обойти ожидание: агент продолжит чтение datagrid, но также будет доступен для следующего действия. Затем можно получить результаты (содержимое datagrid) позже с помощью действия "Ожидание успешного завершения потока агента", чтобы дождаться завершения потока агента, а затем повторно запустить это действие "Получение содержимого элемента UIA datagrid" с входным значением "Получение выходных данных для идентификатора потока" агента. |
|
|
Прокрутка данных по вертикали каждые N%
|
ScrollDataGridVerticallyEveryNPercent | integer |
Производительность чтения некоторых больших наборов данных (например, с тысячами строк) наблюдается, чтобы улучшить, если периодически прокручивать данные в (или рядом) с прокручиваемой папкой. Если задано значение 0 (по умолчанию), datagrid не будет прокручиваться при чтении содержимого. Если задано значение от 1 до 100, функция datagrid периодически прокручивается (каждый N процент от общего количества строк) при чтении содержимого. Например: если задано значение 20, datagrid будет прокручиваться по 0, 20, 40, 60, 80 процентов. Кроме того, используйте "Прокрутка данных по вертикали каждую N-строку", чтобы прокручивать каждую N-строку вместо каждого N процента. |
|
|
Прокрутка данных по вертикали каждой N-строк
|
ScrollDataGridVerticallyEveryNRows | integer |
Производительность чтения некоторых больших наборов данных (например, с тысячами строк) наблюдается, чтобы улучшить, если периодически прокручивать данные в (или рядом) с прокручиваемой папкой. Если задано значение 0 (по умолчанию), datagrid не будет прокручиваться при чтении содержимого. Если задано значение 1 или выше, datagrid будет прокручивать каждую N-строку при чтении содержимого. Например: если задано значение 5, datagrid будет прокручиваться каждые 5 строк. Кроме того, используйте "Прокрутка данных по вертикали каждую N%" для прокрутки каждого N процента строк вместо каждой N-строки. |
|
|
Прокрутите дескриптор данных по вертикали
|
ScrollDataGridVerticallyElementHandle | integer |
Если прокрутка данных по вертикали при чтении содержимого определяет, как IA-Connect будет находить вертикальную полосу прокрутки. Если задано значение 0, IA-Connect попытается прокрутить данные напрямую, используя шаблон прокрутки (если datagrid поддерживает его) или найдите вертикальную полосу прокрутки, содержащуюся в datagrid. Кроме того, можно указать IA-Connect дескриптор UIA вертикальной полосы прокрутки (сам элемент полосы прокрутки, а не кнопки внутри), который является значением 1 или выше. |
|
|
Минимальные строки datagrid для прокрутки
|
MinimumDataGridRowsForScrolling | integer |
Если прокрутка данных выполняется по вертикали при чтении содержимого, это значение указывает минимальное количество строк, необходимых в таблице, прежде чем IA-Connect будет выполнять прокрутку. Если задано значение 0, IA-Connect будет прокручиваться независимо от количества строк. Если задано положительное число, IA-Connect будет выполнять прокрутку только при наличии этого количества строк или более. |
|
|
Вызов исключения, если не удается прокрутить прокрутку
|
RaiseExceptionIfCannotScroll | boolean |
Если прокрутка данных выполняется по вертикали при чтении содержимого: задайте значение true, если ошибка прокрутки должна считаться исключением или иметь значение false (по умолчанию), если не удалось прокрутить прокрутку. Распространенные сбои прокрутки включают не удается найти полосы прокрутки или полосы прокрутки не имеют шаблона UIA, подходящего для прокрутки (прокрутка, rangevalue или value). |
|
|
Альтернативное имя вертикальной полосы прокрутки
|
AlternativeVerticalScrollbarName | string |
По умолчанию вертикальная полоса прокрутки "строка" в datagrid имеет имя элемента UIA "Вертикальная полоса прокрутки". Если вертикальная полоса прокрутки имеет другое имя, укажите это имя здесь. Это будет использоваться, если вы хотите, чтобы IA-Connect периодически прокручивать данные при чтении содержимого, поле ввода "Scroll datagrid vertically element handle" имеет значение 0 (указывая, что IA-Connect должен прокручивать данные напрямую), но datagrid не реализует шаблон прокрутки. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Содержимое Datagrid JSON
|
DataGridContentsJSON | string |
Содержимое элемента datagrid в формате JSON. |
|
Количество строк в таблице
|
NumberOfRowsInTable | integer |
Количество строк в выходной таблице, если таблица была прочитана немедленно. |
|
Количество столбцов в таблице
|
NumberOfColumnsInTable | integer |
Количество столбцов в выходной таблице, если таблица была прочитана немедленно. |
|
Идентификатор потока
|
ThreadId | integer |
Если это действие выполняется в качестве потока агента, выходные данные будут содержать идентификатор потока агента, который можно использовать для мониторинга процесса действия и получения содержимого datagrid после завершения потока. |
Получение текстового значения элемента UIA
Возвращает текстовое значение элемента. Текстовое значение обычно связано с меткой, но многие элементы могут иметь это свойство.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Текстовое значение элемента
|
ElementTextValue | string |
Текстовое значение элемента. |
Получение цветовой области поиска элементов UIA
Возвращает сведения о области пикселей в элементе UIA, удовлетворяющем указанным критериям цвета. Элемент должен быть доставлен на передний план, так как агент находит цвета, принимая снимок экрана с координатами элемента.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Цвет поиска
|
SearchColour | True | string |
Цвет поиска в формате 0xAARRGGBB, #AARRGGBB, 0xRRGGBB или #RRGGBB, где каждый канал цвета является байтом в шестнадцатеричном формате (00 полностью отключен, FF полностью включен). Например: #FF0000 для красного, #00FF00 для синего, #00000 для черного, #FFFFFF для белого. |
|
Максимальное отклонение цвета
|
MaxColourDeviation | True | integer |
Максимальный цвет элемента может отклоняться от цвета поиска, прежде чем он не считается совпадением. 0 для отсутствия отклонения. Отклонение измеряется в значениях RGB. Например, #FF0000 отличается от #FE0102. Отклонение от 15 было бы хорошим отправной точкой. |
|
Смещение X влево
|
LeftPixelXOffset | integer |
Необязательное смещение X для левого края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение по правому пикселю X
|
RightPixelXOffset | integer |
Необязательное смещение X для правого края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Смещение верхнего пикселя Y
|
TopPixelYOffset | integer |
Необязательное смещение Y для верхнего края области поиска. Это позволяет увеличить (с отрицательными значениями) или уменьшить (с положительными значениями) область поиска. |
|
|
Смещение нижнего пикселя Y
|
BottomPixelYOffset | integer |
Необязательное смещение Y для нижнего края области поиска. Это позволяет увеличить (с положительными значениями) или уменьшить (с отрицательными значениями) область поиска. |
|
|
Скрыть агент
|
HideAgent | boolean |
Установите значение true, чтобы автоматически скрыть агент (если видимый), чтобы убедиться, что он не скрывает анализируемый элемент. |
|
|
Возвращать координаты экрана как физические
|
ReturnPhysicalCoordinates | boolean |
Задайте значение true для возвращаемых координат экрана в виде физических координат. Задайте значение false для координат экрана, возвращаемых как виртуальные координаты. Если базовое масштабирование дисплея равно 100%, физические и виртуальные координаты одинаковы. Координаты элементов всегда возвращаются в виде виртуальных координат. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Количество пикселей, соответствующих цвету
|
NumberOfPixelsMatchingColour | integer |
Количество пикселей, которые соответствуют указанному цвету. |
|
Элемент поля с привязкой цвета слева от пикселя
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
Виртуальная координата X левого пикселя, соответствующего указанному цвету, относительно виртуального верхнего верхнего слева элемента. |
|
Прямоугольник с ограничивающим цветом пиксель
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
Виртуальная координата X правого пикселя, соответствующего указанному цвету, относительно элемента виртуального верхнего верхнего слева. |
|
Верхний пиксель ограничивающего прямоугольного элемента цвета
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
Виртуальная координата Y верхней части пикселя, соответствующего указанному цвету, относительно виртуального верхнего верхнего слева элемента. |
|
Нижний пиксель ограничивающего прямоугольного элемента цвета
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
Виртуальная координата Y нижнего большинства пикселей, соответствующая указанному цвету, относительно виртуального верхнего верхнего края элемента. |
|
Цветообвязывание ограничивающего прямоугольного элемента в центре X пикселей
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
Виртуальная координата X центра ограничивающего поля, содержащего пиксели, соответствующие указанному цвету, относительно виртуального верхнего верхнего края элемента. |
|
Ограничивающий прямоугольник цвета в центре пикселя Y
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
Виртуальная координата Y центра ограничивающего поля, содержащего пиксели, соответствующие указанному цвету, относительно виртуального верхнего верхнего края элемента. |
|
Экран левого экрана с ограничивающим цветом
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
Пиксель экрана X-координата левого пикселя, соответствующего указанному цвету. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Экран правого экрана с ограничивающим цветом
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
Пиксель экрана X-координаты правого пикселя, соответствующего указанному цвету. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Экран верхнего экрана с ограничивающим цветом
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
Координата пикселя Y экрана верхнего большинства пикселей, соответствующего указанному цвету. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Пиксель нижнего экрана с ограничивающим полем цвета
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
Координата пикселя Y экрана нижнего большинства пикселей, соответствующих указанному цвету. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Ограничивающий прямоугольник цвета в центре экрана X
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
Пиксель экрана X-координата центра ограничивающего поля, содержащего пиксели, соответствующие указанному цвету. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
|
Ограничивающий прямоугольник цвета в центре экрана Y
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
Координата пикселя Y экрана центра ограничивающего поля, содержащего пиксели, соответствующие указанному цвету. Это физическая или виртуальная координата в зависимости от входных данных "Возвращать физические координаты". |
Получение шаблонов элементов UIA
Извлекает, какие шаблоны UIA доступны для элемента UIA, поэтому IA-Connect действия UIA могут повлиять на элемент.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Развернуть шаблон свертывание, доступный
|
ExpandCollapsePatternAvailable | boolean |
Шаблон свертывания расширения UIA доступен, поэтому действия, которые разворачивают или свернут элемент (например, раскрывающееся меню), скорее всего, будут работать. |
|
Доступный шаблон вызова
|
InvokePatternAvailable | boolean |
Шаблон вызова UIA доступен, поэтому действия, которые нажимают элемент или щелкают элемент списка, скорее всего, будут работать. |
|
Доступный шаблон значения диапазона
|
RangeValuePatternAvailable | boolean |
Шаблон значения диапазона UIA доступен, поэтому действия прокрутки элемента или ползунка, скорее всего, будут работать. |
|
Доступный шаблон прокрутки
|
ScrollPatternAvailable | boolean |
Шаблон прокрутки UIA доступен и поэтому действия, которые прокручивают элемент, скорее всего, будут работать. |
|
Доступный шаблон элемента выбора
|
SelectionItemPatternAvailable | boolean |
Шаблон элемента выбора UIA доступен, поэтому действия, которые выбирают элемент, скорее всего, будут работать. |
|
Доступные текстовые шаблоны
|
TextPatternAvailable | boolean |
Шаблон текста UIA доступен, поэтому действия, которые считывают текстовое значение элемента, скорее всего, будут работать. |
|
Доступный шаблон переключения
|
TogglePatternAvailable | boolean |
Шаблон переключателя UIA доступен, поэтому действия, которые проверяют, отменяют или переключают элемент, скорее всего, будут работать. |
|
Доступные шаблоны значений
|
ValuePatternAvailable | boolean |
Шаблон значений UIA доступен, поэтому действия, которые вводят текст в элемент или считывают значение элемента, скорее всего, будут работать. Полосы прокрутки также могут реагировать на шаблон значений. |
|
Доступный шаблон окна
|
WindowPatternAvailable | boolean |
Шаблон окна UIA доступен, поэтому действия, которые закрывают, максимизировать или свести к минимуму элемент, скорее всего, будут работать. |
|
Доступный шаблон сетки
|
GridPatternAvailable | boolean |
Доступен шаблон сетки UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон элемента сетки
|
GridItemPatternAvailable | boolean |
Доступен шаблон элемента сетки UIA. Этот шаблон не используется IA-Connect. |
|
Доступны устаревшие шаблоны I Available
|
LegacyIAccessiblePatternAvailable | boolean |
Доступен устаревший шаблон IIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон выбора
|
SelectionPatternAvailable | boolean |
Доступен шаблон выбора UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон электронной таблицы
|
SpreadsheetPatternAvailable | boolean |
Доступен шаблон электронной таблицы UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон элемента электронной таблицы
|
SpreadsheetItemPatternAvailable | boolean |
Доступен шаблон элемента электронной таблицы UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон таблицы
|
TablePatternAvailable | boolean |
Доступен шаблон таблицы UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон элемента таблицы
|
TableItemPatternAvailable | boolean |
Доступен шаблон элемента таблицы UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон текста 2
|
TextPattern2Available | boolean |
Доступен текстовый шаблон UIA 2. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон редактирования текста
|
TextEditPatternAvailable | boolean |
Доступен шаблон редактирования текста UIA. Этот шаблон не используется IA-Connect. |
|
Доступный шаблон преобразования
|
TransformPatternAvailable | boolean |
Доступен шаблон преобразования UIA. Этот шаблон не используется IA-Connect. |
Получение элемента UIA в координатах экрана
Возвращает элемент UIA, расположенный в заданных координатах экрана.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Координата X
|
XCoord | integer |
Значение координатЫ X экрана (в пикселях), в котором должен находиться элемент UIA. |
|
|
Координата Y
|
YCoord | integer |
Значение координаты Y экрана (в пикселях), в котором должен находиться элемент UIA. |
|
|
Вызов исключения, если элемент не найден
|
RaiseExceptionIfElementNotFound | boolean |
Следует ли IA-Connect вызывать исключение, если элемент UIA не был расположен в указанном расположении? |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Найденный элемент
|
ElementFound | boolean |
Возвращает значение true, если элемент UIA найден в указанном расположении. |
|
Дескриптор элемента
|
ElementHandle | integer |
Дескриптор UIA для элемента. Это можно использовать в качестве входных данных для дальнейших действий UIA, действующих в этом элементе. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
Получение элементов списка UIA
Возвращает список дочерних элементов, найденных под указанным элементом (обычно раскрывающийся список или элементы меню).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Сначала разверните
|
ExpandFirst | boolean |
Если задано значение true, IA-Connect попытается развернуть список перед поиском элементов элемента списка. Это полезно для динамических списков, так как элементы элемента списка могут не создаваться, пока не будет развернут список. |
|
|
Свернуть после
|
CollapseAfter | boolean |
Если задано значение true, то список будет свернут после выполнения поиска. |
|
|
Проверка выбранных элементов
|
CheckForSelectedItems | boolean |
Если задано значение true, то выходная коллекция будет содержать дополнительное свойство, указывающее, выбран ли элемент списка в данный момент. |
|
|
Секунды между развертыванием и свертыванием
|
SecondsBetweenExpandCollapse | double |
Количество секунд, ожидаемых между действиями развертывания и свертыванием, если задано значение true. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Количество элементов списка
|
NumberOfListItems | integer |
Количество элементов в списке. |
|
Перечисление элементов JSON
|
ListItemsJSON | string |
Свойства элементов в списке в формате JSON. |
|
Количество выбранных элементов
|
NumberOfSelectedItems | integer |
Количество выбранных элементов в списке. |
|
Индекс первого выбранного элемента
|
IndexOfFirstSelectedItem | integer |
Индекс в списке первого выбранного элемента. |
|
Имя выбранного элемента
|
SelectedItemName | string |
Имя выбранного элемента. |
Проверен элемент UIA
Это действие возвращает значение true или false, указывающее, установлен ли элемент (обычно флажок или переключатель).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент проверяется
|
ElementIsChecked | boolean |
Возвращает значение true, если элемент установлен или имеет значение false, если нет. |
Проверка нескольких элементов UIA
Задает состояние нескольких элементов (обычно флажок или переключатель) флажком или снят.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Входные элементы
|
InputElementsJSON | True | string |
Массив элементов UIA для проверки в формате JSON. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Проверка элемента UIA
Задает состояние элемента (обычно флажок или переключатель) флажком или снятым.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Элемент Check
|
CheckElement | boolean |
Следует ли проверять элемент (true) или снять флажок (false)? |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Развернуть элемент UIA
Развертывает элемент (обычно меню или раскрывающийся элемент). Если элемент уже развернут, ничего не произойдет.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Рисование прямоугольника вокруг элемента UIA
Рисует прямоугольник вокруг периметра элемента, помогающего определить, что найденный элемент является обязательным. Прямоугольник автоматически удаляется через 5 секунд.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Цвет пера
|
PenColour | string |
Цвет прямоугольника, нарисованного (например, красный, зеленый, синий, желтый, фиолетовый или оранжевый) или шестнадцатеричный код строки, например #FF0000. |
|
|
Пиксели толщины пера
|
PenThicknessPixels | integer |
Толщина (в пикселях) границы прямоугольника выделения. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Сброс всех дескрипторов элементов UIA
Сбрасывает все дескриптор элемента UIA, хранящиеся в настоящее время IA-Connect которые могут быть полезны, если вы определили много элементов и имеет большое количество дескрипторов элементов. В сценариях с чрезвычайно большим количеством дескрипторов элементов (100 000+) это действие также можно использовать для освобождения использования ОЗУ.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Свести к минимуму окно UIA
Минимизирует окно с указанным дескриптором UIA.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | True | integer |
Дескриптор UIA для окна, который будет минимизирован. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Снимок экрана: расположение элемента UIA
Снимок экрана: расположение элемента и возвращает изображение. Элемент должен быть доставлен на передний план, так как снимок экрана принимает копию экрана в расположении элементов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Формат изображения
|
ImageFormat | string |
Формат изображения, используемый для снимка экрана. Это может повлиять на качество и размер возвращаемых данных. Поддерживаемые форматы — PNG (по умолчанию), JPG, BMP и GIF. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Скрыть агент
|
HideAgent | boolean |
Установите значение true, чтобы автоматически скрыть агент (если видимый), чтобы убедиться, что он не скрывает снимок экрана. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Изображение экрана как Base64
|
ScreenBitmapBase64 | string |
Изображение экрана в виде строки в кодировке Base64. |
Существует ли классический элемент UIA
Сообщает, существует ли классический элемент и предоставляет некоторые базовые свойства элементов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Если задано (значение 1 или выше), поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым (или 0). |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, возвращается только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если элемент существует или false, если нет. |
|
Дескриптор элемента
|
ElementHandle | integer |
Дескриптор UIA для элемента. Это можно использовать в качестве входных данных для дальнейших действий UIA, действующих в этом элементе. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
Существует ли окно Win32 верхнего уровня
Быстрое действие Win32, указывающее, существует ли окно Win32 верхнего уровня. Окно верхнего уровня — это окно, подключенное к рабочему столу. Можно выполнить поиск по имени класса или заголовку окна или указать более сложные фильтры поиска, включая подстановочные знаки. Хотя это действие использует API Win32, оно может обнаруживать Windows, Java, ModernUI и веб-окна. Окно должно существовать, IA-Connect не будет ждать. Чаще всего используется действие UIA "Существует ли классический элемент UIA", которое является более мощным, но это действие Win32 обычно выполняется быстрее.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя класса поиска
|
SearchClassName | string |
Имя класса элемента окна верхнего уровня для поиска, например "Блокнот". |
|
|
Заголовок окна поиска
|
SearchWindowTitle | string |
Заголовок окна верхнего уровня для поиска. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Необязательный идентификатор процесса, который владеет окном (например, как показано в выходных данных действия "Запуск процесса" в действиях IA-Connect среды или сеанса). Установите значение 0, чтобы не выполнять поиск по идентификатору процесса. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов для доступных свойств окна. Пример 1: [ширина] < 200. Пример 2. [Заголовок], например "*Excel" AND [IsMinimize] = False AND [IsResizeable] = True. Дополнительные примеры см. в документации. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Окно существует
|
WindowExists | boolean |
Возвращает значение true, если окно существует или значение false, если нет. |
Существует ли элемент UIA
Сообщает, существует ли элемент и возвращает некоторые базовые свойства элемента.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор процесса поиска
|
SearchProcessId | integer |
Если задано (значение 1 или выше), поиск будет рассматривать только элементы, принадлежащие процессу с этим идентификатором процесса (PID). Если IA-Connect запустили процесс, идентификатор piD предоставляется действием "Запуск процесса" в действиях IA-Connect среды или сеанса. Если вы не знаете piD, оставьте это поле пустым (или 0). |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Дескриптор элемента Return
|
ReturnElementHandle | boolean |
Если задано значение true, возвращается дескриптор для расположенного элемента. Этот дескриптор можно использовать в дальнейших действиях для действия в качестве родительского дескриптора. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Включение дочерних процессов
|
IncludeChildProcesses | boolean |
Если задано значение true и указан идентификатор процесса поиска, дочерние процессы этого процесса также включаются в поиск. Если задано значение false, будет искать только процесс, соответствующий точному идентификатору процесса поиска. |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Элемент существует
|
ElementExists | boolean |
Возвращает значение true, если элемент существует или false, если нет. |
|
Дескриптор элемента
|
ElementHandle | integer |
Дескриптор UIA для элемента. Это можно использовать в качестве входных данных для дальнейших действий UIA, действующих в этом элементе. |
|
Имя элемента
|
ElementName | string |
Имя UIA элемента. |
|
Имя класса элемента
|
ElementClassName | string |
Имя класса UIA элемента. |
|
Идентификатор автоматизации элементов
|
ElementAutomationId | string |
Идентификатор автоматизации UIA элемента. |
|
Локализованный тип элемента управления
|
ElementLocalizedControlType | string |
Локализованный тип элемента управления UIA. |
Установка времени ожидания транзакции UIA
Определяет, сколько времени API UIA будет ждать, пока приложение вернет сведения об элементе. Это время ожидания транзакции обычно достигается только в том случае, если приложение не отвечает.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Время ожидания в секундах
|
TimeoutInSeconds | True | double |
Максимальная продолжительность времени, когда API UIA ожидает возврата сведений об элементе приложения. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Установка нормального окна UIA
Нормализация окна с заданным дескриптором UIA (т. е. устанавливает его в нормальное окно размера, а не минимизировано или максимизировано).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор окна
|
WindowHandle | True | integer |
Дескриптор UIA для нормализации окна. |
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Щелкните элемент списка UIA по имени
Щелкает элемент списка с указанным именем. Обычно это используется для выбора элемента в раскрывающемся списке или элементе меню.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Сначала разверните
|
ExpandFirst | boolean |
Если задано значение true, IA-Connect попытается развернуть список перед поиском элементов элемента списка. Это полезно для динамических списков, так как элементы элемента списка могут не создаваться, пока не будет развернут список. |
|
|
Свернуть после
|
CollapseAfter | boolean |
Если задано значение true, то список будет свернут после выполнения поиска. |
|
|
Наименование товара
|
ItemName | string |
Имя элемента, который нужно щелкнуть. |
|
|
Секунды между развертыванием и свертыванием
|
SecondsBetweenExpandCollapse | double |
Количество секунд, ожидаемых между действиями развертывания и свертыванием, если задано значение true. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Щелкните элемент списка UIA по индексу
Щелкает элемент списка, соответствующий указанному индексу. Обычно это используется для выбора элемента в раскрывающемся списке или элементе меню.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Сначала разверните
|
ExpandFirst | boolean |
Если задано значение true, IA-Connect попытается развернуть список перед поиском элементов элемента списка. Это полезно для динамических списков, так как элементы элемента списка могут не создаваться, пока не будет развернут список. |
|
|
Свернуть после
|
CollapseAfter | boolean |
Если задано значение true, то список будет свернут после выполнения поиска. |
|
|
Индекс элемента
|
ItemIndex | integer |
Индекс в списке элемента, который нужно щелкнуть. |
|
|
Секунды между развертыванием и свертыванием
|
SecondsBetweenExpandCollapse | double |
Количество секунд, ожидаемых между действиями развертывания и свертыванием, если задано значение true. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Элемент Focus UIA
Фокусирует элемент, который делает его активным элементом для фокуса клавиатуры, и в зависимости от приложения может привести окно элемента к переднему плану.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |
Элемент Свернуть UIA
Свернут элемент (обычно меню или раскрывающийся элемент). Если элемент уже свернут, ничего не произойдет.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дескриптор родительского окна
|
ParentWindowHandle | True | integer |
Родительский дескриптор окна UIA (значение 1 или выше), который будет выступать в качестве отправной точки для поиска. Это можно обнаружить с помощью проверки с помощью таких действий, как "Ожидание элемента рабочего стола" или "Ожидание элемента". |
|
Имя элемента поиска
|
SearchElementName | string |
Необязательное имя элемента UIA для поиска (начиная с родительского дескриптора окна). Это можно обнаружить с помощью проверки. |
|
|
Имя класса элемента Search
|
SearchElementClassName | string |
Необязательное имя класса элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Идентификатор автоматизации элементов поиска
|
SearchElementAutomationId | string |
Необязательный идентификатор автоматизации элемента UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Локализованный тип элемента поиска
|
SearchLocalizedControlType | string |
Необязательный тип локализованного элемента управления UIA для поиска (начиная с дескриптора родительского окна). Это можно обнаружить с помощью проверки. |
|
|
Поиск поддерев UIA
|
SearchSubTree | boolean |
Если задано значение true, то будет выполнен поиск по всему дереву UIA под родительским дескриптором окна. Это более тщательно, но может занять больше времени. Если задано значение false, поиск будет выполнен только под родительским дескриптором окна в дереве UIA. |
|
|
Индекс сопоставления
|
MatchIndex | integer |
Если несколько элементов соответствуют поиску, какой элемент (начиная с 1) должен соответствовать. Можно использовать в сочетании с параметром "Сортировка по столбцу", чтобы выбрать порядок сортировки для сопоставления. |
|
|
Фильтр поиска
|
SearchFilter | string |
Необязательный расширенный фильтр для дальнейшего ограничения поиска с помощью условных операторов и любого поля элемента. Пример 1: [ширина] < 200. Пример 2. [Имя], например Document*, AND [ClassName], например Label*. Дополнительные примеры см. в документации. |
|
|
Сортировка по имени столбца
|
SortByColumn | string |
Если несколько элементов соответствуют поиску, это позволяет указать, какое свойство элемента следует сортировать по. Он будет использоваться в сочетании с параметром Match index, чтобы выбрать обязательный элемент. Например, если "Сортировка по имени столбца" имеет значение [TopEdge] и "Match index" равно 1, то соответствующий элемент, ближайший к верхней части экрана, будет сопоставлен. |
|
|
Индекс соответствия возрастает
|
MatchIndexAscending | boolean |
Если несколько элементов соответствуют поиску, должен соответствовать индексу в верхней части отсортированного списка (true) или из нижней части отсортированного списка (false). |
|
|
Максимальное количество элементов для поиска
|
MaxElementsToSearch | integer |
Максимальное количество элементов для поиска целевого элемента в дереве UIA. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальная относительная глубина поиска
|
MaxRelativeSearchDepth | integer |
Максимальная относительная глубина дерева для поиска дочерних элементов под родительским элементом. Прямые дочерние элементы будут иметь значение глубины 1. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Установите значение 0 для неограниченной глубины поиска. Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Максимальное количество дочерних элементов для поиска на каждом узле
|
MaxChildElementsToSearchPerNode | integer |
Максимальное количество дочерних элементов для поиска под каждым элементом при поиске дерева UIA для целевого элемента. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). По умолчанию это значение равно 0 (неограниченно). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Локализованные типы элементов управления не проходят
|
ElementLocalizedControlTypesNotToTraverse | string |
Разделенный запятыми список локализованных типов элементов UIA, которые не проходят (шаг в) при поиске дерева UIA для целевого элемента. Поиск по-прежнему проверяет, соответствует ли отдельный элемент условию поиска, однако он не будет искать дочерние элементы этого элемента, если его локализованный тип элемента находится в этом списке исключений. Эти входные данные работают только в том случае, если режим поиска элементов UIA — "Дерево" (это можно включить на странице параметров в инспекторе). Обычно эти входные данные используются для оптимизации поиска элементов. |
|
|
Рабочий процесс
|
Workflow | True | string |
Добавьте следующее выражение здесь: workflow() |