Категории приложений
Last updated
Last updated
Статья содержит инструкцию по работе с редактором шаблона поиска в различных категориях приложений. Общая информация о шаблоне поиска приведена здесь.
При добавлении в шаблон нескольких компонентов, каждую строку с компонентом можно детализировать в таблице ниже:
В шаблонах возможно использовать имена переменных в формате {переменная}. Если вы прописываете переменную, то робот во время работы будет менять переменную на нужное значение. Вызов переменной может быть прописан прямо в JSON.
Также в значениях полей допустимо использовать символ *.
ВНИМАНИЕ! В окне редактора для всех режимов, кроме SAP, доступен инструмент Инспектор UI, который позволяет детально исследовать интерфейсы приложений. Работа с инструментом подробнее описана в разделе Инспектор UI.
Шаблон поиска для категории приложений Браузер выглядит следующим образом:
В поле Заголовок укажите название сайта, в котором нужно найти компонент. В поле URL задайте адрес сайта. Не забудьте выбрать тип браузера в параметре рядом с полем Заголовок. На рисунке выше выбран браузер Chrome.
Для добавления компонента вручную:
Для уточнения поиска можно ввести имена и значения атрибутов тега в таблицу (ключ, значение). Если указать несколько строк, поиск элемента в браузере будет вестись вглубь от самого верхнего шаблона.
Свойство "Искать во Фреймах" предназначено для поиска элементов внутри HTML-фреймов <frame> и <iframe>, но при его использовании существуют следующие ограничения:
1. Защищённые фреймы: Если фрейм защищён настройками браузера, то поиск внутри него невозможен.
2. Разные домены: Поиск не выполняется, если содержимое фрейма загружается с другого домена или хоста. Например:
Работает: (тот же домен).
Не работает: <iframe src="https://externaldomain.com/page.html"> (другой домен).
Для корректной работы убедитесь, что фрейм загружает содержимое с того же домена и не имеет ограничений безопасности.
Шаблон поиска для приложений Рабочего стола выглядит следующим образом:
Чтобы присоединиться к нужному приложению, достаточно заполнить одно из полей:
Заголовок — имя главного окна десктоп-приложения.
‼️ Важно. Если заголовок содержит спецсимвол \, его потребуется заэкранировать. Примеры:
◽С:\\Users\\User1\\AppData\\Local\\Primo.Exchange\\ext.chrome - Notepad++;
◽ *\\cmd.exe.
Процесс — название процесса запущенного приложения Windows.
Если заполнены оба поля, будут одновременно учитываться оба значения.
В верхнем правом углу находится параметр с типами автоматизации пользовательского интерфейса:
Технология автоматизации обеспечивает программный доступ к элементам пользовательского интерфейса приложения. Доступны следующие типы:
UIAUTOMATION — значение по умолчанию. Подходит для приложений рабочего стола, работающих по правилам Win32.
UIAUTOMATION_UIA — рекомендуется использовать в случае, если в режиме UIAUTOMATION не удается получить доступ к нужному элементу управления. Более старая технология. 🔹 Примечание. Если сначала был выбран режим UIAUTOMATION_UIA, а потом — UIAUTOMATION, то для корректной работы шаблона поиска потребуется перезагрузить Студию.
MSAA — библиотека Microsoft Active Accessibility. Имеет больше ограничений, чем UIAUTOMATION, т.к. является устаревшей технологией. Обращение к MSAA будет полезным в ограниченном количество случаев: например, когда при поиске текстовых элементов необходимо использовать свойство идентификации Role.
JAVA и JAVA_EXT — предназначены для Java-приложений. Тип Java использует расширение Primo, тип Java_Ext — расширения сторонних вендоров. ‼️ При работе с Java, разрядность Студии и Робота должны совпадать с разрядностью Java. ‼️
RDP — используется для работы с приложениями удаленного рабочего стола по протоколу RDP.
Для добавления компонента вручную:
Для уточнения поиска можно ввести имена и значения атрибутов искомого компонента в таблицу (ключ, значение). Если указать несколько строк, поиск элемента в роботизируемом приложении будет вестись вглубь от самого верхнего шаблона.
Функция Быстрый поиск включена по умолчанию и активирует укороченный маршрут поиска компонента в приложении. Рекомендуется использовать этот параметр при работе с 1С. Быстрый поиск не поддерживает поиск по свойствам идентификации BoundingRectangle, AcceleratorKey, ProcessId, NativeWindowHandle, Orientation. Если в режиме быстрого поиска компонент не находится, отключите параметр и произведите поиск еще раз.
При работе с SAP рекомендуется использовать специализированные компоненты.
Шаблон поиска для категории SAP выглядит следующим образом:
Если происходит работа с WebView SAP, шаблон поиска будет иметь следующий вид:
Область Browser представляет собой шаблон поиска для браузера.
В шаблонах поиска SAP допускается использование символа *.
По-прежнему рекомендуется использовать элементы Студии совместно с контейнерами для экономии ресурсов компьютера. При этом подключение к приложению/браузеру будет настраиваться внутри соответствующего контейнера. Например, если мы используем контейнер Присоединиться к приложению, то заголовок десктоп-приложения и тип автоматизации настраивается в его свойствах, а не в редакторе шаблона.
Если элемент помещен в контейнер, то окно редактора шаблона также будет открываться в режиме Контейнер:
При этом параметры поиска будут соответствовать типу приложения — десктоп или веб. По аналогии с параметрами для категории Браузер или Рабочий стол.
Нажмите кнопку , после чего выделите новую строку и введите данные в поля Тэг, Текст, Индекс (начинается с единицы) и Искать во фреймах (поиск внутри элементов iframe).
Для автоматического добавления компонента нажмите кнопку Выбрать компонент и в нужном окне браузера кликните искомый компонент. Также можно использовать кнопку быстрого добавления на самом элементе.
Нажмите кнопку , выделите новую строку и введите данные в поля AutomationID, Name, ClassName, ControlType, LocalizedControlType и Индекс (начинается с единицы). Поля заполняются выборочно. При этом свойство AutomationID является одним из самых важных при поиске: оно не изменяется при каждом запуске и однозначно идентифицирует компонент.
Для автоматического добавления компонента используйте опцию Выбрать компонент и кликните искомый элемент в окне нужного приложения. Откроется окно для выбора свойств компонента (дерево контроллов). В случае, если необходим обход всего дерева свойств, воспользуйтесь кнопкой Автоматически с установленным чекбоксом Полное дерево контроллов:
