Расписания
Last updated
Last updated
Расписания используются для выполнения заданий с триггером Запуск по расписанию. Прежде чем создать такое задание, пользователю необходимо добавить расписание в систему.
Для создания расписания перейдите в раздел Задания > Расписания и нажмите кнопку Добавить расписание:
Укажите название расписания и необходимые настройки запуска. Название должно состоять только из латинских букв и цифр, дефиса, символа подчеркивания и точки.
Отдельного внимания требуют настройки ниже.
Чтобы правильно заполнить Cron-строку, изучите поддерживаемый формат, который приведен ниже. Для создания расписания используется библиотека Quartz. Для удобства также можно воспользоваться генератором cron-выражений.
Формат cron-строки Quartz похож на формат UNIX, но имеет несколько значимых отличий. Одно из них заключается в том, что Quartz-формат поддерживает расписание с точностью до секунды, тогда как UNIX поддерживает расписания только до минуты. Также запуск можно построить на приращениях (например, каждые 45 секунд).
Шаблон cron-строки Quartz состоит из 6 полей, разделенных пробелом, и имеет вид: * * * * * *, где:
Пример заполнения: 0 0 12 * * ? - задание будет запускаться каждый день с полудня.
Примечания:
При установке символа * в одном из полей будет использоваться каждое возможное значение этого поля. Например, если в поле Секунды установлена *, то задание будет запускаться каждую секунду.
Установка знака ? допускается для полей День месяца или День недели. Он означает, что в поле Нет конкретного значения. Знак полезен в том случае, когда нужно указать значение только в одном из двух полей.
Символ / используется для указания приращения значений. Например, если вы укажете 0/15 в поле Минуты, это означает, что задание будет запускаться каждые 15 минут, начиная с нулевой минуты. Если указать 3/20, то запуск будет производиться каждые 20 минут в течение часа, начиная с третьей минуты.
Подробнее об использовании других символов можно прочесть в документации Quartz.
При создании расписания через cron-строку в поле Описание (если оно пустое) будет автоматически сформирована расшифровка созданного расписания. Если же пользователь ранее заполнил поле Описание, то введенное им описание останется без изменений и не будет перезаписано после изменения cron-строки. Пример автоматического заполнения расшифровки:
Расписание можно связать с производственным календарем. В этом случае задание не будет запускаться в выходные и праздничные дни, обозначенные в этом календаре.
Чтобы привязать расписание к производственному календарю, установите чекбокс Согласовано с производственным календарем (24 x 5). Если вы хотите, чтобы задание автоматически запускалось в субботу и воскресенье, то дополнительно установите чекбокс Суббота и воскресенье – рабочие дни (24 x 7).
🔸 Если указанные параметры неактивны, это означает, что пользователь с административными правами не добавил производственный календарь в Оркестратор. Обратитесь к ответственному лицу для решения этого вопроса.
В случае, если в Оркестраторе используется режим множественных производственных календарей, то с каждым расписанием можно связать индивидуальный календарь. Особенность таких календарей заключается в том, что их может быть несколько на один календарный год. Подробнее о том, как создаются множественные календари, читайте в разделе Производственный календарь.
После указания всех настроек, не забудьте сохранить изменения.
✅ Результат: готовое расписание добавится в справочник и станет доступным для выбора при создании задания по расписанию.
