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

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

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

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

Объект ЗаписьРегистра и его свойства

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

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

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

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

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

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

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

Рассмотрим пример изменения цены товара. Нам нужно найти запись по конкретному товару и дате, а затем обновить значение resource «Цена».

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

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

Работа с выборками и массовое обновление

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

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

• 🔄 Открываем выборку с нужными отборами по измерениям.
• 📝 В цикле создаем новый объект записи на основе текущей строки выборки.
• 💾 Вызываем метод записи для каждого обновленного объекта.

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

Удаление записей и отмена проведения

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

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

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

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

Нюансы периодических регистров сведений

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

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

Параметр	Описание	Влияние на запись
Период	Время действия записи	Определяет позицию в истории
Измерения	Уникальный ключ	Группирует записи по сущностям
Актуальность	Флаг состояния	Влияет на выборку среза последних
Ресурсы	Хранимые данные	Меняются при обновлении

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

Оптимизация записи

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

Типичные ошибки и способы их устранения

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

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

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

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

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

FAQ по работе с регистрами сведений

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

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

Что произойдет, если записать запись с тем же периодом и измерениями?

Произойдет обновление существующей записи. Значения ресурсов будут перезаписаны новыми значениями из объекта ЗаписьРегистра.

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

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

В чем разница между Записать() и ЗаписатьЕслиИзменилось()?

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