Панель ресурсов

В процессе своей работы, роботы обращаются к различным ресурсам - АРМа, сетевым ресурсам, веб-страницам и т.п. Для работы с этими ресурсами, в Студии есть вкладка «Ресурсы», расположенная слева в интерфейсе Студии.

Для создания или изменения ресурсов, необходимо открыть на левой панели вкладку «Ресурсы» и выбрать сбоку вкладку необходимого вида ресурса:

В ROBIN Studio 2.0 предусмотрены следующие виды ресурсов, используемые роботом в ходе выполнения процесса:

  • Переменные
  • Файлы
  • Win-элементы
  • Web-элементы
  • Отслеживаемые переменные

Давайте рассмотрим их детально.

Переменные

Вид ресурса, содержимое которого может меняться.

Создание переменных

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

Для создания новой переменной необходимо нажать на кнопку плюса Plus:

На левой панели откроется форма «Новая переменная», на которой можно установить параметры создаваемой переменной.

Параметры переменных:

Параметр Назначение Тип Внешний вид
Имя переменной Для ввода названия создаваемой переменной. Поле ../_images/NameOfVariable.png
Тип переменной Выбор типа переменной. Выпадающий список ../_images/TypeVariable.png
Значение Для ввода начального значения переменной, если это необходимо. Поле/чекбокс/кнопка Зависит от выбранного типа переменной. Подробнее в разделе Типы переменных.
Отслеживать при debug При активации этого атрибута значения переменной будут отображаться в логе Программного робота. Чекбокс ../_images/debag.png
Входной параметр робота При активации этого атрибута, параметры (значения), поступающие в Программного робота при его запуске, будут записаны в эту переменную. Чекбокс ../_images/EnterP.png
Результат работы робота При активации этого атрибута последнее значение переменной по выполнению сценария будет записано в отдельный xml-файл в виде схемы. Чекбокс ../_images/ResultWork.png
Комментарий Для ввода комментария к создаваемой переменной. Поле ../_images/Comment.png

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

Сортировка переменных

Для того, чтобы выполнить сортировку переменных необходимо нажать на кнопку сортировки, далее можно сделать сортировку по порядку добавления, проставив чекбокс около нужного значения (новые/старые) и сортировку по имени (А-Я /Я-А). Для сохранения внесенных изменений следует нажать на кнопку «Применить», для отмены и переходу к списку переменных на кнопку «Отмена».

Редактирование переменных

Для редактирования ранее созданных переменных необходимо перейти на общий список всех переменных (отображается на левой панели на вкладке «Ресурсы»).

У всех созданных переменных, которые отображаются в общем списке, есть:

Параметр Назначение Тип Внешний вид
Имя Название переменной. Можно изменить только при нажатии кнопки редактирования. Поле ../_images/Name.png
Тип переменной Графическое изображение типа переменной. Изображение Зависит от выбранного типа переменной
Отслеживать при debug При активации кнопки значения переменной будут отображаться в логе Программного робота. Кнопка
  1. Параметр не активирован
../_images/notact.png
  1. Параметр активирован
../_images/act.png
Значение Для отображения и редактирования начального значения переменной. Поле/чекбокс/кнопка Внешний вид зависит от выбранного типа переменной. Подробнее в разделе Типы переменных.
Редактировать Кнопка отображается только при наведении на конкретную переменную. По нажатии откроется форма «Редактирование», содержащая все параметры, которые были доступны при создании переменной. Кнопка ../_images/pencil.png
Удалить Кнопка отображается только при наведении на конкретную переменную. По нажатии выбранная переменная будет удалена. Кнопка ../_images/bug.png

Типы переменных

При создании сценария в Robin Studio существует возможность создавать переменные. Для создания переменных необходимо открыть вкладку «Ресурсы» и перейти в раздел «Переменные». При очистке полей с переменными в действиях , путем нажатия на кнопку крестика, данные в полях будут очищаться, а не заменены значением по умолчанию.

Ниже рассмотрены доступные типы переменных:

  1. Горячие клавиши

Тип данных: Горячие клавиши

Описание переменной: Данная переменная используется для записи нажатия на какую-либо клавишу или комбинацию клавиш клавиатуры.

Значение по умолчанию (при создании): Не применимо

Пример использования:

