Задания и триггеры в Оркестраторе
Задания позволяют управлять запуском RPA-проектов в Primo RPA Orchestrator. Задания могут выполняться вручную или автоматически при срабатывании триггеров.
RPA-проекты с входными или выходными аргументами запускаются через задания.
Создание задания
- Перейдите в раздел Задания → Все задания.
- Нажмите Добавить задание.
- Настройте RPA-проект, параметры выполнения и при необходимости триггеры.
- Сохраните задание.

Настройки задания и производительность
При большом количестве запусков, длительном выполнении проектов и интенсивной работе с очередями учитывайте следующие настройки:
| Настройка | Рекомендация |
|---|---|
| Количество одновременно работающих роботов | Устанавливайте с учётом количества доступных роботов, способных выполнить проект. |
| Уникальный запуск | Используйте, если необходимо контролировать однократное выполнение проекта каждым роботом. |
| Наложение | Запрещайте, если проект не рассчитан на параллельное выполнение на одном роботе. |
| Продолжить после ошибки | Отключайте, если после ошибки требуется прекратить последующие запуски по условиям задания. |
При частых срабатываниях триггеров контролируйте очередь проектов, доступность роботов и лицензий. Если скорость поступления заданий превышает возможности выполнения, очередь может увеличиваться.
Триггеры
Триггеры позволяют автоматически запускать RPA-проекты по расписанию или при наступлении события, а также останавливать выполняющихся роботов.
Типы триггеров
В Оркестраторе доступны восемь типов триггеров:
| № | Тип триггера | Назначение | Основные параметры |
|---|---|---|---|
| 1 | Запуск по расписанию | Запускает проект по заданному расписанию. Также может использоваться для остановки выполняющегося робота. | Расписание; при необходимости - Завершение робота и способ остановки. |
| 2 | Запуск при получении Email | Срабатывает при поступлении письма во входящий почтовый ящик. | Почтовый ящик, отправитель, тема письма и дополнительные настройки обработки. |
| 3 | Запуск при изменении очереди обмена данными | Срабатывает при добавлении нового элемента в очередь. | Очередь обмена данными. |
| 4 | Запуск при изменении папки | Реагирует на создание, изменение или удаление файлов в отслеживаемой папке. | Машина робота и путь к папке либо путь к сетевой папке; типы событий. |
| 5 | Запуск при завершении проекта Роботом | Срабатывает после завершения указанного RPA-проекта. | Проект, результат выполнения, версия проекта. |
| 6 | Запуск из другого робота | Запускает задание по вызову из другого робота. | Вызов из RPA-проекта. |
| 7 | Запуск при наличии новых элементов в очереди | Проверяет очередь с заданной периодичностью и срабатывает при обнаружении новых элементов. | Очередь, периодичность опроса, количество новых элементов. |
| 8 | Остановка по таймауту | Останавливает выполняющегося робота после истечения заданного времени с момента его запуска. | Таймаут в минутах и способ остановки. |
Вместо триггера Запуск при изменении очереди обмена данными рекомендуется использовать Запуск при наличии новых элементов в очереди обмена данными, если сценарий предусматривает периодический опрос очереди.
Остановка по таймауту
Триггер Остановка по таймауту позволяет автоматически остановить выполнение робота по истечении заданного времени с момента его запуска.
Для настройки триггера:
- При создании или редактировании задания в разделе «Запуск по триггеру» выберите тип «Остановка по таймауту».
- В поле Таймаут (мин) укажите время в минутах. Значение должно быть больше нуля.
- Выберите способ остановки:
- Попросить остановиться – роботу отправляется запрос на мягкую остановку.
- Принудительно (немедленно) – выполнение робота завершается принудительно.
- Нажмите Добавить триггер и сохраните задание.
Таймаут отсчитывается с момента запуска робота.

Для мягкой остановки RPA-проект должен содержать активность обработки сигнала мягкой остановки. Если такой обработки нет, отправленный запрос не остановит выполнение робота.
Триггер Остановка по таймауту не запускает проект самостоятельно. Для запуска задания необходимо использовать другой триггер. Остановка по таймауту может применяться совместно с остановкой, настроенной в триггере Запуск по расписанию.
Запуск по расписанию
Для триггера Запуск по расписанию необходимо выбрать расписание из справочника Задания → Расписания. Расписание задаётся с помощью Cron-выражения или конструктора расписаний.
Если требуется остановить уже выполняющегося робота по расписанию, используйте параметр Завершение робота и настройте способ остановки.
Расписания могут быть связаны с производственными календарями. Если администратор настроил несколько календарей, для каждого расписания можно выбрать соответствующий календарь.
Не рекомендуется назначать большому числу заданий одинаковое время запуска без необходимости. Например, расписания каждые 15 минут, каждые 30 минут и каждый час могут срабатывать одновременно и создавать пиковую нагрузку. По возможности распределяйте время запусков.
Запуск при завершении проекта Роботом
Для триггера Запуск при завершении проекта Роботом предусмотрен параметр Автоматически применять активную версию проекта. По умолчанию он включён.
- Включён - при срабатывании используется текущая активная версия проекта, даже если после создания задания активная версия изменилась.
- Выключен - используется версия проекта, выбранная при настройке триггера.

