К статье
Практический материал

Другое · 7 мин

Программная запись в регистр сведений в 1С: пошаговая инструкция

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

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

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

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

Когда программная запись в регистр сведений оправдана

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

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

Измерения, ресурсы и атрибуты регистра

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

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

Периодический и непериодичный регистр

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

Порядок записи в регистр сведений
  1. 1
    Открыть менеджер записи нужного регистра сведений
  2. 2
    Заполнить период, если регистр периодический
  3. 3
    Задать значения всех измерений
  4. 4
    Заполнить ресурсы и атрибуты
  5. 5
    Выполнить метод записи
  6. 6
    Проверить результат чтением регистра

Создание менеджера записи и заполнение полей

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

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

Режимы записи и контроль уникальности

Режим записи определяет, разрешена ли регистрация изменений в данный момент. Можно использовать запрет, разрешение или настройки, заданные в самом регистре. Неправильный режим может привести к ошибке записи или к игнорированию попытки изменения.

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

Контрольные точки

Как проверить результат записи

Отбор по измерениям и периоду
Норма

Найдена запись с ожидаемыми значениями ресурсов

Тревожный признак

Запись отсутствует или значения не совпадают

Права доступа пользователя
Норма

Запись выполнена без ошибок

Тревожный признак

Ошибка доступа или запрет регистрации

Уникальность измерений
Норма

Нет дублей ключевых полей

Тревожный признак

Попытка создать дублирующую строку

Проверка результата и чтение данных

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

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

Типичные ошибки
01
Игнорирование уникальности измерений: попытка создать дублирующую запись
02
Запись в периодический регистр без указания периода: данные не попадают в отчёты на дату
03
Изменение измерений вместо ресурсов: нарушается ключ регистра и связь с данными
04
Массовая запись без транзакции: риск частичного сохранения при прерывании

Частые ошибки и ограничения

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

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

Сравнение вариантов хранения

Регистр сведений

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

Константа

Удобна для одного значения настройки, не подходит для истории и множества строк.

Документ

Необходим, когда данные должны формировать движения и участвовать в учёте.

Альтернативы и границы самостоятельной работы

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

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

Итог

Что важно запомнить

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

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

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

Что делать, если запись не сохраняется без ошибки?

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

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

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

Нужна ли транзакция при массовой записи?

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