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

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

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

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

Основы работы с объектом записи

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

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

Рассмотрим базовый пример получения объекта записи для регистра с именем КурсыВалют:

Запись = РегистрыСведений.КурсыВалют.СоздатьЗапись;

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

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

Заполнение измерений и ресурсов

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

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

Процесс заполнения полей выглядит следующим образом:

• 📂 Установите значение измерения Валюта, выбрав необходимый элемент из справочника.
• 📅 Задайте период актуальности, если регистр является периодическим.

• 💰 Присвойте значение ресурсу Курс, введя числовое значение.
• 🏷️ Заполните дополнительные аналитические поля, если они предусмотрены структурой.

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

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

Особенности периодических регистров

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

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

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

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

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

Влияние точности периода

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

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

Методы фиксации данных в базе

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

Метод возвращает булево значение: Истина, если запись прошла успешно, и Ложь, если возникли ошибки или нарушения целостности данных. Рекомендуется всегда анализировать результат выполнения, чтобы гарантировать надежность работы приложения.

Метод	Описание действия	Возвращаемое значение
Записать	Фиксирует изменения в базе данных	Булево (Истина/Ложь)
ОтменитьЗапись	Удаляет запись из базы (если она уже была)	Нет
ПолучитьМенеджерЗаписи	Возвращает менеджер для пакетной обработки	МенеджерЗаписи

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

Если Не Запись.Записать Тогда
Сообщить("Ошибка при сохранении данных регистра!");
КонецЕсли;

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

Обработка ошибок и исключений

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

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

• 🚫 Ошибка типа значения: попытка записать строку в числовое поле.
• 🔒 Блокировка записи: данные заблокированы другим пользователем или процессом.
• 🔑 Нарушение уникальности: конфликт ключей в специфических настройках регистра.

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

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

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

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

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

Одним из эффективных методов является использование менеджера записей. Менеджер позволяет накапливать изменения в памяти и отправлять их в базу данных одним пакетом. Это снижает сетевой трафик и нагрузку на сервер баз данных.

Пример использования менеджера для пакетной записи:

Менеджер = РегистрыСведений.НастройкиПользователей.СоздатьМенеджерЗаписи;
//... цикл заполнения записей...
Менеджер.Записать;

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

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

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

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

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

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

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

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

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

В чем разница между независимым и подчиненным регистром при создании записи?

Главное отличие в наличии измерения"Владелец". В подчиненном регистре это измерение автоматически добавляется платформой и требует обязательного заполнения ссылкой на объект-владелец (справочник или документ). В независимом регистре такого требования нет.