Как добавить список в 1С: 5 рабочих способов для разных задач

Работа со списками в 1С:Предприятие — одна из самых востребованных задач как для бухгалтеров, так и для разработчиков. Без умения правильно создавать, заполнять и обрабатывать списки невозможно эффективно работать с справочниками, документами или отчетами. Но что именно подразумевается под "добавлением списка"? Это может быть:

— создание нового справочника с иерархической структурой (например, список контрагентов или номенклатуры);

— добавление табличной части в документ (например, список товаров в накладной);

— формирование динамического списка в управляемом приложении для отображения данных по фильтру;

— программное заполнение списка значениями через 1С:Enterprise или 1С:Script.

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

1. Справочники: как создать список объектов в конфигураторе

Справочники — это основной инструмент для хранения списков однотипных объектов: сотрудников, товаров, складов и т.д. Чтобы добавить новый справочник:

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

После создания справочника его можно заполнить данными в пользовательском режиме (1С:Предприятие) через меню Справочники → [Название вашего справочника].

• 📌 Иерархические справочники: позволяют создавать вложенные группы (например, "Товары → Одежда → Мужская"). Включается опция на вкладке Иерархия.
• 🔄 Подчинённые справочники: используются для хранения данных, связанных с элементами другого справочника (например, список контактных лиц для каждого контрагента).
• 🔍 Предопределённые элементы: фиксированные значения, которые нельзя удалить (например, "Основной склад" или "Рубль" в справочнике валют).

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

2. Табличные части: списки внутри документов

Табличные части позволяют добавлять списки прямо в документы — например, перечень товаров в накладной или список услуг в акте. Чтобы создать табличную часть:

1. В конфигураторе откройте нужный документ (например, РеализацияТоваровУслуг).
2. На вкладке Данные нажмите Добавить и выберите Табличная часть.
3. Задайте имя (например, Товары) и синоним ("Список товаров").
4. Добавьте колонки: Номенклатура (тип СправочникСсылка.Номенклатура), Количество (тип Число), Цена и Сумма.

Для автоматического расчёта суммы используйте вычисляемое поле:

Процедура ТоварыСуммаПриИзменении(Элемент)
Элемент.Сумма = Элемент.Количество * Элемент.Цена;
КонецПроцедуры

Колонки имеют корректные типы данных|Вычисляемые поля заполнены формулами|Для справочников указаны правильные ссылки|Установлены ограничения на ввод (например, количество > 0)|-->

3. Динамические списки: отображение данных по фильтру

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

1. В конфигураторе откройте нужную форму (или создайте новую).
2. Добавьте элемент ДинамическийСписок на форму.
3. В свойствах списка укажите ОсновнаяТаблица = Документ.РеализацияТоваровУслуг.
4. Настройте Отбор (например, Контрагент = &ТекущийКонтрагент).

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

// Пример фильтрации списка по дате
Процедура ПриОткрытии(Отказ)
ДинамическийСписок1.Отбор.Дата.УстановитьЗначение(ТекущаяДата());
КонецПроцедуры

• 🔄 Автообновление: включите свойство АвтоОбновление, чтобы список перезагружался при изменении фильтров.
• 📊 Группировка: настройте группировку по полям (например, по дате или контрагенту) на вкладке Группировки.
• ⚡ Быстрый поиск: добавьте элемент ПолеВвода и свяжите его с динамическим списком через событие ПриИзменении.

⚠️ Внимание: Если динамический список подгружает большие объемы данных (более 10 000 строк), обязательно настройте постраничный вывод (свойство ПостраничныйРежим = Истина). Иначе форма будет тормозить при открытии.

4. Программное добавление элементов в список

Часто требуется заполнять списки автоматически — например, при загрузке данных из Excel или интеграции с сайтом. Для этого используйте встроенный язык 1С:Enterprise.

Пример добавления элемента в справочник Номенклатура:

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Ноутбук ASUS X515";
НовыйЭлемент.Артикул = "X515MA-BR006";
НовыйЭлемент.Группа = Справочники.Номенклатура.Техника;
НовыйЭлемент.Записать();

Для добавления строки в табличную часть документа:

НоваяСтрока = Документ.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Ноутбук ASUS X515");
НоваяСтрока.Количество = 2;
НоваяСтрока.Цена = 45000;

