Настройка фоновых задач

Планировщик предоставляет возможность запуска фоновых задач с настраиваемой периодичностью и установки для них триггеров. В параметрах фоновых задач устанавливаются настройки с возможностью запуска любого из методов стороннего сервиса Системы. Для задач указываются метод стороннего сервиса, URL метода, а также request body для передачи параметров. Реализован синхронный класс задач, который используется для краткосрочных задач и предполагает запуск и ожидание ответа без приостановки работы.

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

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

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

img

Табличное представление раздела включает в себя информационные блоки по задачам и политикам, а также список фоновых задач и их триггеры.

Для создания фоновой задачи необходимо выполнить следующие действия:

  1. В разделе Планировщик нажать кнопку img. Откроется форма создания фоновой задачи.

    img

  2. Заполнить поля карточки.

Тумблер Признак параллельного выполнения позволяет запускать задачу строго по расписанию вне зависимости от того, завершился ли предыдущий запуск.

В Системе необходимо выполнить следующие настройки фоновых задач:

  • Задача «Установка признака «Истек срок хранения» для дел, его томов и включенных в дело документов»:

    • Наименование задачи: «Установка признака «Истек срок хранения» для дел, его томов и включенных в дело документов»;

    • Класс задачи: «Задача для вызова других микросервисов через HTTP»;

    • Группа задачи: «Цифровой архив»;

    • Признак параллельного выполнения: «false»;

    • Параметры задачи:

      • URL метода внешнего сервиса для запуска задачи: «http://ldm-digital-archive-service:8080/api/v1/da/files/set-flag-expired»;

      • Тип метода внешнего сервиса для запуска задачи: «POST»;

      • Тело запроса для запуска задачи: не заполнять;

      • Логин для авторизации: «admin»;

      • Пароль для авторизации: «123456»;

      • Максимальное время ожидания ответа внешнего сервиса задачи: «600000»;

  • Задача «Отмена доступа к документам по просроченным заявкам в архив»:

    • Наименование задачи: «Отмена доступа к документам по просроченным заявкам в архив»;

    • Класс задачи: «Задача для вызова других микросервисов через HTTP»;

    • Группа задачи: «Цифровой архив»;

    • Признак параллельного выполнения: «false»;

    • Параметры задачи:

      • URL метода внешнего сервиса для запуска задачи: «http://ldm-digital-archive-service:8080/api/v1/da/requests/access-deny»;

      • Тип метода внешнего сервиса для запуска задачи: «POST»;

      • Тело запроса для запуска задачи: не заполнять;

      • Логин для авторизации: «admin»;

      • Пароль для авторизации: «123456»;

      • Максимальное время ожидания ответа внешнего сервиса задачи: «600000»;

  • Задача «Проверка наличия и технического состояния архивных документов»:

    • Наименование задачи: «Проверка наличия и технического состояния архивных документов»;

    • Класс задачи: «Задача для вызова других микросервисов через HTTP»;

    • Группа задачи: «Цифровой архив»;

    • Признак параллельного выполнения: «false»;

    • Параметры задачи:

      • URL метода внешнего сервиса для запуска задачи: «http://ldm-digital-archive-service:8080/api/v1/da/document-check-tasks»;

      • Тип метода внешнего сервиса для запуска задачи: «POST»;

      • Тело запроса для запуска задачи: не заполнять;

      • Логин для авторизации: «admin»;

      • Пароль для авторизации: «123456»;

      • Максимальное время ожидания ответа внешнего сервиса задачи: «600000»;

3. После заполнения полей нажать кнопку img.

Карточка созданной задачи обновится, ниже появится новый блок Триггеры.

Триггер – это условие, которое инициирует выполнение фоновой задачи (например, обработку данных, отправку уведомлений или синхронизацию).

Чтобы добавить новый триггер к существующей фоновой задаче, необходимо выполнить следующие действия:

  1. В блоке Триггеры нажать кнопку img.
  2. В открывшемся окне заполнить поля.

img

Триггеры бывают 2-х типов – «Простой», «CRON»:

  • «Простой» – это триггер, указывающий, что задача будет выполняться определенное количество раз (или бесконечно) с определенным интервалом с указанием дат.
  • «CRON» – это механизм автоматического запуска задач по расписанию, заданному с помощью CRON-выражения.

В Системе необходимо выполнить следующие настройки триггеров фоновых задач:

  • Триггеры задачи «Установка признака «Истек срок хранения» для дел, его томов и включенных в дело документов»:

    • Наименование: «Запуск отбора дел и установки признаков»;

    • Тип запуска: «Простой»;

    • Дата с: «17.12.2025, 10:34:21»;

    • Дата по: не заполнять;

    • Повторять каждые: «24»;

    • Единица измерения: «Час»;

    • Количество повторов: «-1»;

    • Бесконечно: «true».

  • Триггеры задачи «Отмена доступа к документам по просроченным заявкам в архив»:

    • Наименование: «Простой»;

    • Тип запуска: «Простой»;

    • Дата с: «24.12.2025, 14:19:33»;

    • Дата по: не заполнять;

    • Повторять каждые: «24»;

    • Единица измерения: «Час»;

    • Количество повторов: «-1»;

    • Бесконечно: «true».

  • Триггеры задачи «Проверка наличия и технического состояния архивных документов»:

    • Наименование: «Простой»;

    • Тип запуска: «Простой»;

    • Дата с: «24.12.2025, 14:19:33»;

    • Дата по: не заполнять;

    • Повторять каждые: «24»;

    • Единица измерения: «Час»;

    • Количество повторов: «-1»;

    • Бесконечно: «true».

3. Нажать кнопку [Создать].

Созданный триггер с прописанными параметрами появится в одноименном блоке в карточке фоновой задачи.

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

Изменения в фоновую задачу вносятся только при условии, если все ее триггеры приостановлены или выполнены. Если данное условие не реализовано, фоновая задача откроется только для просмотра с полями, недоступными для редактирования, а в правом нижнем углу появится уведомление, информирующее об этом.

img

Для изменения фоновой задачи необходимо выполнить следующие действия:

  1. В разделе Планировщик дважды нажать ЛКМ на строку нужной задачи.

  2. В открывшейся карточке внести необходимые изменения в поля.

    При необходимости можно добавить или удалить триггеры к данной задаче в соответствующем блоке.

  3. После внесения изменений нажать кнопку img.

Карточка обновится, в правом нижнем углу появится уведомление, информирующее об успешном сохранении изменений.

Подробнее работа с фоновыми задачами описана в документе Руководство администратора ЛДМ. ПЛАТФОРМА КОНТЕНТ-СЕРВИСОВ (ЛДМ.ПКС).