Skip to Content

Задания и триггеры в Оркестраторе

Задания позволяют управлять запуском RPA-проектов в Primo RPA Orchestrator. Задания могут выполняться вручную или автоматически при срабатывании триггеров.

RPA-проекты с входными или выходными аргументами запускаются через задания.

Создание задания

  1. Перейдите в раздел Задания → Все задания.
  2. Нажмите Добавить задание.
  3. Настройте RPA-проект, параметры выполнения и при необходимости триггеры.
  4. Сохраните задание.

alt

Настройки задания и производительность

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

НастройкаРекомендация
Количество одновременно работающих роботовУстанавливайте с учётом количества доступных роботов, способных выполнить проект.
Уникальный запускИспользуйте, если необходимо контролировать однократное выполнение проекта каждым роботом.
НаложениеЗапрещайте, если проект не рассчитан на параллельное выполнение на одном роботе.
Продолжить после ошибкиОтключайте, если после ошибки требуется прекратить последующие запуски по условиям задания.

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

Триггеры

Триггеры позволяют автоматически запускать RPA-проекты по расписанию или при наступлении события, а также останавливать выполняющихся роботов.

Типы триггеров

В Оркестраторе доступны восемь типов триггеров:

№Тип триггераНазначениеОсновные параметры
1Запуск по расписаниюЗапускает проект по заданному расписанию. Также может использоваться для остановки выполняющегося робота.Расписание; при необходимости - Завершение робота и способ остановки.
2Запуск при получении EmailСрабатывает при поступлении письма во входящий почтовый ящик.Почтовый ящик, отправитель, тема письма и дополнительные настройки обработки.
3Запуск при изменении очереди обмена даннымиСрабатывает при добавлении нового элемента в очередь.Очередь обмена данными.
4Запуск при изменении папкиРеагирует на создание, изменение или удаление файлов в отслеживаемой папке.Машина робота и путь к папке либо путь к сетевой папке; типы событий.
5Запуск при завершении проекта РоботомСрабатывает после завершения указанного RPA-проекта.Проект, результат выполнения, версия проекта.
6Запуск из другого роботаЗапускает задание по вызову из другого робота.Вызов из RPA-проекта.
7Запуск при наличии новых элементов в очередиПроверяет очередь с заданной периодичностью и срабатывает при обнаружении новых элементов.Очередь, периодичность опроса, количество новых элементов.
8Остановка по таймаутуОстанавливает выполняющегося робота после истечения заданного времени с момента его запуска.Таймаут в минутах и способ остановки.

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

Остановка по таймауту

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

Для настройки триггера:

  1. При создании или редактировании задания в разделе «Запуск по триггеру» выберите тип «Остановка по таймауту».
  2. В поле Таймаут (мин) укажите время в минутах. Значение должно быть больше нуля.
  3. Выберите способ остановки:
    • Попросить остановиться – роботу отправляется запрос на мягкую остановку.
    • Принудительно (немедленно) – выполнение робота завершается принудительно.
  4. Нажмите Добавить триггер и сохраните задание.

Таймаут отсчитывается с момента запуска робота.

alt

⚠️

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

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

Запуск по расписанию

Для триггера Запуск по расписанию необходимо выбрать расписание из справочника Задания → Расписания. Расписание задаётся с помощью Cron-выражения или конструктора расписаний.

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

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

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

Запуск при завершении проекта Роботом

Для триггера Запуск при завершении проекта Роботом предусмотрен параметр Автоматически применять активную версию проекта. По умолчанию он включён.

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

Автоматическое применение активной версии проекта

Запуск при получении Email

Для работы триггера Запуск при получении Email у тенанта должен быть настроен хотя бы один почтовый ящик для входящей почты. Дополнительные ящики добавляются в разделе Настройки → Email для входящей почты.

При настройке доступны следующие возможности:

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

Настройка фильтрации темы письма

Запуск при изменении папки

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

Если сетевая папка отслеживается через вариант Папка на машине робота:

  1. Запустите службу агента от имени доменной учётной записи, имеющей доступ к сетевой папке.
  2. В настройках триггера выберите Папка на машине робота и укажите сетевой путь к папке.

Настройка доступа агента к сетевой папке

Сетевой путь для папки на машине робота

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

Также можно выбрать типы событий, которые должен отслеживать триггер:

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

Выбор отслеживаемых событий папки

Продолжить после ошибки

Параметр Продолжить после ошибки (KeepRunningAfterError) определяет, будет ли задание продолжать работу по заданным условиям после ошибки выполнения.

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

Параметр предусмотрен для триггеров Запуск по расписанию, Запуск при наличии новых элементов в очереди обмена данными, Запуск при получении Email и Запуск при изменении папки.

Параметр Продолжить после ошибки

Несколько триггеров в одном задании

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

Например, можно построить цепочку выполнения:

  1. Задание 1 запускается по расписанию или при получении письма.
  2. Во время выполнения проекта Задания 1 создаётся элемент в очереди Queue1, что вызывает запуск Задания 2.
  3. Задание 2 создаёт файл в папке, изменение которой запускает Задание 3.
  4. После завершения проекта Задания 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.

Параметры применяются без перезапуска Оркестратора.