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