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

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

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

Материал будет полезен как начинающим программистам 1С, так и специалистам с опытом, которые хотят систематизировать свои знания или узнать новые приемы работы. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.22 и новее).

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

Список значений (СписокЗначений) — это коллекция пар "значение-представление", которая широко используется в 1С для:

• 📋 Отображения данных в формах (например, выпадающие списки в диалогах)
• 📊 Передачи параметров между процедурами и функциями
• 🔄 Хранения временных данных при обработке
• 📑 Формирования отчетов с динамическим содержимым

От обычного массива список значений отличает наличие двух свойств для каждого элемента: Значение (то, что хранится и обрабатывается программно) и Представление (то, что видит пользователь). Например, в списке стран значение может хранить код страны ("RU"), а представление — ее название ("Россия").

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

⚠️ Внимание: В версиях платформы ниже 8.3.10 некоторые методы списка значений могут работать медленнее при обработке больших объемов данных (10 000+ элементов). Для критичных операций рекомендуется использовать массивы или структуры.

2. Способ 1: Добавление строки через конструктор формы

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

1. Откройте конфигуратор 1С и найдите объект, где используется список значений (например, отчет или обработка).
2. Перейдите на вкладку Формы и откройте нужную форму в режиме редактирования.
3. Найдите на форме элемент типа Поле списка значений (обычно это выпадающий список или табличное поле).
4. Кликните правой кнопкой по элементу и выберите Список значений...
5. В открывшемся окне нажмите Добавить и заполните поля Значение и Представление.

Этот способ удобен для разовых изменений, но имеет ограничения:

• 🔄 Не подходит для динамического добавления строк во время выполнения программы.
• 📛 Изменения применяются только к текущей форме и не переносятся автоматически в другие объекты.
• 🛠️ Требует прав на редактирование конфигурации.

3. Способ 2: Программное добавление строки методом Добавить()

Основной способ добавления строки в список значений — использование метода Добавить(). Этот метод имеет несколько вариантов синтаксиса, что позволяет гибко настраивать добавление элементов.

Базовый синтаксис:

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

Где:

• Значение — обязательный параметр, содержит данные элемента (может быть любым типом: строка, число, ссылка на объект и т.д.).
• Представление — строка, которая будет отображаться пользователю (если не указано, используется приведение Значение к строке).
• Пометка — булево значение, определяющее, будет ли элемент помечен (по умолчанию Ложь).
• Картинка — картинка, которая будет отображаться рядом с элементом (необязательно).

Примеры использования:

// Пример 1: Простое добавление строки
Список = Новый СписокЗначений;
Список.Добавить("Код1", "Товар 1");

// Пример 2: Добавление с пометкой
Список.Добавить("Код2", "Товар 2 (устаревший)", Истина);

// Пример 3: Добавление без явного указания представления
Список.Добавить("Код3"); // Представление будет "Код3"

Элемент с таким значением еще не существует в списке

Представление корректно отображается на форме

Указаны все обязательные параметры

Учтена кодировка символов (если работаете с многобайтовыми строками)-->

Для добавления элемента в конкретную позицию списка используйте метод Вставить():

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

Где Индекс — позиция, куда будет вставлен элемент (нумерация с 0). Например, чтобы добавить элемент в начало списка:

Список.Вставить(0, "Приоритетный", "Важный элемент");

4. Способ 3: Альтернативные методы добавления строк

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

4.1. Загрузка из массива или таблицы значений

Если данные уже хранятся в массиве или таблице значений, их можно быстро перенести в список:

МассивДанных = Новый Массив;
МассивДанных.Добавить("Значение1");
МассивДанных.Добавить("Значение2");

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

Для таблицы значений:

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

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

4.2. Объединение списков

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

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

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

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

4.3. Клонирование списка

Если нужно создать копию списка с добавлением новых элементов:

ИсходныйСписок = Новый СписокЗначений;
ИсходныйСписок.Добавить("А", "Альфа");

НовыйСписок = ИсходныйСписок.Скопировать();
НовыйСписок.Добавить("Б", "Бета");

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

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

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

Список = Новый СписокЗначений;
Список.Добавить(123); // Добавляем как число

НайденныйЭлемент = Список.НайтиПоЗначению("123"); // Ищем как строку
// НайденныйЭлемент будет Неопределено!

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

Список.Добавить(Число(123)); // Явно указываем тип
НайденныйЭлемент = Список.НайтиПоЗначению(Число(123));

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

6. Оптимизация работы со списками значений

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

• ⚡ Используйте массивы для промежуточного хранения: Если нужно добавить много элементов, сначала соберите их в массив, а затем загрузите в список значений одним методом ЗагрузитьЗначения().
• 🔄 Отключайте обновление формы: При массовом добавлении элементов на форму отключите автоматическое обновление с помощью НачатьИзменение()/ЗакончитьИзменение().
• 🗑️ Очищайте ненужные списки: После использования больших списков значений освобождайте память с помощью Очистить().
• 🔍 Используйте индексы: Для частых поисков по значению создавайте дополнительные структуры данных (например, Соответствие) для ускорения доступа.

