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

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

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

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

Архитектура работы с наборами записей

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

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

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

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

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

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

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

• 🔍 Создайте объект набора записей через конструктор регистра.
• 📝 Установите необходимые отборы по ключевым полям или измерениям.
• 💾 Вызовите метод Прочитать() для загрузки актуальных данных.
• ✏️ Измените значения требуемых реквизитов в найденных строках.

Ключевым моментом здесь является финальный этап — сохранение. Для этого используется метод Записать(). Именно он формирует SQL-запросы к базе данных и фиксирует транзакцию. Если забыть вызвать этот метод, все ваши манипуляции с переменными будут утеряны сразу после завершения процедуры.

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

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

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

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

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

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

Режимы записи

В 1С существует несколько режимов записи наборов записей. Режим Запись позволяет обновлять существующие записи или добавлять новые. Режим Удаление удаляет записи, соответствующие отбору. Режим Выборка только читает данные без права изменения.

Удаление данных из регистра сведений

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

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

Метод	Описание действия	Производительность
Записать()	Обновляет или добавляет записи в наборе	Средняя
Удалить()	Удаляет записи, отобранные фильтром	Высокая
Прочитать()	Только загрузка данных в память	Зависит от объема

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

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

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

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

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

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

Оптимизация и обработка ошибок

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

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

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

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

Транзакции

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

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

Как изменить запись, если я не знаю её точный идентификатор?

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

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

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

Что произойдет, если не вызвать метод Записать()?

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

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

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