Как записать элемент справочника в 1С: все способы для пользователей и разработчиков

• Кнопка Записать — сохраняет изменения, но оставляет форму открытой.
• Кнопка Записать и закрыть — сохраняет и закрывает форму.

Если кнопка Записать неактивна, проверьте:

• 🔴 Заполнены ли все обязательные реквизиты (помечены красным восклицательным знаком).
• 🔒 Достаточно ли у вас прав на запись в этот справочник (проверьте в настройках ролей).
• 🔄 Не включён ли режим "Только просмотр" (иконка замка внизу формы).

Заполнены обязательные реквизиты|Проверены права пользователя|Отсутствуют дубли по наименованию/артикулу|Форма не в режиме "Только просмотр"-->

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

Программная запись элемента справочника

Для автоматизации или массового создания элементов используется встроенный язык 1С. Основной метод — Записать(), но есть нюансы в зависимости от задачи. Рассмотрим базовые сценарии:

1. Создание нового элемента

Чтобы создать и записать элемент программно, используйте следующий код:

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Монитор Samsung 24\"";
НовыйЭлемент.Артикул = "SM-24F390";
НовыйЭлемент.Группа = Справочники.Номенклатура.КомпьютернаяТехника.НайтиПоНаименованию("Мониторы");
НовыйЭлемент.Записать();

Обратите внимание:

• 📍 Метод СоздатьЭлемент() создаёт новый объект, но не сохраняет его в базе.
• 🔗 Ссылки на другие справочники (например, Группа) нужно получать через методы НайтиПоНаименованию() или ПолучитьСсылку().
• 💾 Записать() может вернуть Ложь, если запись не удалась (например, из-за дубля по артикулу).

2. Изменение существующего элемента

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

Элемент = Справочники.Номенклатура.НайтиПоНаименованию("Монитор Samsung 24\"");
Если Элемент.Пустая() Тогда
Сообщить("Элемент не найден!");
Иначе
Элемент.ЦенаПродажи = 18000;
Элемент.Записать();
КонецЕсли;

Для поиска элементов лучше использовать НайтиПоРеквизиту(), если известен уникальный реквизит (например, артикул):

Элемент = Справочники.Номенклатура.НайтиПоРеквизиту("Артикул", "SM-24F390");

3. Массовая запись в транзакции

При работе с большим количеством элементов используйте транзакции, чтобы избежать ошибок при прерывании:

НачатьТранзакцию();
Попытка
Для Каждого Строка Из ТаблицаНовыхЭлементов Цикл
НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = Строка.Наименование;
НовыйЭлемент.Артикул = Строка.Артикул;
НовыйЭлемент.Записать();
КонецЦикла;
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка при записи: " + ОписаниеОшибки());
КонецПопытки;

Для ускорения массовой записи в 1С:Предприятие 8.3.20+ можно использовать пакетный режим:

МенеджерЗаписи = Новый МенеджерЗаписиСправочников();
Для Каждого Строка Из Данные Цикл
Элемент = Справочники.Номенклатура.СоздатьЭлемент();
Элемент.Наименование = Строка.Наименование;
МенеджерЗаписи.Добавить(Элемент);
КонецЦикла;
МенеджерЗаписи.Записать();

Типичные ошибки и их решения

Даже опытные пользователи и разработчики сталкиваются с проблемами при записи элементов. Рассмотрим самые распространённые ошибки и способы их устранения:

⚠️ Внимание: Если при программной записи возникает ошибка "Объект заблокирован другим пользователем", это означает, что элемент редактируется в другой сессии. Используйте метод ЗаблокироватьДляИзменения() с таймаутом или повторите попытку позже.

Одна из коварных ошибок — тихая неудача записи, когда Записать() возвращает Ложь, но не показывает сообщение. Всегда проверяйте результат:

Если НЕ Элемент.Записать() Тогда
Сообщить("Ошибка записи: " + Элемент.ПолучитьСообщениеОшибки());
КонецЕсли;

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

Особенности работы в разных конфигурациях 1С

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

В 1С:УТ 11.4+ и 1С:ERP при записи элементов справочника "Номенклатура" автоматически обновляются связанные данные: остатки, цены, характеристики. Это может замедлять запись, если в системе много аналитики. Для ускорения используйте отложенное обновление:

Элемент.ОтложенноеОбновлениеРеквизитов = Истина;
Элемент.Записать();

⚠️ Внимание: В конфигурациях с включённым механизмом "Управляемые блокировки" (начиная с платформы 8.3.18) при программной записи элементов может возникать ошибка "Объект заблокирован для изменения", даже если никто его не редактирует. В этом случае используйте:

Элемент.ЗаблокироватьДляИзменения(10); // Таймаут 10 секунд
Элемент.Записать();
Элемент.Разблокировать();

Автоматизация записи через обработки и обмен данными

Если вам нужно регулярно загружать элементы в справочник из внешних источников (Excel, XML, другие программы), можно использовать:

• 📑 Обработки загрузки — готовые или кастомизированные решения для импорта данных.
• 🔄 Обмен данными — если нужно синхронизировать справочники между базами (например, между 1С:УТ и 1С:Бухгалтерией).
• 🤖 Роботы 1С — для автоматизации рутинных операций (например, создание контрагентов по входящим письмам).

