IScheduledJobHandler

Обновлено: 13.03.2026

IScheduledJobHandler — интерфейс обработчика Задания по расписанию.

Обработчик реализует пользовательскую логику. Система выполняет её автоматически по настроенному расписанию.

Такие задания используются для фоновых операций, которые не связаны напрямую с действиями пользователя.

НазначениеНазначение

Обработчики заданий по расписанию позволяют реализовать:

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

Задание настраивается в системе. Оно указывает класс обработчика, который реализует IScheduledJobHandler.

ИнтерфейсИнтерфейс

public interface IScheduledJobHandler
{
    Task Execute(ScheduledJobContext context);
}

Метод ExecuteМетод Execute

Task Execute(ScheduledJobContext context);

Метод вызывается системой при выполнении задания по расписанию. Внутри метода реализуется основная логика задания.

ПараметрыПараметры

context

Контекст выполнения задания (ScheduledJobContext). Наследует DynamicCodeContext и предоставляет доступ к API системы.

Через контекст можно:

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

Пример интеграцииПример интеграции

Пример задания, выполняющего HTTP-запрос к внешнему API.

public class SyncJob : IScheduledJobHandler
{
    public async Task Execute(ScheduledJobContext context)
    {
        var http = context.GetHttpClient();

        var response = await http.GetStringAsync(
            "https://api.example.com/data"
        );

        await context.Log("Данные успешно получены из внешнего API");
    }
}

РекомендацииРекомендации

• Делайте задания идемпотентными (повторный запуск не должен приводить к ошибкам).
• Используйте context.Log(...) для диагностики работы задания.
• Для интеграций используйте context.GetHttpClient().
• При обработке большого количества данных выполняйте выборки через IQueryable, чтобы избежать загрузки лишних данных в память.