Расширение формы документа.ПередЗаписью

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

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

Подготовка

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

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

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

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

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

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

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

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

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

Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
    Если Объект.Лимит < 0 Тогда
        Отказ = Истина;
        Сообщить("Отрицательная учебная сумма не допускается");
    КонецЕсли;
КонецПроцедуры

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

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

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

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

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

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

1. Введите -1 и нажмите штатную кнопку Записать: форма отклоняет запись с сообщением.

2. Введите 25: эта проверка пропускает запись; прочие ограничения объекта продолжают действовать.

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

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

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

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

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

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

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

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