Программное создание каталога в 1С: от простого справочника до сложных иерархий

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

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

Чем справочник отличается от каталога в 1С?

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

• 📚 Справочники — основной объект для хранения списков данных (номенклатура, контрагенты, сотрудники). Именно их чаще всего создают программно.
• 🗃️ Каталоги файлов — специализированные справочники для хранения прикреплённых файлов (например, документы контрагентов).
• 📊 Планы видов характеристик (ПВХ) — используются для создания сложных классификаторов (например, свойства товаров).

В 90% случаев под "созданием каталога" имеют в виду программное добавление элементов в справочник. Исключение — задачи интеграции с внешними системами, где может потребоваться работа с Планами обмена или Хранилищами значений.

⚠️ Внимание: Если вы работаете с 1С:Управление торговлей или 1С:ERP, проверьте наличие предопределённых справочников (например, "Виды номенклатуры") — их структура может отличаться от стандартных, и программное создание элементов потребует учёта специфичных реквизитов.

Базовый метод: создание элемента справочника

Самый простой способ добавить запись в справочник — использовать метод СоздатьЭлемент(). Рассмотрим пример для справочника Номенклатура:

// Получаем ссылку на справочник
Справочник = Справочники.Номенклатура;

// Создаём новый элемент
НовыйЭлемент = Справочник.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Ноутбук ASUS ZenBook 14";
НовыйЭлемент.Артикул = "ZB14-2023";
НовыйЭлемент.ПолноеНаименование = "Ноутбук ASUS ZenBook 14 (2023, OLED, i7-1360P)";

// Записываем в базу
НовыйЭлемент.Записать();

Этот код создаст новую позицию номенклатуры с минимальным набором реквизитов. Однако в реальных задачах часто требуется:

• 🔹 Указывать родительские группы (для иерархических справочников).
• 🔹 Заполнять дополнительные реквизиты (например, ЕдиницаИзмерения или СтавкаНДС).
• 🔹 Проверять уникальность по артикулу или наименованию.

Для иерархических справочников (где элементы могут входить в группы) код модифицируется так:

РодительскаяГруппа = Справочники.Номенклатура.НайтиПоНаименованию("Ноутбуки");
НовыйЭлемент.Родитель = РодительскаяГруппа;

⚠️ Внимание: При работе с большими справочниками (более 10 000 элементов) метод НайтиПоНаименованию() может тормозить. В таких случаях используйте ПолучитьСсылку() с известным УникальнымИдентификатором или организуйте предварительную выборку через запрос.

Массовое создание элементов: оптимизация производительности

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

1. Транзакции — объединяйте операции в одну транзакцию, чтобы уменьшить нагрузку на СУБД.
2. Объектную модель — создавайте элементы в памяти и записывайте пакетом.
3. Отключение проверок — временно отключайте контроль уникальности и обязательности реквизитов.

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

НачатьТранзакцию();

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

// Отключаем проверки (если уверены в данных)
Справочник.ПроверятьЗаполнение = Ложь;
Справочник.ПроверятьУникальность = Ложь;

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

// Записываем пакетом
Справочник.Записать(МассовыйЗапись);

ЗафиксироватьТранзакцию();

Для действительно больших объёмов (более 50 000 записей) рассмотрите возможность использования внешних обработок с прямым доступом к СУБД через ADO или SQL-запросы, но этот подход требует глубокого понимания структуры базы данных 1С.

Отключить антивирус на время загрузки|Сделать резервную копию базы|Проверить права пользователя на запись|Ограничить доступ других пользователей|Тестировать на копии базы-->

Создание иерархических структур

Если справочник поддерживает иерархию (например, Номенклатура с группами "Электроника → Ноутбуки → Игровые"), программное создание требует учёта родительских элементов. Основные подходы:

• 📂 Сверху вниз — сначала создаём группы, затем элементы внутри них.
• 🔄 Рекурсивный обход — если структура загружается из внешнего источника (например, XML с вложенностью).
• 🔗 Ссылки на родителей — когда группы уже существуют, и нужно только привязать элементы.

Пример рекурсивного создания дерева групп:

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

// Рекурсия для вложенных групп
Если ЗначениеЗаполнено(Группа.Подгруппы) Тогда
СоздатьГруппы(НоваяГруппа, Группа.Подгруппы);
КонецЕсли;
КонецЦикла;
КонецПроцедуры

