Тип: КомпоновщикНастроекКомпоновкиДанных. Компoновщик для редактирования настроек динамического списка.
Полное описание, параметры и ограничения
ДинамическийСписок.КомпоновщикНастроек (DynamicList.SettingsComposer)
ДинамическийСписок (DynamicList)
КомпоновщикНастроек (SettingsComposer)
Доступен, начиная с версии 8.3.3.
Использование:
Только чтение.
Описание:
Тип: КомпоновщикНастроекКомпоновкиДанных.
Компoновщик для редактирования настроек динамического списка.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.3.
Методическая информация
Практические примеры
Различить настройки списка и их автоматическое сохранение
Показываем три слоя настроек и не трактуем ключ хранилища как текущую строку товара. Для независимых упражнений автосохранение остаётся выключенным.
Где и как запускать
Модуль собственной управляемой формы внешней обработки. Вставляйте готовые процедуры с директивами на уровне модуля; каждый урок — в отдельной копии формы.
Подготовка
В учебной базе 8.5.1.1343 создайте новую внешнюю обработку УчебныйСписок85, пустую управляемую основную форму. Режим совместимости — 8.3.19 или выше. Не переделывайте список рабочей конфигурации.
В реквизитах формы добавьте Список типа ДинамическийСписок. Создайте один элемент ТаблицаФормы с именем ТаблицаТоваров и путём к данным Список. Колонки вручную не добавляйте: их создаёт код. Это не ТаблицаЗначений и не коллекция строк для Добавить().
В событиях формы назначьте ПриСозданииНаСервере одноимённой процедуре из примера. Не используйте одновременно другой обработчик заполнения этого списка.
При открытии код задаёт произвольный запрос из четырёх константных строк. Основная таблица не указана; таблицы базы, файлы и внешние сервисы не используются. Запись данных отсутствует.
Каждый раз открывайте отдельную копию формы. Автоматическое сохранение настроек отключено: старый пользовательский отбор не должен вмешиваться в упражнение.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Список.ПроизвольныйЗапрос = Истина;
Список.ОсновнаяТаблица = "";
Список.ДинамическоеСчитываниеДанных = Ложь;
Список.АвтоЗаполнениеДоступныхПолей = Истина;
Список.АвтоматическоеСохранениеПользовательскихНастроек = Ложь;
Список.ВидКлюча = ВидКлючаДинамическогоСписка.ЗначениеПоля;
КлючевыеПоля = Новый Массив;
КлючевыеПоля.Добавить("УчебныйНомер");
Список.ПоляКлюча = Новый ФиксированныйМассив(КлючевыеПоля);
Список.ТекстЗапроса = "ВЫБРАТЬ
| 1 КАК УчебныйНомер,
| ""Книга"" КАК Наименование,
| ""Канцелярия"" КАК Категория,
| 3 КАК Количество,
| 250 КАК Цена
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 2, ""Ручка"", ""Канцелярия"", 1, 30
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 3, ""Чай"", ""Продукты"", 2, 150
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 4, ""Вода"", ""Продукты"", 0, 70";
Элементы.ТаблицаТоваров.ТолькоПросмотр = Истина;
Редактор = Список.КомпоновщикНастроек;
Базовые = Редактор.Настройки;
Пользовательские = Редактор.ПользовательскиеНастройки;
Фиксированные = Редактор.ФиксированныеНастройки;
ТекущийКлючНастроек = Список.КлючТекущихПользовательскихНастроек;
Сообщить(ТипЗнч(Базовые) = Тип("НастройкиКомпоновкиДанных"));
Сообщить(ТипЗнч(Фиксированные) = Тип("НастройкиКомпоновкиДанных"));
Сообщить(ТипЗнч(Пользовательские) = Тип("ПользовательскиеНастройкиКомпоновкиДанных"));
Сообщить(Не Список.АвтоматическоеСохранениеПользовательскихНастроек);
Сообщить("Ключ настроек сейчас имеет тип: " + Строка(ТипЗнч(ТекущийКлючНастроек)));
Для Каждого ИмяПоля Из СтрРазделить("УчебныйНомер,Наименование,Категория,Количество,Цена", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяПоля, Тип("ПолеФормы"), Элементы.ТаблицаТоваров);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Список." + ИмяПоля;
Колонка.Заголовок = ИмяПоля;
КонецЦикла;
КонецПроцедуры
Разбор по шагам
КомпоновщикНастроек — редактор настроек, не результат запроса и не массив товаров.
Настройки, ПользовательскиеНастройки и ФиксированныеНастройки — разные слои. Читаем их типы, не переписываем всё дерево.
КлючТекущихПользовательскихНастроек только читается и зависит от состояния настройки; нет универсального значения, равного номеру выбранного товара.
При выключенном автосохранении урок не демонстрирует сохранение в хранилище. Начальный набор каждый раз задаётся обработчиком формы.
Как проверить результат
Четыре проверки дают Истина; последнее сообщение показывает фактический тип ключа, значение которого заранее не утверждаем.
Закройте форму после изменения сортировки и откройте снова: сравните настройки с новым экземпляром из обработчика. Отдельное сохранение пользовательского варианта не выполняйте.
Ожидаемый результат
Чтение слоёв настройки с честной границей между редактированием и сохранением.
На что обратить внимание
Отключённое автосохранение не запрещает прикладному коду явно сохранять настройки: в собственной форме такого кода нет.
Ключ может отсутствовать или меняться; нельзя без проверки обращаться к нему как к ссылке справочника.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.