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

Другое · 7 мин

Как прервать выполнение в 1С по условию

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

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

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

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

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

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

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

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

Когда и где уместно прерывание

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

Чем раньше срабатывает проверка, тем безопаснее прерывание. Идеальное место — начало обработки события, перед записью объекта, перед проведением документа или перед вызовом серверной процедуры, которая меняет данные.

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

Как написать проверку с Прервать

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

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

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

Различия по контекстам: форма, сервер, фоновое задание

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

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

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

Что делать с данными и транзакциями

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

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

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

Частые ошибки и как их избегать

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

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

Типичные ошибки
01
Прервать после изменения объекта, но перед записью — изменения могут остаться
02
Отсутствие сообщения о причине остановки для пользователя
03
Прервать всего цикла вместо пропуска одной проблемной строки

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

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

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

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

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

Операция не завершена и пользователь получил сообщение
Норма

Документ не проведён, объект не записан, причина ясна

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

Данные изменены, а пользователь не понял, почему действие не выполнено

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

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

Итог

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

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

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

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

Нужно ли всегда писать сообщение перед Прервать?

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

Откатывает ли Прервать транзакцию автоматически?

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

Работает ли Прервать одинаково в толстом и тонком клиенте?

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