Просмотреть исходный

Описание раздела

Документация ROBIN > Раздел "Роботы" > image2024-2-5_8-27-6.png

В разделе доступно:

просмотр списка роботов, опубликованных в удаленное хранилище платформы
запуск роботов вручную

Описание таблицы роботов

Таблица в разделе содержит список готовых роботов, которые опубликованы в удаленное хранилище платформы. При этом отображаются только те роботы, к которым у вас настроен доступ (подробнее в разделе "Модуль "Управление доступом"").

Название столбца/кнопки	Описание
Столбец "Робот"	Отображается название робота.
Кнопка "Описание робота"	Кнопка расположена в столбце "Робот" у всех роботов. По нажатию открывается окно, в котором указано название робота и его описание. Описание робота пользователь заполняет в окне "Спецификация" в ROBIN Studio перед публикаций робота. Т.к. описание относится к роботу в целом, а не к конкретной его версии, кнопка есть только в строке, где есть название робота:
Столбец "Версия"	В каждой строке отображается конкретная версия робота. Если у робота несколько версий, то каждая из них расположена на отдельной строке в таблице. При этом все версии всегда отображаются в порядке их публикации - от самой новой (сверху) к самой старой (внизу): Список версий можно сворачивать или разворачивать по кнопке или . Если у робота только одна версия, то эта кнопка отсутствует. Рядом с версией есть индикатор, отображающий необходимость наличия графического интерфейса на учетной записи машины для работы этой версии робота. Если отображается , значит графический интерфейс нужен; если -не нужен.
Столбец "Изменения"	Отображается описание изменений, которые были сделаны в конкретной версии робота. Описание изменений в версии робота пользователь заполняет в окне публикации робота в ROBIN Studio при публикации в базу Оркестратора.
Столбец "Среднее время"	Если версию робота запускали менее 2х раз в столбце указано "Нет данных". Если эту версию робота запускали 2 и более раз, в столбце указано среднее время работы этой версии робота, которое Оркестратора автоматически рассчитал на основе длительности выполнения ранее совершенных запусков.
Столбец "Автор"	ФИО пользователя, который опубликовал версию робота. У разных версий одного робота могут быть разные авторы.
Столбец "Дата публикации"	Отображается дата и время, когда версия робота была опубликована.
Кнопка "Запустить"	По нажатию открывается окно "Запуск робота". Подробнее о данном окне описано ниже.
Кнопка	По нажатию происходит обновление записей в таблице.

С помощью выпадающего списка «Столбцы» можно выбрать, какие столбцы будут скрыты или отображены, при этом столбцы «Робот» и "Версия" отображаются всегда.

Запуск робота вручную

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

Выбрать в таблице версию робота, которую нужно запустить.
Нажать на кнопку "Запустить" в строке с нужной версией робота.
Заполнить поля в открывшемся окне "Запуск робота".
Нажать на кнопку "Запустить". Или нажать на кнопку "Отменить", если решили не запускать робота.

Документация ROBIN > Раздел "Роботы" > image2024-2-28_7-54-4.png

Описание окна "Запуск робота"

Название кнопки/поля	Описание
Поле "Учетная запись"	Выпадающий список с учетными записями: к которым у вас настроен доступ, которые относятся к машине, указанной в поле "Машина". Если поле "Машина" не заполнено, данное поле недоступно для редактирования.
Поле "Уровень логирования"	Выпадающий список, в котором отображаются возможные варианты уровней логирования процесса, который будет исполнять робот. Значение по умолчанию: "Бизнес" Доступные значения: Бизнес Разработчик робота Отладка Информация Предупреждение Ошибка Нет
Поле "Машина"	Выпадающий список, в котором отображаются названия и IP-адреса машин, о которых есть данные в базе платформы. При этом отображаются только те машины, к которым у вас настроен доступ (подробнее в разделе "Модуль "Управление доступом"").
Поле "Версия"	Выпадающий список, в котором отображаются все версии робота, которые были опубликованы в базу Оркестратора Рядом с версией есть индикатор, отображающий необходимость наличия графического интерфейса на учетной записи машины для работы этой версии робота. Если отображается , значит графический интерфейс нужен; если -не нужен.
Название робота	Название робота, одна из версий которого будет запущена.
Кнопка "Отменить"	При нажатии появляется окно с подтверждением отмены запуска:
Кнопка "Запустить"	Если все обязательные поля заполнены, то при нажатии начинается процесс запуска робота.
Блок с полями "Настройка входных параметров робота"	Если у выбранной версии робота есть входные параметры, то в окне будет отображаться подраздел "Настройка входных параметров робота" с полями для заполнения этих параметров: с типом "Строка": с типом "Логический": с типом "Число": Количество полей = количеству входных переменных, указанных в роботе. Название каждого такого поля = названию соответствующих переменных. Рядом с полем есть подсказка о типе данных поля. Если в роботе есть параметры с каким-либо другим типом данных, кроме этих 3х, то они не будут отображены. Наличие предупреждения не мешает запуску робота или отображению полей с типом "Строка", "Число" и\или "Логический".

Очередь роботов

При попытке запуска робота (любым способом) система может отправить этот запуск в очередь роботов.

Очередь роботов - это список неудачных запусков роботов (их не удалось начать или прервались из-за ошибки), которые система автоматически попытается выполнить еще раз в порядке попадания запусков в этот список. В текущем релизе отсутствует интерфейс для просмотра и управления запусками в очереди. При этом запуск ≠ роботу; можно запустить несколько раз одного и того же робота - это будут разные запуски.