Задача: Необходимо создать переменную типа «Горячие клавиши» и указать ее в действии «Ожидание нажатия горчих клавиш».

Решение:

Заполнить поля для создания переменной.

Для того, чтобы указать значение клавиши, необходимо нажать на кнопку в поле «Значение».

Далее, будет открыто окно , в котором необходимо нажать на требуемые горячие клавиши и нажать кнопку «Сохранить». При необходимости удаления указанных клавиш можно нажать на кнопку крестика.

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

  1. Дата-время

Тип данных: Дата-время

Описание переменной: Данная переменная используется для хранения даты и времени в формате dd-mm-yyyy hh:mm:ss.

Значение по умолчанию (текущее время компьютера):

Пример использования:

Задача: Необходимо создать переменную типа «Дата-время» и указать ее в действии «Изменить дату».

Решение: Заполнить поля для создания переменной.

При создании переменной параметр «Значение» заполняется путем выбора даты и времени из открывшегося окна.

Указать данную переменную в параметре «Дата» действия «Изменить дату».

При удалении значения даты и времени в параметре действия, будет отображено пустое поле (даты по-умолчанию не будет).

  1. Коллекция

Тип данных: Коллекция

Описание переменной: Данная переменная используется для записи набора значений одного или нескольких типов. Элементом коллекции так же может быть коллекция.

Значение по умолчанию (при создании): Записей = 0

Пример использования:

Задача: создать переменную типа «Коллекция» и указать ее в параметре действия «Добавить элемент».

Решение:

Заполнить поля для создания переменной.

При создании коллекции для каждого ее значения можно выбрать тип.

Указать созданную переменную в параметре «Коллеция» действия «Добавить элемент».

  1. Координаты точки

Тип данных: Координаты точки

Описание переменной: Переменная данного типа содержит координаты X и Y какой-либо точки на экране.

Значение по умолчанию (при создании): (0,0)

Пример использования:

Задача: создать переменную типа «Координаты точки» и указать ее в параметре действия «Клик мышью».

Решение:

Заполнить поля для создания переменной.

При создании переменной можно заполнить значения координат X и Y вручную, либо автоматически посредством нажатия кнопки «PickArea» в открывающимся окне.

Указать созданную переменную в параметре действия «Клик мышью».

  1. Логический

Тип данных: Логический

Описание переменной: Переменная данного типа содержит значения True или False. Заполненный чек-бокс при создании переменной означает, что переменная будет содержать значение истины (True), в противном случае переменная примет значение «ложь (False).

Значение по умолчанию (при создании): False

Пример использования:

Задача: создать переменную типа «Логический » и указать ее в параметре действия «Если».

Решение:

Заполнить поля для создания переменной.

Указать созданную переменную в параметре действия «Если».

  1. Область

Тип данных: Область

Описание переменной: Переменная данного типа содержит значения размера и координат прямоугольной области

Значение по умолчанию (при создании):

Пример использования:

Задача: создать переменную типа «Область» и указать ее в параметре действия «Изменить область».

Решение:

Заполнить поля для создания переменной.

При создании переменной этого типа необходимо указать следующие параметры:

  • Х левого верхнего угла;
  • Y левого верхнего угла;
  • Высота;
  • Ширина;

Заполнить координаты, ширину и высоту можно как в ручном режиме, так и в автоматическом режиме, посредством нажатия на кнопку «PickArea».

Указать созданную переменную в параметре действия «Изменить область».

  1. Объект

Тип данных: Объект

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

Значение по умолчанию (при создании): не применимо

Пример использования:

Задача: создать переменную типа «Объект» и указать ее в параметре действия «Добавить объект».

Решение:

Заполнить поля для создания переменной.

Для заполнения поля значения необходимо нажать на кнопку в поле «Значение» и в открывшемся окне указать тип и значение.

Указать созданную переменную в параметре действия «Добавить объект».

  1. Пароль

Тип данных: Пароль

Описание переменной: Переменная этого типа содержит в себе информацию о пароле.

Значение по умолчанию (при создании): без пароля

Пример использования:

Задача: создать переменную типа «Пароль» и указать ее в параметре действия «Отправить текст» (группа «Браузеры»).

Решение:

Заполнить поля для создания переменной.

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

Указать созданную переменную в параметре действия «Отправить текст».

  1. Путь к папке

