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

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

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

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

Особенности независимых регистров сведений

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

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

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

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

Программное создание новой записи

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

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

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

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

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

Работа с периодичностью и срезами данных

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

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

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

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

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

Массовая загрузка данных в регистр

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

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

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

• 🚀 Производительность: Массовая запись в 10-50 раз быстрее построчной при объемах от 1000 строк.
• 🛡️ Целостность: Все записи добавляются в рамках одной транзакции, что гарантирует атомарность операции.
• 🔄 Гибкость: Возможность предварительной фильтрации данных перед отправкой в базу.

⚠️ Внимание: При использовании набора записей помните, что если в процессе заполнения произойдет ошибка скрипта, вся транзакция будет откатана. Убедитесь, что исходные данные прошли валидацию до начала формирования набора.

Удаление и модификация существующих записей

Часто задача "добавить запись" на самом деле подразумевает "обновить существующую или добавить новую". В платформе 1С нет метода Изменить() для регистра сведений в явном виде. Вместо этого используется паттерн: найти запись, изменить её поля и снова записать. Если запись не найдена — создается новая.

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

При удалении записей следует использовать метод Удалить() у объекта записи или массовое удаление через набор записей с флагом удаления. Физическое удаление данных из таблиц регистра происходит только после вызова соответствующего метода сохранения изменений набора.

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

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

Тонкости управляемых блокировок

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

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

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

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

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

• ⚠️ Конфликт блокировок: Возникает при одновременном доступе нескольких пользователей к одной записи.
• 📉 Переполнение: Ошибка при записи числовых значений, превышающих разрядность ресурса.
• 🔍 Отсутствие ссылки: Попытка записать ссылку на удаленный элемент справочника в измерение.

Грамотная обработка ошибок не только спасает от падений, но и помогает администратору понять причину сбоя через журнал регистрации событий.

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

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

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

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

Как проверить, замедляет ли регистр работу системы?

Используйте технологический журнал (ТЖ) платформы 1С. Отфильтруйте события по типу DBMSSQL или DBPostgreSQL и посмотрите на время выполнения запросов INSERT в таблицу регистра. Если время превышает средние значения, стоит проанализировать индексы и блокировки.

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

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

Что делать, если запись не сохраняется, но ошибок нет?

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

Влияет ли тип СУБД на скорость записи в регистр?

Да, MS SQL Server, PostgreSQL и Oracle имеют разные механизмы блокировок и логирования транзакций. На больших объемах данных разница в производительности может быть существенной, особенно при массовой вставке.