Типы встроенного языка, порождаемые элементом проекта вида «РегистрСведений»
После того как вы добавили в проект регистр сведений и дали ему имя, создаст несколько типов встроенного языка. Например, для регистра сведений с именем Цены будут созданы следующие типы:
- Цены
- Цены.КлючЗаписи
- Цены.Запись
- Цены.НаборЗаписей
- Цены.КлючРазрешенийИзмерений
- Цены.КлючОсновногоФильтра
В общем случае имена этих типов выглядят следующим образом:
- имя-регистра-сведений
- имя-регистра-сведений.КлючЗаписи
- имя-регистра-сведений.Запись
- имя-регистра-сведений.НаборЗаписей
- имя-регистра-сведений.КлючРазрешенийИзмерений
- имя-регистра-сведений.КлючОсновногоФильтра
Тип «имя-регистра-сведений»
Это тип-одиночка.
Тип имя-регистра-сведений содержит методы, которые позволяют, например, блокировать записи по измерениям, указанным в ключе или фильтре.
Также он позволяет пересчитать разрешения доступа: ПересчитатьРазрешенияДоступа, ПересчитатьРазрешенияДоступаДляОбъектов (подробнее).
Этот тип не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа:
// Получить менеджера регистра «Цены»
пер МенеджерРегистра = Цены
// Пересчитать разрешения доступа для регистра «Цены»
Цены.ПересчитатьРазрешенияДоступа()
Модуль регистра сведений
В проекте модуль, расширяющий тип имя-регистра-сведений, называется модулем регистра сведений.
В этом модуле вы можете обработать события вычисления разрешений доступа: ВычислитьРазрешенияДоступа, ВычислитьРазрешенияДоступаДляОбъектов, ВычислитьКлючиДоступаДляЧтения и ВычислитьКлючиДоступаДляИзменения (подробнее).
Тип «имя-регистра-сведений.КлючЗаписи»
Тип имя-регистра-сведений.КлючЗаписи доступен и на клиенте, и на сервере. Он предназначен для указания на какую-то конкретную запись регистра.
Он имеет конструктор новый имя-регистра-сведений.КлючЗаписи(), который позволяет создать новый ключ записи по значениям всех измерений, и метод ЗагрузитьЗапись(), который есть только на сервере и позволяет получить запись (имя-регистра-сведений.Запись) из ключа (имя-регистра-сведений.КлючЗаписи).
Модуль ключа записи
В проекте модуль, расширяющий тип имя-регистра-сведений.КлючЗаписи, называется модулем ключа записи. Он исполняется и на клиенте, и на сервере.
Тип «имя-регистра-сведений.КлючОсновногоФильтра»
Тип имя-регистра-сведений.КлючОсновногоФильтра доступен только на сервере. Он представляет из себя структуру, описывающую ключ основного фильтра регистра сведений. В отличие от ключа регистра сведений, содержит только измерения, которые включены в основной фильтр. Для периодического регистра сведений также может содержать поле Период, если период включен в основной фильтр.
Присутствует как поле в таблице регистра сведений и таблице изменений данных регистра сведений. Это позволяет разработчику проекта удобно фильтровать изменения по данным регистра сведений.
Данный тип имеет конструктор новый имя-регистра-сведений.КлючОсновногоФильтра(), который позволяет создать новый ключ основного фильтра по значениям всех измерений, включенных в основной фильтр.
Данный тип используется в программном интерфейсе для работы с изменениями данных регистров сведений.
Тип имя-регистра-сведений.КлючОсновногоФильтра формируется по элементу проекта всегда, даже если регистр сведений не включен в состав плана обмена или нет измерений, включаемых в основной фильтр.
Тип «имя-регистра-сведений.Запись»
Тип имя-регистра-сведений.Запись доступен на клиенте и сервере.
Он содержит данные одной записи и предназначен для создания, изменения или удаления одной записи.
Он имеет несколько конструкторов новый имя-регистра-сведений.Запись(), которые позволяют создать новую запись. Заполнив эту запись данными, вы можете затем сохранить ее в базе данных.
При записи данных вызываются события типа имя-регистра-сведений.НаборЗаписей, поскольку перед записью автоматически трансформирует эту запись в набор записей, содержащий одну запись и необходимый для этого фильтр.
Модуль записи
В проекте модуль, расширяющий тип имя-регистра-сведений.Запись, называется модулем записи. Он исполняется на сервере.
В нем вы можете обработать такие события, как:
- ПриЗаполнении,
- ПриКопировании.
Тип «имя-регистра-сведений.НаборЗаписей»
Тип имя-регистра-сведений.НаборЗаписей доступен на сервере.
Он содержит данные нескольких записей и предназначен для их создания, изменения или удаления в соответствии с некоторым фильтром.
Он имеет конструктор новый имя-регистра-сведений.НаборЗаписей(), который позволяет создать пустой набор. Заполнив этот набор записями, вы можете затем сохранить их все в базе данных. Также вы можете прочитать в пустой набор те записи из базы данных, которые соответствуют фильтру, установленному в пустом наборе записей.
Модуль набора записей
В проекте модуль, расширяющий тип имя-регистра-сведений.НаборЗаписей, называется модулем набора записей. Он исполняется на сервере.
В нем вы можете обработать такие события, как:
- ПередЗаписью,
- ПослеЗаписи.
@Обработчик
метод ПередЗаписью(Замещать: Булево,
ПараметрыЗаписи: МойРегистрСведений.ПараметрыЗаписи)
// Действия, которые выполняются перед записью
// набора записей регистра сведений
;
Во время записи набора записей открывает в базе данных транзакцию записи и вызывает следующие события:
Тип «имя-регистра-сведений.КлючРазрешенийИзмерений»
Тип имя-регистра-сведений.КлючРазрешенийИзмерений доступен на сервере и порождается только в том случае, если регистр периодический и используется разрешение РазрешенияВычисляютсяДляКаждогоОбъекта.
Он указывает на группу записей с одинаковыми значениями измерений, указанных в настройке РасчетРазрешенийПо. Такие группы записей нужны в системе прав доступа для установки права Чтение на записи периодического регистра сведений.
Экземпляры этого типа передает в обработчик события ВычислитьКлючиДоступаДляЧтения. Для вычисления ключей доступа на чтение в тип имя-регистра-сведений.КлючРазрешенийИзмерений записывается только подмножество измерений, указанных в свойстве РасчетРазрешенийПо (подробнее).
- в качестве параметра указать объект типа ДанныеРасчетаРазрешений:
метод КонструкторИзДанныхРасчетаРазрешений() // Создаем новую запись регистра сведений КурсыВалют // и заполняем ее поля пер НоваяЗапись = новый КурсыВалют.Запись( Валюта = "RUB", // измерение, которое используется для расчета разрешений Курс = 100, Кратность = 1 ) // Создаем экземпляр типа ДанныеРасчетаРазрешений по записи НоваяЗапись пер ДанныеРасчетаРазрешений = новый КурсыВалют.ДанныеРасчетаРазрешений(НоваяЗапись) // Создаем экземпляр типа КлючРазрешенийИзмерений, // который содержит измерения, указанные в настройке РасчетРазрешенийПо пер КлючРазрешенийИзмерений = новый КурсыВалют.КлючРазрешенийИзмерений(ДанныеРасчетаРазрешений) пер ИзмерениеНовойЗаписи = КлючРазрешенийИзмерений.Валюта // "RUB" ;
- в качестве параметра указать запись регистра сведений
имя-регистра-сведений.Запись:
метод КонструкторИзЗаписи() // Создаем новую запись регистра сведений КурсыВалют // и заполняем ее поля пер НоваяЗапись = новый КурсыВалют.Запись( Валюта = "RUB", // измерение, которое используется для расчета разрешений Курс = 100, Кратность = 1 ) // Создаем экземпляр типа КлючРазрешенийИзмерений по записи НоваяЗапись; // КлючРазрешенийИзмерений содержит измерения, указанные в настройке РасчетРазрешенийПо пер КлючРазрешенийИзмерений = новый КурсыВалют.КлючРазрешенийИзмерений(НоваяЗапись) пер ИзмерениеНовойЗаписи = КлючРазрешенийИзмерений.Валюта // "RUB" ;
- в качестве параметра указать ключ записи регистра сведений
имя-регистра-сведений.КлючЗаписи:
метод КонструкторИзКлючаЗаписи() // Создаем новую запись регистра сведений КурсыВалют // и заполняем ее поля пер НоваяЗапись = новый КурсыВалют.Запись( Валюта = "RUB", // измерение, которое используется для расчета разрешений Курс = 100, Кратность = 1 ) // Создаем экземпляр типа КлючРазрешенийИзмерений по ключу записи НоваяЗапись; // КлючРазрешенийИзмерений содержит измерения, указанные в настройке РасчетРазрешенийПо пер КлючРазрешенийИзмерений = новый КурсыВалют.КлючРазрешенийИзмерений(НоваяЗапись.КлючЗаписи) пер ИзмерениеНовойЗаписи = КлючРазрешенийИзмерений.Валюта // "RUB" ;
Тип «РегистрыСведений»
для Регистр из РегистрыСведений
Регистр.ПересчитатьРазрешенияДоступа()
;
Этот тип не имеет конструктора и имеет единственный экземпляр, обращение к
которому выполняется по имени типа.