Тип данных: Путь к папке

Описание переменной: Переменная данного типа содержит значения пути к определенной папке

Значение по умолчанию (при создании): не применимо

Пример использования:

Задача: создать переменную типа «Путь к папке» и указать ее в параметре действия «Переименовать папку».

Решение:

Заполнить поля для создания переменной.

Пример использования данной переменной:

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

Указать созданную переменную в параметре действия «Переименовать папку».

  1. Путь к файлу

Тип данных: Путь к файлу

Описание переменной: Переменная данного типа содержит путь к файлу.

Значение по умолчанию (при создании): не применимо

Пример использования:

Задача: создать переменную типа «Путь к файлу» и указать ее в параметре действия «Переименовать файл».

Решение:

Заполнить поля для создания переменной.

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

Указать созданную переменную в параметре действия «Переименовать файл».

  1. Словарь

Тип данных: Словарь

Описание переменной:

Переменная типа «Словарь» представляет собой массив данных, в отличие от коллекции, работающей с ключами и значениями, а не индексами.

К каждому значению из словаря можно получить доступ по ключу. Значение может быть любого из предложенных в студии типов.

Значение по умолчанию (при создании): Записей = 0

Пример использования:

Задача: создать переменную типа «Словарь» и указать ее в параметре действия «Добавить объект».

Решение:

Заполнить поля для создания переменной.

При заполнении значения переменной возможно указать ключ, тип значения и само значение в появляющемся окне.

Созданную переменную указать в параметре действия «Добавить объект».

  1. Строка

Тип данных: Строка

Описание переменной:

Переменная с типом данных «Строка» содержит произвольную последовательность символьного алфавита.

Значение по умолчанию (при создании): не применимо

Пример использования:

Задача: создать переменную типа «Строка» и указать ее в параметре действия «Сообщение».

Решение:

Заполнить поля для создания переменной.

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

Созданную переменную указать в параметре действия «Сообщение».

  1. Таблица

Тип данных: Таблица

Описание переменной:

Переменная этого типа предназначена для хранения данных в виде таблицы.

Значение по умолчанию (при создании): пустая таблица

Пример использования:

Задача: создать переменную типа «Таблица» и указать ее в параметре действия «Получить сообщение».

Решение:

Заполнить поля для создания переменной.

Указать созданную переменную в параметре действия «Получить сообщение».

  1. Число

Тип данных: Число

Описание переменной:

Переменная с типом данных «Число» хранит в себе числовые значения.

Значение по умолчанию (при создании): 0

Пример использования:

Задача: создать переменную типа «Число» и указать ее в параметре действия «Сложение».

Решение:

Заполнить поля для создания переменной.

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

Поиск действий по используемым переменным

Для того, чтобы осуществлять поиск по используемым переменным необходимо:

  1. Установить платформу.
  2. Открыть студию.
  3. Создать робота.

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

Ресурс может использоваться в качестве параметра или результата в зависимости от потребностей , напрямую или в качестве свойства (например winelement.xPath).

Для этого нужно:

На верхней панели нажать на кнопку «Поиск» (Лупа) - отображается строка поиска, внутри которой написано «Поиск ресурса…» и иконка лупы.

  • В верхней панели студии нажать на иконку поиска.
  • Отображаются три вкладки: «Ресурсы», «Действия» и «Контексты»
  • Выбрать вкладку «Ресурсы». Вид ресурса «Переменные».
  • Вкладка «Ресурсы» расположена между «Действия» и «Контексты»
  • В списке переменных раскрыть список действий, где она используется.
  • Нажать на используемое действие.

Рассмотрим последовательно следующие действия по поиску используемых переменных.

1. Отображение вкладки «Ресурсы» и её строки поиска

1.1 Выбрать вкладку «Ресурсы».

2 . Создание ресурсов 2.1 Создание переменной.

2.2 Создание ресурса «файл».

2.3 Создание ресурса веб элемента.

где,

  • 1 – Вкладка ресурсы
  • 2 – Кнопка создать ресурс
  • 3 – Поле ввода атрибута, по которому робот будет обращаться
  • 4 – Выпадающий список, в котором мы будем выбирать атрибут

2.4 Создание ресурса win элемента

