Ниже перечислены виды программных объектов "Документы", их краткое описание, свойства и методы.
ДокументыМенеджер - это менеджер прикладных объектов данного типа. Объекты данного вида обеспечивают доступ к менеджерам конкретного прикладного объекта (т.е. дает доступ к любому виду документов).
- СправочникиМенеджер
- ДокументыМенеджер
- КонстантыМенеджер
- РегистрыНакопленияМенеджер
- ОтчетыМенеджер
- ОбработкиМенеджер
Обычно доступ к таким объектам производится через свойства глобального контекста, например, Документы.Счет, Справочники.Сотрудники, РегистрыСведений.КурсыВалют и т.д.
Свойства соответствуют именам прикладных объектов и являются объектами типа "Менеджер прикладного объекта".
Эти объекты являются коллекциями значений и позволяют перебрать свои элементы с помощью цикла "Для Каждого".
ДокументМенеджер - это менеджер прикладного объекта; объект обеспечивает доступ к операциям над прикладным объектом как множеством элементов. Через методы этого объекта можно:
- осуществлять поиск,
- получать выборку,
- создавать новые записи,
- обращаться к формам и макетам прикладного объекта.
Является "центральным" в объектной модели 1С (из него можно получить остальные объекты, например, ссылки, выборки, объекты для изменения, наборы записей и т.д.).
- СправочникМенеджер
- ДокументМенеджер
- КонстантаМенеджер
- РегистрНакопленияМенеджер
- ОтчетМенеджер
- ОбработкаМенеджер
Объект ДокументМенеджер предназначен для управления документом:
- программное создание новых документов (метод СоздатьДокумент());
- поиск существующих документов (методы НайтиПоНомеру(), НайтиПоРеквизиту());
- получение выборок (методы Выбрать(), ПолучитьДанныеВыбора());
- получение ссылок (методы ПолучитьСсылку(), ПустаяСсылка());
- получение макетов (метод ПолучитьМакет());
- получение форм (методы ПолучитьФорму(), ПолучитьФормуВыбора(), ПолучитьФормуНовогоДокумента(), ПолучитьФормуСписка()).
ДокументСсылка - этот объект однозначно идентифицирует документ как объект базы данных и позволяет обращаться к нему в режиме "только чтение". Используется для указания ссылки на документ из реквизитов других объектов и переменных. Через свойства и методы этого объекта можно прочитать реквизиты элемента, обратиться к его табличным частям.
- СправочникСсылка
- ДокументСсылка
- ПланСчетовСсылка
- ПланВидовРасчетаСсылка
Ссылки хранятся в реквизитах, ссылающихся на элементы данного прикладного объекта, например, в реквизите "Сотрудник" документа "ПриемНаРаботу" хранится ссылка на конкретный элемент справочника "Сотрудники".
|
Типичные свойства объектов вида "Ссылка": |
Методы объектов вида "Ссылка": |
|
|
Например, для изменения объекта базы данных (элемента справочника, документа) нужно получить другой объект с помощью метода ПолучитьОбъект().
ДокументВыборка- объект предоставляет возможность обхода (перебора) объектов базы данных (выполняет динамический перебор документов).
Например, можно перебрать перебрать документы, входящие в конкретный журнал.
ВАЖНО! Данный объект не является коллекцией значений и, следовательно, нельзя использовать цикл "Для Каждого" для перебора элементов.
- СправочникВыборка;
- ДокументВыборка;
- ЖурналДокументовВыборка;
- РегистрНакопленияВыборка;
Свойства аналогичны свойствам объекта типа "Ссылка".
Типичные методы:
- Следующий()
- ПолучитьОбъект()
ДокументОбъект - предоставляет доступ к объекту базы данных с возможностью записи изменений. Используется для чтения, добавления, изменения, удаления документов.
- СправочникОбъект
- ДокументОбъект
- ПланСчетовОбъект
- ОтчетОбъект
- ОбработкаОбъект
Для отчетов и обработок через этот объект обычно осуществляется формирование отчета или выполнение обработки.
Для регистров подобного объекта не существует, а изменение данных всегда производится через набор записей (см. ниже).
Если в модуле прикладного объекта (не путать с модулем формы) есть экспортируемые переменные модуля или процедуры/функции, то они дополняют набор свойств и методов именно этого программного объекта.
ВАЖНО! У всех событий этого объекта назначены предопределенные процедуры-обработчики. Имена процедур соответствуют именам событий. Процедуры должны располагаться в модуле документа.
Методы ДокументОбъект:
| блокировка и разблокировка | Заблокирован(), Заблокировать(), Разблокировать() |
| модификация | Записать(), Заполнить(), Модифицировать(), Скопировать(), Удалить(), УстановитьВремя(), УстановитьНовыйНомер(), УстановитьПометкуУдаления(), УстановитьСсылкуНового() |
| чтение | Метаданные(), Модифицированность(), МоментВремени(), Прочитать(), ЭтоНовый(), ПроверитьЗаполнение() |
| получение ссылок | ПолучитьСсылкуНового() |
| получение форм | ПолучитьФорму() |
| получение макетов | ПолучитьМакет() |
ДокументСписок - объект предназначен для управления списком элементов в табличном поле (т.е. для решения интерфейсных задач). Позволяет управлять колонками, отбором и сортировкой в списке.
Этот объект нельзя создать программно, он создается системой автоматически при размещении на форме табличного поля. Однако, программно можно создать табличное поле в экранной форме и тогда будет создан объект данного типа.
- СправочникСписок
- ДокументСписок
- ЖурналДокументовСписок
- ПланСчетовСписок
- РегистрНакопленияСписок
- КритерийОтбораСписок
| Типичные свойства: |
|
| Типичные методы: |
|
А где раздел табличная модель работы с данными?
Такого раздела нет, возможно. позже будет.