Список значений в 1С: полное руководство от теории до практики

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

В отличие от простых массивов или таблиц значений, список значений в 1С обладает уникальными свойствами: он может хранить пары "значение-представление", поддерживает сортировку, поиск и даже визуальное отображение в формах. Однако многие разработчики используют лишь базовые возможности этого объекта, не подозревая о его скрытом потенциале. В этой статье мы разберём не только основы работы со списками значений, но и продвинутые техники, которые помогут оптимизировать код и решить нетривиальные задачи.

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

Что такое список значений и зачем он нужен

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

• 🔹 Значение — собственно данные, которые хранятся (может быть любым типом: число, строка, ссылка на объект и т.д.)
• 🔹 Представление — текстовое отображение значения для пользователя (например, вместо кода товара показывается его название)

Основное преимущество перед обычными массивами — возможность связать техническое значение (которое используется в коде) с человекочитаемым текстом. Например, в списке видов оплаты можно хранить коды "01", "02", а отображать пользователю "Наличные", "Безналичный расчёт".

Где применяются списки значений:

• 📋 Поля выбора в формах (выпадающие списки)
• 🔧 Параметры отчётов и обработок
• 📊 Источники данных для элементов управления (например, ПолеВыбора)
• 🔄 Промежуточное хранение данных при сложных вычислениях

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

Как создать список значений: базовые методы

Создать новый список значений можно несколькими способами. Самый простой — использовать конструктор объекта:

Список = Новый СписокЗначений;

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

Список.Добавить(Значение, Представление);

Список.Вставить(Индекс, Значение, Представление);

Список.ЗагрузитьЗначения(МассивЗначений);

Элемент = Список.НайтиПоЗначению(ИскомоеЗначение);

Пример создания списка с видами документов:

ВидыДокументов = Новый СписокЗначений;
ВидыДокументов.Добавить("ПриходнаяНакладная", "Приходная накладная");
ВидыДокументов.Добавить("РасходнаяНакладная", "Расходная накладная");
ВидыДокументов.Добавить("СчетФактура", "Счёт-фактура выданный");

Работа с элементами списка: добавление, изменение, удаление

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

Добавление элементов:

• 📌 Добавить() — добавляет в конец списка
• 📌 Вставить() — добавляет на указанную позицию (индексация с 0!)
• 📌 ДобавитьГруппу() — создаёт группу элементов (для иерархических списков)

Изменение элементов:

// Изменение представления первого элемента
Список[0].Представление = "Новое название";

// Изменение значения второго элемента
Список[1].Значение = НовоеЗначение;

Удаление элементов:

• 🗑️ Удалить() — по индексу
• 🗑️ Очистить() — удаляет все элементы
• 🗑️ УдалитьПоЗначению() — удаляет элемент с указанным значением

Убедиться, что индекс существует (использовать Количество())

Сохранить важные данные из удаляемого элемента

Проверить, не используется ли элемент в текущих вычислениях

Обновить интерфейс после удаления (если список привязан к форме)

-->

Один из самых распространённых багов — попытка обратиться к несуществующему индексу. Всегда проверяйте границы списка:

Если Индекс >= 0 И Индекс < Список.Количество() Тогда
// Безопасное обращение к элементу
Элемент = Список[Индекс];
КонецЕсли;

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

Для опытных разработчиков 1С стандартных методов часто недостаточно. Рассмотрим несколько профессиональных приёмов:

1. Связанные списки значений

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

// Пример связанных списков "Регион - Город"
Процедура ПриИзмененииРегиона(Элемент)
Города = Новый СписокЗначений;
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Наименование КАК Город
ИЗ Справочник.Города
ГДЕ Регион = &Регион";
Запрос.УстановитьПараметр("Регион", Элемент.Значение);
Результат = Запрос.Выполнить();
Пока Результат.Следующий() Цикл
Города.Добавить(Результат.Город, Результат.Город);
КонецЦикла;
ЭлементыФормы.Города.СписокВыбора = Города;
КонецПроцедуры

2. Оптимизация производительности

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

• 🚀 ОтключитьОповещения() перед массовым добавлением
• 🚀 Предварительную сортировку данных в запросе
• 🚀 Кэширование часто используемых списков

3. Сериализация и десериализация

Списки значений можно сохранять в строку и восстанавливать:

// Сохранение в строку
СтрокаСписка = Список.Записать();

// Восстановление из строки
ВосстановленныйСписок = Новый СписокЗначений;
ВосстановленныйСписок.Прочитать(СтрокаСписка);

Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при работе со списками значений. Вот наиболее распространённые:

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

