Триггер расписания Workflow

Материал из Документация Ключ-АСТРОМ
Версия от 15:34, 14 октября 2026; IKuznetsov (обсуждение | вклад) (Новая страница: « = Триггер расписания Workflow = Триггеры расписания запускают Workflow автоматически в заданное время или с заданным интервалом. Используйте их для повторяющихся задач, таких как ежечасная загрузка данных, ночные отчёты или ежемесячные аудиты. == Выбор типа р...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Триггер расписания Workflow

Триггеры расписания запускают Workflow автоматически в заданное время или с заданным интервалом. Используйте их для повторяющихся задач, таких как ежечасная загрузка данных, ночные отчёты или ежемесячные аудиты.

Выбор типа расписания

Тип расписания Когда использовать
Фиксированное время Запуск в определённое время в указанные вами дни: каждый день, только по будням, по рабочим дням согласно календарю или по любому пользовательскому шаблону расписания.
Временной интервал Запуск повторно с фиксированным интервалом, например каждые 10 минут или каждый час. Можно комбинировать с правилом расписания, чтобы ограничить выполнение определёнными днями.
Cron-расписание Запуск по расширенным шаблонам расписания, не покрываемым фиксированным временем или временным интервалом.

Для всех типов расписаний проверяйте расписание перед сохранением, выбирая Следующие запланированные выполнения в конфигурации триггера.

Распределяйте время запуска, чтобы избежать пиковых нагрузок Если несколько Workflow отправляют запросы DQL, вызовы API или запросы к внешней системе, распределите их время запуска на несколько минут, например 00:00, 00:03 и 00:07. Привязка всех Workflow к одному времени запуска создаёт всплеск одновременных запросов, который может перегрузить цель.

Фиксированное время

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

  • Время: время суток в формате ЧЧ:ММ (24-часовой формат).
  • Часовой пояс: часовой пояс IANA для настроенного времени. По умолчанию: UTC. О поведении при переходе на летнее время см. раздел Переход на летнее время.
  • Правило расписания: управляет днями, в которые запускается триггер. По умолчанию: каждый день. Подробнее см. раздел Правила расписания и бизнес-календари.
  • Самая ранняя дата начала: дата, с которой расписание вступает в силу.
  • Условие окончания: окончание по дате, по количеству запусков или никогда. По умолчанию: никогда.

Временной интервал

Триггер Временной интервал запускается повторно с фиксированным интервалом. При необходимости его можно ограничить активным периодом в течение дня или прикрепить правило расписания для ограничения определёнными днями.

  • Запускать каждые (мин): интервал в минутах. Диапазон: 1–720 (максимум 12 часов).
  • Правило: подробнее см. раздел Создание правила.
  • Часовой пояс: часовой пояс IANA. По умолчанию: UTC.
  • Не запускать до / Не запускать после: определяют активный период в течение дня, в который триггер может запускаться, например между 8:00 и 17:00.
  • Правило расписания: управляет днями, в которые запускается триггер. По умолчанию: каждый день. Подробнее см. раздел Правила расписания и бизнес-календари.
  • Дата начала: фактическая дата, с которой расписание вступает в силу. По умолчанию — день определения в начале часа.
  • В: фактическое время, с которого расписание вступает в силу.
  • Окончание: фактическая дата окончания расписания, по количеству запусков или никогда. По умолчанию: никогда.

Cron-расписание

Триггер Cron-расписание запускается в соответствии с cron-выражением. Используйте его для расширенных шаблонов расписания, не покрываемых фиксированным временем или временным интервалом. Cron-выражения следуют стандартному синтаксису cron на основе формата Debian cron и учитывают часовой пояс. О поведении при переходе на летнее время см. раздел Переход на летнее время.

  • Cron-выражение: расписание в стандартном пятиполевом формате cron (минута, час, день месяца, месяц, день недели). Часовой пояс по умолчанию — локаль вашего браузера. Поддерживаемые специальные символы: *, ,, -, */n, n/m. Шестиполевые (Quartz) выражения и подстановочный знак ? не поддерживаются.

Правила расписания и бизнес-календари

Правила расписания позволяют управлять днями, в которые запускается триггер фиксированного времени или временного интервала, используя такие критерии, как будни, дни месяца или рабочие дни из бизнес-календаря. Каждая среда включает календарь по умолчанию; можно создавать дополнительные календари для моделирования различных графиков праздников для команд в разных странах. Чтобы пропустить определённые даты, например государственные праздники, без изменения основного расписания, добавьте их как пользовательские праздники в бизнес-календарь и используйте правило, фильтрующее только рабочие дни.

Переход на летнее время

Когда часы переводятся при переходе на летнее время (DST), поведение расписания зависит от того, основано ли оно на интервале или на времени.

Триггеры на основе интервала

Триггер Временной интервал и триггер Cron-расписание с подстановочным знаком в поле часов или минут всегда запускаются с настроенным интервалом, независимо от изменения часов.

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

Если для триггера Временной интервал выбрана опция Не запускать до или Не запускать после:

  • Весенний перевод вперёд: если ваш активный период начинается во время пропущенного часа, первый запуск переносится на время сразу после изменения часов. Если весь активный период попадает в пропущенный час, триггер в этот день не запускается.
  • Осенний перевод назад: если ваш активный период попадает на повторяющийся час, триггер запускается один раз, во втором вхождении этого часа.

Триггеры на основе времени

Триггер Фиксированное время и триггер Cron-расписание запускаются в определённый час и минуту по установленному времени.

  • Весенний перевод вперёд: если запланированное время попадает в пропущенный час, триггер срабатывает в первое доступное время после изменения часов. Например, триггер Фиксированное время, установленный на 02:30, срабатывает в 03:00 в день перехода.
  • Осенний перевод назад: триггер запускается один раз, во время первого вхождения повторяющегося часа.