Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

В Robin Studio 2.0 также есть возможность автоматической записи сразу нескольких Win-элементов при помощи функции «Запись действий».

Создание и редактирование блоков Win-элементов

Все win-элементы автоматически распределяются по отдельным блокам в зависимости от названия процесса.

Чтобы создать новый win-элемент, нужно нажать на кнопку Image Removed около надписи «Win элементы».  Появятся поля, которые должны быть обязательно заполнены:

  1. «Process name» - название процесса, в одном из окон которого расположены необходимые элементы.
  2. «DisplayName» - название окна, в котором расположены элементы.

Имя окна и имя процесса могут совпадать.

На распределение элементов по блокам влияет только имя процесса, которое будет указано в параметрах элемента. При этом имя окна, указанное в параметрах элемента, может не совпадать с тем, которое указано в параметрах всего блока.

Image Removed

После заполнения полей необходимо нажать на кнопку «Сохранить».

Если нужно выйти с формы добавления win-элемента без сохранения внесенных изменений, нажмите на кнопку «Отмена» или на кнопку Image Removed.

У каждого блока при наведении на него отображаются 3 кнопки:

  1. Добавить Image Removed – открывает окно для ввода параметров нового элемента.
  2. Редактировать Image Removed– раскрывает поля «Имя процесса» и «Имя окна» для их редактирования.
  3. Развернуть Image Removed– разворачивает блок в виде списка элементов, которые в него входят.

Image Removed

При переименовании блока (изменении названия процесса), название процесса автоматически меняется и во всех элементах, входящих в этот блок.

Однако при изменении названия процесса в параметрах элемента, этот элемент будет перенесен в блок с соответствующим названием. Если же блока с таким названием еще не было, он будет создан автоматически.

Добавление и редактирование Win-элементов

Чтобы добавить в необходимый блок новый элемент, необходимо нажать на кнопку Image Removed в этом блоке.

Открывается окно с параметрами элемента:

Image Removed

...

Параметр

...

Тип

...

Назначение

...

DisplayName*

...

поле

...

Поле является обязательным для заполнения

Название win-элемента. При использовании шпиона или Рекордера заполняется автоматически именем окна, в котором был определен этот элемент

...

Window name

...

поле

...

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

...

Process name

...

поле

...

Автоматически заполнено названием блока (названием процесса), на котором нажимали кнопку «Добавить». При использовании шпиона автоматически заполняется названием процесса, которое определил шпион. При использовании Рекордера или шпиона заполняется автоматически.

...

Definition

...

поле

...

В данном поле указываются уникальные идентификаторы элемента. При использовании шпиона или Рекордера заполняется автоматически.

Отображаются только те идентификаторы которые пользователь посчитал нужным оставить, а не все, которые могут быть у элемента

...

XPath

...

поле

...

Путь до элемента, определяемый порядком следования элементов внутри друг друга

...

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

...

Spy

...

кнопка

...

При нажатии открывается окно шпиона для автоматической записи идентификаторов элементов

...

Сохранить

...

кнопка

...

При нажатии все внесенные изменения сохраняются, а окно параметров закрывается

...

Отмена

...

кнопка

...

При нажатии окно параметров закрывается, а все внесенные изменения, очищаются

У каждого элемента при наведении на него есть две кнопки:

  1. Редактировать Image Removed - при нажатии открывается окно с параметрами элемента. Все поля доступны для редактирования.
  2. Удалить Image Removed - при нажатии удаляет выбранный элемент.

Image Removed

Использование Win-spy

Для захвата win-элемента и его параметров необходимо нажать на кнопку SPY , далее, в появившемся окне нажать на кнопку [Захватить] в правой части окна, а затем нажать на клавишу [CTRL] и нажать ЛКМ.

Image Removed

В разделе «Дерево элементов окна» появится информация о названии элемента, в разделе «Скриншот экрана» - скриншот элемента.

Примечание. В окне шпиона отображаются скриншот и идентификаторы только того элемента, который выбран в дереве элементов. Таким образом, можно просмотреть скриншоты и идентификаторы всех элементов, которые шпион смог определить в окне приложения, и сохранить нужный.

При нажатии на кнопку «Построить дерево» будет показано «дерево» (список элементов) выбранного приложения Windows. 

При осуществлении ЛКМ по элементу дерева будет показываться скриншот элемента и его параметры.

Image Removed

В разделе «Список свойств» отображается список параметров окна и набор кнопок. При нажатии на кнопку [Захватить] будет произведен «захват» окна Windows, при нажатии на кнопку [Найти] будет осуществлена проверка того, чтобы выбранный в левой части интерфейса элемент можно найти на экране. 

Красной рамкой выделяется найденный элемент.

 

Image Removed

При нажатии на кнопку [Выбрать уникальные] осуществляется фильтрация выбранных параметров до минимального набора для идентификации элемента.

В поле «Порядок», в котором можно вручную указать порядковый номер (относительно других элементов в окне приложения) выбранного элемента. В этом случае поле не будет заполнено автоматически. 

В поле "Номер окна" можно указать номер окна приложения.

Image Removed

В окне «Статус» отображается количество найденных элементов на экране.

Для сохранения выбранного элеента необходимо нажать на кнопку [Сохранить]. Выбранные элементы сохраняются в формате JSON.

Подстановка переменных / результатов в свойство Order 

