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