Как программно установить список выбора 1С

В экосистеме 1С:Предприятие управление перечислимыми типами данных является одной из базовых задач при разработке конфигураций. Разработчикам часто приходится не просто читать существующие значения, но и динамически формировать или изменять их структуру в runtime. Это особенно актуально при создании гибких интерфейсов, где набор доступных опций зависит от контекста выполнения или прав пользователя.

Ошибки при работе с типом СписокЗначений или Перечисление могут привести к критическим сбоям в логике программы. Например, попытка присвоить объекту значение, отсутствующее в допустимом наборе, вызовет исключение. Поэтому важно четко понимать разницу между статическими перечислениями, заданными в конфигураторе, и динамическими списками, создаваемыми в коде.

В данном материале мы детально разберем механизмы программного управления списками выбора. Вы узнаете, как корректно инициализировать объекты, добавлять в них элементы и связывать их с реквизитами форм или переменных. Особое внимание уделим нюансам работы с типовыми и нетиповыми конфигурациями.

Основные объекты для работы со списками

Фундаментом для реализации списков выбора в коде служит объект СписокЗначений. Это универсальный контейнер, позволяющий хранить пары «Значение — Представление». В отличие от жестко заданных перечислений метаданных, данный объект можно наполнять произвольными данными прямо во время выполнения программы.

Для создания нового экземпляра используется конструктор объекта. Каждый элемент списка может иметь уникальное внутреннее значение (ключ) и текстовое представление, видимое пользователю в интерфейсе.

СписокЗначений часто путают с обычными массивами, однако это принципиально разные структуры данных. Массив хранит только значения, тогда как список значений ориентирован на связку «код-название», что критически важно для элементов управления типа ПолеКомбинированногоСписка или ПолеСписка.

⚠️ Внимание: При попытке записать объект типа СписокЗначений в базу данных напрямую возникнет ошибка. Этот объект предназначен только для оперативной памяти и передачи данных между клиентом и сервером в рамках одной сессии.

Рассмотрим синтаксис создания базового списка. Мы определяем переменную и инициализируем её новым объектом. Далее мы можем сразу задать свойства, такие как использование флагов или возможность множественного выбора, хотя чаще эти параметры настраиваются в элементах формы.

Список = Новый СписокЗначений;
Список.Добавить("Значение1", "Представление 1");
Список.Добавить("Значение2", "Представление 2");

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

Заполнение списка из справочников и перечислений

Наиболее частый сценарий использования — перенос данных из существующих объектов метаданных в динамический список. Это требуется, когда нужно отфильтровать данные справочника или объединить элементы из разных источников в единый интерфейс выбора.

Для работы с перечислениями используется глобальный метод Перечисления. Он возвращает коллекцию всех значений конкретного перечисления, заданного в конфигураторе. iterating по этой коллекции, мы можем избирательно добавлять нужные элементы в наш СписокЗначений.

При работе со справочниками ситуация усложняется наличием пометок на удаление и иерархии. Простой перебор всех элементов может быть неэффективен для больших баз. В таких случаях рекомендуется использовать запросы или выборки с фильтрацией.

СписокСтатусов = Новый СписокЗначений;
Для каждого Элемент Из Перечисления.СтатусыЗаказа Цикл
Если Элемент.Имя <> "Закрыт" Тогда
СписокСтатусов.Добавить(Элемент, Элемент.Представление);
КонецЕсли;
КонецЦикла;

Обратите внимание на использование метода Добавить. Первый аргумент принимает само значение перечисления (ссылку на объект метаданных), а второй — строковое представление. Это гарантирует корректное отображение в форме и правильную запись значения в регистры или документы.

⚠️ Внимание: Интерфейсы и методы доступа к метаданным могут отличаться в разных версиях платформы 1С:Предприятие 8.3. Всегда сверяйте синтаксис с актуальной справкой по вашей версии платформы.

Если необходимо заполнить список из справочника, например, «Номенклатура», лучше использовать выборку. Это позволяет применить отборы непосредственно при чтении данных, экономя ресурсы сервера.

Настройка свойств элементов списка

Объект СписокЗначений предоставляет расширенные возможности настройки каждого отдельного элемента. Помимо базовой пары «Значение-Представление», можно задавать дополнительные флаги, такие как «Пометка» (Check) и «Картинка».

Использование свойства Пометка превращает обычный список в список с чекбоксами. Это незаменимо при создании форм группового подбора товаров или массового изменения статусов. Пользователь может визуально отметить несколько позиций перед выполнением действия.

• 📌 Значение — уникальный идентификатор элемента (строка, число, ссылка, перечисление).
• 🏷️ Представление — текст, отображаемый в поле ввода пользователю.
• ✅ Пометка — булево значение, определяющее состояние чекбокса рядом с элементом.
• 🖼️ Картинка — ссылка на объект Картинка для визуальной идентификации статуса или типа.

Для установки этих свойств используется объект ЭлементСпискаЗначений, который возвращается методом добавления, либо доступ к элементам по индексу. Гибкая настройка позволяет создавать богатые интерфейсы без сложной верстки.

Элемент = Список.Добавить();
Элемент.Значение = Справочники.Валюты.НайтиПоКоду("USD");
Элемент.Представление = "Доллар США";
Элемент.Пометка = Истина;
Элемент.Картинка = КаталогКартинки.Получить("usd_flag");

Такой подход делает интерфейс более интуитивным. Пользователь сразу видит, какие элементы активны, а какие нет, благодаря визуальным маркерам. Это снижает количество ошибок ввода данных.

