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

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

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

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

Минимальный код для добавления нового элемента выглядит так:

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

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

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

НовыйЭлемент.Записать();
СсылкаНаЭлемент = НовыйЭлемент.Ссылка;

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

НовыйЭлемент = Справочники.Контрагенты.СоздатьЭлемент();
НовыйЭлемент.Наименование = "ООО Ромашка";
НовыйЭлемент.ИНН = "7701234567";
НовыйЭлемент.Записать();
Сообщить("Создан элемент: " + НовыйЭлемент.Ссылка);

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

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

НайденнаяСсылка = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка", Истина);
Если НайденнаяСсылка.Пустая() Тогда
// создаём новый элемент
Иначе
// элемент уже существует — обновляем или пропускаем
КонецЕсли;

Метод НайтиПоНаименованию со вторым параметром Истина ищет точное совпадение, без него — по началу строки, что может вернуть не тот элемент. Для поиска по ИНН, артикулу или другому реквизиту используйте НайтиПоРеквизиту("ИНН", ЗначениеИНН). Учтите: поиск по реквизиту работает только если у реквизита включено индексирование, иначе на больших справочниках запрос будет медленным.

Для надёжной синхронизации с внешними системами лучше искать по коду или по уникальному идентификатору ссылки, если он хранится во внешнем источнике. Наименование — ненадёжный ключ: пользователи его переименовывают.

Работа с иерархическими справочниками и группами

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

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

// Создаём элемент внутри группы
НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Кабель ВВГнг 3х2.5";
НовыйЭлемент.Родитель = НоваяГруппа.Ссылка;
НовыйЭлемент.Записать();

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

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

Заполнение табличных частей и подчинённых справочников

У многих справочников есть табличные части — например, «Единицы измерения» у номенклатуры или «Контактная информация» у контрагентов. Они заполняются до записи объекта, добавлением строк:

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Кабель ВВГнг 3х2.5";

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

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

Подчинённые справочники — отдельный случай. Их элементы нельзя создать без указания владельца, поэтому сначала записывается элемент-владелец, а затем создаётся подчинённая запись:

НовыйДоговор = Справочники.ДоговорыКонтрагентов.СоздатьЭлемент();
НовыйДоговор.Владелец = СсылкаНаКонтрагента; // обязательно
НовыйДоговор.Наименование = "Договор поставки № 12";
НовыйДоговор.Записать();

Если не заполнить Владелец, при записи возникнет ошибка «Не заполнено значение обязательного реквизита». Аналогично ведут себя реквизиты с признаком «Проверка заполнения: Выдавать ошибку» — платформа не даст записать объект без них.

1. 1
   Проверьте наличие дубля через НайтиПоНаименованию или НайтиПоРеквизиту
2. 2
   Создайте объект методом СоздатьЭлемент() или СоздатьГруппу()
3. 3
   Заполните обязательные реквизиты, родителя и владельца
4. 4
   Заполните табличные части, если они есть
5. 5
   Вызовите Записать() и проверьте полученную ссылку
6. 6
   Обработайте возможное исключение через Попытка/Исключение

Обработка ошибок и транзакции при массовой загрузке

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

Попытка
НовыйЭлемент.Записать();
Исключение
Сообщить("Не удалось создать элемент: " + ОписаниеОшибки());
КонецПопытки;

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

Для массовой загрузки также имеет смысл отключать итоги и использовать режим загрузки при обмене: НовыйЭлемент.ОбменДанными.Загрузка = Истина;. Этот приём отключает проверку заполнения и обработчики событий, что ускоряет запись, но перекладывает ответственность за корректность данных полностью на ваш код. Применяйте его только при проверенных входных данных.

Права доступа, события и особенности записи

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

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

Для проверки результата после записи полезно убедиться, что ссылка не пустая и элемент реально доступен в базе:

Типичные ошибки при программном создании записей

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

FAQ