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

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

Типовой сценарий выглядит так: создаётся объект РегистрыСведений.ИмяРегистра.СоздатьНаборЗаписей(), при необходимости на него накладывается отбор по измерениям, набор заполняется записями и фиксируется методом Записать(). Нюансы — в правильной установке отборов, режиме замещения и контроле периодичности регистра.

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

Что такое набор записей и когда он нужен

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

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

Базовый код записи набора

Минимальный рабочий пример для непериодического регистра сведений с измерением «Номенклатура» и ресурсом «Цена»:

Набор = РегистрыСведений.ЦеныНоменклатуры.СоздатьНаборЗаписей();
Набор.Отбор.Номенклатура.Установить(ТекНоменклатура);

НоваяЗапись = Набор.Добавить();
НоваяЗапись.Номенклатура = ТекНоменклатура;
НоваяЗапись.Цена = 1500;

Набор.Записать();

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

Набор = РегистрыСведений.КурсыВалют.СоздатьНаборЗаписей();
Набор.Отбор.Валюта.Установить(ВалютаСсылка);
Набор.Прочитать();
Запись = Набор.Добавить();
Запись.Период = ТекущаяДатаСеанса();
Запись.Валюта = ВалютаСсылка;
Запись.Курс = 92.5;
Набор.Записать(Истина);

Отборы: главный элемент безопасности

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

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

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

Режим замещения и чтение существующих данных

Метод Записать(Замещение) принимает булев параметр. При Замещение = Истина (значение по умолчанию) набор полностью заменяет записи, попадающие под его отбор. При Замещение = Ложь новые записи добавляются к существующим, а при конфликте уникальных ключей (совпадение измерений и периода) возникнет ошибка.

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

Массовая загрузка и транзакции

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

Оборачивайте загрузку в явную транзакцию через НачатьТранзакцию() / ЗафиксироватьТранзакцию() с обработкой исключений и ОтменитьТранзакцию() в блоке Исключение. Так при сбое в середине загрузки регистр не останется наполовину заполненным.

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

Проверка результата записи

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

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

Большинство проблем при записи наборов связано с несколькими повторяющимися причинами. Их знание экономит часы отладки и защищает данные.

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

Часто задаваемые вопросы