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

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

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

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

Архитектура регистра сведений и его назначение

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

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

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

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

Подготовка объекта записи и заполнение полей

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

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

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

Рассмотрим пример заполнения для регистра "КурсыВалют", где измерением является "Валюта", а ресурсом — "Курс".

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

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

Алгоритм непосредственной записи данных

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

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

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

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

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

// Заполнение набора в цикле
Для Каждого Эл Из СписокВалют Цикл
НоваяЗапись = Набор.Добавить();
НоваяЗапись.Валюта = Эл.Валюта;
НоваяЗапись.Курс = Эл.НовыйКурс;
КонецЦикла;

Набор.Записать();

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

Работа с периодичностью и срезами данных

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

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

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

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

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

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

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

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

Сравнение методов записи: прямая vs через документ

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

В таблице ниже приведено сравнение основных характеристик двух подходов:

Характеристика	Прямая запись (МенеджерЗаписи)	Запись через Документ
Гибкость управления	Высокая. Можно писать в любой момент.	Низкая. Привязана к проведению документа.
Целостность данных	Требует ручной реализации транзакций.	Автоматическая. Связь с документом.
Удаление данных	Нужно писать код удаления явно.	Автоматически при отмене проведения.
Производительность	Выше при массовых операциях.	Ниже из-за накладных расходов документа.

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

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

Когда речь заходит о загрузке тысяч или миллионов записей (например, при импорте исторических данных или синхронизации с внешними системами), эффективность кода выходит на первый план. Основной враг производительности в 1С — это лишние обращения к базе данных.

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

Еще один прием — использование временных таблиц. Вы можете выгрузить данные из внешнего источника во временную таблицу, а затем одним движением скопировать их в регистр сведений, используя запрос с конструкцией ПОМЕСТИТЬ или специализированные методы конвертации данных. Это переносит нагрузку на сервер СУБД, который справляется с такими задачами гораздо эффективнее, чем скрипт 1С.

Секрет быстрой загрузки

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

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

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

Даже опытные разработчики иногда допускают ошибки при работе с регистрами. Одна из самых распространенных — попытка записать значение типа, несовместимого с типом ресурса. Платформа 1С строго типизирована, и неявное преобразование работает не всегда. Например, попытка записать строку в числовое поле вызовет исключение.

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

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

Можно ли записать в регистр сведений данные задним числом?

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

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

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

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

Нет, не нужно. Независимые регистры сведений не привязаны к документам. Вы можете вызывать метод Записать() напрямую из любого места кода: модуля формы, общего модуля или регламентного задания.

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

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

Влияет ли запись в регистр сведений на итоги регистров накопления?

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