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

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

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

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

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

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

Это дает гибкость, но накладывает ответственность на программиста. Вы должны сами определить момент создания или изменения записи. Это может быть обработка события формы, таймер или специализированная обработка. Отсутствие поля «Регистратор» в структуре таблицы базы данных экономит место, но усложняет аудит изменений.

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

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

Использование объекта РегистрСведений.СоздатьМенеджерЗаписи

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

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

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

Метод Записать финализирует операцию. Он проверяет уникальность ключа (измерения + период) и либо обновляет существующую строку, либо вставляет новую. Важно корректно заполнять все ключевые поля перед вызовом записи, иначе платформа выдаст ошибку нарушения уникальности или ссылочной целостности.

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

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

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

• 🚀 Создается новый объект набора записей для конкретного регистра.
• 📝 В цикле создаются новые элементы набора, им присваиваются значения измерений и ресурсов.
• 💾 Метод Записать() вызывается один раз после формирования всего списка.

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

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

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

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

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

Особенности работы с периодичностью

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

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

В режимах «Внутри периода» и «По дню» система контролирует уникальность связки «Измерения + Период». Вы можете хранить историю изменений. Однако при получении среза последних значений (РегистрСведений.ПолучитьСрезПоследних) система вернет запись с максимальным периодом, меньшим или равным запрошенной дате.

Режим периодичности	Уникальность ключа	Поведение при записи	Пример использования
Неопределенная	Только измерения	Обновление существующей	Константы, настройки
Внутри периода	Измерения + Период	Добавление новой строки	Курсы валют, цены
По дню	Измерения + День	Добавление новой строки	Ежедневные остатки
По секунде	Измерения + Время	Добавление новой строки	Логи событий, телеметрия

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

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

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

Пример обработки блокировки

В цикле делается попытка записать данные. Если возникает ошибка блокировки, скрипт ждет случайное время (например, 100-500 мс) и повторяет попытку. Количество повторений ограничено, чтобы избежать бесконечного цикла.

Также стоит помнить о транзакциях. Если запись в регистр является частью сложного бизнес-процесса (например, обновление цен и пересчет итогов), все операции должны быть обернуты в транзакцию НачатьТранзакцию() и ЗафиксироватьТранзакцию(). Это гарантирует целостность данных: либо выполнится всё, либо ничего.

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

Оптимизация и лучшие практики

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

Избегайте записи данных «в прошлое», если это не требуется бизнес-логикой. Частое изменение исторических записей в режимах периодичности «По дню» или «По секунде» может требовать перестройки служебных таблиц системы. Лучше добавлять новые записи с актуальной датой, чем менять старые.

• ⚡ Используйте отборы в наборах записей для точечного обновления, а не полного перезаписывания регистра.
• 🗑️ Регулярно удаляйте устаревшие данные, если они не нужны для ретроспективного анализа, используя обработку удаления движений.
• 🔍 Проверяйте наличие записи перед записью только если логика обновления сложная; в простых случаях доверяйте методу Записать().

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

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

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

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

Поведение зависит от периодичности. Если периодичность «Неопределенная», запись обновится. Если периодичность зависит от времени (день, секунда), и ключи полностью совпадают, произойдет обновление существующей строки. Уникальность обеспечивается по всем измерениям и периоду.

Как очистить независимый регистр сведений программно?

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

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

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

Влияет ли запись в регистр сведений на скорость работы 1С?

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