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

Другое · 9 мин

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

Как программно добавить записи в независимый регистр сведений в 1С: порядок действий, проверка измерений, массовая запись и частые ошибки.

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

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

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

Что представляет собой независимый регистр сведений

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

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

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

Способы добавления записей программно

Основной объект для записи — менеджер записи независимого регистра сведений. В модуле приложения создаётся экземпляр менеджера, заполняются его свойства: измерения, ресурсы, атрибуты, период, а затем вызывается метод записи. Такой подход даёт полный контроль над данными и позволяет встроить запись в логику документа или обработки.

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

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

Пошаговый порядок добавления одной записи

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

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

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

Проверка уникальности и обработка ошибок

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

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

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

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

Массовое добавление через набор записей

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

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

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

Отличие от зависимого регистра и ограничения

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

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

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

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

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

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

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

Открыть форму или отчёт по регистру с теми же измерениями
Норма

Появилась новая строка с ожидаемыми ресурсами и атрибутами

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

Строка отсутствует или появилось сообщение об ошибке уникальности

Повторить запись с теми же ключом и периодом
Норма

Система отказывает из-за дубликата ключа

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

Создаётся вторая одинаковая запись, что нарушает структуру

Проверить журнал регистрации после записи
Норма

Запись зафиксирована без предупреждений

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

Есть ошибки доступа, блокировки или несоответствия типов

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

Безопасная самостоятельная работа и альтернативы

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

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

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

Итог

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

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

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

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

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

Что делать, если система отказывает в записи из-за дубликата ключа?

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

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

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

Нужно ли оборачивать запись в транзакцию?

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