// Запуск с корневой группы
КорневаяГруппа = Справочники.Номенклатура.ПолучитьСсылку(Новый УникальныйИдентификатор("00000000-0000-0000-0000-000000000001"));
СоздатьГруппы(КорневаяГруппа, ЗагруженнаяСтруктураГрупп);

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

Если НЕ Справочники.ВидыЦен.Предопределенный("ОсновнаяЦена") Тогда
НовыйВидЦены = Справочники.ВидыЦен.СоздатьЭлемент();
НовыйВидЦены.Наименование = "Основная цена";
НовыйВидЦены.УстановитьПредопределенныеДанные("ОсновнаяЦена");
НовыйВидЦены.Записать();
КонецЕсли;

Чтение = Новый ЧтениеXML;
Чтение.ОткрытьФайл("C:\price.xml");

Справочник = Справочники.Номенклатура;
ТаблицаДанных = Новый ТаблицаЗначений;
ТаблицаДанных.Колонки.Добавить("Наименование");
ТаблицаДанных.Колонки.Добавить("Артикул");
ТаблицаДанных.Колонки.Добавить("Цена");

// Парсинг XML
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента И Чтение.Имя = "Товар" Тогда
НоваяСтрока = ТаблицаДанных.Добавить();
НоваяСтрока.Наименование = Чтение.ПолучитьАтрибут("Наименование");
НоваяСтрока.Артикул = Чтение.ПолучитьАтрибут("Артикул");
НоваяСтрока.Цена = Чтение.ПолучитьАтрибут("Цена");
КонецЕсли;
КонецЦикла;

// Массовая загрузка
Загрузка = Новый ЗагрузкаДанных;
Загрузка.Источник = ТаблицаДанных;
Загрузка.ЦелевойОбъект = Справочник;
Загрузка.Выполнить();

Чтение = Новый ЧтениеJSON;
Чтение.ОткрытьСтроку(ПолученныеДанныеИзAPI);

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

// Неправильно: ссылка на несохранённый элемент
НовыйПоставщик = Справочники.Контрагенты.СоздатьЭлемент();
НоваяНоменклатура.Поставщик = НовыйПоставщик; // Ссылка нестабильна!
НоваяНоменклатура.Записать();
НовыйПоставщик.Записать();

// Правильно: сначала сохраняем поставщика
НовыйПоставщик.Записать();
НоваяНоменклатура.Поставщик = НовыйПоставщик.Ссылка();
НоваяНоменклатура.Записать();

// Получаем объект дополнительных реквизитов
ДопРеквизиты = Справочники.Номенклатура.ДопРеквизиты;

// Добавляем новый реквизит (если его ещё нет)
Если НЕ ДопРеквизиты.НайтиПоНаименованию("Вес") Тогда
НовыйРеквизит = ДопРеквизиты.СоздатьЭлемент();
НовыйРеквизит.Наименование = "Вес";
НовыйРеквизит.ТипЗначения = Новый ОписаниеТипов("Число");
НовыйРеквизит.Записать();
КонецЕсли;

// Заполняем значение для элемента номенклатуры
НоваяНоменклатура.ДопРеквизиты.Установить("Вес", 1.25); // 1.25 кг

// Создаём вид характеристики "Цвет"
ВидХарактеристики = Справочники.ВидыХарактеристикНоменклатуры.СоздатьЭлемент();
ВидХарактеристики.Наименование = "Цвет";
ВидХарактеристики.ТипЗначения = Новый ОписаниеТипов("СправочникСсылка.Цвета");
ВидХарактеристики.Записать();

// Присваиваем характеристику номенклатуре
НоваяНоменклатура.Характеристики.Добавить();
НоваяНоменклатура.Характеристики[0].Вид = ВидХарактеристики.Ссылка();
НоваяНоменклатура.Характеристики[0].Значение = Справочники.Цвета.НайтиПоНаименованию("Чёрный");

Товар = Справочники.ТоварыИУслуги.СоздатьЭлемент();
Товар.Наименование = "Услуга монтажа";
Товар.ТипНоменклатуры = Перечисления.ТипыНоменклатуры.Услуга;
Товар.Записать();