Как добавить значение в список значений в 1С

Список значений в 1С (объект «СписокЗначений») — это универсальная коллекция, которая хранит пары «значение + представление» и применяется повсюду: от выбора варианта в диалоге до передачи параметров в отчёты и динамические списки. Умение правильно добавлять в него элементы — базовый навык разработчика, от которого зависит корректность отборов, отчётов и интерфейсных механизмов.

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

Что такое список значений и где он используется

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

Типичные места применения: список видов субконто в проводках, параметры отборов в СКД, список выбора у поля ввода, передача нескольких ссылок в запрос одним параметром, диалоги «Отметить элементы». Понимание структуры списка помогает выбрать правильный способ добавления и избежать дублей.

Базовое добавление через метод Добавить()

Метод Добавить() помещает новый элемент в конец списка и возвращает ссылку на созданный элемент, что удобно для дальнейшей настройки пометки или картинки. Синтаксис:

Список = Новый СписокЗначений;
Список.Добавить(СсылкаНаКонтрагента, "ООО Ромашка");
Список.Добавить(42, "Числовой код");
НовыйЭлемент = Список.Добавить(ТекущаяДатаСеанса(), "Дата операции");
НовыйЭлемент.Пометка = Истина;

Первый параметр — само значение произвольного типа (ссылка, число, строка, дата). Второй, необязательный, — представление: именно его увидит пользователь в диалогах и полях выбора. Если представление не задано, платформа сформирует его автоматически из строкового представления значения, что для ссылок обычно даёт наименование объекта.

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

Вставка в нужную позицию и массовое наполнение

Метод Вставить() для контроля порядка

Когда порядок элементов важен — например, пункт «Все» должен стоять первым в списке выбора — используйте Вставить() с указанием индекса:

Список.Вставить(0, Неопределено, "Все контрагенты");

Индексация начинается с нуля. Если указать индекс больше текущего количества элементов, будет вызвана ошибка, поэтому перед вставкой при необходимости проверяйте Список.Количество().

Загрузка из массива через ЗагрузитьЗначения()

Если значения уже собраны в массив — например, результат выгрузки колонки таблицы значений — наполнить список одной командой позволяет ЗагрузитьЗначения():

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

Учтите: метод полностью заменяет текущее содержимое списка, а представления не задаёт — они будут сформированы автоматически. Если нужно дополнить список без очистки, пройдите по массиву циклом с Добавить().

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

Добавление с пометкой и картинкой

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

Элемент = Список.Добавить(ОтчетСсылка, "Отчёт по продажам");
Элемент.Пометка = Истина;
Элемент.Картинка = БиблиотекаКартинок.Отчет;

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

После интерактивного выбора через Список.ОтметитьЭлементы() или ВыбратьЭлемент() состояние пометок читается в цикле по элементам списка — это стандартный приём для форм подбора.

Работа со списком в форме и на сервере

Реквизит формы типа «СписокЗначений» наполняется теми же методами, но в клиент-серверном режиме есть нюанс: список сериализуется между клиентом и сервером, поэтому хранить в нём несериализуемые объекты (например, COMОбъект или запрос) нельзя. Допустимы примитивные типы, ссылки, перечисления и другие сериализуемые значения.

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

Элементы.ПолеОрганизация.СписокВыбора.Добавить(ОрганизацияСсылка, ОрганизацияСсылка.Наименование);

Если список выбора нужно перестроить заново, сначала вызовите СписокВыбора.Очистить(), иначе старые значения останутся и появятся дубли с устаревшими ссылками.

Проверка результата и контроль дублей

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

Если Список.Количество() = 0 Тогда
Сообщить("Список не заполнен");
КонецЕсли;

Найденный = Список.НайтиПоЗначению(ИскомаяСсылка);
Если Найденный = Неопределено Тогда
Список.Добавить(ИскомаяСсылка);
КонецЕсли;

Сравнение значений при поиске выполняется с учётом типа: число 5 и строка «5» — разные значения. Это частая причина «не находит значение, которое точно добавлял». Проверяйте тип добавляемых данных, особенно когда значения приходят из внешних источников или из строк табличных документов, где всё по умолчанию имеет строковый тип.

Типичные ошибки и альтернативы списку значений

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

Ещё одна распространённая ситуация: разработчик добавляет в список значения внутри цикла обхода результата запроса и не сбрасывает список между итерациями внешнего цикла. Итог — накопление данных из предыдущих проходов. Решение простое: создавайте новый список (Новый СписокЗначений) или вызывайте Очистить() в начале каждой итерации.

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