Планировщик задач

• выгрузка и загрузка данных из внешних систем;
• отправка ежедневных писем или отчётов;
• очистка и архивация старых записей;
• пересчёты и служебные операции ночью.

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

Планировщики создаются в Конструкторе: раздел Планировщик → Добавить. Внутри одного планировщика может быть много задач.

# Шапка планировщика

# Экран «Задачи планировщика»

Список задач в виде карточек. Кнопка Новая задача (зелёная, с плюсом).

На каждой карточке:

Если задач нет: «Нет созданных задач» и подсказка «Нажмите "Новая задача" для создания».

# Форма задачи

# Основное

Код берётся из подключённого компонента. См. Компоненты.

# Режим запуска

Для режимов «Один раз» и «Несколько» появляется дополнительное поле количества запусков.

# Расписание

Выберите тип, затем заполните поля типа:

Примеры Cron-выражений:

*/5 * * * *     каждые 5 минут
0 */2 * * *     каждые 2 часа
0 0 * * 0       каждое воскресенье в полночь
0 0 1 * *       1-го числа каждого месяца в полночь

# Код задачи

Задача вызывает функцию из компонента. Имя функции — onSchedule (если её нет — вызывается main). Функция получает два аргумента: formApi и объект задачи.

// Компонент «Синхронизация товаров»
async function onSchedule(formApi, schedulerTask) {
  const response = await fetch('https://api.example.com/data');
  const data = await response.json();

  for (const item of data) {
    await formApi.create('Справочник', 'Товары', {
      'Наименование': item.name,
      'Артикул': item.sku,
      'Цена': item.price
    });
  }

  const ctx = formApi.getContext();
  // ctx = { currentUser, task: { id, name, componentId, ... } }
  return `Синхронизировано: ${data.length}`;
}

# Журнал выполнений («Лог»)

Каждая задача ведёт журнал последних 50 запусков. Кнопка Лог в карточке задачи открывает диалог с записями.

Каждая запись содержит:

Если задача ещё ни разу не выполнялась: «Задача ещё не выполнялась» и «Журнал появится после первого запуска планировщика». Кнопка Закрыть закрывает диалог.

Журнал обновляется сам — открытый лог показывает новые выполнения без перезагрузки страницы.

# Что доступно в коде задачи

Особенности:

• код выполняется в изолированном окружении с таймаутом;
• ошибка одной задачи не останавливает планировщик;
• после ошибки следующий запуск задачи переносится на минуту;
• read() не разворачивает ссылочные реквизиты автоматически, как в интерфейсе.

# Надёжность и производительность

# Частые проблемы

# Смотрите также

• Компоненты
• Перепроведение документов
• ИИ-агент