894 1С:Предприятие 8.3. Практическое пособие разработчика

Контрольные вопросы

;; Как добавить в форму основной реквизит?

;; Как добавить элементы формы, связанные с данным реквизитом?

;; Как объединить элементы формы в группы?

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

;; Как добавить в форму табличную часть и выделить ее строки по условию?

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

;; Как сгруппировать данные в списке?

Краткий справочник разработчика

896 1С:Предприятие 8.3. Практическое пособие разработчика

Объекты встроенного языка для работы с прикладными данными

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

Менеджер информационных структур одного вида. Это такие объекты, как:

СправочникиМенеджер,ДокументыМенеджер,ОтчетыМенеджер,

ПланыСчетовМенеджер и т. д.

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

Например, менеджер справочников СправочникиМенеджер  – это коллекция значений, содержащая объекты Справоч-

никМенеджер.<имя>.

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

Менеджер конкретной информационной структуры. Это такие объекты, как:

СправочникМенеджер.Клиенты,СправочникМенеджер.Номенклатура,

ДокументМенеджер.ПриходнаяНакладная,

ДокументМенеджер.ОказаниеУслуги и т. д.

Каждый из этих объектов предоставляет средства для работы с конкретной информационной структурой. Например, менеджер

документа ПриходнаяНакладная – ДокументМенеджер.ПриходнаяНак-

ладная – позволяет находить конкретные документы Приходная накладная, создавать объекты этих документов и т. д.

Объект – это такие объекты, как:

СправочникОбъект.Клиенты,СправочникОбъект.Номенклатура,

Краткий справочник разработчика 897

ДокументОбъект.ПриходнаяНакладная,ДокументОбъект.ОказаниеУслуги и т. д.

С помощью объектов этого вида возможно чтение, изменение, запись и удаление данных информационной структуры. Они предоставляют доступ к объекту информационной структуры и позволяют изменять информацию в базе данных. Применяются для тех информационных структур, на объекты которых могут существовать ссылки (справочники – СправочникОбъект.<имя>, документы –

ДокументОбъект.<имя> и т. д.).

Набор записей – это такие объекты, как:

РегистрСведенийНаборЗаписей.Цены,РегистрНакопленияНаборЗаписей.ОстаткиМатериалов,

РегистрБухгалтерииНаборЗаписей.Управленческий и т. д.

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

РегистрНакопленияНаборЗаписей.<имя>, перерасчеты – ПерерасчетНаборЗаписей.<имя> и т. д.).

Ссылка – это такие объекты, как:

СправочникСсылка.Клиенты,СправочникСсылка.Номенклатура,

ДокументСсылка.ПриходнаяНакладная,ДокументСсылка.ОказаниеУслуги и т. д.

Объекты этого вида служат для указания ссылки на объект базы данных и кроме этого предоставляют некоторую информацию об этом объекте (например, документ – ДокументСсылка.<имя>).

Выборка – это такие объекты, как:

СправочникВыборка.Клиенты,ДокументВыборка.ПриходнаяНакладная,РегистрСведенийВыборка.Цены,

РегистрНакопленияВыборка.ОстаткиМатериалов и т. д.

898 1С:Предприятие 8.3. Практическое пособие разработчика

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

СправочникВыборка.<имя>).

Манипулирование данными объектов

Несмотря на большое разнообразие объектов встроенного языка, предназначенных для работы с данными, хранящимися в базе данных, лишь некоторые из них позволяют изменять данные, хранящиеся в базе данных. Такие объекты мы назовем объектами манипу-

лирования данными.

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

ности к тому или иному объекту конфигурации. Для констант этот модуль называется модулем менеджера значений.

Так вот, модуль объекта манипулирования данными будет всегда выполняться при создании объекта манипулирования данными. Кроме этого, он будет всегда выполняться и при интерактивном обращении пользователя к самой структуре данных, поскольку оно будет вызывать создание соответствующего объекта манипулирования данными. Например, при открытии формы элемента справочника будет создаваться объект СправочникОбъект.<имя>.

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

Например, если мы для объекта конфигурации Справочник Клиенты опишем в модуле объекта процедуру (листинг 29.1), то в дальнейшем сможем вызывать ее как метод объекта СправочникОбъект.Клиенты

(листинг 29.2).

Краткий справочник разработчика 899

Листинг 29.1. Процедура «Проверка()» в модуле справочника

Процедура Проверка() Экспорт

…

КонецПроцедуры;

Листинг 29.2. Вызов процедуры как метода объекта «Справочник»

Клиент = Справочники.Клиенты.НайтиПоКоду(1).ПолучитьОбъект(); Клиент.Проверка();

Однако следующий код будет приводить к ошибке, так как объект

СправочникСсылка.Клиенты не имеет метода Проверка (листинг

29.3).

Листинг 29.3. Вызов процедуры «Проверка» приведет к ошибке

Клиент = Справочники.Клиенты.НайтиПоКоду(1); Клиент.Проверка();

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