Для создания win элемента необходимо запустить шпиона. В шпионе необходимо выбрать кнопку захватить и далее уже навестись на нужный win элемент и путем зажатия кнопки LCTRL и ЛКМ мы захватываем нужный нам элемент. После уже нажимаем кнопку сохранить.

3. В проекте есть ресурсы, но ресурсы нигде не используются

Вводим 1 в поле «Ресурсы»

Вводим «Переменная 1»

Вводим «Файл»

Вводим «Веб»

Вводим «Вин»

Так как ресурсы не используются нигде, около записи с ресурсами нет выпадающего списка (нет кнопки «Развернуть») и при клике по записи с самим ресурсом ничего не происходит.

4 . Поиск действий по используемым Переменным

4.1 . Добавить два действия «Перевернуть 1» и «Перевернуть 2»

Добавить два действия «Перевернуть 1» и «Перевернуть 2».
WorkWithRobinStudio/RPanel/4.1.png:alt:

В действии «Перевернуть 1» указать в качестве входного параметра «Текст» ресурс «Переменная 1».

В действии «Перевернуть 2» указать в качестве выходного параметра ресурс «Переменная 1».

4.2. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и очистить строку поиска (см в п. 1.1)

4.3. Активировать поиск, введя в него слово «Переменная»

4.4. Развернуть выпадающий список у ресурса «Переменная»

*4.5. Кликнуть на каждый элемент выпадающего списка: «Перевернуть 1» и «Перевернуть 2» *

Если мы кликнем на «Перевернуть 1», «Перевернуть 2», то нас перекинет на само действие, где данная переменная используется.

5. Поиск действий по используемым Файлам

5.1. Добавить два действия «Прочитать текстовый файл 1» и «Открыть 1»(например, из группы «Word»).

5.2. В «Прочитать текстовый файл 1» указать в качестве входного параметра ресурс «Файл 1»

5.3 В «Открыть 1» указать в качестве входного параметра ресурс «Файл 1»

5.4. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и очистить строку поиска

5.5. Активировать поиск, введя в него слово «Файл»

5.6. Развернуть выпадающий список у ресурса «Файл 1»

5.7. Кликнуть на каждый элемент выпадающего списка: «»Прочитать текстовый файл 1» и «Открыть 1»

При клике на строку с записью «Прочитать текстовый файл 1» студия пролистывает сценарий и фокусируется на действии «Прочитать текстовый файл 1», на панели свойств отображаются свойства действия «Прочитать текстовый файл 1»

При клике на строку с записью «Открыть 1» студия пролистывает сценарий и фокусируется на действии «Открыть 1», на панели свойств отображаются свойства действия «Открыть 1».

6 . Поиск действий по используемым Web-элементам

6.1. Добавить два действия «Отправить текст 1» и «Отправить клик 1».

6.2 . В «Отправить текст 1» указать в качестве входного параметра ресурс «Веб-элемент 1».

6.3. В «Отправить клик 1» указать в качестве входного параметра ресурс «Веб-элемент 1».

6.4. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и очистить строку поиска.

6.5. Активировать поиск, введя в него слово «Веб-элемент».

6.6. Развернуть выпадающий список у ресурса «Веб-элемент 1».

6.7. Кликнуть на каждый элемент выпадающего списка: «Отправить текст 1» и «Отправить клик 1».

При клике на строку с записью «Отправить текст 1» студия пролистывает сценарий и фокусируется на действии «Отправить текст 1», на панели свойств отображаются свойства действия «Отправить текст 1» При клике на строку с записью «Отправить клик 1» студия пролистывает сценарий и фокусируется на действии «Отправить клик 1», на панели свойств отображаются свойства действия «Отправить клик 1»

7 . Поиск действий по используемым Win-элементам

7.1. Добавить два действия «Фокус на элементе 1» и «Получить текст элемента 1».

7.2. В «Фокус на элементе 1» указать в качестве входного параметра ресурс «Вин-элемент 1».

7.3. В «Получить текст элемента 1» указать в качестве входного параметра ресурс «Вин-элемент 1».

7.4 . На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и очистить строку поиска.

*7.5 . Активировать поиск, введя в него слово «Вин-элемент».

*7.6 . Развернуть выпадающий список у ресурса «Вин-элемент.»

