Как создать и настроить список выбора на форме в 1С

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

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

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

Настройка реквизита типа СписокЗначений

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

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

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

⚠️ Внимание: Если вы изменяете список значений в конструкторе, не забудьте обновить конфигурацию базы данных, иначе изменения не применятся к работающей системе.

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

Программное создание списка в модуле формы

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

Рассмотрим пример, где мы добавляем элементы в список вручную. Сначала создается новый объект, затем в него добавляются пары ключ-значение. Ключом может выступать числовой код или ссылка на элемент справочника, а значением — понятная пользователю строка. После наполнения список присваивается свойству СписокВыбора нужного поля ввода.

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Список = Новый СписокЗначений;
Список.Добавить("Красный", "Цвет: Красный");
Список.Добавить("Зеленый", "Цвет: Зеленый");
Список.Добавить("Синий", "Цвет: Синий");

ЭлементыФормы.ПолеЦвет.СписокВыбора = Список;
КонецПроцедуры

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

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

Использование перечислений как источника данных

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

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

• 📌 Гарантированная целостность данных: пользователь не сможет ввести значение, которого нет в перечислении.
• 📌 Локализация: синонимы элементов перечисления автоматически переводятся в интерфейс пользователя.
• 📌 Упрощение кода: не нужно писать циклы для наполнения списка значений.

Однако, у этого метода есть ограничение: состав элементов перечисления жестко задан в конфигураторе. Если бизнес-логика требует, чтобы пользователи могли сами добавлять новые варианты выбора в процессе работы, перечисления не подойдут. В таком случае придется использовать справочники или динамические списки значений.

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

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

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

Этап	Действие	Объект 1С
1	Формирование запроса	Новый Запрос
2	Выполнение и выборка	Запрос.Выполнить().Выбрать()
3	Добавление в список	СписокЗначений.Добавить()
4	Привязка к форме	Элемент.СписокВыбора

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

⚠️ Внимание: Не загружайте в список выбора полные таблицы справочников без отборов. Это может привести к критическому падению производительности интерфейса.

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

Обработка событий и валидация выбора

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

Валидация данных — важный этап. Если пользователь выбрал недопустимую комбинацию (например, определенный тип оплаты для конкретного клиента), система должна немедленно сообщить об этом. Это реализуется через установку свойства Доступность или вывод сообщения в статус-бар.

Секрет быстрой валидации

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

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

Если СписокЗначений.НайтиПоЗначению(НужноеЗначение) <> Неопределено Тогда
Объект.ПолеСписка = НужноеЗначение;
Иначе
Сообщить("Выбранное значение отсутствует в списке!");
КонецЕсли;

Такой подход защищает систему от некорректных данных. Всегда проверяйте existence значения перед записью, особенно если список формируется динамически на основе внешних условий, которые могли измениться с момента открытия формы.

Частые ошибки и способы их устранения

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

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

• 🛑 Ошибка типов: Ключ списка не совпадает с типом поля формы.
• 🛑 Потеря данных: Список не сохраняется между вызовами сервера и клиента.
• 🛑 Дублирование: Многократное добавление одних и тех же элементов без очистки.

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

Помните, что интерфейс 1С — это лицо вашей программы. Удобный и надежный список выбора повышает лояльность пользователей и снижает нагрузку на службу поддержки. Тщательное тестирование сценариев использования сэкономит время в будущем.

⚠️ Внимание: Поведение списков выбора может различаться в Толстом и Тонком клиенте. Всегда тестируйте форму в том режиме, в котором она будет использоваться основными пользователями.

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

Для этого используйте метод Добавить с пустым значением ключа и отображаемым текстом, например, "Не выбрано". Убедитесь, что тип пустого ключа соответствует типу поля (пустая строка для Строки, 0 для Числа).

Можно ли сделать список выбора многострочным?

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

Почему список выбора не обновляется при изменении данных в справочнике?

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

Как отсортировать элементы списка по алфавиту?

Используйте метод СписокЗначений.СортироватьПоЗначению() после наполнения списка. Это упорядочит элементы по текстовому представлению, что удобно для пользователей при большом количестве вариантов.

Можно ли использовать картинки в списке выбора?

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