Пример загрузки из Excel через обработку:

1. Скачайте обработку "Универсальная загрузка из Excel" (доступна на infostart.ru или в каталоге 1С).
2. Настройте соответствие колонок Excel и реквизитов справочника.
3. Запустите загрузку. Обработка сама создаст элементы или обновит существующие.

Для обмена данными между базами:

1. Настройте план обмена в обеих базах (Администрирование → Обмен данными).
2. Укажите правила соответствия справочников (например, Номенклатура в УТ → Номенклатура в Бухгалтерии).
3. Запустите синхронизацию. Система сама определит, какие элементы нужно создать или обновить.

При использовании обмена данными обратите внимание на:

• 🔗 Связи между элементами — если в справочнике есть ссылки на другие справочники (например, группа номенклатуры), они тоже должны быть синхронизированы.
• 🔄 Конфликты версий — если один и тот же элемент изменили в обеих базах, нужно настроить правила разрешения конфликтов.
• 📡 Производительность — при большом объёме данных используйте фоновую обработку (ФоновоеЗадание).

💡

Если вам нужно регулярно обновлять справочник "Контрагенты" по данным из ЕГРЮЛ, используйте обработку "Загрузка данных из ФНС" (доступна в каталоге 1С). Она автоматически создаёт и обновляет элементы, сверяя данные по ИНН.

Оптимизация работы со справочниками

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

• 🚀 Отключите проверки на время массовой загрузки:

  НастройкаПараметров.ОтключитьПроверкуЗаполнения = Истина;

• 📊 Используйте пакетную запись (как показано в разделе про программную запись).
• 🔍 Индексируйте реквизиты, по которым часто ищут элементы (например, артикул в "Номенклатуре").
• 🗑️ Очищайте пометки удаления после массовых операций:

  Справочник.Номенклатура.УдалитьПометкиУдаления();

Для справочников с большой иерархией (например, "Номенклатура" с десятками тысяч групп) ускорьте работу, отключив автоматическое развёртывание дерева:

Форма.Дерево.АвтоРазвертывание = Ложь;

Если справочник используется в документах (например, "Номенклатура" в "Реализации товаров"), после массовой записи элементов обновите кэш метаданных:

Метаданные.ОбновитьКэш();

В клиент-серверном варианте работы 1С:Предприятия для ускорения записи используйте серверные процедуры. Например:

&НаСервере
Процедура ЗаписатьЭлементыНаСервере(Данные)
Для Каждого Строка Из Данные Цикл
Элемент = Справочники.Номенклатура.СоздатьЭлемент();
Элемент.Наименование = Строка.Наименование;
Элемент.Записать();
КонецЦикла;
КонецПроцедуры

💡

При работе с большими справочниками (более 10 000 элементов) делите операции на пакеты по 500-1000 записей. Это снизит нагрузку на сервер и уменьшит риск блокировок.

FAQ: Частые вопросы по записи элементов справочника

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

Используйте метод ЗаполнитьПоУмолчанию() перед записью:

НовыйЭлемент = Справочники.Контрагенты.СоздатьЭлемент();
НовыйЭлемент.ЗаполнитьПоУмолчанию();
НовыйЭлемент.Наименование = "ООО Розница";
НовыйЭлемент.Записать();

Это заполнит стандартные реквизиты (например, "Вид контрагента" или "Валюта расчётов") значениями по умолчанию из настроек справочника.

Почему при записи элемента справочника возникает ошибка "Нарушение прав доступа"?

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

1. Проверьте настройки ролей в конфигураторе (Администрирование → Пользователи и права).
2. Если вы разработчик, временно используйте права администратора:

   Пользователь = ПользователиИнформационнойБазы.ТекущийПользователь();
   Если НЕ Пользователь.ПолныеПрава() Тогда
   Сообщить("Недостаточно прав!");
   КонецЕсли;

3. В клиент-серверном варианте проверьте права на сервере 1С.

Как записать элемент справочника с уникальным идентификатором (GUID)?

В 1С:Предприятие 8.3 каждый элемент справочника имеет уникальный идентификатор (УникальныйИдентификатор или Ссылка.УникальныйИдентификатор()). Чтобы записать элемент с конкретным GUID:

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.УстановитьНовыйУникальныйИдентификатор("123e4567-e89b-12d3-a456-426614174000");
НовыйЭлемент.Наименование = "Тестовый элемент";
НовыйЭлемент.Записать();

Обратите внимание: если элемент с таким GUID уже существует, возникнет ошибка дублирования.

Можно ли записать элемент справочника без открытия формы?

Да, для этого используйте программную запись (см. раздел выше) или фоновые задания. Пример:

ФоновоеЗадание.Выполнить("ЗаписатьЭлементСправочника", Структура, "Низкий");

Где Структура содержит данные для элемента, а "Низкий" — приоритет задания.

Как отменить запись элемента, если он уже сохранён?

Если элемент записан, но ещё не использован в документах, его можно:

• 🗑️ Пометить на удаление:

  Элемент.ПометитьУдаление(Истина);

• 🔄 Восстановить предыдущую версию (если включено версионирование).
• 📝 Изменить реквизиты (если ошибка в данных, а не в самом факте создания).

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