Order -  порядковый номер элемента. Он работает с учетом выбранных свойств. Если по выбранным свойствам находится несколько элементов, order позволяет указать какой из этих найденных элементов нужен

Order - строковое значение. Свойство "Order" располагается в Definition.

Image Removed

Чтобы поменять значение порядка другим действием, надо обратиться как Элемент.Definition.

Успешное выполнение.

Предусловие: создан win-элемент.

Image Removed

  1. Поставить на рабочую область действие "Заменить совпадения". В поле "Текст" указали win-элемент и его свойство Order. (Файл.Definition).
  2. Поставить на рабочую область действие "Фокус на элементе". Заполнить поля. Тип события - клик ЛКМ.  В поле "Элемент" указываем тот элемент, который изменяли (Файл).

Image Removed

Результат: робот нажал на тот элемент, порядковый номер которого изменяли. 

Рассмотрим другие примеры, описанные в таблице ниже: 

...

Предусловие:

  1. Открыт или создан новый робот
  2. Открыто приложение "Блокнот"
    Image Removed

...

...

Действие

...

Ожидаемый результат

...

  1. Шпион запущен
  2. Элемент захвачен, отображаются свойства элемента
  3. Свойства настроены, данным свойствам соответствует 6 элементов

...

Order в шпионе

  1. Оставить "Порядок"=0 и нажать "Найти"
  2. Указать "Порядок"=2 и нажать "Найти"
  3. Указать "Порядок"=6 и нажать "Найти"
  4. Нажать "Сохранить" в шпионе
  5. Сохранить win-элемент

...

  1. Найдено 6 элементов, все элементы меню подсвечены красной рамкой
    Image Removed
  2. Найден и подсвечен один элемент - кнопка "Файл"
    Image Removed
  3. Найден и подсвечен один элемент - кнопка "Справка"
    Image Removed
  4. Шпион закрывается, в win-элементе теперь отсутствует отдельно поле Order, а поле Definition заполнено так:

    {
    "30004": "элемент меню",
    "order": "6"
    }

  5. Win-элемент сохранен (с названием "элемент меню")

...

Запуск действия

  1. Добавить в робота действие "Получить текст элемента" (работа с win-элементами)
    Image Removed
  2. В действии "Получить текст элемента" указать только что созданный win-элемент
    Image Removed
  3. Запустить робота

...

  1. Действие добавлено
  2. Элемент указан
  3. Действие отрабатывает успешно, в результате - Справка

...

Изменение order в Definition

  1. Добавить в робота действие "Заменить совпадения", группа "Текст" (перед действием "Получить текст элемента")
    Image Removed
  2. В поле "Текст" указать Win-элемент.Definition (в данном случае "элемент меню.Definition")
    В поле "Заменить" указать "order": "6"
    В поле "На" указать "order": "2"
    Сохранить результат в "элемент меню.Definition"
  3. В действии "Получить текст элемента" по-прежнему указан созданный на шаге 2 элемент
  4. Запустить робота
  5. Открыть win-элемент

...

  1. Действие добавлено
  2. Параметры заполнены
  3. В действии "Получить текст элемента" по-прежнему указан созданный на шаге 2 элемент
  4. Действие отрабатывает успешно, в результате - Файл
  5. Поле Definition в элементе не поменялось

...

Нет элемента, подходящего под заданный порядковый номер с заданными свойствами

  1. В поле "Заменить" действия "Заменить совпадения" указать строковую переменную, в которой записано "2"
    В поле "На" указать строковый результат какого-то действия "11"
  2. Запустить робота
  3. Открыть win-элемент

...

Снимок и отображение захваченного элемента  

Для того, чтобы просмотреть сделанный снимок win / web/ sap элемента на экране, нужно:

1 способ.

  1. Нажать на редактирование веб-элемента, появится окно параметров;
    Image Removed
  2. Нажать на кнопку "Снимок элемента", появится окно с изображением.

    Image Removed

Положения для кнопки в параметрах:

  • Кнопка "Снимок элемента" всегда отображается, если есть сохраненный шпионом скриншот, то он откроется по клику, если нет, то кнопка будет неактивна.
  • Диалоговое окно, в котором будет появляться скриншот отображает картинку и крестик, чтобы закрыть окно.
  • Сохраненный скриншот хранится в папке проекта. 
  • Если ресурс (web/win элемент) был удален из студии, то скрин также будет удален. 
  • Если при редактировании ресурса (web/win элемента) туда записан новый элемент через шпион, то старый скрин будет заменен или удален. 
  • Окно не отображается на весь экран при открытии скриншота (в размер стандартной тулзы).

 

2 способ. 

  1. В действии на флоу, к которому прикреплен снимок экрана, навести на иконку камеры; Будет отображен скрин в миниатюре с отметкой точного места захваченного элемента.
    Image Removed
  2. Если убрать курсор с иконки камеры, скрин закроется.

Положения для кнопки на действии:

  • Иконка снимка отображается на тех, действиях, в которых используются win/web элементы (т.е. браузерные действия и windows)
  • Если скрин приложен НЕ к действиям win/web/sap , на них нет иконки просмотра скрина.
  • Если элемент записан через шпион, то там делается скрин и он будет виден при наведении на иконку. Если пользователь создал web-элемент сам и заполнил поля , то там не будет скриншота.
  • Если в действии изменить ссылку на ресурс, скриншот сразу изменится, не надо будет совершать дополнительные действия (сохранять, переоткрывать проект, переапускать студию).