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

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

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

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

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

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

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

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

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

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

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

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

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

НоваяЗапись = Набор.Добавить();
НоваяЗапись.Период = ТекущаяДата();
НоваяЗапись.Валюта = Справочники.Валюты.НайтиПоКоду("USD");
НоваяЗапись.Курс = 95.50;
НоваяЗапись.Кратность = 1;

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

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

Массовое обновление данных через ЗаписатьМассивом

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

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

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

• 🚀 Создание объекта набора записей без отборов для массовой операции.
• 📝 Заполнение коллекции строк в цикле по источнику данных.
• 💾 Единый вызов метода записи для всего массива.

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

Использование метода Заполнить для полной замены среза

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

Представьте ситуацию: у вас есть регистр, хранящий цены номенклатуры на каждый день. Поступил новый прайс-лист. Вам нужно удалить все старые цены на текущую дату и записать новые. Использование связки «Удалить + Записать» вручную потребовало бы двух проходов по базе. Метод Заполнить() делает это атомарно и эффективно.

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

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

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

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

⚠️ Внимание: Метод Заполнить() физически удаляет записи из таблицы перед вставкой новых. Это может вызвать срабатывание триггеров базы данных или нарушить ссылки, если на эти записи есть зависимости в других подсистемах, не защищенных транзакцией.

Очистка регистра и удаление записей

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

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

Если регистр сведений имеет режим периодичности «Внутридня», удаление записей за весь день может потребовать разбивки операции на более мелкие транзакции, чтобы не переполнить журнал транзакций СУБД. В таких случаях рекомендуется использовать обработки постепенной очистки.

Что происходит при удалении записи в 1С?

При вызове метода удаления платформа генерирует SQL-команду DELETE. Если удаление происходит в транзакции, данные физически не стираются с диска до фиксации транзакции, но становятся недоступны для других сеансов.

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

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

Метод	Назначение	Производительность	Влияние на старые записи
Записать()	Добавление или обновление одной/нескольких записей	Низкая (при цикле)	Обновляет существующие по ключу
ЗаписатьМассивом()	Пакетная вставка или обновление большого объема	Высокая	Обновляет существующие по ключу
Заполнить()	Полная замена среза данных	Средняя/Высокая	Удаляет старые и пишет новые
Удалить()	Стирание данных по отбору	Зависит от объема	Физическое удаление

Анализ таблицы показывает, что для оперативного изменения одного поля (например, коррекция курса) лучше подходит Записать(). Для nightly-процессов загрузки справочников незаменим ЗаписатьМассивом(). А для пересчета итогов или цен по новому алгоритму — Заполнить().

Обработка ошибок и транзакционная безопасность

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

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

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

⚠️ Внимание: Интерфейс и точные названия методов могут незначительно отличаться в разных версиях платформы 1С (8.3.10, 8.3.20, 8.3.25). Всегда сверяйте синтаксис в справке по конкретной версии вашей платформы, особенно при использовании новых функций оптимизации.

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

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

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

Что делать, если метод Записать() выдает ошибку «Нарушение уникальности»?

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

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

Самый быстрый способ — создать набор записей без отборов и вызвать метод Удалить(). Однако для больших регистров это может занять много времени и заблокировать таблицу. В таких случаях рекомендуется использовать обработку удаления данных по периодам или прямые SQL-запросы (с осторожностью и пониманием рисков).

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

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

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

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