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

примеры:

• СправочникиМенеджер
• ДокументыМенеджер
• КонстантыМенеджер
• РегистрыНакопленияМенеджер
• ОтчетыМенеджер
• ОбработкиМенеджер

Объекты данного вида обеспечивают доступ к менеджерам конкретного прикладного объекта.

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

Эти объекты являются коллекциями значений и позволяют перебрать свои элементы с помощью цикла "Для Каждого".

Свойства соответствуют именам прикладных объектов и являются объектами типа "Менеджер прикладного объекта"

примеры:

• СправочникМенеджер
• ДокументМенеджер
• КонстантаМенеджер
• РегистрНакопленияМенеджер
  
• ОтчетМенеджер
• ОбработкаМенеджер

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

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

• <предопределенный элемент>

• Выбрать()
• НайтиПоКоду()
• НайтиПоРеквизиту()
• ПустаяСсылка()
• СоздатьЭлемент()
• СоздатьНаборЗаписей()
• ПолучитьМакет()
• ПолучитьФорму()

примеры:

• СправочникСсылка
• ДокументСсылка
• ПланСчетовСсылка
• ПланВидовРасчетаСсылка

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

Ссылки хранятся в реквизитах, ссылающихся на элементы данного прикладного объекта, например, в реквизите "Сотрудник" документа "ПриемНаРаботу" хранится ссылка на конкретный элемент справочника "Сотрудники".

Заметьте, что у записей регистров нет ссылок.

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

• <реквизит>
• <табличная часть>
• ПометкаУдаления
• Дата
• Предопределенный
• Ссылка

• Пустая()
• ПолучитьОбъект()
• ПолучитьФорму()
• Метаданные()
• Скопировать()

примеры:

• СправочникВыборка
• ДокументВыборка
• ЖурналДокументовВыборка
• РегистрНакопленияВыборка

Этот объект предоставляет возможность обхода (перебора) объектов базы данных. Например, можно перебрать элементы справочника или перебрать документы, входящие в конкретный журнал.

Обратите внимание, что данный объект не является коллекцией значений и, следовательно, нельзя использовать цикл "Для Каждого" для перебора элементов.

Свойства аналогичны свойствам объекта типа "Ссылка".

Типичные методы:

• Следующий()
• ПолучитьОбъект()

примеры:

• СправочникОбъект
• ДокументОбъект
• ПланСчетовОбъект
• ОтчетОбъект
• ОбработкаОбъект

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

Для отчетов и обработок через этот объект обычно осуществляется формирование отчета или выполнение обработки.

Если в модуле прикладного объекта (не путать с модулем формы) есть экспортируемые переменные модуля или процедуры/функции, то они дополняют набор свойств и методов именно этого программного объекта.

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

Свойства аналогичны свойствам объекта типа "Ссылка".

Типичные методы:

• Записать()
• Удалить()
• Заблокировать()
• Разблокировать()
• Заблокирован()
• Скопировать()
• ПолучитьФорму()
• ПолучитьМакет()
• Метаданные()

примеры:

• СправочникСписок
• ДокументСписок
• ЖурналДокументовСписок
• ПланСчетовСписок
• РегистрНакопленияСписок
• КритерийОтбораСписок

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

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

• Колонки
• Отбор
• Порядок

• Обновить()

примеры:

• РегистрСведенийНаборЗаписей
• РегистрНакопленияНаборЗаписей
• РегистрБухгалтерииНаборЗаписей
• РегистрРасчетаНаборЗаписей
• ПоследовательностьНаборЗаписей

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

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

• Отбор
• ЭтотОбъект

• Добавить()
• Удалить()
• Очистить()
• Записать()
• Прочитать()
• Количество()
• Выгрузить()
• Загрузить()

примеры:

• РегистрСведенийЗапись
• РегистрНакопленияЗапись
• РегистрБухгалтерииЗапись
• РегистрРасчетаЗапись

Обеспечивает доступ к одной записи из набора, для того чтобы установить ее измерения, ресурсы и т.д. Этот объект возвращается методами других объектов, например, методом Добавить у объекта типа РегистрНакопленияНаборЗаписей.

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

• <измерение>
• <реквизит>
• <ресурс>
• Активность
• Период
• Регистратор
• НомерСтроки
• ВидДвижения

• МоментВремени()

примеры:

• РегистрСведенийКлючЗаписи
• РегистрНакопленияКлючЗаписи
• РегистрБухгалтерииКлючЗаписи
• РегистрРасчетаКлючЗаписи

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

• НомерСтроки
• Регистратор

Свойства для регистра сведений:

• <ИмяИзмерения>
• Период
• Регистратор

Менеджер записи регистра сведений

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

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

ПланСчетовВидыСубконто
ПланСчетовВидыСубконтоСтрока

РегистрБухгалтерииСубконто

КонстантыНабор

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

МенеджерВнешнихОбработок
ВнешняяОбработка

Менеджер внешних обработок подобен менеджерам других прикладных объектов. Его метод Создать(<имя файла>) позволяет создать объект типа "ВнешняяОбработка". Этот объект, в свою очередь, подобен объектам ОтчетОбъект и ОбработкаОбъект и предоставляет доступ к реквизитам и табличным частям внешней обработки для передачи параметров формирования отчета или выполнения обработки.

Если в модуле внешней обработки (не путать с модулем формы) есть экспортируемые переменные модуля или процедуры/функции, то они дополняют набор свойств и методов объекта "ВнешняяОбработка".