Как сделать выбор из списка значений в 1С Предприятие

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

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

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

Создание и наполнение объекта СписокЗначений

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

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

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

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

Список = Новый СписокЗначений;
Список.Добавить("Значение1","Первый элемент");
Список.Добавить(100,"Сто рублей");
Список.Добавить(СсылкаНаКонтрагента,"ООО Ромашка");

⚠️ Внимание: Типы данных всех элементов в одном списке значений должны быть совместимы или приведены к общему типу, если вы планируете передавать этот список в качестве параметра внешней обработки или отчета. Смешивание несовместимых типов может вызвать ошибки при сериализации.

Организация выбора из формы документа

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

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

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

• 📌 Используйте свойство ТолькоПросмотр, если список нужен только для отображения информации без возможности редактирования пользователем.
• 📌 Настройте Ширина поля ввода, чтобы длинные названия элементов не обрезались и были полностью видны пользователю.
• 📌 Включите АвтоВыбор, чтобы при вводе первых букв названия система автоматически предлагала подходящие варианты из списка.

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

Программное открытие окна выбора

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

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

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

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

Особенности работы функции ВыбратьИзСписка

Функция блокирует выполнение кода до тех пор, пока пользователь не закроет окно выбора. Это означает, что код после вызова функции выполнится только после получения результата. Учитывайте это при проектировании асинхронных процессов, хотя в типовой архитектуре 1С это стандартное поведение.

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

Обработка результатов выбора и валидация

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

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

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

Свойство элемента	Тип данных	Описание	Пример использования
Значение	Любой	Хранимые данные (ссылка, строка, число)	Запись в регистр накопления
Представление	Строка	Текст для отображения в интерфейсе	Печать в печатной форме
Пометка	Булево	Флаг активности или группировки	Визуальное выделение в списке
ИндексКартинки	Число	Код изображения из пиктограмм	Добавление иконки к элементу

Расширенные возможности: картинки и группировка

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

Использование иконок помогает пользователю быстрее ориентироваться в списке, особенно если он большой. Например, разные статусы заказа могут быть помечены разными цветами или значками (зеленая галочка, красный крестик, желтый восклицательный знак).

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

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

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

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

Разработчики часто сталкиваются с проблемой, когда список значений создается, но в форме отображается пустым. Самая распространенная причина — нарушение контекста выполнения. Если список заполняется на клиенте, а форма перерисовывается на сервере (или наоборот), данные могут теряться. Необходимо соблюдать правило: работа с визуальными элементами формы и их наполнение должны происходить в одном контексте.

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

• 🔍 Проверяйте, что реквизит формы имеет тип СписокЗначений, а не Строка или Массив.
• 🔍 Убедитесь, что метод заполнения вызывается именно в том событии, где это необходимо (например, не в ПриОткрытии на клиенте, если данные нужны на сервере).
• 🔍 При использовании ВыбратьИзСписка помните, что эта функция работает только на клиенте. Вызов ее из серверного модуля вызовет ошибку выполнения.

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

Можно ли использовать СписокЗначений для хранения постоянных данных в базе?

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

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

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

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

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

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

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