Перейти к основному содержимому

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ПриЗаполнении,
  • ПриКопировании.

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

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

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

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

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

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

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

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

Например:

@Обработчик
метод ПередЗаписью(Замещать: Булево,
                   ПараметрыЗаписи: МойРегистрСведений.ПараметрыЗаписи)
    // Действия, которые выполняются перед записью 
    // набора записей регистра сведений
;

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

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

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

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

Экземпляры этого типа «Шина» передает в обработчик события ВычислитьКлючиДоступаДляЧтения. Для вычисления ключей доступа на чтение в тип имя-регистра-сведений.КлючРазрешенийИзмерений записывается только подмножество измерений, указанных в свойстве РасчетРазрешенийПо (подробнее).

В коде объекты типа КлючРазрешенийИзмерений можно создать тремя способами:

  • в качестве параметра указать объект типа ДанныеРасчетаРазрешений:

    метод КонструкторИзДанныхРасчетаРазрешений()
        // Создаем новую запись регистра сведений КурсыВалют
        // и заполняем ее поля
        пер НоваяЗапись = новый КурсыВалют.Запись(
            Валюта = "RUB",   // измерение, которое используется для расчета разрешений
            Курс = 100,
            Кратность = 1
        )

        // Создаем экземпляр типа ДанныеРасчетаРазрешений по записи НоваяЗапись
        пер ДанныеРасчетаРазрешений = новый КурсыВалют.ДанныеРасчетаРазрешений(НоваяЗапись)

        // Создаем экземпляр типа КлючРазрешенийИзмерений,
        // который содержит измерения, указанные в настройке РасчетРазрешенийПо
        пер КлючРазрешенийИзмерений = новый КурсыВалют.КлючРазрешенийИзмерений(ДанныеРасчетаРазрешений)

        пер ИзмерениеНовойЗаписи = КлючРазрешенийИзмерений.Валюта   // "RUB"
    ;

  • в качестве параметра указать запись регистра сведений имя-регистра-сведений.Запись:

    метод КонструкторИзЗаписи()
        // Создаем новую запись регистра сведений КурсыВалют
        // и заполняем ее поля
        пер НоваяЗапись = новый КурсыВалют.Запись(
            Валюта = "RUB",   // измерение, которое используется для расчета разрешений
            Курс = 100,
            Кратность = 1
        )

        // Создаем экземпляр типа КлючРазрешенийИзмерений по записи НоваяЗапись;
        // КлючРазрешенийИзмерений содержит измерения, указанные в настройке РасчетРазрешенийПо
        пер КлючРазрешенийИзмерений = новый КурсыВалют.КлючРазрешенийИзмерений(НоваяЗапись)

        пер ИзмерениеНовойЗаписи = КлючРазрешенийИзмерений.Валюта   // "RUB"
    ;

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

    метод КонструкторИзКлючаЗаписи()
        // Создаем новую запись регистра сведений КурсыВалют
        // и заполняем ее поля
        пер НоваяЗапись = новый КурсыВалют.Запись(
            Валюта = "RUB",   // измерение, которое используется для расчета разрешений
            Курс = 100,
            Кратность = 1
        )

        // Создаем экземпляр типа КлючРазрешенийИзмерений по ключу записи НоваяЗапись;
        // КлючРазрешенийИзмерений содержит измерения, указанные в настройке РасчетРазрешенийПо
        пер КлючРазрешенийИзмерений = новый КурсыВалют.КлючРазрешенийИзмерений(НоваяЗапись.КлючЗаписи)

        пер ИзмерениеНовойЗаписи = КлючРазрешенийИзмерений.Валюта   // "RUB"
    ;

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

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

для Регистр из РегистрыСведений
    Регистр.ПересчитатьРазрешенияДоступа()
;

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

Последнее обновление