Перейти к основному содержанию
`Ctrl`+`K`

# Менеджер заданий

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

Путь: `Приложение «Настройка системы» > Настройки и сервисы > Менеджер заданий`

Использование планировщика позволяет:

- экономить время на рутинных операциях;

- снижать влияние человеческого фактора;

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

Сценарии использования:

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

- Сложные процессы: Запуск ETL-процессов, последовательности действий по расписанию.

- Техническое обслуживание: Архивация, очистка данных.

- Автоматизация бизнеса: Начисление бонусов, пересчет рейтингов.

- Синхронизация: Обмен данными с внешними системами по расписанию.

Принцип работы:

1. Создание задачи (Job): Определение конкретной операции для выполнения (генерация конкретного отчета, запуск процедуры синхронизации).

2. Настройка расписания (Trigger): Установка времени и периодичности:

   - однократно;

   - с периодичностью (например, каждые 30 мин.);

   - в определенное время суток;

   - по сложным правилам (например, в последнюю пятницу месяца).

3. Запуск и мониторинг: Автоматический запуск задач по расписанию с контролем выполнения.

## Описание интерфейса

### Общий вид интерфейса

Интерфейс состоит из трех основных областей:

1. Группы заданий: Служат для логической группировки задач.

Атрибут | Описание
--- | ---
Наименование | Название группы заданий

2. Список заданий: Отображает все задания выбранной группы.

Атрибут | Описание
--- | ---
Наименование | Название задания
Системное имя | Уникальный идентификатор задания
Включен | Признак активности задания
Тип задания | Выполнение скрипта — выполняет указанный скрипт Очистка данных — удаляет записи из БД Планирование работ — настройка объектных характеристик
Исполнитель | Учетная запись для выполнения задания
Описание | Дополнительная информация о задании
Индикатор состояния | Серый — выключено Зеленый — включено, последнее выполнение успешно Красный — включено, последнее выполнение с ошибкой
Статус | Текущий статус выполнения
Время предыдущего запуска | Дата и время последнего запуска
Срок хранения логов (дней) | Период хранения записей в журнале
Время следующего запуска | Планируемая дата следующего запуска
Задержка запуска | Отклонение от установленного времени
Последнее состояние в журнале | Результат последнего выполнения
Среднее время выполнения | Средняя продолжительность выполнения задания

3. Закладки задания: Содержат детальную информацию и настройки выбранного задания.

Расписание
Содержит список расписаний для текущего задания.

Интервалы запуска
Определяет временные промежутки для выполнения задания.

Важно

Если выполнение по расписанию не попадает в разрешенные интервалы, в логе фиксируется ошибка.

Журнал
Стандартный журнал заданий, в котором можно просматривать историю процедур, отслеживать их статус, а также анализировать источник вызова, текст ошибок и продолжительность выполнения.
Он содержит список сессий и результаты выполнения заданий. Данные хранятся в течение периода, указанного в настройке «Срок хранения логов (дней)».

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

Доступная информация:

- список сессий — история выполнений;

- логи сессии — начало, ошибки, предупреждения, окончание;

- параметры — дополнительные настройки.

Доступная информация:

- список сессий — история выполнений;

- логи сессии — начало, ошибки, предупреждения, окончание;

- параметры — дополнительные настройки.

Журнал Quartz
Отображает текстовые логи процесса менеджера заданий. Для работы необходимо предварительно указать путь к логам в настройках Quartz.
Настройка пути к логам: `Приложение «Настройка системы» > Настройки и сервисы > Настройка модулей системы > Общие настройки модулей > btk > Путь до логов планировщика`

Доступные операции:

- посмотреть отчет — выборка для просмотра логов;

- загрузить логи — подгрузка логов с указанного в настройках пути.

Скрипт
Опциональная закладка, доступная только для типа задания «Выполнение скрипта». Содержит скрипт на языке JEXL для выполнения.

Настройка очистки
Опциональная закладка, доступная только для типа задания «Очистка данных».
Настройка включает:

- список таблиц/классов для очистки;

- способ удаления;

- время хранения данных перед удалением.

Настройка
Опциональная закладка, доступная только для типа задания «Планирование работ».
Позволяет настраивать объектные характеристики на самом задании с последующей возможностью использовать эти характеристики при непосредственном выполнении задания.

### Операции менеджера заданий

Основные операции:

- Включить выделенные задания — активирует выбранные задачи;

- Выключить выделенные задания — деактивирует выбранные задачи.

Дополнительные операции:

- Сменить группу — перемещает задание в другую группу;

- Выполнить задачу — запускает внеочередное однократное выполнение;

- Открыть отчет по задачам — отображает отчет по активным заданиям;

- Открыть журнал — открывает журнал Quartz в отдельном окне.

### Создание и работа через интерфейс

Создание задания

Для создания задания выполните следующие шаги:

1. Заполните обязательные поля:

   - наименование задания;

   - системное имя задания;

   - тип задания.

2. Убедитесь, что поле исполнитель заполнено корректно (заполняется автоматически).

3. Заполните соответствующую закладку в зависимости от выбранного типа задания.

4. Настройте расписание для выполнения задания.

5. Установите признак Включен.

Создание расписания

Для настройки расписания:

1. Выберите тип расписания, подходящий для задачи.

2. Заполните параметры расписания.

3. При необходимости укажите дату начала и окончания действия расписания (по умолчанию расписание действует постоянно).

После создания расписания и включения задания оно добавляется в базу данных и начинает выполняться по указанному расписанию.

Однократное выполнение задачи

Для однократного выполнения уже созданной задачи используйте операцию «Выполнить задачу» в меню «Дополнительно».

Примечание

В отличие от создания задачи с однократным расписанием, операция «Выполнить задачу» создает новую задачу с таким же скриптом, даже если исходная задача уже существует в базе данных. Новая задача не перезаписывает существующую.

## Полезные задания

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

- «Запуск процедур в фоновом режиме» - содержит все процедуры, выполняемые в фоновом режиме. Историю фоновых процедур можно посмотреть в журнале задания.

- «Очистка таблиц» - основное задание очистки второстепенных данных (логов, истории сессии, календарей) в классах/таблицах.