Общая информация

ROBIN Robot 2.0 - пользовательское приложение, входящее в состав платформы Robin и предназначенное для локального запуска и контроля программных роботов, созданных с помощью ПО «Robin Studio».

Является обязательным компонентом для запуска и исполнения программных роботов. Объектом лицензироания является рабочее место = возможность запуска роботов под одной учетной записью на одной вычислительной мощности (это может быть, как рабочий компьютер пользователя, так и сервер - физический или виртуальный).

ПО «ROBIN Robot» представлено тремя редакциями:

  • «ROBIN Robot. Desktop Edition» - предназначено для запуска на рабочей станции, не подключенной к корпоративной сети,
  • «ROBIN Robot. Enterprise Edition» - предназначено для запуска на рабочей станции, подключенной к корпоративной сети,
  • «ROBIN Robot. Cloud Edition» - предназначено для запуска на рабочей станции, расположенной в облаке.

ROBIN Robot состоит из двух модулей: ROBIN Agent и Robin Player:

  • ROBIN Agent -программный модуль, который обеспечивает подключение компонента ROBIN Orchestrator к ПК/серверу для запуска роботов. ROBIN Agent получает от оркестратора команду на выполнения роботов и передает «логи» (информацию об исполнении) роботов оркестратору в режиме реального времени.
  • ROBIN Player-модуль исполняющий сценарий робота. ROBIN Playerпредоставляет возможность запускать роботов, созданных в ROBIN Studio (файлы .robin-robot), в соответствии с различными сценариями: по настроенному расписанию, по событиям в информационных системах, по нажатию горячих клавиш или по команде, полученной от оркестратора(через ROBIN Agent).

ROBIN Robot 2.0 обладает следующими функциональными возможностями:

  • ручной запуск и остановка программных роботов;
  • настройка расписания для запуска/перезапуска/периодичности запуска программных роботов;
  • настройка отправки писем при завершении выполнения процесса;
  • загрузка программных роботов в каталог;
  • просмотр истории запусков;
  • просмотр логов роботов.

Одна лицензия ROBIN Robot позволяет исполнять неограниченное количество сценариев роботов на одном рабочем месте. Доступен как последовательный, так и параллельный запуск сценариев. Параллельное исполнение сценариев возможно, если алгоритм может быть выполнен в фоновом режиме (например, без необходимости работы с интерфейсом desktop-приложений или машинным зрением).

Условия эксплуатации ROBIN Robot 2.0

Минимальные аппаратные требования

  • CPU: 1.8 Ггц или быстрее. Два ядра или больше.
  • RAM: 8 Гб или больше.
  • НDD: 10 Гб или больше свободного места.
  • Видеоподсистема поддерживает разрешение дисплея WXGA (1366х768) или выше

Требования к системному программного обеспечению:

Microsoft Windows 7 Professional или Enterprise (SP1) с обновлением ESU, 8, 10, Server 2008 r2 (SP1) с обновлением ESU, 2012, 2016.

Требования к прикладному программному обеспечению:

  • .NET Framework 4.8
  • .NET Desktop Runtime 5.0.х
  • Microsoft Visual C++ Redistributable Package 2017

При установке на Windows Server 2012R, для работы функций зрения на компьютерах с операционной системой необходимо установить компонент операционной системы (Feature). Для этого необходимо в PowerShell выполнить команду:

Install-WindowsFeature server-media-foundation

Важно

Для обеспечения корректного запуска и выполнения программного робота на АРМе необходимо убедиться, что всё используемое роботом специализированное ПО заранее установлено, например: браузеры, офисные пакеты, корпоративные системы и прочее.

Установка и конфигурирование программы ROBIN Robot 2.0

В данном разделе описана установка и настройка Программы для трех редакций – Desktop, Cloud, Enterprise.

Установка программного обеспечения производится с помощью мастера установки. Во время установки параметрам конфигурации Программы (адреса, порты, логины, пароли, протоколы и т.д.) будут присвоены значения по умолчанию.

Установка программы ROBIN Robot 2.0 для редакции Desktop

