Возникает перед выполнением записи вида расчета. Процедура-обработчик вызывается после начала транзакции записи, но до начала записи вида расчета.
Синтаксис
ПередЗаписью(<Отказ>)Полное описание, параметры и ограничения
ПланВидовРасчетаОбъект.<Имя плана видов расчета>.ПередЗаписью (ChartOfCalculationTypesObject.<Chart of calculation types name>.BeforeWrite)
ПланВидовРасчетаОбъект.<Имя плана видов расчета> (ChartOfCalculationTypesObject.<Chart of calculation types name>)
ПередЗаписью (BeforeWrite)
Доступен, начиная с версии 8.0.
Синтаксис:
ПередЗаписью(<Отказ>)
Параметры:
<Отказ>
Тип: Булево.
Признак отказа от записи элемента. Если в теле процедуры-обработчика установить данному параметру значение Истина, запись элемента выполнена не будет и будет вызвано исключение.
Значение по умолчанию: Ложь.
Описание:
Возникает перед выполнением записи вида расчета. Процедура-обработчик вызывается после начала транзакции записи, но до начала записи вида расчета.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Не записывать отрицательный лимит: УчебныеВидыРасчета
Возникает перед выполнением записи вида расчета. Процедура-обработчик вызывается после начала транзакции записи, но до начала записи вида расчета. Проверка выполняется перед записью самого объекта; повторную Записать из обработчика не вызываем.
Где и как запускать
Модуль объекта УчебныеВидыРасчета. Дополнительный блок — тело отдельной серверной команды учебной обработки.
Подготовка
Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте ПланВидовРасчета УчебныеВидыРасчета; не добавляйте эти учебные объекты в рабочую базу.
Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.
Для плана видов расчёта не включайте зависимость от базового периода и действие по периоду. Регистры расчёта в этом уроке не нужны.
Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.
Откройте ПланыВидовРасчета → УчебныеВидыРасчета → Модуль объекта и вставьте основной обработчик на уровне модуля без директивы НаКлиенте.
Дополнительный блок запускайте в теле серверной команды собственной учебной обработки. Он вызывает настоящий метод подготовленного объекта; обработчик события вручную не вызывайте.
Каждое событие проверяйте как отдельный урок. Обновите только учебную базу; примеры не исполняются HTML-справочником.
Процедура ПередЗаписью(Отказ)
Комментарий = СокрЛП(Комментарий);
Если Лимит < 0 Тогда
Отказ = Истина;
Сообщить("Лимит не может быть отрицательным");
КонецЕсли;
КонецПроцедурыНастоящий вызов события подготовленным объектом
Объект = ПланыВидовРасчета.УчебныеВидыРасчета.СоздатьВидРасчета();
Объект.Наименование = "Учебная карточка";
Объект.Код = Лев(Строка(Новый УникальныйИдентификатор), 8);
Объект.Лимит = 100;
Объект.Комментарий = "Учебный пример";
Объект.Лимит = -1;
Попытка
Объект.Записать();
Исключение
Сообщить(ОписаниеОшибки());
КонецПопытки;Разбор по шагам
Дополнительный код создаёт реальный объект УчебныеВидыРасчета штатным менеджером.
Проверка выполняется перед записью самого объекта; повторную Записать из обработчика не вызываем.
Параметры события передаёт платформа; модуль обращается к собственным реквизитам из подготовки.
Как проверить результат
В дополнительном коде Лимит = -1: запись отменена, показана причина.
Замените -1 на 100: запись разрешена, крайние пробелы комментария убраны.
Ожидаемый результат
Не записывать отрицательный лимит для подготовленного учебного объекта.
На что обратить внимание
Работайте только с объектом, созданным дополнительным кодом, и только в своей учебной базе.
Сообщение внутри события записи не доказывает завершение всей транзакции; не отправляйте оттуда письма и не вызывайте внешние сервисы.
Правила объекта не надо обходить повторной записью из его же обработчика.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.