7.7. Кликнуть на каждый элемент выпадающего списка: «Фокус на элементе 1» и «Получить текст элемента 1».

При клике на строку с записью «Фокус на элементе 1» студия пролистывает сценарий и фокусируется на действии «Фокус на элементе 1» , на панели свойств отображаются свойства действия «Фокус на элементе 1».*

При клике на строку с записью «Получить текст элемента 1» студия пролистывает сценарий и фокусируется на действии «Получить текст элемента 1», на панели свойств отображаются свойства действия «Получить текст элемента 1».

8 . Поиск действий по используемым свойствам ресурсов

8.1. Добавить действия «Конвертировать данные 1» и «Заменить совпадения 1».

8.2 . В действии «Конвертировать данные 1» в качестве входного параметра указать свойство ресурса «Вин-элемент 1» : «Вин-элемент 1.WindowName».

8.3. В действии «Заменить совпадения 1» в качестве выходного параметра указать свойство ресурса «Вин-элемент 1» : «Вин-элемент 1.Definition».

8.4. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы».

*8.5. Активировать поиск, введя в него «Вин-элемент».

8.6 . Развернуть выпадающий список у ресурса «Вин-элемент 1».

8.7 . Добавить действия «Конвертировать данные 2» и «Заменить совпадения 2».

8.8. В действии «Конвертировать данные 2» в качестве входного параметра указать свойство ресурса «Веб-элемент 1» : «Веб-элемент 1.XPath».

8.9. В действии «Заменить совпадения 2» в качестве выходного параметра указать свойство ресурса «Веб-элемент 1» : «Веб-элемент 1.DisplayName».

8.10. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы». Активировать поиск, введя в него «Веб-элемент» Развернуть выпадающий список у ресурса «Веб-элемент 1».

8.11. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы». Активировать поиск, введя в него «Файл» Развернуть выпадающий список у ресурса «Файл 1» на вкладке «Файлы».

8.12. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы». Активировать поиск, введя в него цифру «1» Развернуть выпадающий список у каждого из ресурсов.

9 . Проверка с несколькими ресурсами одного типа

9.1. Создать еще несколько ресурсов (например, еще по 5-10 штук):

  • несколько переменных.
  • несколько ресурсов-файлов.
  • несколько веб-элементов.
  • несколько вин-элементов.

9.2. Добавить в сценарий много разных действий, в параметрах и результатах которых указать только что созданные ресурсы и свойства данных ресурсов (касается всех ресурсов, кроме переменных).

9.3. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и проверить каждый из типов ресурсов, активировав поиск вводом имени ресурса.

10 . Переоткрыть студию и еще раз проверить каждую вкладку на вкладке «Ресурсы» в функционале «Поиск»

11. Проверка, когда в одном действии одновременно используются ресурсы разных типов

11.1. Добавить в сценарий действие «Добавить элемент 1», увеличить количество параметров.

11.2. В параметре «Объект» указать ресурс «Переменная 1».

В параметре «Объект 1» указать свойство ресурса «Файл 1» : «Файл 1.Value».

В параметре «Объект 2» указать свойство ресурса «Веб-элемент 1» : «Веб-элемент 1.XPath».

В параметре «Объект 3» указать свойство ресурса «Вин-элемент 1» : «Вин-элемент 1.Definition».

11.3. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и проверить каждый ресурс, активировав поиск вводом имени ресурса.

12. Поиск по частичному совпадению

12.1. В настройках студии в поле «Поиск по строгому совпадению» убрать галочку, если установлена.

12.2. Ввести в поле поиска: «Переменная»

12.3. Ввести в поле поиска: «Файл»

12.4. Ввести в поле поиска: «Веб-элемнт»

12.5. Ввести в поле поиска: «Вин-эемент»

13. Удаление из параметров и результатов действий ресурсов и свойств ресурсов

13.1. Удалить из всех параметров и результатов действий все ссылки на ресурсы.

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

14. Удаление действий, в которых используются ресурсы и их свойства

14.1. В параметрах и результатах действий указать ресурсы и их свойства.

14.2 .Удалить некоторые действия, в которых используются ресурсы.

14.3. На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и проверить каждый ресурс, активировав поиск по имени ресурса.

Удалим действие «Прочитать текстовый файл».

Результат

15. Удаление ресурсов

