К статье
Практический материал

Другое · 7 мин

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

Создание группы справочника программно в 1С: пример кода, выбор родителя, права доступа, проверка результата и типичные ошибки при работе со справочниками.

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

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

Код выполняется в модуле объекта, формы или общего модуля в зависимости от того, где запускается операция. Для записи в базу обычно подходит серверный контекст, но точный выбор зависит от типа формы и настроек конфигурации. Перед массовым созданием рекомендуется проверить права пользователя и сделать резервную копию информационной базы.

Когда программное создание группы оправдано

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

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

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

Типичная последовательность: получить объект справочника, вызвать метод создания группы, заполнить реквизиты и вызвать запись. Ниже общая схема без привязки к конкретной конфигурации. Имя справочника и набор реквизитов зависят от вашей конфигурации.

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

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

ОбъектГруппы = Справочники.Номенклатура.СоздатьГруппу();

ОбъектГруппы.Наименование = "Новая группа товаров";

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

ОбъектГруппы.Записать();

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

Родитель, код и наименование: условия записи

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

Пустая родительская ссылка означает корень справочника. Если требуется создать группу внутри уже существующей ветки, сначала найдите эту ветку и присвойте её ссылку свойству Родитель. Создание группы с несуществующим родителем вызовет ошибку записи.

Контрольные точки

Как проверить результат

Ссылка на созданную группу получена и не пуста
Норма

Группа сохранена и доступна по ссылке

Тревожный признак

Ссылка пуста или объект не найден

Значение свойства ЭтоГруппа
Норма

Истина

Тревожный признак

Ложь — создан элемент, а не группа

Поиск по наименованию в родителе
Норма

Одна запись

Тревожный признак

Несколько записей — возможен дубль

Проверка результата и права доступа

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

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

Ограничения и риски

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

Массовое создание в цикле без фиксации транзакций увеличивает нагрузку на базу и замедляет работу. Если операция прервётся, могут остаться неполные или частично сохранённые группы. Используйте транзакции только там, где это действительно необходимо и безопасно.

Типичные ошибки
01
Создание элемента вместо группы и попытка использовать его как узел иерархии
02
Повторный запуск скрипта без проверки существующих групп, что приводит к дублям
03
Указание несуществующего родителя и ошибка при записи

Альтернативы и когда не стоит создавать группу

Вместо программного создания можно использовать стандартный импорт данных, обработку загрузки из Excel или настройку иерархии в конфигураторе. Эти подходы подходят для разовых операций и не требуют поддержки кода. Программный метод оправдан при повторяющихся сценариях и интеграции.

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

Итог

Что важно запомнить

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

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

Можно ли создать группу на клиенте без сервера?

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

Что делать, если группа не сохраняется?

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

Можно ли удалить созданную группу программно?

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

Нужен ли код у группы?

Не обязательно. Код заполняйте, если справочник использует коды и это требуется бизнес-логикой. В остальных случаях достаточно наименования и родительской связи.

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

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