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

Другое · 7 мин

Как прервать выполнение процедуры в 1С: способы и ограничения

Как остановить выполнение процедуры в 1С: операторы Возврат и ВозвестиИсключение, выход из циклов, отмена фоновых заданий и безопасная отладка без потери данных.

В 1С нет одной универсальной кнопки «остановить процедуру»: способ зависит от того, нужно ли просто выйти из процедуры, прервать её с ошибкой, выйти из цикла или отменить фоновое задание. Неправильный выбор может оставить данные неполными или скрыть ошибку от вызывающего кода.

Самый простой способ завершить процедуру нормально — оператор Возврат. Без значения он завершает текущую процедуру и возвращает Неопределено, с выражением — возвращает указанный результат. Возврат не останавливает процедуры, которые вызвали текущую, выше по стеку вызовов.

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

Нормальное завершение: оператор Возврат

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

Если Объект = Неопределено Тогда
Возврат;
КонецЕсли;

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

Нужен просто выходИспользуйте Возврат

Проверьте, что вызывающий код корректно обрабатывает возвращаемое значение.

Нужен отказ с ошибкойИспользуйте ВозвестиИсключение

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

Нужно выйти только из циклаИспользуйте Прервать или Продолжить

Помните, что процедура при этом продолжает работу после цикла.

Прерывание с ошибкой: ВозвестиИсключение

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

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

Выход из циклов без остановки всей процедуры

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

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

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

Фоновые задания и длительные операции

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

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

Типичные ошибки
01
Считать, что Прервать останавливает всю процедуру, а не только цикл
02
Перехватывать исключение Попыткой и не замечать, что прерывание не произошло
03
Прерывать запись документа без проверки отката, что может привести к неполным данным

Отмена в форме и отладка

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

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

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

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

Процедура завершена без ошибки
Норма

Возвращено ожидаемое значение или Неопределено, вызывающий код продолжает работу

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

Исключение поднято не там, где ожидалось, или данные остались частично записанными

Цикл прерван
Норма

Выполнение перешло к коду после цикла

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

Процедура остановилась полностью вместо продолжения после цикла

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

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

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

Итог

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

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

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

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

В чём разница между Возврат и ВозвестиИсключение?

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

Останавливает ли Прервать всю процедуру?

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

Что делать, если исключение перехвачено блоком Попытка?

Если исключение перехвачено, выполнение не останавливается окончательно: управление переходит в блок Исключение, а затем продолжается после КонецПопытки. Чтобы прерывание действительно привело к остановке, исключение не должно быть перехвачено, либо после перехвата нужно повторно возбудить его или завершить процедуру оператором Возврат.

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

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