В обработчик передается объект-соответствие, в который будут сохраняться настройки. В объекте уже заполнены значения реквизитов, которые требовалось сохранять. В обработчике можно добавить в объект настроек какую-либо информацию. Например, поместить в реквизит настроек отбор.
Синтаксис
ПриСохраненииДанныхВНастройкахНаСервере(<Настройки>)Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.ПриСохраненииДанныхВНастройкахНаСервере (ClientApplicationForm.OnSaveDataInSettingsAtServer)
ФормаКлиентскогоПриложения (ClientApplicationForm)
ПриСохраненииДанныхВНастройкахНаСервере (OnSaveDataInSettingsAtServer)
Доступен, начиная с версии 8.2.
Синтаксис:
ПриСохраненииДанныхВНастройкахНаСервере(<Настройки>)
Параметры:
<Настройки>
Тип: Соответствие.
Настройки формы.
Описание:
В обработчик передается объект-соответствие, в который будут сохраняться настройки. В объекте уже заполнены значения реквизитов, которые требовалось сохранять.
В обработчике можно добавить в объект настроек какую-либо информацию. Например, поместить в реквизит настроек отбор.
Доступность:
Тонкий клиент, веб-клиент, толстый клиент.
Примечание:
Вызывается на сервере.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Сохранить и восстановить свою скидку в настройках формы
Платформа передаёт Соответствие настроек: дополняем его своим ключом и читаем ключ перед загрузкой.
Где и как запускать
Модуль управляемой формы, указанной в подготовке. Директивы &НаКлиенте и &НаСервере уже включены в код.
Подготовка
В отдельной учебной конфигурации создайте обработку УчебнаяПанель и управляемую форму Панель. Код обработчика вставляйте на уровне модуля формы.
В свойствах формы на вкладке События назначьте указанному событию одноимённую процедуру. Обновите только учебную базу; проверяйте в тонком клиенте.
Для этого опыта создайте отдельную форму Параметры у УчебнаяПанель. Реквизиты Количество (Число 10.0, Сохраняемые данные Да) и Скидка (Число 5.2, Сохраняемые данные Нет); выведите оба поля.
Сохранение данных в настройках — Использовать список, автоматическое сохранение — Не использовать. Назначьте все три серверных события процедурам из примера.
Откройте форму под своим учебным пользователем. В меню формы используйте Сохранить параметры и Восстановить параметры; так опыт не зависит от автоматического сохранения при закрытии.
&НаСервере
Процедура ПриСохраненииДанныхВНастройкахНаСервере(Настройки)
Настройки.Вставить("УчебнаяСкидка", Скидка);
КонецПроцедуры
&НаСервере
Процедура ПередЗагрузкойДанныхИзНастроекНаСервере(Настройки)
ЗначениеСкидки = Настройки.Получить("УчебнаяСкидка");
Если ЗначениеСкидки = Неопределено Тогда
Скидка = 0;
Иначе
Скидка = ЗначениеСкидки;
КонецЕсли;
КонецПроцедуры
&НаСервере
Процедура ПриЗагрузкеДанныхИзНастроекНаСервере(Настройки)
Сообщить("Скидка после загрузки: " + Строка(Скидка));
КонецПроцедурыРазбор по шагам
Сохраняемый Количество платформа записывает сама, а Скидку код добавляет в то же соответствие отдельным ключом.
Перед загрузкой восстанавливаем свой ключ; при первом открытии без настроек скидка становится нулём.
После загрузки показываем фактически установленную скидку, не записывая её в документ.
Как проверить результат
Введите Количество 3 и Скидка 7, выполните Сохранить параметры; затем поменяйте на 1 и 0 и выполните Восстановить параметры: получатся 3 и 7.
Закройте и откройте эту же форму под тем же пользователем: ранее сохранённая скидка восстанавливается.
Ожидаемый результат
Собственный ключ прошёл настоящий цикл пользовательских настроек формы.
На что обратить внимание
Ключ УчебнаяСкидка принадлежит только этому уроку; не перезаписывайте стандартные ключи платформы.
Настройки зависят от пользователя и формы. Последнее сохранение другого экземпляра может заменить предыдущие параметры.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.