Возникает перед выполнением сохранения значений формы из списка сохраняемых значений.
Синтаксис
ПередСохранениемЗначений(<Отказ>)Полное описание, параметры и ограничения
Расширение формы отчета.ПередСохранениемЗначений (Report form extension.BeforeSaveValues)
Расширение формы отчета (Report form extension)
ПередСохранениемЗначений (BeforeSaveValues)
Доступен, начиная с версии 8.0.
Синтаксис:
ПередСохранениемЗначений(<Отказ>)
Параметры:
<Отказ>
Тип: Булево.
Признак сохранения значений формы. Если в теле процедуры-обработчика установить данному параметру значение Истина, сохранение не будет выполнено.
Значение по умолчанию: Ложь.
Описание:
Возникает перед выполнением сохранения значений формы из списка сохраняемых значений.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
ПередСохранениемЗначений: свой отчёт
Действие выполняется над явно подготовленными собственными данными и элементами; источник параметров — настоящее событие формы / поля.
Где и как запускать
Модуль собственной обычной формы, толстый клиент в обычном режиме.
Подготовка
В своей учебной конфигурации создайте Отчеты → УчебныеПараметрыКниг и его обычную основную форму. Толстый клиент в обычном режиме.
Реквизиты формы Количество Число 10.0, Цена и Сумма Число 12.2, Статус Строка 200, все выведите на форму. В списке сохраняемых значений формы включите только Количество и Цена.
В Конфигураторе включите у формы Восстанавливать настройки автоматически. При сохранении своего набора установите Использовать при открытии; без этого автоматического восстановления не будет. Нужно право СохранениеДанныхПользователя. Сумма пересчитывается, а ПриОткрытии не должен затирать восстановленные Количество и Цена.
Дополнительный блок — отдельная кнопка СвоиЗначения. Нажмите её только перед первоначальным сохранением, не запускайте автоматически при каждом открытии.
Основной обработчик назначьте событию самой формы ПередСохранениемЗначений. Сохраните свои значения штатной командой Сохранить значения, затем измените поля и выполните Восстановить значения / заново откройте свою форму.
Процедура ПередСохранениемЗначений(Отказ)
Если Количество < 0 Или Цена < 0 Тогда
Отказ = Истина;
Сообщить("Отрицательные свои параметры не сохраняются");
КонецЕсли;
Статус = "Проверены собственные значения перед сохранением";
КонецПроцедурыТа же своя обычная форма: начальные значения отдельной кнопкой
Процедура СвоиЗначения(Кнопка)
Количество = 3;
Цена = 250;
Сумма = Количество * Цена;
Сообщить("Подготовлены собственные значения 3 и 250");
КонецПроцедурыРазбор по шагам
Создайте свои реквизиты, элементы и указанные начальные данные.
Назначьте основной блок правильному событию формы либо поля.
Выполните описанное действие мышью / штатной командой и сравните результат.
Как проверить результат
При отрицательном своём количестве / цене сохранение отменяется; для 3 и 250 стандартное сохранение допускается.
Это сохранение значений обычной формы, не сохранение СКД-варианта и не запись документа.
Ожидаемый результат
Событие связано с воспроизводимым действием собственной обычной формы.
На что обратить внимание
В событиях поля первый Элемент добавляет редактор; у событий самой формы его нет.
Собственная структура расшифровки, маркер переноса и настройки формы — разные контракты; они не выдаются за произвольные объекты.
BSL и сохранение пользовательских значений здесь не запускались, рабочие данные и печать не использовались.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.