15.1. В параметрах и результатах действий указать ресурсы и их свойства.

15.2. Удалить все ресурсы.

15.3 .На верхней панели нажать на кнопку «Поиск» (Лупа), выбрать вкладку «Ресурсы» и проверить каждый ресурс, активировав поиск по имени ресурса.

Давайте удалим параметр Файл и проверим.

Результат

Как видим поиск не дал результатов, т.к. ресурс удален.

Файлы

Файлы, используемые в ROBIN Studio 2.0 в качестве ресурса – это внешние ресурсы, необходимые в работе некоторых действий, которые (файлы) хранятся внутри робота. Однако, в отличие от переменных, файлы в ходе выполнения процесса не могут быть перезаписаны. Файлы, которые выступают в качестве ресурсов, могут содержать в себе различную служебную информацию и иметь любое расширение (.txt, .xlsx, .png, .dll и т.д.). Для создания и просмотра всех ресурсов файлового типа необходимо на левой панели открыть вкладку «Ресурсы» и выбрать слева вкладку «Файлы».

При необходимости все файлы можно отсортировать по их названию (от А до Я или наоборот), нажав на кнопку Sort

Или по их расширению, нажав на кнопку Extension

Для отмены определенного вида сортировки нужно снова нажать на соответствующую кнопку.

Добавление файлов

Чтобы добавить новый файл, нужно нажать на кнопку плюса. На левой панели появится форма «Новый файл», на которой необходимо:

  1. Заполнить поле «Название» именем создаваемого ресурса.
  2. Нажать на кнопку «Загрузить» и выбрать в открывшемся окне Проводника нужный файл.

ИЛИ

Перетащить нужный файл в область загрузки:

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

  1. Нажать на кнопку «Создать».

Если нужно выйти с формы добавления файла без сохранения внесенных изменений, нажмите на кнопку «Отмена» или значок крестика вверху формы:

Редактирование добавленных файлов

Все созданные ресурсы файлового типа, которые отображаются в общем списке на левой панели, имеют кнопки (появляются при наведении на конкретный ресурс):

  1. При нажатии Bucket выбранный ресурс будет удален
  1. При нажатии Edit откроется форма «Редактирование», на которой можно поменять имя ресурса или выбрать другой внешний файл
  1. При нажатии SaveR откроется окно Проводника, в котором можно выбрать директорию в системе компьютера, где будет сохранена копия файла из выбранного ресурса

Win-элементы

Win-элементы – это ресурсы, в которых записаны уникальные идентификаторы, определяющие конкретный элемент (кнопка/поле/т.п) в окне Windows. Действия из группы «Windows» используют параметры из win-элемента для обнаружения этого элемента в окне и дальнейшей работы с ним.

Для создания и просмотра всех win-элементов необходимо на левой панели открыть вкладку «Ресурсы» и нажать внизу на кнопку «Win-элементы».

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

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

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

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

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

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

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

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

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

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

AddRes - Добавить, открывает окно для ввода параметров нового элемента.

EditRes - Редактировать, раскрывает поля «Имя процесса» и «Имя окна» для их редактирования.

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

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

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

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

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

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

Параметр Тип Назначение
Window name Поле Имя окна, в котором робот будет определять необходимый элемент. При использовании Рекордера заполняется автоматически. Поиск возможен по частичному имени окна с применением регулярного выражения
Process name Поле Автоматически заполнено названием блока (названием процесса), на котором нажимали кнопку «Добавить». При использовании шпиона автоматически заполняется названием процесса, которое определил шпион. При использовании Рекордера или шпиона заполняется автоматически.
Display Name Поле Название элемента – именно оно отображается в общем списке элементов. При использовании шпиона или Рекордера заполняется автоматически именем окна, в котором был определен этот элемент.
Definition Поле В данном поле указываются уникальные идентификаторы элемента. При использовании шпиона или Рекордера заполняется автоматически. Отображаются только те идентификаторы которые пользователь посчитал нужным оставить, а не все, которые могут быть у элемента.
XPath Поле Путь до элемента, определяемый порядком следования элементов внутри друг друга.
Order Поле Порядковый номер элемента. Он работает с учетом выбранных свойств. Если по выбранным свойствам находится несколько элементов, order позволяет указать какой из этих найденных элементов нужен.
Spy Кнопка При нажатии открывается окно шпиона для автоматической записи идентификаторов элементов.
SapSpy Кнопка При нажатии открывается окно шпиона для автоматической записи идентификаторов элементов в SAP
Сохранить Кнопка При нажатии все внесенные изменения сохраняются, а окно параметров закрывается.
Отмена Кнопка При нажатии окно параметров закрывается, а все внесенные изменения, очищаются.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Поставить на рабочую область действие «Заменить совпадения». В поле «Текст» указали win-элемент и его свойство Order. (Файл.Definition).

  • Поставить на рабочую область действие «Фокус на элементе». Заполнить поля. Тип события - клик ЛКМ. В поле «Элемент» указываем тот элемент, который изменяли (Файл).

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

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

