Win-элементы – это ресурсы, в которых записаны уникальные идентификаторы, определяющие конкретный элемент (кнопка/поле/т.п) в окне Windows. Действия из группы «Windows» используют параметры из win-элемента для обнаружения этого элемента в окне и дальнейшей работы с ним.
Для создания и просмотра всех win-элементов необходимо на левой панели открыть вкладку «Ресурсы» и нажать на вкладку «Win-элементы».
В Robin Studio 2.0 также есть возможность автоматической записи сразу нескольких Win-элементов при помощи функции «Запись действий».
Создание и редактирование блоков Win-элементов
Все win-элементы автоматически распределяются по отдельным блокам в зависимости от названия процесса.
Чтобы создать новый win-элемент, нужно нажать на кнопку «Win элементы». Появятся поля, которые должны быть обязательно заполнены:
около надписи- «Process name» - название процесса, в одном из окон которого расположены необходимые элементы.
- «DisplayName» - название окна, в котором расположены элементы.
Имя окна и имя процесса могут совпадать.
На распределение элементов по блокам влияет только имя процесса, которое будет указано в параметрах элемента. При этом имя окна, указанное в параметрах элемента, может не совпадать с тем, которое указано в параметрах всего блока.
После заполнения полей необходимо нажать на кнопку «Сохранить».
Если нужно выйти с формы добавления win-элемента без сохранения внесенных изменений, нажмите на кнопку «Отмена» или на кнопку
.У каждого блока при наведении на него отображаются 3 кнопки:
- Добавить – открывает окно для ввода параметров нового элемента.
- Редактировать – раскрывает поля «Имя процесса» и «Имя окна» для их редактирования.
- Развернуть – разворачивает блок в виде списка элементов, которые в него входят.
При переименовании блока (изменении названия процесса), название процесса автоматически меняется и во всех элементах, входящих в этот блок.
Однако при изменении названия процесса в параметрах элемента, этот элемент будет перенесен в блок с соответствующим названием. Если же блока с таким названием еще не было, он будет создан автоматически.
Добавление и редактирование Win-элементов
Чтобы добавить в необходимый блок новый элемент, необходимо нажать на кнопку
в этом блоке.Открывается окно с параметрами элемента:
Параметр | Тип | Назначение |
DisplayName* | поле | Поле является обязательным для заполнения Название win-элемента. При использовании шпиона или Рекордера заполняется автоматически именем окна, в котором был определен этот элемент |
Window name | поле | Имя окна, в котором робот будет определять необходимый элемент. При использовании Рекордера заполняется автоматически. Поиск возможен по частичному имени окна с применением регулярного выражения |
Process name | поле | Автоматически заполнено названием блока (названием процесса), на котором нажимали кнопку «Добавить». При использовании шпиона автоматически заполняется названием процесса, которое определил шпион. При использовании Рекордера или шпиона заполняется автоматически. |
Definition | поле | В данном поле указываются уникальные идентификаторы элемента. При использовании шпиона или Рекордера заполняется автоматически. Отображаются только те идентификаторы которые пользователь посчитал нужным оставить, а не все, которые могут быть у элемента |
XPath | поле | Путь до элемента, определяемый порядком следования элементов внутри друг друга |
Order | поле | Порядковый номер элемента. Он работает с учетом выбранных свойств. Если по выбранным свойствам находится несколько элементов, order позволяет указать какой из этих найденных элементов нужен |
Spy | кнопка | При нажатии открывается окно шпиона для автоматической записи идентификаторов элементов |
Сохранить | кнопка | При нажатии все внесенные изменения сохраняются, а окно параметров закрывается |
Отмена | кнопка | При нажатии окно параметров закрывается, а все внесенные изменения, очищаются |
У каждого элемента при наведении на него есть две кнопки:
- Редактировать - при нажатии открывается окно с параметрами элемента. Все поля доступны для редактирования.
- Удалить - при нажатии удаляет выбранный элемент.
Использование Win-spy
Для захвата win-элемента и его параметров необходимо нажать на кнопку SPY , далее, в появившемся окне нажать на кнопку [Захватить] в правой части окна, а затем нажать на клавишу [CTRL] и нажать ЛКМ.
В разделе «Дерево элементов окна» появится информация о названии элемента, в разделе «Скриншот экрана» - скриншот элемента.
Примечание. В окне шпиона отображаются скриншот и идентификаторы только того элемента, который выбран в дереве элементов. Таким образом, можно просмотреть скриншоты и идентификаторы всех элементов, которые шпион смог определить в окне приложения, и сохранить нужный.
При нажатии на кнопку «Построить дерево» будет показано «дерево» (список элементов) выбранного приложения Windows.
При осуществлении ЛКМ по элементу дерева будет показываться скриншот элемента и его параметры.
В разделе «Список свойств» отображается список параметров окна и набор кнопок. При нажатии на кнопку [Захватить] будет произведен «захват» окна Windows, при нажатии на кнопку [Найти] будет осуществлена проверка того, чтобы выбранный в левой части интерфейса элемент можно найти на экране.
Красной рамкой выделяется найденный элемент.
При нажатии на кнопку [Выбрать уникальные] осуществляется фильтрация выбранных параметров до минимального набора для идентификации элемента.
В поле «Порядок», в котором можно вручную указать порядковый номер (относительно других элементов в окне приложения) выбранного элемента. В этом случае поле не будет заполнено автоматически.
В поле "Номер окна" можно указать номер окна приложения.
В окне «Статус» отображается количество найденных элементов на экране.
Для сохранения выбранного элеента необходимо нажать на кнопку [Сохранить]. Выбранные элементы сохраняются в формате JSON.
Подстановка переменных / результатов в свойство Order
Order - порядковый номер элемента. Он работает с учетом выбранных свойств. Если по выбранным свойствам находится несколько элементов, order позволяет указать какой из этих найденных элементов нужен
Order - строковое значение. Свойство "Order" располагается в Definition.
Чтобы поменять значение порядка другим действием, надо обратиться как Элемент.Definition.
Успешное выполнение.
Предусловие: создан win-элемент.
- Поставить на рабочую область действие "Заменить совпадения". В поле "Текст" указали win-элемент и его свойство Order. (Файл.Definition).
- Поставить на рабочую область действие "Фокус на элементе". Заполнить поля. Тип события - клик ЛКМ. В поле "Элемент" указываем тот элемент, который изменяли (Файл).
Результат: робот нажал на тот элемент, порядковый номер которого изменяли.
Рассмотрим другие примеры, описанные в таблице ниже:
Предусловие:
| ||||
№ | Действие | Ожидаемый результат | ||
1 |
|
| ||
2 | Order в шпионе
|
| ||
3 | Запуск действия
|
| ||
4 | Изменение order в Definition
|
| ||
5 | Нет элемента, подходящего под заданный порядковый номер с заданными свойствами
|
|
Снимок и отображение захваченного элемента
Для того, чтобы просмотреть сделанный снимок элемента на экране, нужно:
1 способ.
- Нажать на редактирование веб-элемента, появится окно параметров;
- Нажать на кнопку "Снимок элемента", появится окно с изображением.
Положения для кнопки в параметрах:
- Кнопка "Снимок элемента" всегда отображается, если есть сохраненный шпионом скриншот, то он откроется по клику, если нет, то кнопка будет неактивна.
- Диалоговое окно, в котором будет появляться скриншот отображает картинку и крестик, чтобы закрыть окно.
- Сохраненный скриншот хранится в папке проекта.
- Если ресурс (web/win элемент) был удален из студии, то скрин также будет удален.
- Если при редактировании ресурса (web/win элемента) туда записан новый элемент через шпион, то старый скрин будет заменен или удален.
- Окно не отображается на весь экран при открытии скриншота (в размер стандартной тулзы).
2 способ.
- В действии на флоу, к которому прикреплен снимок экрана, навести на иконку камеры; Будет отображен скрин в миниатюре с отметкой точного места захваченного элемента.
- Если убрать курсор с иконки камеры, скрин закроется.
Положения для кнопки на действии:
- Иконка снимка отображается на тех, действиях, в которых используются win/web элементы (т.е. браузерные действия и windows)
- Если скрин приложен НЕ к действиям win/web/sap , на них нет иконки просмотра скрина.
- Если элемент записан через шпион, то там делается скрин и он будет виден при наведении на иконку. Если пользователь создал web-элемент сам и заполнил поля , то там не будет скриншота.
- Если в действии изменить ссылку на ресурс, скриншот сразу изменится, не надо будет совершать дополнительные действия (сохранять, переоткрывать проект, переапускать студию).