• 🔍 Поиск по наименованию: метод НайтиПоНаименованию() ищет первый подходящий элемент. Для точного поиска используйте НайтиПоРеквизиту("Артикул", "X515MA-BR006").
• 🔄 Пакетная запись: если добавляете много элементов, используйте НачатьТранзакцию() и ЗафиксироватьТранзакцию() для ускорения.
• ⚠️ Проверка уникальности: перед добавлением проверяйте, существует ли элемент, чтобы избежать дублей: Если Не Справочники.Номенклатура.НайтиПоАртикулу(Артикул) Тогда....

5. Списки значений: работа с временными данными

СписокЗначений — это временный объект в памяти, который используется для хранения набора данных без привязки к базе. Его удобно применять для:

• 📋 Выпадающих списков в формах;
• 🔄 Передачи данных между функциями;
• 📊 Хранения промежуточных результатов обработки.

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

СписокЦветов = Новый СписокЗначений();
СписокЦветов.Добавить("Красный", "Редиска");
СписокЦветов.Добавить("Зелёный", "Огурец");
СписокЦветов.Добавить("Синий", "Черника");

// Привязка к элементу формы
ЭлементыФормы.ВыборЦвета.СписокВыбора = СписокЦветов;

Чтобы получить выбранное значение:

ТекущийЦвет = ЭлементыФормы.ВыборЦвета.Значение;

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

6. Обмен данными: импорт и экспорт списков

Для переноса списков между базами или интеграции с внешними системами используйте:

• 📄 Универсальные форматы: XML, JSON, CSV (через ЗаписьДанныхXML или ЧтениеJSON).
• 🔄 Планы обмена: встроенный механизм 1С для синхронизации данных между базами.
• 🌐 REST API: для интеграции с веб-сервисами (например, загрузка списка товаров с сайта).

Пример экспорта справочника в CSV:

Текст = "";
Запрос = Новый Запрос("ВЫБРАТЬ Наименование, Артикул ИЗ Справочник.Номенклатура");
Результат = Запрос.Выполнить();

Пока Результат.Следующий() Цикл
Текст = Текст + Результат.Наименование + ";" + Результат.Артикул + Символы.ПС;
КонецЦикла;

ЗаписьТекста = Новый ЗаписьТекста("C:\export\nomenklatura.csv");
ЗаписьТекста.ЗаписатьСтроку(Текст);
ЗаписьТекста.Закрыть();

Для импорта из Excel удобно использовать библиотеку OneScript.Xlsx или встроенный механизм ЧтениеТабличногоДокумента.

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

Даже опытные пользователи 1С сталкиваются с проблемами при работе со списками. Вот самые распространённые ошибки и способы их решения:

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

• 🔄 Изменилось имя справочника или реквизита;
• 🗑️ Удалены предопределённые элементы;
• 🔧 Изменился тип данных (например, с Число на Строка).

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

8. Продвинутые техники: списки с иерархией и полнотекстовым поиском

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

1. Иерархические списки с неограниченной вложенностью

Если нужно создать справочник с глубокой иерархией (например, "Категории товаров → Подкатегории → Подподкатегории"), настройте:

• 📌 В конфигураторе на вкладке Иерархия выберите Иерархический;
• 🔄 Включите опцию Неограниченная глубина;
• 🔍 Для ускорения поиска добавьте индекс по полю Родитель.

2. Полнотекстовый поиск по спискам

Чтобы пользователи могли искать по любому слову в наименовании (как в поисковике), настройте:

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

Для больших баз (>50 000 элементов) полнотекстовый поиск может тормозить. В этом случае:

• 🔧 Используйте Elasticsearch или PostgreSQL с модулем pg_trgm;
• 📊 Создайте отдельный реквизит с "токенизированным" наименованием (разбитым на слова).

FAQ: Ответы на частые вопросы

ЭлементыФормы.ВыборКонтрагента.СписокВыбора = Справочники.Контрагенты.Выбрать();

ТабДок = Новый ТабличныйДокумент;
ТабДок.Вывести(ДинамическийСписок1);
ТабДок.Записать("C:\export\список.xlsx", ТипФайлаТабличногоДокумента.XLSX);

ДинамическийСписок1.Сортировка.Добавить("Дата", НаправлениеСортировки.Убыв);
ДинамическийСписок1.Сортировка.Добавить("Наименование", НаправлениеСортировки.Возр);