Как создать объект справочника в 1С

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

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

Что нужно проверить перед созданием элемента

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

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

Как создать элемент справочника вручную

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

1. 1
   Откройте нужный справочник через раздел меню (например, «Номенклатура» в разделе «Справочники» или «Покупки»).
2. 2
   Нажмите кнопку «Создать» в командной панели формы списка. Если справочник иерархический, сначала выберите группу, в которую попадёт элемент.
3. 3
   Заполните наименование и обязательные реквизиты — они обычно подчёркнуты красным или отмечены звёздочкой.
4. 4
   Нажмите «Записать и закрыть» или «Записать», чтобы сохранить элемент.
5. 5
   Проверьте, что элемент появился в списке справочника.

Если кнопка «Создать» недоступна (серая), причины обычно две: нет прав на добавление либо справочник находится в режиме только просмотра из-за настроек формы. В первом случае обратитесь к администратору за назначением роли, во втором — проверьте, не открыта ли форма подбором из другого объекта.

Как создать объект справочника программно

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

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Кабель ВВГнг 3х2,5";
НовыйЭлемент.Артикул = "КБ-325";
НовыйЭлемент.Записать();

Сообщить("Создан элемент: " + НовыйЭлемент.Ссылка);

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

Если нужно создать элемент внутри конкретной группы иерархического справочника, заполните реквизит Родитель ссылкой на группу:

Группа = Справочники.Номенклатура.НайтиПоНаименованию("Кабельная продукция");
НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Родитель = Группа;
НовыйЭлемент.Наименование = "Кабель ВВГнг 3х1,5";
НовыйЭлемент.Записать();

Создание группы и заполнение табличной части

Для иерархических справочников группы создаются отдельным методом — СоздатьГруппу(). Обычному элементу нельзя назначить подчинённые записи, поэтому путать эти два метода нельзя: попытка указать элемент в качестве родителя приведёт к ошибке при записи.

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

Если у справочника есть табличные части (например, «Единицы измерения» или «Контактная информация»), они заполняются после создания объекта, но до записи, либо после записи с последующим повторным Записать():

СтрокаТЧ = НовыйЭлемент.ДополнительныеРеквизиты.Добавить();
СтрокаТЧ.Свойство = СвойствоЦвет;
СтрокаТЧ.Значение = "Синий";
НовыйЭлемент.Записать();

Как избежать дублей при программном создании

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

Ссылка = Справочники.Номенклатура.НайтиПоНаименованию("Кабель ВВГнг 3х2,5");
Если Ссылка.Пустая() Тогда
    НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
    НовыйЭлемент.Наименование = "Кабель ВВГнг 3х2,5";
    НовыйЭлемент.Записать();
Иначе
    Сообщить("Такой элемент уже существует");
КонецЕсли;

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

Проверка результата и типичные ошибки

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

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