1. Путаница между значением и представлением

Частая ошибка — сравнивать или использовать представление вместо значения:

// НЕПРАВИЛЬНО:
Если Список.НайтиПоЗначению(Элемент.Представление) Тогда

// ПРАВИЛЬНО:
Если Список.НайтиПоЗначению(Элемент.Значение) Тогда

2. Модификация списка во время перебора

Это приводит к непредсказуемым ошибкам:

// ОПАСНО:
Для Каждого Элемент Из Список Цикл
Если Условие Тогда
Список.Удалить(Элемент); // Вызовет исключение!
КонецЕсли;
КонецЦикла;

Правильный способ:

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

3. Неучтённая чувствительность к регистру

Метод НайтиПоЗначению() учитывает регистр при сравнении строк:

Список.Добавить("CODE1", "Первый код");
Список.Добавить("code1", "Второй код");

// Эти два поиска вернут РАЗНЫЕ результаты:
Найденный1 = Список.НайтиПоЗначению("CODE1");
Найденный2 = Список.НайтиПоЗначению("code1");

Список значений vs Таблица значений: что выбрать

Новички часто путают эти два объекта. Вот ключевые различия:

Когда использовать СписокЗначений:

• 🎯 Нужно показать пользователю выпадающий список с понятными названиями
• 🎯 Требуется хранить пары "код-наименование"
• 🎯 Данные простые и не требуют сложной обработки

Когда выбрать ТаблицаЗначений:

• 📈 Данные многоколонные (например, прайс-лист с ценой, количеством, скидкой)
• 📈 Нужна сортировка по нескольким критериям
• 📈 Требуется фильтрация или группировка данных

Практический пример: динамическое заполнение списка из базы

Рассмотрим реальную задачу: нужно создать список контрагентов для поля выбора в документе, но показывать только активных партнёров с определённым видом.

Шаг 1. Создаём запрос для получения данных:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Контрагенты.Ссылка КАК Ссылка,
|   Контрагенты.Наименование КАК Наименование
|ИЗ
|   Справочник.Контрагенты КАК Контрагенты
|ГДЕ
|   Контрагенты.ПометкаУдаления = ЛОЖЬ
|   И Контрагенты.Вид = &ВидКонтрагента";

Шаг 2. Устанавливаем параметры и выполняем запрос:

Запрос.УстановитьПараметр("ВидКонтрагента", ВидыКонтрагентов.Покупатель);
РезультатЗапроса = Запрос.Выполнить();

Шаг 3. Заполняем список значений:

СписокКонтрагентов = Новый СписокЗначений;
Пока РезультатЗапроса.Следующий() Цикл
НовыйЭлемент = СписокКонтрагентов.Добавить(
РезультатЗапроса.Ссылка,  // Значение - ссылка на объект
РезультатЗапроса.Наименование  // Представление - название
);
// Дополнительно можно установить картинку или пометку
НовыйЭлемент.Картинка = Картинки.Контрагент;
КонецЦикла;

Шаг 4. Привязываем список к элементу формы:

ЭлементыФормы.ПолеВыбораКонтрагента.СписокВыбора = СписокКонтрагентов;
ЭлементыФормы.ПолеВыбораКонтрагента.Значение = СписокКонтрагентов[0].Значение;

Убедиться, что запрос возвращает данные (проверить РезультатЗапроса.Пустой())

Обработать случай, когда список пуст (показать сообщение пользователю)

Проверить права доступа к данным в запросе

Оптимизировать запрос (индексы, выборка только нужных полей)

-->

FAQ: Частые вопросы о списках значений в 1С

Список.СортироватьПоПредставлению(НаправлениеСортировки.Возр); // По возрастанию
Список.СортироватьПоПредставлению(НаправлениеСортировки.Убыв); // По убыванию

Список.Добавить(ДокументСсылка, "Документ №" + ДокументСсылка.Номер + " от " + ДокументСсылка.Дата);

Список = Новый СписокЗначений;
Группа1 = Список.ДобавитьГруппу("Основные");
Список.Добавить(1, "Элемент 1", Группа1);
Список.Добавить(2, "Элемент 2", Группа1);
Группа2 = Список.ДобавитьГруппу("Дополнительные");
Список.Добавить(3, "Элемент 3", Группа2);

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Значение");
Таблица.Колонки.Добавить("Представление");

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

Excel = Новый ExcelОбъект;
Excel.Видимость = Истина;
Excel.Таблицы.Открыть(Таблица);