Для установки ПО необходимо скачать по ссылке, предоставленной разработчиками или загрузить на АРМ файл с дистрибутивом ПО, имеющим название Robin Platform-std_ordinal_mix-2.0.0-RTM-Standalone и выполнить следующую последовательность действий:

  1. Запустить установку, совершив двойное нажатие ЛКМ по названию файла.
  2. Выбрать режим установки Программы - для одного или нескольких пользователей АРМа.
  1. Разрешить внесение изменений на АРМе, нажав на кнопку [Да], а затем выбрать из выпадающего списка язык интерфейса установки и нажать на кнопку [Ок].
  1. Выбрать компоненты для установки (рекомендуется выбрать все компоненты) и нажать на кнопку [Далее].
  1. Подтвердить начало установки, нажав на кнопку [Установить], программа будет установлена в папку по адресу C:/Program Files/Robin Platform.
  1. Далее начнется процедура установки.
  1. Для завершения установки необходимо нажать на кнопку [Завершить].
  1. Для установки файла лицензии, необходимо скопировать файл вида license*.lic в папку C:/Program Files/Robin Platform/2.0.0/RobotPlayer.

Установка программы ROBIN Robot 2.0 для редакции Cloud

Для скачивания ПО необходимо зарегистрироваться на портале «Облачная фабрика роботов (ОФР)», адрес портала зависит от реализации проекта. Затем необходимо перейти в раздел портала «Дистрибутивы» и нажать на кнопку [Скачать] в строке с названием «Robin Robot».

Для установки ПО необходимо выполнить следующую последовательность действий:

  1. Запустить установку, совершив двойное нажатие ЛКМ по названию файла Robin Platform-Robot -2.0.0-RTM-Cloud.exe.
  2. Выбрать режим установки Программы - для одного или нескольких пользователей АРМа.
  1. Разрешить внесение изменений на АРМе, нажав на кнопку [Да], а затем выбрать из выпадающего списка язык интерфейса установки и нажать на кнопку [Ок].
  1. Ввести токен, который был сгенерирован для пользователя портала ОФР, и нажать на кнопку [Далее].

Токен пользователя находится в правом верхнем углу под логином пользователя на портале ОФР.

  1. Выбрать компоненты для установки (рекомендуется выбрать все компоненты) и нажать на кнопку [Далее].
  1. Подтвердить начало установки, нажав на кнопку [Установить], программа будет установлена в папку по адресу C:/Program Files/Robin Platform.
  1. Далее начнется процедура установки.
  1. Для завершения установки необходимо нажать на кнопку [Завершить].

Установка программы ROBIN Robot 2.0 для редакции Enterprise

Для установки ПО необходимо скачать по ссылке, предоставленной разработчиками или загрузить на АРМ файл с дистрибутивом ПО, имеющим название Robin Platform-WO_ENV_mix-2.0.0-RTM-Enterprise.

Для установки с помощью мастера установки, необходимо выполнить следующую последовательность действий:

  1. Запустить установку, совершив двойное нажатие ЛКМ по названию файла.
  2. Выбрать режим установки Программы - для одного или нескольких пользователей АРМа.
  1. Разрешить внесение изменений на АРМе, нажав на кнопку [Да], а затем выбрать из выпадающего списка язык интерфейса установки и нажать на кнопку [Ок].
  1. Выбрать компоненты для установки (рекомендуется выбрать все компоненты) и нажать на кнопку [Далее].
  1. Ввести IP-адрес ROBIN сервера и нажать на кнопку [Далее].
  1. Подтвердить начало установки, нажав на кнопку [Установить], программа будет установлена в папку по адресу C:/Program Files/Robin Platform.
  1. Далее начнется процедура установки.
  1. Для завершения установки необходимо нажать на кнопку [Завершить].

ROBIN Agent

ROBIN Agent модуль отвечающий за:

  • получение команды на запуск конкретного робота м сами зашифрованные пакеты этого программного робота. Получает эту команду от ROBIN Orchestrator 2.0, когда речь идет о запуске из оркестратора, и от ROBIN Studio 2.0 при запуске в режиме отладки
  • передачу в ROBIN Orchestrator 2.0 логов выполнения робота в режиме реального времени, логов ROBIN Studio 2.0 и Robin Player и своих собственных логов после завершения их работы.

ROBIN Agent устанавливается в операционную систему как служба, поэтому отсутствует полноценный графический интерфейс пользователя.

Изменять настройки модуля можно только через его конфигурационный файл Robin.Agent.Service.exe.config:

  • логирование (путь и название файла лога, кодировка, максимальный размер файла лога, количество файлов лога, формат записи (паттерн) строки лога);
  • адрес для обращения к хранилищу роботов через сервер приложений;
  • настройки подключения к RabbitMQ (имя хоста, порт, логин и пароль пользователя, добавленного в RabbitMQ).

