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

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

Главное условие: справочник должен быть иерархическим. Если в конфигураторе у справочника не включено свойство «Иерархический», метод СоздатьГруппу() вызовет ошибку. Также важно учитывать вид иерархии — «Список» или «Группы и элементы»: от этого зависит, могут ли элементы и группы находиться на одном уровне.

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

Проверка настроек справочника перед созданием группы

Перед написанием кода откройте конфигуратор и убедитесь, что у нужного справочника установлен флаг «Иерархический» на закладке «Иерархия». Без этого свойства платформа не позволит создавать группы — ни интерактивно, ни программно. Там же проверьте вид иерархии: «Список» допускает смешение групп и элементов на одном уровне, а «Группы и элементы» жёстко разделяет папки и элементы.

Ещё один параметр — «Ограничение количества уровней» и «Количество уровней». Если задано ограничение, попытка создать группу глубже допустимого уровня завершится ошибкой при записи. Учитывайте это при проектировании загрузки многоуровневых классификаторов.

Также проверьте длину наименования и кода. Если наименование группы из внешнего источника длиннее допустимого, платформа обрежет его или выдаст ошибку в зависимости от настроек. Лучше обрезать строку в коде явно с помощью Лев().

Базовый код создания группы

Минимальный сценарий состоит из трёх шагов: получить новый объект группы, заполнить реквизиты, записать. Метод СоздатьГруппу() вызывается у менеджера справочника и возвращает объект типа «СправочникОбъект» с признаком ЭтоГруппа = Истина.

НоваяГруппа = Справочники.Номенклатура.СоздатьГруппу();
НоваяГруппа.Наименование = "Строительные материалы";
НоваяГруппа.Записать();

После вызова Записать() у объекта появляется ссылка, доступная через НоваяГруппа.Ссылка. Именно ссылку нужно сохранять, если дальше вы будете создавать элементы или подгруппы внутри этой папки. До записи ссылка уникальна, но не сохранена в базе — использовать её как родителя до записи нельзя.

Если у справочника есть дополнительные реквизиты, обязательные для заполнения, заполните их до вызова Записать(). Иначе сработает проверка заполнения, и запись будет отклонена с сообщением об ошибке.

НоваяГруппа = Справочники.Номенклатура.СоздатьГруппу();
НоваяГруппа.Наименование = "Строительные материалы";
НоваяГруппа.Записать();
Сообщить("Создана группа: " + НоваяГруппа.Ссылка);

Создание группы внутри другой группы

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

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

НоваяПодгруппа = Справочники.Номенклатура.СоздатьГруппу();
НоваяПодгруппа.Наименование = "Сухие смеси";
НоваяПодгруппа.Родитель = РодительскаяГруппа;
НоваяПодгруппа.Записать();

Обратите внимание на второй параметр НайтиПоНаименованию: значение Истина означает точное соответствие. Если группа не найдена, функция вернёт пустую ссылку — присваивать её родителем без проверки рискованно, так как группа попадёт в корень вместо нужной папки. Всегда проверяйте результат через ЗначениеЗаполнено().

1. 1
   Убедитесь, что справочник иерархический и вид иерархии подходит под задачу
2. 2
   Найдите или создайте родительскую группу и запишите её
3. 3
   Вызовите СоздатьГруппу(), заполните Наименование и Родитель
4. 4
   Вызовите Записать() и сохраните полученную ссылку
5. 5
   Проверьте результат в пользовательском режиме или запросом

Проверка на дубли перед созданием

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

Функция ПолучитьГруппу(НаименованиеГруппы, Родитель)

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

Если ЗначениеЗаполнено(Найденная) И Найденная.ЭтоГруппа Тогда
Возврат Найденная;
КонецЕсли;

НоваяГруппа = Справочники.Номенклатура.СоздатьГруппу();
НоваяГруппа.Наименование = НаименованиеГруппы;
НоваяГруппа.Родитель = Родитель;
НоваяГруппа.Записать();

Возврат НоваяГруппа.Ссылка;

КонецФункции

Третий параметр НайтиПоНаименованию ограничивает поиск указанным родителем — это важно, когда одноимённые папки могут существовать в разных ветках. Дополнительная проверка ЭтоГруппа защищает от ситуации, когда найден обычный элемент с таким же наименованием.

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

Особенности: клиент-сервер, транзакции и права

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

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

Проверьте права пользователя, под которым выполняется код: у роли должно быть право «Добавление» на справочник. В файловой базе под полными правами проблем обычно нет, но в клиент-серверном режиме с настроенными ролями запись может молча завершаться отказом в обработчиках подписок. При необходимости используйте УстановитьПривилегированныйРежим(Истина) — осознанно, понимая, что это обходит ограничения доступа.

Типичные ошибки и их устранение

Самая частая ошибка — вызов СоздатьГруппу() у неиерархического справочника. Платформа сообщит, что метод недоступен. Решение — включить иерархию в конфигураторе или пересмотреть структуру данных.

Вторая распространённая проблема — попытка присвоить родителем элемент, а не группу. Проверяйте Родитель.ЭтоГруппа перед записью. Третья ошибка — использование ссылки ещё не записанной группы в качестве родителя для следующей папки: сначала Записать(), потом использование Ссылка.

Также к типичным относятся дубли при повторном запуске обработки без поиска и потеря вложенности из-за поиска по наименованию без родителя. Обе проблемы решаются функцией «найти или создать», показанной выше.

Проверка результата

После выполнения кода откройте справочник в пользовательском режиме и убедитесь, что группа отображается в нужной ветке дерева. Если форма списка настроена в режиме «Список», а не «Дерево», вложенность визуально не видна — переключите режим просмотра.

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

Частые вопросы