К статье
Практический материал

Другое · 6 мин

Программный запуск регламентного задания в 1С:Предприятии

Как запустить регламентное задание в 1С программно: способы, проверки перед стартом, порядок действий, типичные ошибки и способы подтвердить результат.

Регламентные задания в 1С:Предприятии предназначены для автоматического выполнения операций по расписанию: обмен данными, закрытие периода, расчеты, отправка уведомлений и другие повторяющиеся процессы. Иногда требуется запустить такое задание по требованию из кода, а не ждать следующего срабатывания по расписанию.

Программный запуск возможен, но порядок зависит от типа приложения, режима работы и того, где находится обработчик задания. Регламентные задания рассчитаны на выполнение на сервере, поэтому инициировать их лучше из серверного контекста, а не из обычной клиентской формы.

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

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

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

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

Проверки перед программным запуском

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

Проверьте права текущего пользователя: запуск регламентного задания может требовать соответствующих ролей или прав доступа к объекту конфигурации. Также убедитесь, что само задание помечено как активное и не отключено администратором.

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

Основные способы запуска из кода

Один из вариантов — вызов серверной процедуры-обработчика задания напрямую. Этот подход подходит, когда логика задания вынесена в отдельную процедуру и не зависит от встроенного планировщика. Выполнение целесообразно выносить на сервер через директиву &НаСервере.

Порядок действий
  1. 1
    Откройте конфигуратор и найдите нужное регламентное задание
  2. 2
    Проверьте, что задание активно и у пользователя есть права на его запуск
  3. 3
    Вынесите вызов обработчика в серверную процедуру
  4. 4
    Выполните запуск и дождитесь завершения
  5. 5
    Проверьте журнал регистрации и сообщения о выполнении

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

Третий путь — использование встроенного механизма регламентных заданий, если платформа предоставляет соответствующий интерфейс запуска по имени задания. Точный набор действий зависит от версии 1С:Предприятия и типа приложения, поэтому перед внесением изменений рекомендуется проверить поведение на копии базы.

Контрольные точки

Как проверить результат

Статус задания после запуска
Норма

Задание выполнено без ошибок

Тревожный признак

Задание зависло или завершилось с ошибкой

Записи в журнале регистрации
Норма

Есть записи о начале и завершении

Тревожный признак

Записей нет или есть сообщения об ошибке

Данные после выполнения
Норма

Ожидаемые изменения применены

Тревожный признак

Данные не изменились или изменились частично

Порядок действий и пример кода

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

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

Типичные ошибки
01
Запуск клиентской процедуры вместо серверной — задание не выполняется или работает некорректно
02
Игнорирование прав доступа — запуск завершается без результата и без ошибки для пользователя
03
Запуск в эксклюзивном режиме или во время обновления конфигурации — возможна блокировка или повреждение данных

Как подтвердить, что задание выполнилось

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

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

Ограничения, риски и типичные ошибки

Частая ошибка — попытка запустить регламентное задание из клиентской формы без вызова на сервере. В этом случае код может не сработать или выполниться в некорректном контексте. Другая ошибка — игнорирование прав доступа, из-за чего запуск молча завершается без результата.

Не запускайте одно и то же длительное задание повторно, пока предыдущее выполнение не завершено. Это может привести к дублированию операций, блокировкам записей и нарушению целостности данных. При сомнениях обратитесь к администратору информационной базы.

Итог

Что важно запомнить

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

Часто задаваемые вопросы

Можно ли запустить регламентное задание из обычной формы?

Можно, но вызов должен выполняться на сервере. Если обработчик содержит только клиентский код, прямой запуск из клиентской формы может не сработать. Безопаснее создать серверную процедуру и вызывать её из формы через серверный вызов.

Нужны ли специальные права для запуска?

Да, пользователь должен иметь права на выполнение регламентного задания или доступ к соответствующему объекту конфигурации. Без нужных прав запуск может быть отклонен или завершиться без видимого эффекта.

Что делать, если задание не запускается?

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

Можно ли запускать одно задание несколько раз одновременно?

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