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

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

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

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

Создание и базовая инициализация объекта

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

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

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

Список = Новый СписокЗначений;
Список.Добавить(10, "Десять единиц");
Список.Добавить(20, "Двадцать единиц");
Список.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Товар А"));

Для простых типов это работает отлично, но для сложных объектов лучше задавать представление явно, чтобы избежать неоднозначности в отчетах.

Методы заполнения и работы с элементами

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

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

• 📌 Добавить(Значение, Представление) — добавляет элемент в конец коллекции.
• 📌 Вставить(Значение, Индекс, Представление) — вставляет элемент по указанному индексу.
• 📌 Очистить() — удаляет все элементы, оставляя объект пустым, но готовым к работе.
• 📌 Удалить(Индекс) — удаляет элемент по номеру позиции в списке.

Частой задачей является поиск элемента внутри коллекции. Метод НайтиПоЗначению возвращает индекс элемента, если он найден, или -1, если поиск не увенчался успехом. Это позволяет быстро проверить наличие данных перед добавлением дубликатов, что особенно актуально при обработке пользовательского ввода.

Сортировка и фильтрация данных в списке

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

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

⚠️ Внимание: Сортировка изменяет порядок элементов в исходном списке. Если вам нужно сохранить исходный порядок для последующей обработки, предварительно создайте копию списка методом Скопировать().

Фильтрация в прямом смысле (как в запросах SQL) в списке значений не предусмотрена, но эмулируется через создание нового списка. Вы можете пройти циклом по исходной коллекции, проверить условие и добавить подходящие элементы в новый СписокЗначений. Это стандартный паттерн работы с коллекциями в 1С.

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

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

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

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

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

Метод конвертации	Направление	Особенности
ЗаполнитьЗначенияСвойств	Таблица -> Список	Требует предварительного создания элементов
ВыгрузитьКолонку	Таблица -> Массив	Потеря свойства «Представление»
Цикл с Добавить	Список -> Таблица	Универсальный, но медленный на больших объемах
СкопироватьКолонки	Таблица -> Таблица	Промежуточный этап конвертации

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

Оптимизация конвертации

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

Использование в интерфейсе и формах

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

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

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

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

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

Производительность и типичные ошибки

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

Типичной ошибкой является многократный поиск элемента внутри цикла. Метод НайтиПоЗначению выполняет линейный проход по списку. Если вы вызываете его внутри цикла, который тоже перебирает этот список, сложность алгоритма становится квадратичной (O(n²)). Для больших списков это приведет к заметным зависаниям интерфейса.

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

// Плохой пример для большого списка
Для Каждого Элемент Из БольшойСписок Цикл
Индекс = БольшойСписок.НайтиПоЗначению(Элемент.Значение); // Долго!
КонецЦикла;

// Хороший пример
Соответствие = Новый Соответствие;
Для Каждого Элемент Из БольшойСписок Цикл
Соответствие.Вставить(Элемент.Значение, Элемент);
КонецЦикла;
// Поиск в Соответствии происходит мгновенно

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

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

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

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

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

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

Как сохранить СписокЗначений в файл?

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

Почему метод НайтиПоЗначению возвращает -1?

Это означает, что элемент с указанным значением не найден в списке. Обратите внимание, что поиск чувствителен к типу данных: число 10 не равно строке "10".

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

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