Пример оптимизированного добавления 10 000 элементов:

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

// 1. Быстро заполняем массив
Для Сч = 1 По 10000 Цикл
МассивДанных.Добавить("Значение" + Сч);
КонецЦикла;

// 2. Одним методом загружаем в список
Список.ЗагрузитьЗначения(МассивДанных);

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

7. Практические примеры использования

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

7.1. Динамическое формирование фильтра в отчете

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

Процедура ЗаполнитьСписокТиповДокументов(СписокТипов)
СписокТипов.Очистить();

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|  ТипДокумента КАК Ссылка
|ИЗ
|  Документ.ЗаказПокупателя КАК Заказ";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
СписокТипов.Добавить(Выборка.Ссылка, Выборка.Ссылка.Наименование);
КонецЦикла;
КонецПроцедуры

7.2. Заполнение выпадающего списка на форме

Пример заполнения списка значений для элемента формы ПолеСписка:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Список = Новый СписокЗначений;
Список.Добавить("male", "Мужской");
Список.Добавить("female", "Женский");
Список.Добавить("unknown", "Не указано");

ЭлементыФормы.Пол.СписокВыбора = Список;
ЭлементыФормы.Пол.Значение = Список.НайтиПоЗначению("unknown");
КонецПроцедуры

7.3. Обработка пользовательского ввода

Добавление элементов в список на основе ввода пользователя в таблицу на форме:

Процедура ДобавитьЭлемент(Команда)
НовоеЗначение = ЭлементыФормы.ПолеВвода.Значение;
Если НовоеЗначение <> "" Тогда
СписокЭлементов = ЭлементыФормы.СписокЭлементов.Список;
Если СписокЭлементов.НайтиПоЗначению(НовоеЗначение) = Неопределено Тогда
СписокЭлементов.Добавить(НовоеЗначение, НовоеЗначение);
ЭлементыФормы.ПолеВвода.Значение = "";
Иначе
ПоказатьПредупреждение("Такой элемент уже существует!");
КонецЕсли;
КонецЕсли;
КонецПроцедуры

8. Работа со списками значений в разных клиентах 1С

Поведение списков значений может отличаться в зависимости от типа клиента (толстый, тонкий, веб-клиент). Рассмотрим ключевые особенности:

• 🖥️ Толстый клиент:
  • Поддерживает все методы списка значений без ограничений.
  • Может работать с большими объемами данных (100 000+ элементов).
  • Поддерживает отображение картинок в элементах списка.
• 🌐 Тонкий/веб-клиент:
  • Ограничение на размер передаваемых данных (обычно ~10 Мб для одного пакета).
  • Некоторые визуальные эффекты (например, анимация) могут отсутствовать.
  • Для больших списков рекомендуется использовать постраничную загрузку.
• 📱 Мобильное приложение:
  • Сильно ограниченный функционал списков значений.
  • Рекомендуется использовать простые структуры данных.
  • Отсутствует поддержка картинок в элементах списка.

Пример адаптивного кода для разных клиентов:

Процедура ЗаполнитьСписок(Список)
Если КлиентНаСервере() Тогда
// Серверный код - можно работать с большими данными
Запрос = Новый Запрос("ВЫБРАТЬ ПЕРВЫЕ 1000..");
ИначеЕсли ТолстыйКлиент Тогда
// Используем все возможности толстого клиента
Список.ВключитьРежимРедактирования();
Иначе
// Тонкий/веб-клиент - оптимизируем передачу данных
Если Список.Количество() > 100 Тогда
ПоказатьПредупреждение("Для веб-клиента рекомендуется не более 100 элементов!");
КонецЕсли;
КонецЕсли;
КонецПроцедуры

⚠️ Внимание: В веб-клиенте при передаче больших списков значений между клиентом и сервером может возникать ошибка "Превышен максимальный размер передаваемых данных". В этом случае разбейте данные на части или используйте альтернативные структуры (например, массивы).

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

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

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

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

// Удаление по индексу
Список.Удалить(0); // Удаляет первый элемент

// Удаление по значению
Элемент = Список.НайтиПоЗначению("УдаляемоеЗначение");
Если Элемент <> Неопределено Тогда
Список.Удалить(Элемент);
КонецЕсли;

// Экспорт в JSON
Запись = Новый ЗаписьJSON;
Список.ЗаписатьJSON(Запись);
JSONСтрока = Запись.Закрыть();

// Импорт из JSON
Чтение = Новый ЧтениеJSON;
Чтение.УстановитьСтроку(JSONСтрока);
НовыйСписок = Новый СписокЗначений;
НовыйСписок.ПрочитатьJSON(Чтение);