Тип сигнала: по расписанию

В данном разделе приведены сведения по настройке заданий автоматизации на запуск по заранее составленному расписанию. Настройка доступна только для узлов Платформа НЕЙРОСС.

Общие сведения

Расписание позволяет задать точное время или периодичность выполнения задания автоматизации. Для его настройки предусмотрены два взаимосвязанных режима:

• Визуальный редактор — формирование распространённых расписаний с помощью списков;
• Текстовый шаблон — ввод произвольного Cron-выражения вручную.

Переключение режимов осуществляется посредством соответствующих вкладок. Под редактором отображается сформированное расписание в удобном для чтения виде, например: «В 12:00».

Для настройки расписания вы можете воспользоваться Cron-форматом записи. В этом формате предусмотрено пять позиций: для установки минут, часов, дней месяца, месяцев, и дней недели. Позиции разделяются пробелом.

Визуальный редактор

Визуальный редактор позволяет настроить расписание без ручного составления Cron-выражения.

На первом шаге выберите периодичность выполнения:

• год;
• месяц;
• неделя;
• день;
• час;
• минута.

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

Например, чтобы выполнять задание ежедневно в 08:05:

1. В поле Каждый выберите значение день.
2. В поле часов укажите 08.
3. В поле минут укажите 05.

В результате будет сформировано выражение:

5 8 * * *

И его текстовое описание:

В 08:05

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

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

Для ежегодного запуска можно последовательно выбрать:

• месяц;
• день месяца;
• при необходимости — день недели;
• время выполнения.

Текстовый шаблон

Текстовый редактор позволяет ввести произвольное Cron-расписание. Выражение состоит из пяти позиций, разделённых пробелами:

Допустимые диапазоны:

1. минута — 0–59;
2. час — 0–23;
3. день месяца — 1–31;
4. месяц — 1–12;
5. день недели — 1–7, где 1 — воскресенье, 2 — понедельник, 3 — вторник, 4 — среда, 5 — четверг, 6 — пятница, 7 — суббота.

Секунда выполнения в диапазоне от 0 до 59 выбирается системой случайным образом.

Под полем ввода отображается текстовое описание введённого расписания. Это позволяет проверить выражение перед сохранением задания.

В каждой из позиций может быть задано:  

• символ * — произвольное значение (каждую минуту, каждый день и проч.);
• фиксированное значение — число;
• несколько значений — список чисел, разделённых запятыми;
• диапазон диапазон допустимых значений: минута (0—59), час (0—23), день месяца (1—31), месяц (1—12), день недели (1—7, 1 — воскресенье); 
• два числа, разделённых дефисом, для указания интервал значений с..по;

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

• M/N — выполнение с шагом N, начиная со значения M,
• L — последний день месяца;
• L-n — за n дней до последнего дня месяца;
• nL — последний указанный день недели месяца;
• LW — последний будний день месяца;
• W — ближайший будний день к указанной дате, например 15W;
• # — определённый по счёту день недели месяца, например 5#3 — третий четверг.

Символы L, LW, W и #, а также шаги вида M/N, доступны только в текстовом редакторе. 

Как читать и составлять Cron-расписание

Порядок полей

Запись читается слева направо: сначала когда в течение часа (минута), затем в какой час, затем какой день месяца, какой месяц, какой день недели. Платформа проверяет все пять условий одновременно: срабатывание возможно только если текущие дата и время подходят каждой позиции выражения.

Символ * 

Означает «без ограничения по этому полю». Например, в выражении ниже звёздочки в полях дня, месяца и дня недели означают «каждый календарный день», а 0 и 12 фиксируют минуту и час:

Списки и диапазоны

• 9,18 в поле часа — запуск в 09:00 и 18:00;
• 2-6 в поле дня недели — с понедельника по пятницу (2 — понедельник, 6 — пятница);
• 1,7 — воскресенье и суббота.

Шаг M/N или */N

• */30 в минутах — каждые 30 минут (0, 30);
• 5/15 — каждые 15 минут, начиная с 5-й (5, 20, 35, 50);
• 8-18/2 в часах — каждые 2 часа в интервале с 8 до 18 включительно (8, 10, 12, …).

День месяца и день недели

Если нужно «каждый понедельник», задайте день недели (например, 2) и поставьте * в поле день месяца. Если нужно «15-е число каждого месяца», укажите 15 в дне месяца и * в дне недели. Одновременно задавать и конкретное число месяца, и конкретный день недели нельзя — одно из полей должно быть *.

Практический порядок настройки

1. Определите время: минута и час (точное или с шагом).
2. Решите, как часто по календарю: каждый день (%%* *%%), определённые месяцы, число месяца или дни недели.
3. Для редких случаев (последний день месяца, последний будний день, N-й четверг) используйте вкладку Текстовый шаблон и символы L, LW, W, #.
4. Сохраните задание только после проверки текстового описания под полем ввода.

Примеры расписаний

• * * * * *  — каждую минуту,
• 0 * * * * — в начале каждого часа,
• 0 12 * 1,2 * — каждый день в 12 часов дня в январе и феврале,
• 0 0 1 1 * — 1 января в 00:00,
• 0 0 L * * — в 00:00 последнего дня месяца,
• 0 0 L-5 * * — в 00:00 за пять дней до последнего дня месяца,
• */30 * * * * — каждые 30 минут,
• */30 * * * 2-6 — каждые 30 минут по будням,
• 5/15 * * * * — каждые 15 минут, начиная с 5-й минуты часа.
• 0 12 * * * — каждый день в 12:00,
• 0 0-5 * * * — в начале часов 0,1,2,3,4 и 5 (шесть раз за ночь),
• 0 9 * * 2 — каждый понедельник в 09:00,
• 0 9,18 * * * — каждый день в 09:00 и 18:00,
• 0 8-18/2 * * 2-6 — каждые 2 часа с 08:00 по 18:59 по будням,
• 0 10 * * 1,7 — по выходным в 10:00,
• 0 0 1 * * — в 00:00 первого числа каждого месяца,
• 0 9 15 * * — в 09:00 пятнадцатого числа каждого месяца.
• 0 0 LW * * — в 00:00 последнего буднего дня месяца,
• 30 17 LW * * — в 17:30 последнего буднего дня месяца,
• 0 0 * * 5#3 — в 00:00 в третий четверг месяца,
• 0-59/2 * * * * — по чётным минутам,
• 5 21 * * * — ежедневно в 21:05,
• 0 20 * * 6 — в 20:00, только по пятницам,
• 0 20 * * 6L — в 20:00, в последнюю пятницу вечера,
• 59 23 * 4-6 * — В 23:59 ежедневно во втором квартале,
• 0 0 15W * * — в ближайший будний день к 15-му числу.

Порядок действий

Чтобы создать новое задание автоматизации с запуском по расписанию:

В списке заданий нажмите на кнопку Добавить новое задание .

В блоке Параметры сигнала [3] в поле Тип сигнала выберите из раскрывающегося списка По расписанию.

Откройте вкладку Визуальный редактор или Текстовый шаблон.

Настройте периодичность и время запуска задания.

Проверьте текстовое описание сформированного задания. На примере ниже настроено расписание на ежедневный запуск в 9 часов вечера.

Настройте параметры действия [Действия автоматизации].

Сохраните изменения.