Top.Mail.Ru
Запуск скрипта
8 800 555-89-02
Документация
CTRL+K
Standalone2404
SaaS

Запуск скрипта

В этой статье
  • Запуск скрипта
  • Планировщик
  • Расписание в формате CRON
  • Ограничения
  • Примеры cron-выражений
  • Ручной запуск
  • Вебхук

Чтобы запустить скрипт, после его публикации в правом верхнем углу нажмите Активировать.

Запуск скрипта

Запустить можно только тот скрипт, у которого настроено расписание, ручной запуск, вебхук или трекер.

Когда скрипт запускается, в верхнем правом углу появляется статус «Выполняется» с датой и временем запуска.

Выполняется

При нажатии кнопки Отключить статус меняется на «Выполнение останавливается».

Выполнение останавливается

После завершения выполнения статус меняется на «Последнее выполнение» с датой и временем последнего запуска.

Последнее выполнение

Планировщик

Расписание выполнения скрипта задается через блок Планировщик. Этот блок может быть выбран только в начале скрипта. Выберите вариант расписания в настройках блока:

  • по минутам (по умолчанию 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» означает, что скрипт будет запускаться в третью пятницу каждого месяца

В поле ввода значения подсвечивается разряд, рядом с которым стоит курсор.

Cron-выражения

Соотношение символов и диапазон значений для полей представлены в таблице ниже.

ПолеДопустимые значенияИспользуемые символы
Минуты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 число, каждый ноябрь

Ручной запуск

Блок Ручной запуск моментально запускает скрипт по нажатию кнопки Активировать и отключается после его завершения. Выполнение скрипта происходит единоразово.

Ручной запуск скрипта

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

При добавлении ожидаемого поля в блок, укажите следующие параметры:

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

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

При запуске блок возвращает ожидаемые поля, если они были указаны, и start_time.

Вебхук

Блок-триггер Вебхук запускает скрипт, когда получает новые события.

В левой панели представлен адрес вебхука, UUID, который можно редактировать, и переключатель синхронного режима работы.

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

Вебхук

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

При синхронном режиме работы скрипт возвращает ответ сразу после выполнения. При асинхронном режиме ответ возвращается по GraphQL-запросу. Возвращаются данные, указанные в блоке Вернуть данные.

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

Заметка

При импорте и экспорте скрипта с блоком Вебхук будет сгенерирован новый адрес.

Была ли статья полезна?

Да
Нет
Предыдущая
Проверка и публикация скрипта
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102024. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.