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

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

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

Архитектура регистров сведений и понятие уникальности

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

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

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

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

Режимы записи: Различия между добавлением и заменой

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

Для выполнения перезаписи необходимо явно установить режим в значение РежимЗаписиРегистраСведений.Запись. В этом режиме платформа автоматически выполняет поиск записей с совпадающими измерениями (и периодом, если регистр периодический). Если такая запись найдена, её ресурсы обновляются значениями из нового набора. Если запись не найдена, она создается заново. Это наиболее безопасный и рекомендуемый способ обновления данных.

Существует также режим РежимЗаписиРегистраСведений.Подчинение, который используется в специфических сценариях, когда записи регистра сведений подчинены регистратору. Однако для стандартной задачи перезаписи произвольных данных он подходит редко. Использование режима Добавление при наличии дублей приведет к исключительной ситуации "Нарушение уникальности записи", что остановит выполнение кода и потребует обработки ошибок.

• 🔹 РежимЗапись — обновляет существующие записи или создает новые, если их нет.
• 🔹 РежимДобавление — создает только новые записи, вызывает ошибку при дублировании ключей.
• 🔹 РежимУдаление — удаляет записи, соответствующие измерениям в наборе, игнорируя значения ресурсов.

Алгоритм перезаписи данных на встроенном языке

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

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

Финальным этапом является вызов метода Записать(). В этот момент платформа формирует SQL-запрос к базе данных. Если режим записи установлен верно, старые данные будут затерты новыми. Ниже приведен пример корректной последовательности действий для типовой задачи обновления справочной информации.

Процедура ОбновитьКурсВалюты(Валюта, ДатаКурса, НовыйКурс)

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

// Создаем набор записей
НаборЗаписей = МенеджерРегистра.СоздатьНаборЗаписей();

// Устанавливаем режим записи для перезаписи существующих данных
НаборЗаписей.РежимЗаписи = РежимЗаписиРегистраСведений.Запись;

// Создаем новую запись в наборе
НоваяЗапись = НаборЗаписей.Добавить();

// Заполняем измерения (ключи)
НоваяЗапись.Валюта = Валюта;
НоваяЗапись.Период = ДатаКурса;

// Заполняем ресурсы (данные)
НоваяЗапись.Курс = НовыйКурс;
НоваяЗапись.Кратность = 1;

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

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

Обработка периодических и непериодических регистров

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

В периодических регистрах, например "ЦеныНоменклатуры", критически важен параметр времени. Если вы записываете данные с периодом 2023.10.01 12:00:00, а в базе уже есть запись с периодом 2023.10.01 12:00:01, система сочтет их разными записями. Для корректной перезаписи "текущего" состояния часто используют специальный метод получения конца периода или явно округляют время до секунд/минут, чтобы попасть в ту же временную точку.

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

Тип регистра	Ключевые измерения	Особенность перезаписи	Риск ошибки
Непериодический	Только основные	Полная замена по ключу	Низкий
Периодический	Основные + Период	Зависит от точности времени	Высокий (дубли по времени)
Подчиненный	Регистратор + Основные	Привязка к документу	Средний (ошибка регистратора)
Ведомственный	Владельцы + Основные	Контекст владельца	Средний (неверный владелец)

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

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

Вы можете наполнить один объект НаборЗаписей тысячами элементов и вызвать метод записи единожды. Платформа 1С:Предприятие оптимизирует этот процесс, формируя пакетные SQL-инструкции. Однако даже в этом случае существуют лимиты на размер пакета, зависящие от версии платформы и настроек сервера. Превышение лимита может привести к разрыву соединения или ошибке выполнения.

Еще одним важным аспектом является использование отборов. Если вам нужно перезаписать данные только для конкретного подразделения или склада, нет необходимости выгружать весь регистр в память. Используйте метод СоздатьНаборЗаписей() с параметром отбора или формируйте отбор программно перед добавлением записей. Это значительно уменьшает потребление оперативной памяти сервером 1С.

⚠️ Внимание: При массовой перезаписи в высоконагруженных системах (более 100 пользователей) возможно возникновение взаимоблокировок (deadlocks). Планируйте такие операции на ночное время или используйте механизмы фоновых заданий.

Типичные ошибки и способы их устранения

Наиболее распространенной ошибкой является попытка записать запись в режиме Добавление, когда она уже существует. Система выдаст сообщение об ошибке, и транзакция будет отклонена. Решение простое: всегда проверяйте логику или принудительно ставьте режим Запись. Вторая частая проблема — незаполненные измерения. Если измерение имеет тип "Справочник" и в него передано пустое значение, запись может не найтись или быть записана неверно.

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

Иногда возникает ситуация, когда запись вроде бы прошла успешно, но данные в базе не изменились. Это может быть связано с тем, что набор записей оказался пустым в момент записи, либо отборы были наложены неверно. Для диагностики используйте отладчик и проверяйте свойство Количество() у набора записей перед вызовом метода записи.

Что делать, если запись не обновляется?

Проверьте, не установлен ли режим "ТолькоЗапрос" у пользователя. Убедитесь, что тип данных в переменных совпадает с типом измерений регистра. Проверьте, не блокирует ли запись другой активный процесс.

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

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

Да, можно. В этом случае измерение "Регистратор" также должно быть заполнено в наборе записей. Обычно оно заполняется автоматически, если набор записей создан из объекта-документа, но при программной записи его нужно указать явно.

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

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

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

Если вы записываете данные с тем же самым периодом (до секунды), старая запись заменяется, и история в этой точке времени обновляется. Если период отличается, создается новая версия, и история сохраняется.

Что произойдет, если не заполнить ресурс при перезаписи?

Если ресурс не заполнен в новой записи, он примет значение по умолчанию для своего типа (0 для чисел, пустая строка для строк, null для ссылочных типов). Старое значение будет утеряно.