Возникает при записи объекта. Процедура-обработчик вызывается после записи объекта в базу данных, но до окончания транзакции записи.
Синтаксис
ПриЗаписи(<Отказ>)Полное описание, параметры и ограничения
ДокументОбъект.<Имя документа>.ПриЗаписи (DocumentObject.<Document name>.OnWrite)
ДокументОбъект.<Имя документа> (DocumentObject.<Document name>)
ПриЗаписи (OnWrite)
Доступен, начиная с версии 8.0.
Синтаксис:
ПриЗаписи(<Отказ>)
Параметры:
<Отказ>
Тип: Булево.
Признак отказа от записи документа. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись документа выполнена не будет.
Значение по умолчанию: Ложь.
Описание:
Возникает при записи объекта. Процедура-обработчик вызывается после записи объекта в базу данных, но до окончания транзакции записи.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
См. также:
ДокументОбъект.<Имя документа>, метод Записать
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Показать номер на этапе ПриЗаписи документа
Номер уже доступен, но транзакция записи ещё не завершена.
Где и как запускать
Модуль объекта или набора записей, указанный в подготовке. Обработчик вызывается платформой; не вызывайте его как обычную команду формы.
Подготовка
В отдельной учебной конфигурации создайте документ УчебнаяЗаявка: строковый номер длиной 12 с автонумерацией и разрешённым проведением.
Добавьте реквизиты Комментарий (Строка 100), Сумма (Число 15.2), Утвержден (Булево), ЗакрытПериод (Булево). Регистры и движения для этого урока не нужны.
Откройте Документы → УчебнаяЗаявка → Модуль объекта, вставьте обработчик и обновите только учебную базу. Это пример жизненного цикла, а не готовый бухгалтерский документ.
Процедура ПриЗаписи(Отказ)
Если Не ОбменДанными.Загрузка Тогда
Сообщить("Этап ПриЗаписи заявки № " + Номер);
КонецЕсли;
КонецПроцедурыРазбор по шагам
Запишите допустимую учебную заявку.
Платформа вызывает обработчик после записи объекта внутри транзакции.
Покажите номер, не выполняя повторную запись и внешние действия.
Как проверить результат
При обычной записи виден номер заявки.
В коде нет повторного вызова Записать.
Ожидаемый результат
Показан этап жизненного цикла, а не подтверждение фиксации транзакции.
На что обратить внимание
Позднейший отказ может откатить запись после этого сообщения.
Рассылку о подтверждённой операции организуйте после успешной фиксации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.