Другое · 7 мин
Как программно создать группу справочника в 1С: пошагово
Создание группы справочника программно в 1С: пример кода, выбор родителя, права доступа, проверка результата и типичные ошибки при работе со справочниками.
В 1С группа справочника — это иерархический узел, который объединяет элементы или другие группы. Программное создание группы нужно, когда справочник заполняется при обмене данными, переносе из другой системы или автоматизированном развертывании конфигурации. Ручной ввод в таких случаях неудобен, а ошибки в иерархии могут нарушить отборы и отчеты.
Основной способ создания — метод объекта справочника, который возвращает новый экземпляр группы. После создания заполняют наименование, при необходимости код, указывают родительскую группу и сохраняют объект. Важно различать создание группы и создание элемента: группы не используются в движениях регистров и документов напрямую, они служат только структурой.
Код выполняется в модуле объекта, формы или общего модуля в зависимости от того, где запускается операция. Для записи в базу обычно подходит серверный контекст, но точный выбор зависит от типа формы и настроек конфигурации. Перед массовым созданием рекомендуется проверить права пользователя и сделать резервную копию информационной базы.
Когда программное создание группы оправдано
Автоматизация оправдана, если группы добавляются регулярно, по шаблону или из внешнего файла. Например, при импорте номенклатуры из прайс-листа можно создавать группы по категориям товаров, а затем распределять по ним элементы. Это ускоряет первоначальное заполнение и снижает количество ручных операций.
Не стоит создавать группы программно для разовых правок, если достаточно изменить справочник в интерфейсе. Лишнее программное вмешательство усложняет поддержку и может привести к дублированию узлов, если скрипт запускают повторно без проверки существующих записей.
Как создать группу в коде 1С
Типичная последовательность: получить объект справочника, вызвать метод создания группы, заполнить реквизиты и вызвать запись. Ниже общая схема без привязки к конкретной конфигурации. Имя справочника и набор реквизитов зависят от вашей конфигурации.
- 1Получить объект справочника через Справочники.ИмяСправочника.СоздатьГруппу()
- 2Заполнить наименование и при необходимости код
- 3Указать родительскую группу или оставить пустую ссылку для корневого уровня
- 4Вызвать метод Записать() для сохранения в базе
- 5Проверить, что объект создан и имеет признак группы
В примере используется общий подход, применимый к многим конфигурациям 1С:Предприятия. Точная запись метода и доступность свойств могут отличаться в управляемом и обычном приложении, поэтому перед использованием в рабочей базе проверьте синтаксис в конфигураторе на копии базы.
ОбъектГруппы = Справочники.Номенклатура.СоздатьГруппу();
ОбъектГруппы.Наименование = "Новая группа товаров";
ОбъектГруппы.Родитель = Справочники.Номенклатура.ПустаяСсылка();
ОбъектГруппы.Записать();
Если группа должна быть вложенной, вместо пустой ссылки укажите существующую группу-родителя. Ссылку можно получить через функцию поиска по наименованию или из ранее созданного объекта. Неправильный родитель приведёт к размещению группы в другом разделе и нарушит ожидаемую иерархию.
Родитель, код и наименование: условия записи
Наименование группы обычно должно быть уникальным в пределах одного родителя, но точные правила уникальности зависят от конфигурации. Код может быть необязательным, если справочник не использует коды, но при заполнении кода стоит избегать совпадений с уже существующими значениями.
Пустая родительская ссылка означает корень справочника. Если требуется создать группу внутри уже существующей ветки, сначала найдите эту ветку и присвойте её ссылку свойству Родитель. Создание группы с несуществующим родителем вызовет ошибку записи.
Как проверить результат
Группа сохранена и доступна по ссылке
Ссылка пуста или объект не найден
Истина
Ложь — создан элемент, а не группа
Одна запись
Несколько записей — возможен дубль
Проверка результата и права доступа
После записи получайте ссылку на созданную группу и проверяйте свойство ЭтоГруппа. Если значение истинное, объект создан как группа. Также можно выполнить поиск по наименованию в том же родителе, чтобы убедиться, что дубли не появились.
Права доступа влияют на возможность создания и записи. Пользователь должен иметь право на редактирование справочника, иначе операция завершится ошибкой или будет ограничена ролями. В конфигураторе проверьте права роли и настройки доступа к объекту метаданных.
Ограничения и риски
Не создавайте группы программно в рабочей базе без предварительного тестирования на копии. Ошибка в иерархии может затруднить отборы, отчёты и обмен данными. Удаление группы, в которой есть элементы или вложенные группы, ограничено и может привести к потере структуры.
Массовое создание в цикле без фиксации транзакций увеличивает нагрузку на базу и замедляет работу. Если операция прервётся, могут остаться неполные или частично сохранённые группы. Используйте транзакции только там, где это действительно необходимо и безопасно.
Альтернативы и когда не стоит создавать группу
Вместо программного создания можно использовать стандартный импорт данных, обработку загрузки из Excel или настройку иерархии в конфигураторе. Эти подходы подходят для разовых операций и не требуют поддержки кода. Программный метод оправдан при повторяющихся сценариях и интеграции.
Если справочник не предполагает иерархию, создание групп будет лишним. Также не создавайте группы только для временной маркировки элементов; для таких целей лучше подходят реквизиты, пометки или отдельные справочники признаков.
Что важно запомнить
Создавайте группу методом СоздатьГруппу(), укажите родителя и наименование, сохраните через Записать(), проверьте признак ЭтоГруппа и тестируйте на копии базы.
Часто задаваемые вопросы
Можно ли создать группу на клиенте без сервера?
Возможность зависит от типа приложения и контекста выполнения. В управляемых формах некоторые операции допустимы на клиенте, но запись в базу часто требует серверного вызова. Уточните порядок для своей конфигурации в конфигураторе.
Что делать, если группа не сохраняется?
Проверьте права доступа, заполнение обязательных реквизитов и корректность родительской ссылки. Также убедитесь, что объект действительно является группой, а не элементом, и что не нарушаются правила уникальности наименования в родителе.
Можно ли удалить созданную группу программно?
Да, но только если в группе нет элементов и вложенных групп, а также нет зависимых данных в документах и регистрах. В противном случае удаление будет ограничено или заблокировано конфигурацией.
Нужен ли код у группы?
Не обязательно. Код заполняйте, если справочник использует коды и это требуется бизнес-логикой. В остальных случаях достаточно наименования и родительской связи.
Чем отличается группа от элемента справочника?
Группа служит узлом иерархии для объединения элементов и других групп. Элемент представляет конкретную единицу справочника и может использоваться в документах и регистрах. Группу в таких местах использовать нельзя.