Другое · 7 мин
Как программно изменить запись регистра сведений в 1С:Предприятие
Как программно найти и изменить запись регистра сведений в 1С: алгоритм поиска по измерениям, обновление полей, проверка результата и ограничения.
Регистр сведений в 1С:Предприятии предназначен для хранения произвольных данных, связанных с набором измерений и ресурсами. Каждая запись идентифицируется значениями измерений, а изменение ресурсных или атрибутивных полей выполняется программно в модулях объекта, формы или общего модуля.
Чтобы изменить существующую запись, приложение должно сначала найти её по значениям измерений, затем заполнить поля, которые требуется обновить, и вызвать метод записи. Если запись с таким набором измерений отсутствует, попытка изменения не создаст новую строку автоматически — потребуется отдельная логика создания.
Программное изменение оправдано, когда данные корректируются по результатам расчёта, импорта или пользовательского действия, а также при необходимости массовой переоценки показателей без открытия интерфейса справочника или документа.
Когда программное изменение записи уместно
Изменение регистра сведений через код имеет смысл, если корректировка должна выполняться автоматически, без участия пользователя, или как часть бизнес-процесса в документе. Типичные ситуации: пересчёт показателей после проведения документа, синхронизация данных при импорте, обновление флагов готовности по результатам расчёта.
Перед началом работы важно убедиться, что период не закрыт, нет запрета на редактирование и у текущего пользователя достаточно прав. В противном случае запись может не сохраниться, а программа выдаст ошибку или промолчит в зависимости от настроек обработки исключений.
Также нужно чётко понимать, какие поля являются измерениями, а какие — ресурсами или атрибутами. Измерения определяют уникальность строки, поэтому их значения обычно не меняют «на месте»: для изменения измерения запись приходится удалять и создавать заново с новым ключом.
Способ получения менеджера записи и поиск строки
Поиск по измерениям через отбор
Для поиска существующей строки используется менеджер записи регистра сведений. В нём формируется отбор по значениям измерений, после чего выполняется чтение первой подходящей записи. Если отбор вернул несколько строк, нужно решить, какая именно подлежит изменению, иначе можно обновить не ту строку.
Порядок значений измерений в отборе должен совпадать со структурой регистра. Пропуск обязательного измерения или несоответствие типов приведёт к тому, что запись не будет найдена, даже если нужная строка существует в базе.
Создание менеджера записи
Менеджер записи получается через встроенный язык средствами конфигуратора. После получения менеджера программа устанавливает значения измерений, затем заполняет ресурсы и атрибуты, которые требуется обновить. Поля, не указанные в коде, сохраняют прежние значения.
Если менеджер записи создаётся для новой строки, а не для существующей, логика отличается: сначала проверяется отсутствие записи с таким ключом, и только затем выполняется создание. Смешивание этих двух сценариев в одном блоке кода часто становится причиной дублирования или потери данных.
Алгоритм изменения существующей записи
Базовый алгоритм состоит из трёх шагов: найти запись по измерениям, изменить поля ресурсов или атрибутов, сохранить результат. На этапе поиска важно обработать случай, когда запись отсутствует, чтобы программа не попыталась изменить пустую ссылку.
После заполнения полей вызывается метод записи менеджера. Если метод завершается без исключений, изменения фиксируются в базе. Рекомендуется сразу после записи выполнить повторную выборку той же строки и сравнить значения, чтобы убедиться, что обновление применено.
В транзакционных процессах изменение регистра может быть включено в общую транзакцию документа или операции. Тогда откат операции отменит и изменение регистра. Это нужно учитывать при проектировании, чтобы не оставить данные в противоречивом состоянии.
МенеджерЗаписи = РегистрыСведений.ИмяРегистра.СоздатьМенеджерЗаписи(); МенеджерЗаписи.Записать();Пример кода на встроенном языке 1С
Ниже приведён схематический фрагмент, показывающий общую структуру без привязки к конкретному имени регистра. Реальные имена измерений, ресурсов и регистра подставляются из конфигурации.
МенеджерЗаписи = РегистрыСведений.ИмяРегистра.СоздатьМенеджерЗаписи();
МенеджерЗаписи.Измерение1 = ЗначениеИзмерения1;
МенеджерЗаписи.Измерение2 = ЗначениеИзмерения2;
Если МенеджерЗаписи.Прочитать() Тогда
МенеджерЗаписи.Ресурс1 = НовоеЗначение;
МенеджерЗаписи.Записать();
Иначе
// Запись не найдена: требуется отдельная обработка создания
КонецЕсли;
В реальном коде вместо «ИмяРегистра» указывается имя, заданное в конфигураторе, а поля подбираются из состава регистра. Если регистр измеряется по ссылке на справочник или документ, в измерение передаётся именно ссылка, а не строковое представление.
- 1Получить менеджер записи регистра сведений
- 2Установить отбор по измерениям и прочитать строку
- 3Изменить значения ресурсов или атрибутов
- 4Вызвать метод записи менеджера
- 5Повторно прочитать запись и сравнить значения
Проверка результата и границы безопасной работы
Результат считается успешным, если после вызова метода записи повторная выборка той же строки возвращает обновлённые значения. Если значения остались прежними, без ошибки, возможно, запись не была найдена или изменения откатились при завершении транзакции.
Безопасная самостоятельная работа допустима на тестовой базе или в копии информационной базы. На рабочей базе программное изменение регистров лучше выполнять после резервного копирования и в часы минимальной нагрузки, чтобы не прервать работу других пользователей.
Как проверить результат
Значения полей соответствуют заданным в коде
Значения не изменились или запись не найдена
Метод завершился без ошибки
Возникло исключение или запись откатилась
Не рекомендуется изменять регистры сведений напрямую средствами СУБД, минуя встроенный язык 1С. Это нарушает целостность данных, может повредить индексы и привести к некорректной работе конфигурации.
Типичные ошибки и ограничения
Одна из частых ошибок — попытка изменить измерение существующей записи. Изменение ключевых полей через менеджер записи не приведёт к перемещ строки в другой ключ; для этого нужно удалить старую запись и создать новую с другим набором измерений.
Другая ошибка — игнорирование закрытых периодов. Если период закрыт, запись может быть защищена от редактирования, и программа либо откажет в сохранении, либо сохранит данные с нарушением бухгалтерской логики, что потребует последующей корректировки.
Также не стоит полагаться на неявное создание записи при изменении. Если строки с заданными измерениями нет, код должен явно обрабатывать этот случай: либо создавать новую запись, либо сообщать об отсутствии цели для обновления.
Что важно запомнить
Изменение записи регистра сведений требует поиска по измерениям, обновления полей и явного вызова записи; отсутствие строки, закрытый период или ошибка в измерениях делают изменение невозможным без дополнительной логики.
Часто задаваемые вопросы
Можно ли изменить измерение уже существующей записи?
Измерение определяет уникальность строки, поэтому его значение не меняется «на месте». Для смены измерения существующую запись удаляют и создают новую с другим набором измерений, перенося при этом нужные ресурсы и атрибуты.
Что делать, если запись с нужными измерениями не найдена?
Метод изменения не создаёт запись автоматически. Нужно явно проверить результат чтения, и если строка отсутствует, выполнить создание новой записи через менеджер записи или сообщить пользователю о невозможности обновления.
Безопасно ли менять регистры сведений на рабочей базе?
На рабочей базе изменения лучше выполнять после резервного копирования, в период низкой нагрузки и с предварительной проверкой на тестовой копии. Прямое изменение данных средствами СУБД минуя встроенный язык 1С недопустимо.
Нужно ли закрывать период перед программным изменением?
Наоборот, период не должен быть закрыт, иначе запись может быть защищена от редактирования. Перед кодом целесообразно проверять доступность периода и права текущего пользователя.