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

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

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

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

Как устроен регистр сведений и что нужно знать перед записью

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

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

Третье — состав измерений. Совокупность измерений (и периода для периодического регистра) образует уникальный ключ записи. Попытка записать строку с уже существующим ключом без установки отбора приведёт либо к перезаписи, либо к ошибке уникальности — в зависимости от способа записи.

Запись одной строки через менеджер записи

Менеджер записи подходит, когда нужно добавить или изменить одну конкретную запись независимого регистра сведений. Это самый простой и наиболее часто используемый способ.

МенеджерЗаписи = РегистрыСведений.ЦеныНоменклатуры.СоздатьМенеджерЗаписи();
МенеджерЗаписи.Период = ТекущаяДатаСеанса();
МенеджерЗаписи.Номенклатура = НоменклатураСсылка;
МенеджерЗаписи.ВидЦены = ВидЦеныСсылка;
МенеджерЗаписи.Цена = 1500;
МенеджерЗаписи.Записать();

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

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

МенеджерЗаписи = РегистрыСведений.Штрихкоды.СоздатьМенеджерЗаписи();
МенеджерЗаписи.Номенклатура = НоменклатураСсылка;
МенеджерЗаписи.Прочитать();
Если МенеджерЗаписи.Выбран() Тогда
    МенеджерЗаписи.Штрихкод = НовыйШтрихкод;
    МенеджерЗаписи.Записать();
КонецЕсли;

Пакетная запись через набор записей

Набор записей используется, когда требуется записать несколько строк за одну операцию или полностью заменить группу записей с одинаковым отбором. Типичный сценарий — загрузка курсов валют за месяц или перезапись настроек по одному объекту.

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

Для Каждого СтрокаДанных Из ТаблицаКурсов Цикл
НоваяЗапись = НаборЗаписей.Добавить();
НоваяЗапись.Период = СтрокаДанных.Дата;
НоваяЗапись.Валюта = ВалютаСсылка;
НоваяЗапись.Курс = СтрокаДанных.Курс;
КонецЦикла;

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

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

Если нужно только добавить строки к существующим, сначала вызовите НаборЗаписей.Прочитать(), затем добавляйте новые строки и записывайте. Либо используйте параметр Записать(Ложь), который добавляет записи без замещения — но при совпадении ключей возникнет ошибка уникальности.

Запись в регистр, подчинённый регистратору

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

В модуле документа движения формируются через коллекцию Движения:

Процедура ОбработкаПроведения(Отказ, РежимПроведения)

Движения.СтатусыЗаказов.Записывать = Истина;

Движение = Движения.СтатусыЗаказов.Добавить();
Движение.Период = Дата;
Движение.Заказ = ЗаказПокупателя;
Движение.Статус = Перечисления.СтатусыЗаказа.ВРаботе;

КонецПроцедуры

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

Транзакции и запись нескольких регистров

Когда программная обработка пишет в несколько регистров или комбинирует запись регистра сведений с изменением других объектов, оборачивайте операции в транзакцию. Иначе при ошибке на середине часть данных будет записана, а часть — нет, и база останется в несогласованном состоянии.

НачатьТранзакцию();
Попытка
// запись в первый регистр
// запись во второй регистр
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
ВызватьИсключение ОписаниеОшибки();
КонецПопытки;

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

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

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

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

Наиболее частые проблемы: запись не появляется из-за исключения, «проглоченного» пустой обработкой ошибок; появляются дубли, потому что разные представления периода (начало дня и произвольное время) дают разные ключи; данные затирают соседние записи из-за слишком широкого отбора набора записей.

Выбор между менеджером записи и набором записей

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

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

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