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

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

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

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

Основные методы доступа к данным регистра

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

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

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

• 🔍 Метод Получить идеален для точечного изменения одной записи по известному ключу.
• ⚙️ Использование Выбрать необходимо при пакетной обработке данных по отбору.
• 🛡️ Всегда проверяйте результат получения объекта перед попыткой записи изменений.

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

Алгоритм изменения существующей записи

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

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

Финальным шагом является вызов метода Записать. Именно в этот момент платформа генерирует SQL-команду обновления для СУБД. Если в процессе работы с объектом были изменены ключевые поля (что возможно только при создании новой записи через СоздатьМенеджерЗаписи), система автоматически выполнит операцию вставки или обновления в зависимости от контекста.

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

Если Запись <> Неопределено Тогда
Запись.Курс = НовыйКурс;
Запись.Записать();
КонецЕсли;

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

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

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

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

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

Что такое срез последних?

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

Обработка конфликтов и блокировок

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

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

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

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

Использование запросов для массового обновления

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

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

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

ТекстЗапроса = "
ИЗМЕНЕНИЕ
РегистрСведений.ЦеныНоменклатуры.Актуальность
УСТАНОВИТЬ
Актуальность = &НовоеЗначение
ГДЕ
Номенклатура = &Номенклатура";

Запрос = Новый Запрос(ТекстЗапроса);
Запрос.УстановитьПараметр("НовоеЗначение", Истина);
Запрос.УстановитьПараметр("Номенклатура", ВыбраннаяНоменклатура);
Запрос.Выполнить();

Подписки на события и контроль целостности

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

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

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

Можно ли изменить измерение у существующей записи?

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

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

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

Как откатить изменения, если запись уже выполнена?

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

Влияет ли режим совместимости на работу с регистрами?

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

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

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