Другое · 7 мин
Как прервать выполнение в 1С по условию
Практически о прерывании выполнения в 1С: где ставить проверку, как использовать Прервать, какие риски и как проверить результат без потери данных в рабочей базе.
В 1С прерывание выполнения чаще всего нужно, когда условие не выполнено: не заполнен реквизит, не прошла проверка остатков, контрагент не найден или операция недопустима в текущем состоянии.
Основной инструмент встроенного языка — оператор Прервать. Он останавливает выполнение текущей процедуры или функции, после чего управление не возвращается к остальному коду того же блока. Что произойдёт дальше, зависит от контекста: форма, отчёт, обработка, серверная процедура или фоновое задание.
Прерывание не отменяет автоматически уже записанные данные и не откатывает транзакцию, если вы её не управляли явно. Поэтому проверку лучше ставить до записи, проведения или изменения регистров, а не после.
Перед изменением рабочей базы проверяйте сценарий на копии, делайте резервную копию и убедитесь, что пользователи понимают, почему операция прервалась.
Не ставьте прерывание в самом конце обработки, если до него уже успели изменить объекты или зарегистрировать движения. В таких случаях проще предотвратить недопустимое действие на этапе ввода или проверки, чем пытаться откатить последствия.
Также важно различать остановку кода и отказ пользователя. Прервать работает внутри алгоритма, а прерывание пользователем через закрытие формы или отмену диалога обрабатывается иначе и не всегда доступно для программного перехвата.
- 1Определите точку, до которой данные ещё можно не менять
- 2Напишите условие Если…Тогда с оператором Прервать
- 3Добавьте информативное сообщение пользователю
- 4Проверьте поведение на копии базы
Когда и где уместно прерывание
Прерывание уместно, когда дальнейшее выполнение приведёт к некорректному результату: например, документ не может быть проведён без контрагента, отчёт не имеет смысла без периода, а обработка не должна менять остатки при отсутствии источника.
Чем раньше срабатывает проверка, тем безопаснее прерывание. Идеальное место — начало обработки события, перед записью объекта, перед проведением документа или перед вызовом серверной процедуры, которая меняет данные.
Если прерывание нужно в массовой обработке или обмене, подумайте, как система продолжит работу после остановки одного элемента. Иногда лучше пропустить проблемную запись и продолжить следующую, чем прерывать весь пакет.
Как написать проверку с Прервать
Типичная конструкция выглядит так: сначала проверяется необходимое условие, затем выводится сообщение и выполняется Прервать. Сообщение нужно делать конкретным, чтобы пользователь знал, какой реквизит заполнить или какое условие исправить.
Не используйте Прервать без сообщения в интерфейсе: пользователь увидит просто остановку операции и не поймёт причину. Лучше комбинировать Прервать с Сообщить, ОповещениеПользователю или отказом в сохранении формы, в зависимости от типа конфигурации.
В управляемых формах проверку часто удобно разместить в обработчике события перед записью, например при изменении важного реквизита или при попытке провести документ. В обычных формах подойдёт обработка команды или события перед выполнением действия.
Различия по контекстам: форма, сервер, фоновое задание
На клиенте прерывание обычно останавливает действие пользователя в открытой форме. На сервере оно завершает выполнение серверной процедуры или функции, но не обязательно прерывает весь вызов, если процедура запущена из другого кода.
В фоновых заданиях и расписаниях прерывание может завершить только текущий шаг задания. Поведение зависит от способа запуска и настроек планировщика, поэтому перед использованием в автоматических процессах проверяйте, как система фиксирует остановку.
Если прерывание происходит в транзакции, явно решите, фиксировать изменения или отменять их. Без такого решения часть данных может остаться изменённой даже после остановки кода.
Что делать с данными и транзакциями
Используйте транзакции только там, где это действительно необходимо, и помните, что Прервать сам по себе не откатывает изменения. Если нужно обеспечить атомарность, оберните критический участок в начало и фиксацию или отмену транзакции.
Не полагайтесь на прерывание как на способ отмены уже проведённого документа. Проведение может создавать записи в регистрах, которые требуют отдельного отменного проведения или корректировки.
Проверяйте целостность после прерывания в критических процессах: остатки, остатки по контрагентам, накопленные итоги и закрытые периоды могут требовать повторной сверки.
Частые ошибки и как их избегать
Одна из частых ошибок — ставить Прервать после изменения объекта, но до его записи. В этом случае изменения могут остаться в памяти или быть записаны другим кодом, а пользователь получит ложное впечатление, что операция полностью отменена.
Вторая ошибка — отсутствие сообщения о причине. Тогда пользователь повторяет действие и снова получает молчаливую остановку, что увеличивает нагрузку на поддержку и замедляет работу.
Третья ошибка — использование Прервать в циклах без учёта продолжения обработки остальных элементов. Если нужно пропустить только одну строку, лучше использовать переход к следующей итерации или пропуск, а не остановку всего цикла.
Как проверить, что прерывание сработало
Проверяйте результат по признакам: операция не завершена, документ не проведён, объект не записан, а пользователь получил сообщение о причине. В журналах регистрации должно быть видно, что действие прервано, а не завершено успешно.
Как проверить результат
Документ не проведён, объект не записан, причина ясна
Данные изменены, а пользователь не понял, почему действие не выполнено
Если прерывание используется в фоновых процессах, проверяйте статус задания и сообщения об ошибках. Убедитесь, что одно прерывание не блокирует всю очередь задач.
Повторяйте проверку после изменений конфигурации или обновления платформы, так как поведение некоторых событий и форм может отличаться.
Что важно запомнить
Ставьте проверку и Прервать до критических изменений, объясняйте пользователю причину, управляйте транзакциями явно и тестируйте на копии базы.
Можно ли прервать проведение документа после его записи?
Обычно нет, если проведение уже завершилось и движения зарегистрированы. Прервать останавливает выполнение кода, но не отменяет уже записанные данные. Нужно использовать отмену проведения или корректирующие операции, если они предусмотрены конфигурацией.
Нужно ли всегда писать сообщение перед Прервать?
В интерфейсе для пользователя — желательно, иначе причина остановки будет неясной. В серверном или фоновом коде сообщение может быть не обязательным, но полезно для журнала и диагностики.
Откатывает ли Прервать транзакцию автоматически?
Не обязательно. Оператор останавливает выполнение текущего блока, а откат транзакции требует явных действий, если транзакция была начата. Без этого часть изменений может остаться в базе.
Работает ли Прервать одинаково в толстом и тонком клиенте?
Поведение может различаться в зависимости от места вызова, типа формы и способа запуска. Перед использованием в производстве проверяйте сценарий в той же конфигурации и клиенте, где он будет применяться.