Запуск действия и изменение order в Definition:

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

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

1 способ.

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

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

    • Кнопка «Снимок элемента» всегда отображается, если есть сохраненный шпионом скриншот, то он откроется по клику, если нет, то кнопка будет неактивна.
    • Диалоговое окно, в котором будет появляться скриншот отображает картинку и крестик, чтобы закрыть окно.
    • Сохраненный скриншот хранится в папке проекта.

  • Если ресурс (web/win элемент) был удален из студии, то скрин также будет удален.

  • Если при редактировании ресурса (web/win элемента) туда записан новый элемент через шпион, то старый скрин будет заменен или удален.

  • Окно не отображается на весь экран при открытии скриншота (в размер стандартной тулзы).

2-й способ.

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

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

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

Web-элементы

Web-элемент - это ресурс, хранящий информацию об уникальном элементе на web-странице (текстовое поле/кнопка/блок текста)

Действия из группы «Браузерыs» используют параметры из web-элемента для обнаружения этого элемента в окне и дальнейшей работы с ним.

Web-recorder - удобный инструмент для записи действий пользователя в браузере.

Recorder записывает манипуляции пользователя в браузере и автоматически производит добавление определенных действий на схему робота в Студии. Записанные таким образом действия помещаются в конец схемы робота.

Порядок работы Web-recorder

  1. Web-recorder производит запись действий пользователя, и отправляет их в Robin Studio с помощью технологии Web Sockets;
  2. В Robin Studio создаётся ресурс с типом «web-элемент»;
  3. На основании параметров из web-элемента вызывается соответствующее действие и располагается на рабочем поле;
  4. Параметры действия заполняются параметрами из web-элемента (по умолчанию «Default attribute»);
  5. При запуске действия ПО обращается к параметрам веб-элемента.

Внимание! Web-recorder поддерживает только браузер Chrome.

Все добавленные действия автоматически предзаполняются входными параметрами, полученными из браузера. В случае если параметр не найден действием, автоматически выбирается следующий параметр из веб-элемента. В случае если параметр не найден действием, автоматически выбирается следующий параметр из веб-элемента. У вэб элемента есть ряд параметров и внизу окна «Добавление нового ресурса» есть выпадающий список, где можно выбрать по какому параметру искать элемент (имя элемента, xpath, selector и др). Например, у нас в поле выбран CssSelector и по нему не удалось найти элемент, но это не значит, что элемент не будет найден. Будет произвден поиск по следуюдщему параметру, например Xpath

Список параметров получаемых Web-recorder

При добавлении ресурса, путем нажатия на кнопку плюса, будет открыто окно «Добавление нового ресурса».

Поля для заполнения:

Параметр Значение параметра
DisplayName Отображаемое имя элемента
Page title Имя страницы
Url Адрес страницы
ElementId Идентификатор элемента
ElementName Имя тега
XPath Запрос к элементу
Full XPath Полный запрос к элементу
Selector Путь к элементу в html
Class Перечисление классов элемента
TagName Тип тега
LinkText Адрес страницы, на который ссылается выбранный элемент
JavaScript Код для поиска элемента на странице
IFrame Имя отдельного HTML-документ на странице
Default Attribute Атрибут который используется в параметрах действия по умолчанию. Возможен выбор элемента.

При нажатии на кнопку [Spy] имеется возможность забрать свойства другого элемента.

