Запуск скрипта
Чтобы запустить скрипт, после его публикации в правом верхнем углу нажмите Активировать.
Запустить можно только тот скрипт, у которого настроено расписание, вебхук или трекер.
Планировщик
Расписание выполнения скрипта задается через блок Планировщик. Этот блок может быть вставлен только в начало скрипта. Выберите вариант расписания в настройках блока:
- каждые несколько минут (по умолчанию 15 минут);
- каждый день (нужно выбрать часы и минуты);
- по дням недели (нужно выбрать дни недели, часы и минуты);
- по датам (нужно выбрать месяцы, дни, часы, минуты);
- вручную;
- по CRON расписанию (система для автоматического запуска задач в определенное время).
В расширенных параметрах можно указать даты первого и последнего запуска скрипта.
Расписание в формате CRON
Cron (Command Run On) — система, предназначенная задавать периодичность и время срабатывания задач планировщика.
В cron-выражениях используются символы:
- * — любое значение, используемое в пределах одного фрагмента cron-выражения. Например, в поле «Минуты» означает, что скрипт будет запускаться каждую минуту;
- ? — неопределенное значение. Например, если необходимо, чтобы задача запускалась 10 числа каждого месяца, но не важно, в какой день недели, то в поле «День» установите значение «10», а в поле «День недели» — «?»;
- - — диапазон значений. Например, «10-12» в поле «Час» означает часы 10, 11 и 12;
- , — список значений. Например, значения «ПОНЕДЕЛЬНИК, СРЕДА, ПЯТНИЦА» в поле «День недели» означают, что скрипт будет запускаться в понедельник, среду и пятницу;
- / — шаг значения. Например, «5/15» в поле «Минуты» означает, что скрипт будет запускаться в 5, 20, 35 и т.д. минут. Значение «5» будет увеличиваться на «15»;
- L — последний день месяца. Например, в поле «День» значение «L» означает, что скрипт будет выполняться в последний день каждого месяца;
- W — ближайший будний день. Например, в поле «День» значение «15 W» означает ближайший будний день к 15-ому числу месяца. Если 15-е — суббота, то скрипт будет запущен в пятницу 14-го. Если 15-е — воскресенье, то — в понедельник 16-го.
- # — номер недели месяца. Например, выражение «6#3» означает, что скрипт будет запускаться в третью пятницу каждого месяца.
В поле ввода значения подсвечивается разряд, рядом с которым стоит курсор.
Соотношение символов и диапазон значений для полей представлены в таблице ниже.
| Поле | Допустимые значения | Используемые символы |
|---|---|---|
| Минуты | 0-59 | *,-/ |
| Часы | 0-23 | *,-/ |
| День | 1-31 | *,-/?LW |
| Месяц | 1-12 | *,-/ |
| День недели | 1-7 | *,-/?L# |
Ограничения
- CRON-выражение должно состоять из 5 значений.
- День или День недели должен быть ?.
- Символы «L», «W», «#» не могут быть использованы вместе с шагами значения (/), списками (,) или диапазонами (-).
Примеры cron-выражений
| Выражение | Значение |
|---|---|
| */15 * * * ? | Каждые 15 минут |
| 0 12 * * ? | Каждый день в 12:00 |
| 15 10 ? * * | Каждый день в 10:15 |
| 15 10 ? * MON-FRI | В 10:15 с понедельника по пятницу |
| 15 10 L * ? | В 10:15 последний день каждого месяца |
| 15 10 ? * 6L | В 10:15 последнюю пятницу каждого месяца |
| 15 10 ? * 6#3 | В 10:15, третью пятницу каждого месяца |
| 11 11 11 11 ? | В 11:11, 11 число, каждый ноябрь |
Вебхук
Блок-триггер Вебхук также запускает скрипт, когда получает новые события. После того, как блок получил события, он снова запустится через 5 минут. Изменить временный параметр невозможно.
В левой панели представлен адрес вебхука. Чтобы блок получал новые события, скопируйте его и вставьте на сайт или в приложение, с которых необходимо отслеживать изменения.
Во вкладке Тест можно создать тестовое событие. При нажатии на соответсвующую кнопку введите пример тела запроса JSON-формате. При нажатии на применить отобразится маппинг введенного примера.
Примечание:
- При импорте и экспорте скрипта с блоком Вебхук будет сгенерирован новый адрес.