ХранилищеНастроекМенеджер.<Имя хранилища>.ОбработкаПолученияОписания

ОбработкаПолученияОписания: собственные настройки книг

Полный небольшой адаптер: свой ключ отделён префиксом, данные действительно сохраняются / загружаются штатным внутренним хранилищем, а публичный менеджер вызывает нужное событие.

Подготовка

1. В своей отдельной учебной конфигурации Общие → Хранилища настроек создайте УчебныеНастройкиКниг. Все четыре процедуры и функцию ключа разместите в его модуле менеджера. Это самостоятельное собственное хранилище, его не нужно назначать глобальным хранилищем конфигурации.

2. Пример работает только со своим строковым ключом объекта УчебныеКниги. В стандартном внутреннем хранилище используется отдельное пространство СинтаксисУчебный.УчебныеКниги; чужие системные ключи не читаются и не перезаписываются.

3. Дополнительный блок выполните в собственной серверной обработке или кнопке обычной формы, толстый клиент. Пользователю нужно право СохранениеДанныхПользователя. Параметр другого пользователя не задаётся; стандартное хранилище само проверяет АдминистрированиеДанных, если такой параметр передан.

4. Каждый обработчик вызывается своим публичным методом менеджера. Не вызывайте процедуру ОбработкаСохранения напрямую для имитации сохранения. Прямой ПолучитьСтандартноеХранилищеОбщихНастроек исключает возврат в настроенный пользовательский обработчик и рекурсию.

5. BSL, изменение своих настроек и запись в хранилище при сборке HTML не выполнялись. Показанный ручной опыт сохраняет только собственные учебные ключи.

Процедура ОбработкаПолученияОписания(КлючОбъекта, КлючНастроек, ОписаниеНастроек, Пользователь)
    Пользователь = ПользовательУчебногоХранилища(Пользователь);
    БазовыйКлюч = КлючУчебногоХранилища(КлючОбъекта);
    База = ПолучитьСтандартноеХранилищеОбщихНастроек();
    ОписаниеНастроек = База.ПолучитьОписание(БазовыйКлюч, КлючНастроек, Пользователь);
КонецПроцедуры

Функция КлючУчебногоХранилища(КлючОбъекта)
    Если КлючОбъекта <> "УчебныеКниги" Тогда
        ВызватьИсключение "Этот учебный пример обслуживает только ключ УчебныеКниги";
    КонецЕсли;
    Возврат "СинтаксисУчебный." + КлючОбъекта;
КонецФункции

Функция ПользовательУчебногоХранилища(Пользователь)
    Если ПустаяСтрока(Пользователь) Тогда
        Возврат ИмяПользователя();
    КонецЕсли;
    Возврат Пользователь;
КонецФункции

Процедура ОбработкаСохранения(КлючОбъекта, КлючНастроек, Настройки, ОписаниеНастроек, Пользователь)
    Пользователь = ПользовательУчебногоХранилища(Пользователь);
    БазовыйКлюч = КлючУчебногоХранилища(КлючОбъекта);
    База = ПолучитьСтандартноеХранилищеОбщихНастроек();
    Если ОписаниеНастроек = Неопределено Тогда
        База.Сохранить(БазовыйКлюч, КлючНастроек, Настройки, , Пользователь);
    Иначе
        База.Сохранить(БазовыйКлюч, КлючНастроек, Настройки, ОписаниеНастроек, Пользователь);
    КонецЕсли;
КонецПроцедуры

Процедура ОбработкаЗагрузки(КлючОбъекта, КлючНастроек, Настройки, ОписаниеНастроек, Пользователь)
    Пользователь = ПользовательУчебногоХранилища(Пользователь);
    БазовыйКлюч = КлючУчебногоХранилища(КлючОбъекта);
    База = ПолучитьСтандартноеХранилищеОбщихНастроек();
    Если ОписаниеНастроек = Неопределено Тогда
        Настройки = База.Загрузить(БазовыйКлюч, КлючНастроек, , Пользователь);
    Иначе
        Настройки = База.Загрузить(БазовыйКлюч, КлючНастроек, ОписаниеНастроек, Пользователь);
    КонецЕсли;
КонецПроцедуры

Процедура ОбработкаУстановкиОписания(КлючОбъекта, КлючНастроек, ОписаниеНастроек, Пользователь)
    Пользователь = ПользовательУчебногоХранилища(Пользователь);
    БазовыйКлюч = КлючУчебногоХранилища(КлючОбъекта);
    Если КлючНастроек = Неопределено Тогда
        КлючНастроек = Строка(Новый УникальныйИдентификатор);
    КонецЕсли;
    База = ПолучитьСтандартноеХранилищеОбщихНастроек();
    База.УстановитьОписание(БазовыйКлюч, КлючНастроек, ОписаниеНастроек, Пользователь);
КонецПроцедуры

Хранилище = ХранилищаНастроек.УчебныеНастройкиКниг;
Описание = Новый ОписаниеНастроек;
Описание.Представление = "Собственные книги: первоначальный вариант";
Настройки = Новый Структура("Количество,ПоказыватьСумму", 3, Истина);
Хранилище.Сохранить("УчебныеКниги", "Основной", Настройки, Описание);
Получено = Хранилище.Загрузить("УчебныеКниги", "Основной");
Если Получено = Неопределено Тогда
    ВызватьИсключение "Собственные настройки не загрузились";
КонецЕсли;
Сообщить("Сохранённое количество: " + Строка(Получено.Количество));
Описание.Представление = "Собственные книги: уточнённое название";
Хранилище.УстановитьОписание("УчебныеКниги", "Основной", Описание);
ПрочитанноеОписание = Хранилище.ПолучитьОписание("УчебныеКниги", "Основной");
Сообщить(ПрочитанноеОписание.Представление);

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

1. Создайте собственное хранилище и разместите весь модуль из блоков.

2. В своей обработке выполните публичное сохранение / загрузку / изменение описания.

3. Проверьте количество 3 и новое представление, затем повторно загрузите свой ключ в следующем сеансе.

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

1. В ОбработкаЗагрузки результат передаётся параметру Настройки; Возврат из процедуры не заменяет этот выходной параметр.

2. Изменение представления не заменяет сохранённую структуру настроек. Для стандартного хранилища из ОписаниеНастроек используется Представление.

3. Новый ключ в ОбработкаУстановкиОписания возвращается изменением КлючНастроек, если передано Неопределено. Основной опыт использует явный ключ Основной.

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

Собственный публичный менеджер выполняет полный цикл на реальном внутреннем хранилище, не в фиктивном глобальном словаре.

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

1. ПолучитьСтандартноеХранилищеОбщихНастроек не зависит от назначения пользовательского хранилища конфигурации.

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

3. Проверка пространства своего ключа не является проверкой имени конфигурации или версии платформы.

4. Сборка HTML не исполняет сохранение и не подтверждает запуск BSL.

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