Причины, из-за которых запуск робота будет отправлен в очередь:

В очереди уже есть запуск, который должен быть выполнен на той же учетной записи машины, которую пользователь выбирает для другого запуска. Это происходит по той причине, что данная учетная запись уже "забронирована" другим запуском, который пытались выполнить еще раньше.
Если на выбранной учетной записи машины уже выполняется максимально допустимое число запусков. Такой лимит запусков можно настроить через конфигурационный файл системы при ее развертывании. Параметр общий для всех машин, т.е. нельзя настроить разные лимиты для разных машин. При этом процессы (проекты роботов), запущенные через ROBIN Studio, не учитываются в общем количестве текущих запусков.
На учетной записи машины нельзя запускать более одного робота с отметкой , иначе они будут мешать работе друг друга. Если производится запуск робота с , но на выбранной учетной записи же работает робот с такой же отметкой, то рассматриваемый запуск будет отправлен в очередь.
Для выбранной учетной записи необходимо поднимать RDP-сессию, но системе не удалось ее поднять. Соотвественно, далее начать запуск также не получится, и он отправляется в очередь.
Системе исполнения, установленная на выбранной учетной записи машины, не удалось начать запуск (к этому моменту все вышеперечисленные проверки уже пройдены успешно и запуску не мешают).
Возникла ошибка уже при выполнении запущенного робота

Если робот завершил свою работу успешно или был остановлен пользователем, система не добавляет такой запуск в очередь.

События, при которых система пытается еще раз повторить запуски, попавшие в очередь:

какой-либо выполняющийся робот завершил свою работу, т.е. на одной из учетных записей машин освободилось место для еще одного запуска
в карточке учетной записи машины добавили или обновили учетные данные
одна из учетных записей машин стала активной, и при этом количество выполняющихся на ней запусков не > установленного лимита запусков.

Помимо лимита выполняющихся запусков, в конфигурационном файле системы настраивается еще 2 параметра, влияющих на работу очереди роботов:

Максимальное количество перезапусков. Некоторые запуски могут попадать в очередь бесконечно, например, если проблема в самом роботе, и требуется его изменение через ROBIN Studio. Чтобы очередь не была забита такими запусками, после попадания запуска в очередь система попытается его повторно выполнить только установленное количество раз. Когда количество выполненных попыток станет = числу, установленному в конфигурационном файле, система удаляет этот запуск из очереди и далее его не контролирует.
Тайм-аут. Это время, которое должно пройти с момента попадания запуска в очередь (в первый раз или при неудачной попытке перезапуска), прежде чем система попытается еще раз выполнить этот запуск. Пример работы этого параметра:
1. Робот упал в ошибку, и система отправила этот запуск в очередь.
2. Возникает событие, при котором система повторяет запуски в очереди.
3. С момента попадания запуска в очередь еще не прошло время = значению из конфигурационного файла. Поэтому система пропускает этот запуск, оставляя его в очереди. Количество выполненных перезапусков для этого запуска остается неизменным.
4. Спустя какое-то время снова возникает событие, запускающее проверку очереди
5. С момента попадания запуска в очередь уже прошло время = значению из конфигурационного файла. В этот раз система не пропускает этот запуск и пытается начать его выполнение. Вне зависимости от результата (удалось начать запуск или нет), количество выполненных перезапусков для этого запуска увеличивается на 1.

Оба параметры общие для всех запускаемых роботов.

Работа с RDP-сессиями

В конфигурационных файлах платформы есть несколько параметров, связанных с RDP-сессиями для запуска роботов, которые будут полезны пользователю:

"rdp.isEnable":
- Если значение "false", система не будет предпринимать попытки запуска RDP-сессий на каких-либо машинах, даже если это необходимо для запуска робота.
- Если "true", система будет запускать RDP-сессию на учетной записи машины, если есть такая необходимость.
"rdp.start.timer.duration" - время, в течение которого Оркестратор будет ожидать активации RDP-сессии и успешного запуска системы исполнения роботов. Время задается в миллисекундах. Если время вышло, но Оркестратор не получил нужный ответ, запуск робота на этой учетной записи будет отменен. Такое ограничение времени необходимо для случаев, когда из-за неизвестных ошибок Оркестратору не поступает обратно ответ, и в итоге запуск робота зависает, не завершаясь.
"rdp.stop.timer.duration" - время, в течение которого Оркестратор будет ожидать появления новых запросов о запуске робота на данной учетной записи машины, прежде чем завершить на ней RDP-сессию. Время задается в миллисекундах. Работает параметр следующим образом:
1. На учетной записи завершился последний робот. Теперь на ней ничего не выполняется.
2. Оркестратор активирует счетчик времени.
3. Если за установленное время на этой учетной записи не будет запущен ни один робот, RDP-сессия будет завершена за ее ненадобностью. Если поступит запрос на запуск робота, Оркестратор отключит счетчик и не станет отключать RDP-сессию - оставит для нового запускаемого робота.
Этот параметр полезен, если между окончанием одного робота и началом другого проходит мало времени - можно не тратить время на лишнее завершение RDP-сессии и ее повторный запуск для второго робота, а просто использовать ранее запущенную сессию.
"rdp.screen.resolution" - разрешение экрана, которое будет установлено на учетной записи машины при подключении на ней RDP-сессии.

Все параметры можно настроить в файле "rms2.properties", расположенном на серверной части платформы.