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

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

Если вы только начинаете осваивать 1С 8.3 или уже сталкивались с необходимостью динамически формировать выпадающие списки, фильтры отчётов или параметры обработок — эта статья поможет систематизировать знания. Мы не просто дадим определение, но и покажем практические примеры использования, разберём типичные ошибки и раскроем нюансы, о которых часто умалчивают в стандартной документации. Например, знали ли вы, что список значений может хранить не только примитивные типы (строки, числа), но и ссылки на объекты метаданных? Или что его можно привязать к реквизиту формы без единой строки кода?

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

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

В терминологии 1С:Предприятие 8 список значений — это коллекция пар «значение-представление», где:

• 📌 Значение — собственно данные, которые хранятся в элементе списка (может быть любым типом: строка, число, дата, ссылка на справочник, документ и т.д.).
• 🏷️ Представление — текстовая строка, которая отображается пользователю в интерфейсе (например, в выпадающем списке).
• 🔗 Пометка — необязательный флаг, который позволяет помечать элементы (аналог «галочки» в чекбоксах).
• 🎨 Картинка — иконка, которая может сопровождать элемент (реже используется, но поддерживается платформой).

Внутренне СписокЗначений реализован как объект платформы с методами для добавления, удаления, сортировки и поиска элементов. Его ключевое отличие от Массива — наличие двух слоёв данных: того, что видно пользователю (представление), и того, что используется в логике программы (значение). Например, в списке стран пользователь видит «Россия», «Казахстан», «Белоруссия», а программа оперирует кодами "RU", "KZ", "BY".

Списки значений широко применяются в:

• 📋 Формах — для выпадающих списков (ПолеВыбора, ПолеВводаСписка).
• 📊 Отчётах — как параметры с фиксированным набором вариантов.
• ⚙️ Обработках — для динамического формирования меню действий.
• 🔄 Обменах данными — как промежуточный формат хранения сопоставлений.

⚠️ Внимание: Не путайте СписокЗначений с ТаблицаЗначений! Последняя предназначена для работы с табличными данными (строки + колонки), тогда как список значений оперирует только одним измерением — элементами.

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

Создать список значений в 1С можно несколькими способами — как программно, так и через конструкторы форм. Рассмотрим основные подходы.

1. Программное создание в коде

Самый гибкий метод — инициализация через встроенный язык. Например, так можно создать список с кодами и названиями валют:

СписокВалют = Новый СписокЗначений;
СписокВалют.Добавить("RUB", "Рубль");
СписокВалют.Добавить("USD", "Доллар США");
СписокВалют.Добавить("EUR", "Евро");

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

2. Заполнение из массива или запроса

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

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

Или из результата запроса:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ РАЗЛИЧНЫЕ Город ИЗ Справочник.Контрагенты";
Результат = Запрос.Выполнить();
СписокГородов = Результат.Выгрузить().ВыгрузитьКолонку("Город");

3. Визуальное создание в конструкторе формы

Если список статический (например, варианты оплаты: «Наличные», «Безналичный расчёт», «Карта»), его удобно создать прямо в конструкторе формы:

1. Добавьте на форму элемент ПолеВыбора.
2. В свойствах элемента найдите параметр СписокВыбора.
3. Нажмите кнопку «...» и в открывшемся окне добавьте нужные элементы.

Такой подход не требует написания кода, но подходит только для фиксированных наборов данных.

Методы работы со списком значений: добавление, удаление, поиск

Объект СписокЗначений предоставляет богатый набор методов для манипуляции данными. Рассмотрим самые востребованные.

Основные методы

Работа с пометками

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

// Пометить элемент с индексом 1
Список.УстановитьПометку(1, Истина);

// Проверить пометку
Если Список.Пометка(1) Тогда
Сообщить("Элемент помечен!");
КонецЕсли;

Поиск и фильтрация

Для поиска элементов используйте методы НайтиПоЗначению() и НайтиПоПредставлению(). Например, так можно найти элемент по частичному совпадению:

РезультатПоиска = Список.НайтиПоПредставлению("Долл*", Ложь); // Ложь - не точный поиск

⚠️ Внимание: Метод НайтиПоЗначению() возвращает Неопределено, если элемент не найден. Всегда проверяйте результат на Неопределено, чтобы избежать ошибок!

Примеры практического применения списков значений

Теория без практики бесполезна. Рассмотрим реальные сценарии, где списки значений незаменимы.

1. Динамическое заполнение выпадающего списка в форме

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
СписокДоставки = Новый СписокЗначений;
Если ДокументОбъект.Город = "Москва" Тогда
СписокДоставки.Добавить("CDEK", "СДЭК (доставка за 1 день)");
СписокДоставки.Добавить("COURIER", "Курьер (300 руб.)");
Иначе
СписокДоставки.Добавить("POST", "Почта России (5-7 дней)");
КонецЕсли;
ЭлементыФормы.СпособДоставки.СписокВыбора = СписокДоставки;
КонецПроцедуры