При нажатии на данную кнопку будет открыто окно с полями:

  • Поле «Подключение». Выпадающий список из элементов: «Подключиться к открытому браузеру», «Открыть новый браузер». Обязательное поле. Значение по умолчанию - Открыть новый браузер.

  • Поле «Браузер». Выпадающий список из элементов «Google Chrome», «Internet Explorer» , «Yandex». Значение по умолчанию - «Google Chrome»

  • Поле «Адрес страницы». Необязательное поле. Поле активируется, только если выбрано «Открыть новый браузер». В нем вводится адрес страницы, которую необходимо открыть в новом браузере.

  • Кнопка «Начать».

Варианты работы с Web-recorder

Открытие окна WebSpy через тулзу в параметрах действия;

Открытие окна WebSpy через панель ресурсов;

Подключение к последнему активному окну Google Chrome;

Подключение к окну с включенным расширением в Google Chrome;

Подключение к открытому браузеру Internet Explorer;

Открытие нового браузера Google Chrome;

Открытие нового браузера Internet Explorer;

Открытие нового браузера Yandex:

После добавления блока web-элементов пользователю становится доступен набор кнопок:

Функции кнопок:

После нажатия на кнопку [Начать] в правом нижнем углу экрана АРМа появляется окно, в котором отобразится информация о DisplayName, Xpath и Selector.

После закрытия браузера окно WebSpy заполняется соответствующими параметрами.

Для приостановки работы web-элемента необходимо нажать на кнопку «Пауза» , для завершения работы – на кнопку «Стоп». Для сохранения созданного web-элемента необходимо нажать на кнопку «Сохранить», для отказа от сохранения – на кнопку «Отмена».

Список действий поддерживаемых в Recorder

  1. открыть вкладку;
  2. перейти по URL;
  3. отправить нажатие клавиш;
  4. расширенный клик;
  5. получить текст;
  6. получить таблицу;
  7. получить значение;
  8. получить значение чек-бокса;
  9. получить значение списка;
  10. получить значение радио-кнопки;
  11. переключиться на вкладку;
  12. переключиться на фрейм.

Отслеживаемые переменные

В ROBIN Studio 2.0 можно осуществлять отслеживание переменных, результаты которых необходимо видеть во время отладки робота. Также отслеживать можно не только переменные, но и результаты действий. Если поставить переменную или результат действия на отслеживание, то их значение не будет видно во время выполнения, так как значения отслеживаемых переменных видны только когда робот стоит на паузе.

Вкладка «Отслеживаемые переменные» находится на панели «Ресурсы».

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

  1. Добавление уже созданной переменной на вкладку «Отслеживаемые переменные»

1.1 Для выбора переменных с целью дальнейшего их отслеживания, необходимо кликнуть на пиктограмму плюса, после чего отобразится список с переменными.

1.2 Для добавления нужной переменной на вкладку «Отслеживаемые переменные» следует из выпадающего списка нажать на выбранную переменную.

1.3 Переменная появится на вкладке «Отслеживаемые переменные». Также можно воспользоваться строкой «Поиск» для поиска нужной переменной.

../_images/AddTrace.png –> ../_images/AddTrace2.png –> ../_images/AddTrace3.png
  1. Добавление переменной на вкладку «Отслеживаемые переменные» во время ее создания.

2.1 В панели «Ресурсы» необходимо перейти на вкладку «Переменные».

2.2 Добавить переменную (нажать на пиктограмму плюса). Произойдёт переход на форму, где представлены поля для создания новой переменной. После заполнения обязательных полей нужно установить параметр «Отслеживать при debug».

2.3 Кликнуть по кнопке «Создать».

2.4 Далее на вкладке «Отслеживаемые переменные», отобразиться созданная переменная.

  1. Добавление переменной на вкладку «Отслеживаемые переменные» с помощью установки параметра «Отслеживать при debug» в списке созданных переменных, находящиеся на вкладке «Переменные».

3.1 В ресурсах на вкладке «Переменные» представлен список созданных переменных. Нужно кликнуть на значок «Отслеживать при debug».

3.2 Данная переменная отобразится на вкладке «Отслеживаемые переменные».

  1. Добавление результата действия на вкладку «Отслеживаемые переменные».

4.1 Открыть свойства действий и у результата действия сделать значок «Отслеживать при debug» активным.

4.2 Данный результат действия отобразится на вкладке «Отслеживаемые переменные».