Добавление записей в регистр сведений 1С программно

Работа с регистрами сведений является одной из фундаментальных задач при разработке конфигураций в платформе 1С Предприятие 8.3. Эти объекты предназначены для хранения статической или медленно меняющейся информации, такой как курсы валют, дополнительные свойства номенклатуры или справочные данные, которые не требуют проведения документов. Однако часто возникают ситуации, когда стандартного интерактивного заполнения недостаточно, и требуется автоматическое создание записей непосредственно из программного кода.

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

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

Архитектура регистров сведений и типы записей

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

Существует два основных типа регистров сведений: периодические и непериодические. Для периодических регистров ключом записи является комбинация измерений и даты (периода). Это позволяет хранить историю изменений, создавая "срезы" данных на определенный момент времени. Программная запись в такой регистр требует обязательного указания поля Период.

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

⚠️ Внимание: При работе с периодическими регистрами всегда проверяйте, не существует ли уже запись с таким же периодом и теми же измерениями, чтобы избежать дублирования или непреднамеренного перекрытия исторических данных.

Использование МенеджераЗаписи для управления данными

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

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

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

// Получение менеджера записи
МенеджерЗаписи = РегистрыСведений.КурсыВалют.СоздатьМенеджерЗаписи();

// Создание новой записи
НоваяЗапись = МенеджерЗаписи.Создать();
НоваяЗапись.Валюта = Справочники.Валюты.НайтиПоНаименованию("Доллар США");
НоваяЗапись.Период = ТекущаяДата();
НоваяЗапись.Курс = 92.50;
НоваяЗапись.Кратность = 1;

// Сохранение в базу данных
НоваяЗапись.Записать();

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

Применение МенеджераСоздания для быстрой вставки

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

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

Однако у МенеджераСоздания есть ограничение: он не предназначен для сложной логики обновления "если есть — изменить, если нет — создать". Если запись уже существует, поведение может зависеть от настроек уникальности индексов базы данных, и в некоторых случаях возможна ошибка нарушения уникальности.

// Получение менеджера создания
МенеджерСоздания = РегистрыСведений.ДополнительныеРеквизиты.СоздатьМенеджерСоздания();

// Формирование структуры данных
СтруктураДанных = Новый Структура;
СтруктураДанных.Вставить("Номенклатура", СсылкаНаТовар);
СтруктураДанных.Вставить("Цвет", "Красный");
СтруктураДанных.Вставить("Размер", "L");

// Мгновенное создание записи
МенеджерСоздания.Создать(СтруктураДанных);

В чем техническая разница методов?

МенеджерЗаписи загружает объект в оперативную память со всеми свойствами, что позволяет читать старые значения. МенеджерСоздания сразу формирует SQL-инструкцию INSERT, минуя этап загрузки существующих данных, что экономит ресурсы сервера.

Обработка ошибок и контроль уникальности ключей

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

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

Также полезно перед записью выполнять предварительную проверку существования записи с помощью запроса. Хотя это создает дополнительную нагрузку на СУБД, в некоторых сценариях это оправдано, чтобы избежать дорогостоящих откатов транзакций при ошибках.

Метод проверки	Производительность	Надежность	Рекомендуемый сценарий
Попытка...Исключение	Высокая (при отсутствии ошибок)	Высокая	Массовая загрузка, редкие коллизии
Предварительный запрос	Средняя (доп. запрос к БД)	Высокая	Точечное обновление, частые коллизии
МенеджерСоздания	Очень высокая	Средняя (риск ошибки)	Гарантированно новые данные

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

Особенности работы с периодическими регистрами

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

Важным аспектом является точность времени. В 1С Предприятие 8 период хранится с точностью до секунды. При формировании среза данных ("Первые", "Последние") система использует это значение для определения актуальности записи. Ошибка в несколько секунд может привести к тому, что документ попадет в другой срез и данные не будут найдены.

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

⚠️ Внимание: При записи в периодический регистр убедитесь, что часовой пояс сервера и время в объекте записи синхронизированы, иначе возможны расхождения при получении срезов данных в отчетах.

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

Оптимизация производительности при массовой загрузке

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

Оптимальным решением в таких случаях является использование объекта НаборЗаписей. Этот объект позволяет сформировать в оперативной памяти пакет из множества записей и сохранить их одним вызовом метода Записать. Это существенно сокращает количество сетевых взаимодействий между клиентом и сервером, а также уменьшает нагрузку на СУБД.

При работе с НаборомЗаписей важно правильно отфильтровать данные перед загрузкой, если вы планируете обновление, или просто добавлять новые строки в коллекцию. После заполнения набора вызов метода записи выполняет массовую вставку (Bulk Insert), что является наиболее быстрым способом.

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

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

// Массовая запись всех данных
Набор.Записать();

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

Лимиты набора записей

Хотя НаборЗаписей эффективен, избегайте формирования слишком огромных массивов (миллионы строк) в одном объекте, так как это может привести к исчерпанию оперативной памяти сервера 1С. Разбивайте большие объемы на пакеты по 10-50 тысяч записей.

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

Можно ли добавить запись в регистр сведений без указания периода?

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

Что произойдет, если записать запись с тем же ключом, что уже есть в базе?

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

Как удалить программно созданную запись из регистра сведений?

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

Влияет ли проведение документа на записи в регистре сведений?

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

Можно ли использовать запрос для вставки данных вместо методов объекта?

Да, в серверном коде можно выполнить запрос языка 1С с конструкцией ВЫБРАТЬ... ПОМЕСТИТЬ во временную таблицу, а затем использовать оператор ИЗ для вставки напрямую в таблицу регистра. Это низкоуровневый метод, который требует глубокого знания структуры таблиц базы данных и используется для экстремальной оптимизации.