Запись данных в регистр сведений подчиненный регистратору: полное руководство

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

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

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

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

Регистр сведений, подчиненный регистратору, отличается от независимого регистра тем, что одно из его измерений зарезервировано системой для хранения ссылки на объект-регистратор. Это измерение обычно имеет имя Регистратор и тип ДокументСсылка (или другой тип объекта, которому подчинен регистр). Такая архитектура гарантирует целостность данных: если документ будет удален, все связанные с ним записи в регистре также будут удалены автоматически благодаря механизму каскадного удаления.

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

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

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

Автоматическая запись при проведении документа

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

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

НаборЗаписей = РегистрыСведений.МойПодчиненныйРегистр.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Регистратор.Установить(Ссылка);

НоваяЗапись = НаборЗаписей.Добавить();
НоваяЗапись.Период = ТекущаяДата();
НоваяЗапись.Склад = ДокументОбъект.Склад;
НоваяЗапись.Количество = ДокументОбъект.Количество;
НоваяЗапись.Записать();

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

• 📌 Автоматическое заполнение измерения «Регистратор» происходит только при записи набора записей из модуля объекта-регистратора.
• 📌 При удалении документа все связанные записи в подчиненном регистре удаляются автоматически без дополнительного кода.
• 📌 Использование движений документа обеспечивает транзакционность: если проведение не удастся, записи в регистр не попадут.

Ручная запись данных вне контекста проведения

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

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

Критически важно соблюдать типизацию. Если регистр подчинен документу «ЗаказКлиента», то в поле Регистратор нельзя записать ссылку на «РеализациюТоваровУслуг», даже если их структуры похожи. Платформа строго контролирует соответствие типов на уровне ядра.

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

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

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

Особенности работы с периодичностью

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

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

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

Периодичность	Входит в ключ	Особенность поведения
Непериодический	Измерения + Регистратор	Ошибка при дублировании ключа
В пределах дня	Период (минуты) + Измерения	Хранит историю внутри суток
День	Период (день) + Измерения	Одна запись на день на комбинацию
Месяц	Период (месяц) + Измерения	Агрегация данных по месяцам

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

Обработка ошибок и блокировок

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

Для минимизации конфликтов рекомендуется использовать управляемые блокировки или оптимистическую блокировку при записи. Если вы используете метод Записать() в транзакции, убедитесь, что время жизни транзакции минимально. Длительные транзакции с открытыми записями в регистрах могут «положить» работу всего сервера 1С.

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

• 🛡️ Используйте конструкцию Попытка..Исключение для перехвата ошибок блокировки и реализации логики повторной попытки записи.
• 🛡️ Избегайте записи в подчиненный регистр из циклов с большим количеством итераций без разбивки на пакеты.
• 🛡️ Проверяйте свойство ПометкаУдаления у документа-регистратора перед созданием новой связанной записи.

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

Как снять блокировку вручную?

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

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

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

Для оптимизации следует использовать наборы записей (НаборЗаписейРегистраСведений). Вы создаете один набор, добавляете в него сотни или тысячи записей в цикле, и только один раз вызываете метод Записать() для всего набора. Это позволяет платформе сформировать один оптимальный SQL-запрос (или пакет запросов) и выполнить вставку данных максимально быстро.

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

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

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

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

Да, регистр сведений может быть подчинен не только документу, но и справочнику, плану счетов или плану видов характеристик. Логика работы при этом сохраняется: измерение «Регистратор» будет ссылаться на объект справочника, и при удалении элемента справочника записи в регистре также будут удалены.

Что произойдет, если изменить тип документа, которому подчинен регистр?

Изменение типа документа-регистратора в конфигураторе приведет к необходимости перепроведения всех документов этого типа. Структура таблицы регистра в БД изменится, и старые записи могут стать некорректными или недоступными. Рекомендуется избегать таких изменений в рабочей базе без тщательного тестирования миграции данных.

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

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

Можно ли отключить подчинение регистратору программно?

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

Влияет ли подчинение на скорость выборки данных?

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