Запуск при получении Email
Для работы триггера Запуск при получении Email у тенанта должен быть настроен хотя бы один почтовый ящик для входящей почты. Дополнительные ящики добавляются в разделе Настройки → Email для входящей почты.
При настройке доступны следующие возможности:
- Оповестить автора(ов) письма - отправлять уведомление отправителям письма об успешном или неуспешном выполнении проекта либо об ошибке запуска робота. При срабатывании такого триггера уведомления по соответствующим событиям другим подписчикам не отправляются.
- Ресурс - выбрать ресурс типа
JObject, в который при срабатывании триггера записываются сведения о письме в формате JSON, включая адрес, отправителя, тему и текст письма. - Ограничение количества писем - задать максимальное число писем, обрабатываемых за одно срабатывание триггера, в том числе при использовании IMAP.
- Фильтрация темы письма - использовать регулярные выражения для отбора писем по теме.

Запуск при изменении папки
Триггер Запуск при изменении папки может отслеживать папку на машине робота или сетевую папку. При выборе папки на машине робота укажите машину и абсолютный путь; для сетевого расположения используется UNC-путь.
Если сетевая папка отслеживается через вариант Папка на машине робота:
- Запустите службу агента от имени доменной учётной записи, имеющей доступ к сетевой папке.
- В настройках триггера выберите Папка на машине робота и укажите сетевой путь к папке.


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

Продолжить после ошибки
Параметр Продолжить после ошибки (KeepRunningAfterError) определяет, будет ли задание продолжать работу по заданным условиям после ошибки выполнения.
- Выключен (по умолчанию) - после ошибки выполнение задания прекращается.
- Включён - следующие срабатывания триггера продолжают обрабатываться, даже если предыдущий запуск завершился с ошибкой.
Параметр предусмотрен для триггеров Запуск по расписанию, Запуск при наличии новых элементов в очереди обмена данными, Запуск при получении Email и Запуск при изменении папки.

Несколько триггеров в одном задании
Одному заданию можно назначить несколько триггеров. При этом важно учитывать возможные конфликты условий запуска и остановки как внутри одного задания, так и между разными заданиями.
Например, можно построить цепочку выполнения:
- Задание 1 запускается по расписанию или при получении письма.
- Во время выполнения проекта Задания 1 создаётся элемент в очереди
Queue1, что вызывает запуск Задания 2. - Задание 2 создаёт файл в папке, изменение которой запускает Задание 3.
- После завершения проекта Задания 3 срабатывает триггер Задания 4.

Запуск, остановка и мониторинг заданий
Для управления заданиями используются действия Запустить и Остановить. Для заданий, выполняемых по триггеру, действие Остановить приостанавливает дальнейшую работу задания по триггерам. Не следует путать эту операцию с принудительной остановкой выполняющегося робота.
При запуске задания его RPA-проект помещается в очередь выполнения. Если подходящий робот доступен, проект передаётся ему. Если свободного робота нет, проект ожидает выполнения в очереди.
В поле Состояние отображается состояние задания, а не отдельного робота. Сведения о выполнении можно просматривать в разделах Роботы → Все роботы, Мониторинг и История выполнения.
Для корректного распределения нагрузки согласуйте периодичность срабатывания триггеров, число доступных роботов, ограничения одновременного выполнения и количество лицензий.

Массовое управление заданиями
Для массовых операций предусмотрены действия Остановить все и Запустить все остановленные. Их доступность зависит от прав, назначенных пользователю в Конструкторе прав.
- Права на массовые операции назначаются отдельно.
- У ролей Администратор и Администратор тенанта полный набор прав предусмотрен по умолчанию.
- Перед выполнением массовой операции отображается окно подтверждения.
- В журнале Оркестратора фиксируются события
Старт остановки всех запущенных заданийиСтарт возобновления всех ранее остановленных заданий.

Настройка аутентификации почтовых триггеров
Этот раздел предназначен для системных администраторов, настраивающих подключение Оркестратора к почтовым серверам IMAP и Exchange (EWS).
Если при подключении к почтовому серверу возникают ошибки аутентификации, в том числе 401, можно настроить механизмы аутентификации через секцию Triggers → Email конфигурации Оркестратора.
| Параметр | Назначение | По умолчанию |
|---|---|---|
UseProtocolLogger | Включает диагностическое протоколирование подключения в файле imap.log, включая информацию CAPABILITY. | false |
RemoveGSSAPI | Исключает механизм GSSAPI из доступных механизмов аутентификации. | false |
RemoveNTLM | Исключает механизм NTLM из доступных механизмов аутентификации. | false |
UseManagedNtlm | Делает NTLM приоритетным; при необходимости используется совместно с RemoveGSSAPI: true. | false |
Примеры настройки
Для диагностики подключения включите протоколирование:
{
"Triggers": {
"Email": {
"UseProtocolLogger": true
}
}
}В журнале imap.log можно проверить список механизмов, объявленных сервером, например AUTH=PLAIN AUTH=NTLM AUTH=GSSAPI.
Если ошибка связана с GSSAPI, установите RemoveGSSAPI: true. Для выбора управляемого NTLM можно использовать следующую комбинацию параметров:
{
"Triggers": {
"Email": {
"UseManagedNtlm": true,
"RemoveGSSAPI": true
}
}
}Если необходимо исключить GSSAPI и NTLM:
{
"Triggers": {
"Email": {
"RemoveGSSAPI": true,
"RemoveNTLM": true
}
}
}UseProtocolLogger предназначен только для диагностики. Файл imap.log не
имеет механизма ротации и при длительном протоколировании может занять всё
доступное место на диске. После проверки отключите параметр, установив
false.
Параметры применяются без перезапуска Оркестратора.