Взаимодействие ROBIN Agent 2.0 с другими компонентами и модулями

  • ROBIN Player. ROBIN Agent отправляет команды на исполнения программных роботов в ROBIN Player, который установлен на том же хосте. Перед началом рабочей сессии приложения проходят процедуру взаимной аутентификации.
  • ROBIN Studio 2.0. Если робот запущен в режиме отладки, агент передает логи исполняющегося процесса в ROBIN Studio 2.0 (формирование этого лога пользователь видит сразу на панели лога в Studio). Agent осуществляет взаимодействие только с той Studio, которая установлена на том же хосте. Перед началом рабочей сессии приложения проходят процедуру взаимной аутентификации.

ROBIN Player

ROBIN Player графическое пользовательское приложение, позволяющее управлять запуском роботов на локальной машине. Данный модуль может запускать сценарий по настроенному расписанию, по команде, полученной от ROBIN Agent или от пользователя (ручной запуск). Роботы исполняются локально, на той же машине и УЗ, на которой установлен модуль.

Работа с модулем ROBIN Player

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

Порядок действий при входе в приложение ROBIN Player:

  1. Запуск приложения двойным кликом по иконке приложения.
  1. Нажатие на иконку приложения в панели задач, после чего будет открыто основное окно с вкладками.
  • Для редакции Desktop авторизация для доступа к ПО не требуется, право доступа предоставляется после установки файла лицензии.
  • Для редакции Cloud авторизация программы осуществляется по ключу с портала ОФР, который вводится пользователем при установке.
  • Для редакции Enterprise необходимо ввести логин и пароль пользователя и нажать на кнопку [Войти].

Примечание. Логин и пароль предоставляется пользователю Администратором системы.

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

Взаимодействие ROBIN Player с другими компонентами

ROBIN Agent. ROBIN Player передает информацию об исполнителе роботов (ROBIN Executor - расшифровывает и исполняет пакеты программного робота) в ROBIN Agent, который установлен на том же хосте. Перед началом рабочей сессии приложения взаимно аутентифицируют друг друга.

Загрузка программного робота

Для запуска программного робота необходимо предварительно создать программного робота с помощью «Robin Studio» или загрузить робота в любую папку АРМа.

Примечание. Загрузка программного робота для редакции Cloud производится через Маркетплейс портала ОФР или после создания в «Robin Studio».

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

В правой части каждой строки с программным роботом находятся кнопки:

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

Для загрузки робота в Каталог Программы, необходимо нажать на кнопку в виде плюса, расположенную в правом углу экрана, с помощью проводника выбрать папку на АРМе, где расположен программный робот, и нажать на кнопку [Открыть].

Внимание! Файл программного робота имеет расширение robin-robot.

Далее файл будет размещен в Каталоге программных роботов.

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

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

Примечание. Программный робот будет удален из каталога Программы, но останется в папке на АРМе.

Запуск программного робота

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

Вкладка «Запущенные роботы»

На вкладке отображается список запущенных на текущий момент роботов под УЗ пользователя. В списке отображаются робот удаленно через Robin Orchestrator, либо локально самим пользователем или автоматически по расписанию.

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

Для приостановки работы робота (поставить выполнение сценария на паузу) необходимо нажать кнопу «пауза»:

Вкладка «Каталог роботов»

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

На вкладке находятся кнопки:

  • поиск роботов по названию
  • добавление роботов в закладки (избранное)
  • добавление новых роботов в каталог из хранилища

Вкладка «Расписание запуска»

На вкладке пользователь может просмотреть настройки локального расписания роботов.

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

Для отключения расписания необходимо передвинуть бегунок:

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

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

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

Для запуска планировщика задач Windows необходимо нажать на кнопку:

При редактировании расписания открывается окно:

В окне пользователь может редактировать расписание запуска робота, перезапуска, периодичности запуска:

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

