Настройки сценариев
Настройки открываются кнопкой Настройки над списком сценариев. Они действуют на все сценарии сразу и разбиты на два раздела: Основное и Расписание.
На скриншоте — значения тестового магазина. Значения по умолчанию указаны в таблицах ниже.
Основное
| Настройка | По умолчанию | Что делает |
|---|---|---|
| Тестовый режим — заказы не меняются | Включён | Пока режим включён, сценарии проверяют условия и пишут в журнал, что изменили бы, но заказы не сохраняются. Выключите его, когда убедитесь по журналу, что сценарии работают как задумано |
| Предел сохранений заказа за 10 минут | 5 | Сколько раз сценарии могут сохранить один и тот же заказ за 10 минут. При превышении проход останавливается, а в журнал пишется цепочка сработавших сценариев |
| Срок хранения журнала, дней | 90 | Сколько дней хранить записи журнала прогонов. Старые записи удаляет агент раз в сутки |
| Запуск очереди сразу после ответа | Включён | Задачи сценариев выполняются в конце того же запроса, уже после ответа браузеру, — изменения появляются почти сразу |
Тестовый режим
Тестовый режим — общий выключатель «ничего не менять» для всех сценариев. В журнале прогонов срабатывания в тестовом режиме отмечены итогом Тест.
Не путайте его с другими способами проверки:
- флаг «Тестовый» в карточке сценария касается только этого сценария;
- проверка на заказе и запуск по заказам выбирают режим сами — проверку или применение.
Защита от петель
Типичная петля: сценарий меняет заказ → заказ сохраняется → чужой обработчик пересохраняет заказ → снова срабатывает сценарий. Собственные сохранения модуля сценарии заново не запускают, но чужие обработчики могут обойти эту защиту. Предел сохранений — последний рубеж: цепочка обрывается, а в журнал пишется, какие сценарии в ней участвовали.
Повышайте предел, только если несколько сценариев законно меняют один заказ подряд.
Срок хранения журнала
Записи об однократных срабатываниях — сценариях с повтором «Один раз на заказ» — не удаляются никогда, независимо от срока. Иначе после чистки журнала такой сценарий сработал бы на заказе повторно.
Запуск очереди сразу после ответа
Выключать стоит на нагруженном сайте с тяжёлыми сценариями: тогда очередь разбирает только агент, и задержка применения составит до минуты-двух.
Расписание
Параметры агента, который перебирает заказы для сценариев с событием «По расписанию».
| Настройка | По умолчанию | Допустимо | Что делает |
|---|---|---|---|
| Как часто проверять заказы, мин | 60 | 5–1440 | Раз во сколько минут агент выбирает заказы. Чем чаще, тем быстрее сработает сценарий и тем больше нагрузка на сайт |
| Заказов за один проход | 200 | 10–1000 | Сколько заказов агент проверяет за один запуск; остальные дождутся следующего прохода. Уменьшите, если проход заметно нагружает сайт |
| Не проверять заказы, не менявшиеся дольше, дней | 30 | 1–365 | Заказы, которые не менялись дольше этого срока, сценарии по расписанию не смотрят вовсе. Увеличьте, если сценарий должен дотягиваться до давно забытых заказов |
Агент очереди
Справа вверху на странице настроек — состояние агента очереди: он выполняет задачи сценариев в фоне. По клику открывается окно с подробностями.
- Состояние — работает, остановлен, остановлен предохранителем (запустится сам при следующем событии) или не установлен.
- Интервал и Ближайший запуск — когда агент сработает в следующий раз.
- Очередь — сколько задач ждёт выполнения.
Кнопки Остановить агента и Перезапустить агента нужны для обслуживания. Пока агент остановлен, сценарии не выполняются, а события заказов копятся в очереди — после перезапуска они будут обработаны.
Для стабильной работы очереди и сценариев по расписанию рекомендуем переводить агенты Битрикса на cron — см. Настройка агентов на cron.