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

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

Материал рассчитан на встроенный язык 1С:Предприятие 8.3 и управляемые формы. Примеры приведены для типового справочника «Номенклатура», но подход одинаков для любых справочников — контрагентов, сотрудников, складов. Все операции с записью выполняйте сначала на копии базы: прямое изменение данных обходит часть прикладных проверок, и откатить массовую обработку без резервной копии невозможно.

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

Получаем объект справочника и меняем реквизит

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

Минимальный пример: меняем ставку НДС у конкретной номенклатуры, ссылка на которую уже известна (например, выбрана на форме обработки).

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

Если ссылки нет, элемент находят по коду, наименованию или реквизиту через методы менеджера справочника: Справочники.Номенклатура.НайтиПоКоду("000000123") или НайтиПоНаименованию("Кирпич М-150", Истина). Методы возвращают ссылку; если элемент не найден — пустую ссылку, которую обязательно проверяют через Ссылка.Пустая() перед получением объекта.

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

ЭлементСсылка = Справочники.Номенклатура.НайтиПоКоду("000000123");
Если Не ЭлементСсылка.Пустая() Тогда
    ЭлементОбъект = ЭлементСсылка.ПолучитьОбъект();
    ЭлементОбъект.СтавкаНДС = Перечисления.СтавкиНДС.НДС20;
    ЭлементОбъект.Записать();
КонецЕсли;

Ссылка и объект: в чём разница и почему это важно

Ссылка (СправочникСсылка) — лёгкий объект-указатель. Через неё можно читать реквизиты «через точку» (платформа неявно выполняет запрос к базе), но присваивание значений полям ссылки недоступно. Попытка написать НоменклатураСсылка.СтавкаНДС = ... вызовет ошибку исполнения.

Объект (СправочникОбъект) — редактируемое представление элемента со всеми реквизитами, табличными частями и механизмами записи. Именно объект вызывает обработчики событий ПередЗаписью, ПриЗаписи, проверку заполнения и контроль уникальности кода и наименования.

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

Массовое изменение реквизита у группы элементов

Когда реквизит нужно поменять у десятков или тысяч элементов, перебор делают выборкой запроса. Запрос выбирает только ссылки (быстро, без лишних данных), а внутри цикла каждая ссылка превращается в объект, изменяется и записывается.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   Номенклатура.Родитель = &Группа
|   И НЕ Номенклатура.ПометкаУдаления";
Запрос.УстановитьПараметр("Группа", ГруппаТоваров);

Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
ТекОбъект = Выборка.Ссылка.ПолучитьОбъект();
ТекОбъект.СтавкаНДС = Перечисления.СтавкиНДС.НДС20;
ТекОбъект.Записать();
КонецЦикла;

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

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

1. 1
   Сделайте резервную копию или выполните обработку на копии базы
2. 2
   Сформируйте запрос с точным отбором нужных элементов
3. 3
   В цикле получайте объект, меняйте реквизит, вызывайте Записать()
4. 4
   Оберните цикл в транзакцию или обрабатывайте порциями
5. 5
   Проверьте результат запросом: сколько элементов получили новое значение

Транзакция и обработка ошибок записи

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

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

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

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

Изменение реквизита на сервере и в фоновом задании

В управляемом приложении код, меняющий данные, должен выполняться на сервере. В модуле формы обработки используют директиву &НаСервере; с клиента серверную процедуру вызывают без передачи объектов — объекты справочников нельзя передавать между клиентом и сервером, передают только ссылки и примитивные типы.

Тяжёлые обработки правильно запускать в фоновом задании через ДлительныеОперации.ВыполнитьВФоне() (в конфигурациях на БСП) или ФоновыеЗадания.Выполнить(). Фоновое выполнение не блокирует интерфейс пользователя и позволяет показывать прогресс и корректно отменять операцию.

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

Как проверить результат и что делать при ошибках

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

Также полезно сверить количество обработанных записей с количеством строк в выборке. Если обработка вела лог ошибок, каждый пропущенный элемент должен быть в нём зафиксирован с причиной отказа — это превращает догадки в конкретный список доработки.

Типичные ошибки при программном изменении реквизитов

Большинство проблем у начинающих разработчиков связано не со сложностью языка, а с пропуском базовых шагов: забыта запись, изменяется не тот элемент, обработка запущена без отбора. Ниже — ошибки, которые встречаются чаще всего.

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

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