ПриЗаписи: обычная форма УчебнаяЗаписка

Событие обычной формы срабатывает после записи объекта, но до окончания транзакции. Отказ ещё позволяет отменить изменение.

Подготовка

1. Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте Документ УчебнаяЗаписка; не добавляйте эти учебные объекты в рабочую базу.

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

3. Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.

4. У Документ УчебнаяЗаписка создайте именно обычную объектную форму УчебнаяОбычная, не управляемую и не форму списка. Основной реквизит формы назовите Объект, тип — объект данного собственного метаданного.

5. Выведите Объект.Лимит и Объект.Комментарий на форму. Оставьте штатные команды записи. Добавьте надпись УчебноеПояснение без связи с данными.

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

7. В отдельной внешней обработке создайте обычную форму и кнопку ОткрытьСвойОбъект; последний дополнительный блок назначьте её обработчиком. Это настоящий производитель объекта, который получает его именованную форму.

8. Запуск — толстый клиент, обычные формы, отдельная учебная конфигурация. Директивы &НаКлиенте / &НаСервере в модуль обычной формы не добавляются.

9. Для обычного опыта задайте число 25. Старт процесса выполняется только подготовительным производителем задачи; сами события записи не стартуют процесс и не выполняют задачу.

Процедура ПриЗаписи(Отказ)
    Если Объект.Лимит > 100 Тогда
        Отказ = Истина;
        Сообщить("Превышен учебный лимит 100: запись отменяется");
    КонецЕсли;
КонецПроцедуры

Процедура ОткрытьСвойОбъект(Кнопка)
    СвойОбъект = Документы.УчебнаяЗаписка.СоздатьДокумент();
    СвойОбъект.Дата = Дата(2026, 10, 14);
    СвойОбъект.Лимит = 100;
    СвойОбъект.Комментарий = "Учебный пример";
    ФормаОбъекта = СвойОбъект.ПолучитьФорму("УчебнаяОбычная");
    ФормаОбъекта.Открыть();
КонецПроцедуры

Разбор по шагам

1. Открываем точную обычную форму собственного объекта, созданного дополнительным кодом.

2. Платформа вызывает назначенный обработчик своей формы с параметрами установленной справки.

3. Событие обычной формы срабатывает после записи объекта, но до окончания транзакции. Отказ ещё позволяет отменить изменение.

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

1. Сначала сохраните 25, затем попытайтесь записать 150: данная проверка отменяет запись.

2. Закройте форму без сохранения и заново откройте свою ссылку: в базе осталось 25, не 150.

Ожидаемый результат

Событие проверяется в настоящей собственной объектной форме толстого клиента.

На что обратить внимание

1. Этот пример не предназначен для управляемой формы: контексты и последовательности событий различаются.

2. Правило формы не защищает программную запись без этой формы; общие правила данных размещают в модуле объекта.

3. Не вызывайте Записать повторно внутри ПередЗаписью, ПриЗаписи или ПослеЗаписи; здесь нет рекурсивной записи.

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

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