Ниже приведено описание доступных опций на вкладке:

  1. Опция «Запуск» предназначена для настройки даты и времени запуска робота. Для настройки опции «Запуск» (дата и время запуска), необходимо нажать на кнопку , а затем с помощью «календаря» выбрать дату и время запуска робота.
  1. Опция «Перезапуск» предназначена для настройки интервала и количество повторных перезапусков робота. Для настройки опции «Перезапуск» необходимо перевести переключатель в режим «Включено», задать интервал повторения, при необходимости перевести переключатель «Повторять в течение» в режим «Включено» и задать количество повторений в интервал времени.
  1. Опция «Периодичность» предназначена для настройки периодичности (еженедельной, ежемесячной, ежедневной) запуска робота. Для настройки опции «Периодичность» необходимо перевести переключатель в режим «Включено», а затем выбрать периодичность запуска – ежедневно, еженедельно (далее необходимо выбрать день недели) или ежемесячно (далее необходимо выбрать день месяца).
  1. Опция «Запускать до» предназначена для настройки даты и времени, до которой необходимо запускать робота. Для настройки опции «Запускать до» необходимо перевести переключатель в режим «Включено», а затем нажать на кнопку календаря и задать дату и время, до которой необходимо запускать робота.
  2. Опция «Параметры запуска» предназначена для выбора параметров запуска роботов. А именно: настройки уровня логирования и выбора правила при выполнении задачи. Функционал по выбору правила аналогичен данному функционалу в планировщике задач. По умолчанию значение «Не запускать новый экземпляр».

Для обновления расписания запуска робота, необходимо нажать на кнопку [Обновить], для отмены созданного расписания – на кнопку [Отмена].

Вкладка «Настройки»

Для перехода на вкладку «Настройки» следует нажать на кнопку в виде шестерёнки.

На данной вкладке имеется доступный функционал по настройке отправки писем при завершении выполнения процесса.

Для настройки отправки писем при завершении выполнения сценария роботом необходимо заполнить поля в разделе «Настройки соединения с почтовым сервером»: Сервер, Порт, Логин, Пароль. Если требуется использовать SSL/TLS необходимо перевести бегунок во включенное состояние. В разделе «Список получателей уведомлений о выполнении роботов» есть возможность добавления почтовых адресов при успешных выполнениях и неуспешных. Для добавления адресов необходимо нажать на кнопку:

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

Письмо при ошибке:

Письмо при успешном выполнении:

Для прикрепления лога к письму необходимо передвинуть бегунок во включенное состояние.

Для прекрепления видео к письму с работой робота (последние 10 секунд) необходимо передвинуть бегунок во включенное состояние.

Таким образом:

  • Если чек-бокс True - Robot Player должен вести запись всего экрана на видео (сохраняя только последние 10 секунд). При завершении работы робота, последние 10 секунд записи сохраняются и отправляются пользователю на почту.
  • Если чек-бокс False - Robot Player ничего не записывает и не отправляет.

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

Логирование работы роботов осуществляется в автоматическом режиме. Файл с логом размещается каталоге C:/Program Files/Robin Platform/2.0.0/RobotLogs в папке с названием робота.

В имени файла с логами работы содержится название робота и дата запуска в формате гггг.мм.дд., для каждого запуска робота создается отдельный файл с логом. Для открытия и просмотра файла с логами можно воспользоваться любим приложением, работающим с txt-файлами.

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

Для смены пароля необходимо ввести логин пользователя, а затем текущий пароль, новый пароль и повтор нового пароля и нажать на кнопку [Заменить пароль].

Настройки модуля ROBIN Player можно изменить через его конфигурационный файл RobotPlayer.exe.config:

  • логирование (путь и название файла лога, кодировка, максимальный размер файла лога, количество файлов лога, формат записи (паттерн) строки лога);
  • настройка размера окна приложения;
  • настройки подключения к FreeIPA (включениеотключение аутентификации в Студии, хост и порт подключения, путь к дереву объектов).

Вкладка «История запусков»

Интерфейс Robin Player на вкладке «История запусков»:

На вкладке «История запусков» доступен следующий функционал:

  1. Фильтрация по дате запуска. Если фильтр не установлен, то выводится вся история запусков.

2. Поиск по наименованию запущенного ранее робота. Если фильтрация не задана, выводится вся история запусков.

  1. Кнопка сброса всех установленных фильтров.
  1. Поле с информацией о запущенном роботе, которое включает в себя следующее:
  • Поле «Дата и время» - отражается дата и время каждого действия в схеме робота.
  • Поле «Сообщение» - отражает наименование действия, начало действия, конец действия, либо ошибку в действии.
  • Поле «Параметр» - отражает параметры, имеющиеся в действии на входе, а также результаты, полученные на выходе.
  • Поле «Значение» - отражает значения, внесенные в параметры, и значения, полученные в результатах.

Отражение работы робота на вкладке «История запусков»

Если робот запущен в данный момент, то в строке отсутствует символ.