Сортировка и фильтрация данных в списке

Порядок элементов в СпискеЗначений по умолчанию соответствует порядку их добавления. Однако в реальных задачах часто требуется сортировка по алфавиту, по коду или по пользовательскому критерию. Для этого предусмотрен встроенный метод Сортировать.

Метод сортировки позволяет упорядочить элементы по значению или по представлению. Это особенно полезно при работе со справочниками, где элементы могут быть добавлены в хаотичном порядке в результате выборки из базы данных без явного указания порядка в запросе.

Параметр сортировки	Описание	Пример использования
ПоЗначению	Сортировка по внутреннему ключу	Список.Сортировать(ПоЗначению)
ПоПредставлению	Сортировка по видимому тексту	Список.Сортировать(ПоПредставлению)
ПоПометке	Группировка отмеченных элементов	Список.Сортировать(ПоПометке)

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

При удалении элементов из списка во время перебора важно соблюдать осторожность. Изменение коллекции в цикле Для каждого может привести к непредсказуемому поведению. Рекомендуется использовать цикл Пока с индексом или собирать индексы на удаление в отдельный список.

Индекс = 0;
Пока Индекс < Список.Количество() Цикл
Если Список[Индекс].Значение.ЭтоГруппа() Тогда
Список.Удалить(Индекс);
Иначе
Индекс = Индекс + 1;
КонецЕсли;
КонецЦикла;

Такая логика гарантирует, что ни один элемент не будет пропущен из-за сдвига индексов после удаления. Это классический паттерн программирования, применимый ко многим языкам, но критичный именно в 1С из-за специфики работы коллекций.

Интеграция списка с элементами формы

Созданный программно список должен быть связан с элементом формы, чтобы пользователь мог взаимодействовать с ним. Чаще всего это делается путем присваивания списка свойству СписокВыбора элемента управления, такого как ПолеКомбинированногоСписка.

Важно учитывать контекст выполнения кода. Если элемент формы находится на клиенте, то и формирование списка должно происходить на клиенте, либо список должен быть передан с сервера как параметр. Прямая передача объектов сервера на клиент без сериализации невозможна.

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

При связывании списка с реквизитом документа следует убедиться, что типы данных совместимы. Если реквизит имеет тип СправочникСсылка.Номенклатура, то значения в списке выбора должны быть именно ссылками на этот справочник, а не строками.

⚠️ Внимание: Изменение списка выбора на клиенте не сохраняется в базе данных автоматически. Оно действует только в рамках текущей сессии работы с формой. При перезаписи объекта данные сохранятся только в соответствии с выбранным значением.

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

Обработка ошибок и оптимизация производительности

При работе с большими объемами данных наполнение списка выбора может стать узким местом производительности. Загрузка тысяч элементов справочника в память клиента приведет к зависанию интерфейса. Необходимо применять методы оптимизации.

Один из эффективных способов — использование механизм «Загрузка по требованию» или ограничение количества выводимых строк. Если список используется только для поиска, достаточно загружать первые 50-100 совпадений по введенному тексту.

Почему тормозит форма при открытии?

Чаще всего причина в попытке заполнить список выбора всеми элементами огромного справочника (например, Контрагенты) при инициализации формы. Решение: использовать отборы или автоподбор.

Обработка ошибок должна включать проверку на существование объектов перед добавлением их в список. Если ссылка на элемент справочника была удалена в другой сессии, попытка доступа к его свойствам вызовет исключение.

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

МассивЗначений = Список.ВыгрузитьКолонку("Значение");
Если МассивЗначений.Количество() = 0 Тогда
Сообщить("Список пуст, проверьте права доступа");
КонецЕсли;

Оптимизация также касается использования картинок. Загрузка тяжелых графических файлов в каждый элемент списка может замедлить отрисовку. Рекомендуется использовать стандартные пиктограммы платформы или миниатюры.

Часто задаваемые вопросы (FAQ)

Можно ли программно изменить состав встроенного перечисления?

Нет, состав перечислений, заданных в конфигураторе, является неизменным в рантайме. Вы не можете добавить новое значение в перечисление «ВидыНоменклатуры» кодом. Однако вы можете создать СписокЗначений, скопировать туда все элементы перечисления и добавить свои собственные строки или значения, имитируя расширение.

Как очистить список выбора перед новым заполнением?

Для полного удаления всех элементов из объекта используется метод Очистить(). Он удаляет все записи, освобождая память. Пример: МойСписок.Очистить(). После этого объект готов к новому заполнению без создания нового экземпляра.

В чем разница между СписокЗначений и Массив?

Массив хранит только значения (индекс — значение). СписокЗначений хранит структурированные данные: у каждого элемента есть свойства «Значение», «Представление», «Пометка» и «Картинка». Для элементов форм 1С всегда требуется СписокЗначений.

Как отсортировать список по убыванию?

Стандартный метод Сортировать сортирует только по возрастанию. Для сортировки по убыванию необходимо сначала отсортировать список, а затем перевернуть его, меняя элементы местами с начала и с конца, либо использовать временный список.

Можно ли сохранить СписокЗначений в файл?

Напрямую сохранить объект СписокЗначений в файл нельзя, так как он не является сериализуемым в стандартные форматы (txt, xml) одним методом. Необходимо сначала выгрузить данные в ТаблицуЗначений или Массив, и уже их записать в файл через ЗаписьJSON или ТабличныйДокумент.