2. Фильтрация данных в отчёте

В отчёте «Продажи по номенклатуре» можно добавить параметр «Тип товара» со списком значений, заполненным из справочника:

СписокТипов = Новый СписокЗначений;
Запрос = Новый Запрос("ВЫБРАТЬ РАЗЛИЧНЫЕ Тип ИЗ Справочник.Номенклатура");
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
СписокТипов.Добавить(Выборка.Тип, Выборка.Тип.Наименование);
КонецЦикла;

3. Обмен данными между системами

При интеграции 1С с внешними сервисами списки значений удобны для хранения сопоставлений кодов. Например, так можно сохранить соответствие статусов заказов между 1С и Bitrix24:

СопоставлениеСтатусов = Новый СписокЗначений;
СопоставлениеСтатусов.Добавить("NEW", "Новый");       // Bitrix → 1С
СопоставлениеСтатусов.Добавить("PAID", "Оплачен");
СопоставлениеСтатусов.Добавить("SHIPPED", "Отгружен");

// На клиенте
СтрокаСписка = ЗначениеВСтрокуВнутр(СписокЗначений);

// На сервере
СписокЗначений = ЗначениеИзСтрокиВнутр(СтрокаСписка);

Типичные ошибки при работе со списками значений

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

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

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

// ❌ Неверно: сравнение по представлению
Если Список.Представление(Индекс) = "Доллар США" Тогда
// Логика
КонецЕсли;

// ✅ Правильно: сравнение по значению
Если Список.Значение(Индекс) = "USD" Тогда
// Логика
КонецЕсли;

2. IgnoreCase при поиске

По умолчанию поиск по представлению чувствителен к регистру. Если нужно игнорировать регистр, используйте параметр НеЧувствительноКРегистру:

Элемент = Список.НайтиПоПредставлению("доллар", Истина); // Истина - нечувствительно к регистру

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

Если вы перебираете элементы списка в цикле и одновременно пытаетесь их удалять или добавлять, это приведёт к ошибке. Решение — использовать обратный цикл или собирать индексы для удаления в отдельный массив:

// ❌ Ошибка: модификация во время прямого обхода
Для Инд = 0 По Список.Количество() - 1 Цикл
Если Список.Значение(Инд) = "USD" Тогда
Список.Удалить(Инд); // Ошибка!
КонецЕсли;
КонецЦикла;

// ✅ Правильно: обратный цикл
Для Инд = Список.Количество() - 1 По 0 Шаг -1 Цикл
Если Список.Значение(Инд) = "USD" Тогда
Список.Удалить(Инд);
КонецЕсли;
КонецЦикла;

⚠️ Внимание: При работе с большими списками (1000+ элементов) операции вставки/удаления в середине могут быть ресурсоёмкими. Для таких случаев рассмотрите использование ТаблицаЗначений или Массив.

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

В 1С есть несколько структур данных для хранения коллекций. Как понять, когда использовать СписокЗначений, а когда — альтернативы?

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

Например, для хранения списка ID документов для дальнейшей обработки лучше подойдёт Массив, а для вывода таблицы с данными — ТаблицаЗначений.

Расширенные возможности: XML, JSON и обмен данными

Списки значений можно сериализовать в XML или JSON, что полезно при обмене данными с внешними системами или сохранении настроек.

1. Сериализация в XML

Для сохранения списка в XML используйте ЗаписьXML:

Запись = Новый ЗаписьXML;
Запись.ОткрытьФайл("C:\temp\список.xml");
Список.ЗаписатьXML(Запись);
Запись.Закрыть();

2. Десериализация из XML

Чтобы загрузить список из XML:

Чтение = Новый ЧтениеXML;
Чтение.ОткрытьФайл("C:\temp\список.xml");
Список = Новый СписокЗначений;
Список.ПрочитатьXML(Чтение);
Чтение.Закрыть();

3. Работа с JSON

Для работы с JSON потребуется преобразовать список в массив или таблицу значений:

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

JSON = Новый СериализаторJSON;
ТекстJSON = JSON.Записать(МассивДляJSON);

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

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

СписокДоков = Новый СписокЗначений;
СписокДоков.Добавить(Документы.ЗаказПокупателя.НайтиПоНомеру("0001"), "Заказ №0001 от 10.05.2026");

Список.СортироватьПоЗначениюНасервере();

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

Процедура ГородПриИзменении(Элемент)
СписокМагазинов = ПолучитьСписокМагазиновПоГороду(ЭлементыФормы.Город.Значение);
ЭлементыФормы.Магазин.СписокВыбора = СписокМагазинов;
КонецПроцедуры

Если Список.КоличествоПомеченных() > 0 Тогда
Сообщить("Есть помеченные элементы!");
КонецЕсли;