Типы встроенного языка, порождаемые элементом проекта вида «РегистрСведений»

После того как вы добавили в проект регистр сведений и дали ему имя, создаст несколько типов встроенного языка. Например, для регистра сведений с именем Цены будут созданы следующие типы:

  • Цены
  • Цены.КлючЗаписи
  • Цены.Запись
  • Цены.НаборЗаписей
  • Цены.КлючИзмерений
  • Цены.КлючОсновногоОтбора

В общем случае имена этих типов выглядят следующим образом:

  • имя-регистра-сведений
  • имя-регистра-сведений.КлючЗаписи
  • имя-регистра-сведений.Запись
  • имя-регистра-сведений.НаборЗаписей
  • имя-регистра-сведений.КлючИзмерений
  • имя-регистра-сведений.КлючОсновногоОтбора

Тип «имя-регистра-сведений»

Это тип-одиночка.

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

Также он позволяет пересчитать разрешения доступа: ПересчитатьРазрешенияДоступа, ПересчитатьРазрешенияДоступаДляОбъектов (подробнее).

Этот тип не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа:

// Получить менеджера регистра «Цены»
пер МенеджерРегистра = Цены

// Пересчитать разрешения доступа для регистра «Цены»
Цены.ПересчитатьРазрешенияДоступа()

Модуль регистра сведений

В проекте модуль, расширяющий тип имя-регистра-сведений, называется модулем регистра сведений.

В этом модуле вы можете обработать события вычисления разрешений доступа: ВычислитьРазрешенияДоступа, ВычислитьРазрешенияДоступаДляОбъектов, ВычислитьКлючиДоступаДляЧтения и ВычислитьКлючиДоступаДляИзменения (подробнее).

Совет: В модуле регистра сведений может находиться реализация контракта сервиса.

Тип «имя-регистра-сведений.КлючЗаписи»

Тип имя-регистра-сведений.КлючЗаписи доступен и на клиенте, и на сервере. Он предназначен для указания на какую-то конкретную запись регистра.

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

Модуль ключа записи

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

Тип «имя-регистра-сведений.КлючОсновногоОтбора»

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

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

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

Данный тип используется в программном интерфейсе для работы с изменениями данных регистров сведений.

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

Тип «имя-регистра-сведений.Запись»

Тип имя-регистра-сведений.Запись доступен на сервере.

Он содержит данные одной записи и предназначен для создания, изменения или удаления одной записи.

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

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

Модуль записи

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

Совет: В модуле записи может находиться реализация методов контракта типа.

Тип «имя-регистра-сведений.НаборЗаписей»

Тип имя-регистра-сведений.НаборЗаписей доступен на сервере.

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

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

Модуль набора записей

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

В нем вы можете обработать такие события как:

  • ПередЗаписью
  • ПослеЗаписи

Во время записи набора записей открывает в базе данных транзакцию записи и события вызываются следующим образом:

Тип «имя-регистра-сведений.КлючИзмерений»

Тип имя-регистра-сведений.КлючИзмерений существует только у периодических регистров сведений и доступен на сервере.

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

Экземпляры этого типа передает в обработчик события ВычислитьКлючиДоступаДляЧтения (подробнее).

Тип «РегистрыСведений»

Независимо от того, есть в проекте регистры сведений или нет, во встроенном языке существует тип РегистрыСведений. Он предназначен для обхода всех регистров сведений и вызова пересчета разрешений доступа (подробнее), например:
для Регистр из РегистрыСведений
    Регистр.ПересчитатьРазрешенияДоступа()
;
Этот тип не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа.