В среде разработчиков 1С часто возникает вопрос о классификации тех или иных структур данных. Одним из таких камней преткновения является СписокЗначений. С одной стороны, документация говорит, что он не сохраняется в базе данных и является временным набором данных в памяти. С другой стороны, синтаксис-помощник (СП) называет его объектом. Давайте вместе разберемся в этой терминологии, проанализируем техническую природу этого типа данных и выясним, как эффективно использовать его в разработке.
Для начала нам необходимо разграничить два понятия: объекты базы данных и объектные типы данных. Это критически важное различие для любого программиста 1С. Проанализируем ситуацию: когда мы говорим о справочнике или документе, мы подразумеваем запись в таблице базы данных, которая имеет уникальный идентификатор (GUID). СписокЗначений к таким сущностям не относится. Он не имеет ссылки, его нельзя найти методом НайтиПоСсылке(), и он прекращает свое существование сразу после того, как переменная, указывающая на него, выходит из области видимости или очищается.
Однако с точки зрения объектно-ориентированного программирования (ООП), реализованного в платформе 1С, СписокЗначений — это полноценный программный объект. Рассмотрим главный аргумент, подтверждающий это: способ его создания. В платформе 1С 8.x создание любого объекта коллекции или прикладного типа производится через конструктор. Обратим внимание на пример кода:
// Создание нового экземпляра объекта
МойСписок = Новый СписокЗначений;
Использование ключевого слова Новый однозначно указывает на то, что в оперативной памяти выделяется место под экземпляр класса СписокЗначений. В старых версиях платформы (1С 7.7) аналогичное действие выполнялось через функцию СоздатьОбъект(), что также подчеркивало объектную природу данной структуры данных.
Разберем подробнее внутреннее устройство этого объекта. В отличие от простого массива (Массив), где элементы — это просто значения (числа, строки, ссылки), СписокЗначений представляет собой коллекцию специальных вспомогательных объектов типа ЭлементСпискаЗначений. Посмотрим, из чего состоит каждый такой элемент. Он обладает четырьмя ключевыми свойствами:
Такая сложная структура делает СписокЗначений не просто «складом данных», а высокоуровневым инструментом для построения пользовательского интерфейса.
Выясним, в чем главное преимущество СписокЗначений перед другими коллекциями, такими как ТаблицаЗначений или Массив. Этот объект обладает встроенными методами для взаимодействия с пользователем, что делает его незаменимым при разработке обработок и отчетов. Рассмотрим наиболее часто используемые методы:
Во-первых, метод ВыбратьЭлемент(). Он позволяет вызвать диалоговое окно, в котором пользователь может выбрать одну строку. Проанализируем пример использования:
ВыбранныйЭлемент = МойСписок.ВыбратьЭлемент("Выберите контрагента из списка");
Если ВыбранныйЭлемент <> Неопределено Тогда
Сообщить("Вы выбрали: " + ВыбранныйЭлемент.Значение);
КонецЕсли;
Во-вторых, метод ОтметитьЭлементы(). Этот метод открывает окно со списком, где напротив каждого элемента стоит флажок (чекбокс). Это идеальное решение для реализации пакетной обработки данных, когда пользователю нужно выбрать несколько позиций из предложенных.
Рассмотрим еще одну уникальную особенность этого объекта — его интеграцию с языком запросов 1С. СписокЗначений — это один из немногих объектных типов данных, который можно передать напрямую в параметры запроса для использования в операторе В. Система автоматически понимает, что из объекта нужно извлечь содержимое колонки Значение для сопоставления.
Посмотрим на пример реализации такой задачи:
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Номенклатура.Наименование
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|ГДЕ
| Номенклатура.Ссылка В (&ФильтрПоТоварам)";
Запрос.УстановитьПараметр("ФильтрПоТоварам", МойСписок);
РезультатЗапроса = Запрос.Выполнить();
Это делает СписокЗначений крайне удобным посредником между формой, где пользователь выбирает данные, и программным кодом, который эти данные обрабатывает в базе.
Хотя мы выяснили, что СписокЗначений живет только в оперативной памяти, иногда возникает задача сохранить его между сеансами работы пользователя или передать в другое место. Для этого платформа предоставляет механизмы сериализации. Объект поддерживает преобразование в форматы XML и JSON.
Также разберем способ сохранения списка непосредственно в базу данных. Поскольку в 1С нет типа поля «Список значений», мы можем использовать ХранилищеЗначений. Проанализируем алгоритм: мы помещаем наш объект в ХранилищеЗначений, которое затем записывается в реквизит справочника или документа с соответствующим типом. При считывании мы извлекаем объект обратно в память, сохраняя все его элементы, пометки и представления.
Чтобы окончательно закрепить понимание того, когда использовать этот объект, проведем краткое сравнение:
Таким образом, мы выяснили, что СписокЗначений — это полнофункциональный программный объект, предназначенный для временного хранения и интерактивного управления данными. Его «временность» (отсутствие в БД) не лишает его статуса объекта, а лишь определяет его жизненный цикл в рамках выполнения программного кода.