Шаблоны поиска
Шаблон поиска - это свойство ряда элементов Студии, которое используется для взаимодействия с пользовательским интерфейсом программ. Шаблон позволяет идентифицировать компонент приложения и получить к нему программный доступ.
Свойство Шаблон поиска есть, например, у элемента Клик мышью - с его помощью можно определить кнопку приложения, по которой нужно кликнуть.
Шаблон представляет собой JSON-файл, который содержит заданный набор свойств для идентификации компонента. Его можно сформировать вручную или автоматически. Автоматическое формирование является предпочтительным сценарием, для этого используется кнопка Выбрать компонент
- она вызывает захват элемента управления в зависимости от категории приложения. Кнопку можно найти на панели элемента или в его свойствах, например:


Primo RPA поддерживает поиск в категориях:
- Браузер
- Рабочий стол
- SAP
Редактировать шаблон можно двумя способами:
- В формате правки JSON-файла. Для открытия файла нажмите в свойстве Шаблон поиска значок многоточия. Пример:.
- Через окно редактора шаблона. Для открытия графического окна нажмите кнопку. Окно редактора видоизменяется в зависимости от категории приложения. Примеры интерфейса приведены в подразделе Интерфейс редактора шаблона.
Интерфейс редактора зависит от категории приложения, в котором необходимо найти компонент. В ситуации, когда категория неизвестна, окно редактора будет выглядеть так:

После выбора категории приложения в окне редактора появятся соответствующие параметры поиска и возможные команды.
Интерфейс редактора шаблона для категорий Браузер и Рабочий стол имеет следующие общие элементы:

- 1.Режим - иконка выбора между категориями приложений (Браузер, Рабочий стол, SAP). Также доступен режим Контейнер, о котором подр обнее сказано ниже, в подразделе Выбор категории приложений.
- 2.Подтип - список значений зависит от выбранного режима. Например, в режиме Рабочий стол потребуется выбрать тип автоматизации, в режиме Браузер - тип браузера.
- 3.Заголовок - параметр для поиска. Например, имя главного окна десктоп-приложения в режиме Рабочий стол.
- 4.Выбрать компонент- позволяет автоматически выбрать элемент управления и добавить его в шаблон.
- 5.Отобразить компонент- выделяет элемент управления, который был задан в шаблоне. Используется для проверки правильности шаблона поиска.
- 6.Инспектор UI - инструмент для детального исследования интерфейсов приложений. Выводит окно с подробной информацией обо всех открытых приложениях и их компонентах. Позволяет перенести выбранный элемент в шаблон. Подробнее об инструменте см. здесь.
- 7.- кнопка для ручного добавления элемента управления в шаблон.
- 8.- кнопка для удаления элемента из шаблона. Возможно удалить клавишей Del.
Кроме этого, окно редактора имеет две таблицы: первая - для добавления строк с компонентами, а вторая - для детализации каждой строки:

Р ассмотрим, как происходит поиск компонента на примере работы с приложением Калькулятор (категория Рабочий стол).
С точки зрения Windows, приложение состоит из ряда компонентов (кнопки, текстовые поля, таблицы), объединенных в дерево. Любая кнопка, которую видит пользователь в инте рфейсе программы, будет входить в данное дерево. В свою очередь, каждый компонент обладает набором свойств: они идентифицируют элемент приложения, предоставляют информацию о его специфике и назначении, разбивают все компоненты рабочего стола по тегам и классам.
Для идентификации компонента Primo RPA также использует поиск по его свойствам.
Откроем приложение Калькулятор в Windows. Создадим в Студии новый проект и выполним следующие действия:
- 1.Добавим контейнер Присоединиться к приложению. В свойстве Заголовок воспользуемся кнопкойдля быстрого указания названия приложения (Калькулятор).
- 2.
- 3.На панели элемента Клик мышью нажмем кнопку Выбрать компонент- для автоматического добавления компонента в шаблон.

Внимание! Окно с приложением Калькулятор должно быть активным!
После нажатия кнопки
мы переместимся в окно с Калькулятором, чтобы выбрать нужный компонент. При наведении указателя на элемент приложения, он подсветится, а в левом верхнем углу появится его увеличенное изображение:


Выберем кнопку 5 - появится окно с выбором свойств для идентификации компонента:

Необходимо выбрать т акую комбинацию свойств, которая была бы уникальна и неизменна для данного компонента. Для нашего случая выберем параметры AutomationID, Name (имя элемента автоматизации) и нажмем ОК - селектор создан. Он сохранится в JSON-файле шаблона поиска. Если просмотреть готовый шаблон через окно редактора, он будет выглядеть таким образом:

В дальнейшем, при обработке шаблона, Робот возьмет заданные свойства и проанализирует дерево компонентов в поисках позиции, которая имеет указанные значения в параметрах AutomationID и Name. При совпадении значений компонент будет найден.
Категорию приложения (Рабочий стол, Браузер, SAP, Контейнер) можно выбрать в шаблоне вручную либо использовать автоматическое определение. Студия самостоятельно определяет категорию в том случае, если пользователь добавляет компонент в шаблон автоматически - кнопкой
.

Так, в примере с Калькулятором окно редактора шаблона отображается в режиме Контейнер. Система выбрала данный режим потому, что элемент Клик мышью находится в контейнере Присоединиться к приложению*. Студия также определила, что Калькулятор, к которому установлено подключение в контейнере, относится к приложениям рабочего стола, поэтому в окне редактора отображаются настройки для приложений рабочего стола.
Если бы мы использовали шаблон поиска для компонента веб-приложения, а элемент Клик мышью находился бы в контейнере Присоединиться к браузеру, то параметры поиска в окне редактора соответствовали параметрам для категории приложений Браузер:

*Размещение элементов Студии в контейнере экономит ресурсы компьютера и улучшает работу с нагруженными проектами.
Last modified 7d ago