Объектная модель документов 1C

Ниже перечислены виды программных объектов «Документы», их краткое описание, свойства и методы.

ДокументыМенеджер — это менеджер прикладных объектов данного типа. Объекты данного вида обеспечивают доступ к менеджерам конкретного прикладного объекта (т.е. дает доступ к любому виду документов).

Примеры менеджеров прикладных объектов данного типа

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

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

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

[свернуть]

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


ДокументМенеджер — это менеджер прикладного объекта; объект  обеспечивает доступ к операциям над прикладным объектом как множеством элементов. Через методы этого объекта можно:

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

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

Примеры менеджера прикладного объекта

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

[свернуть]

Объект ДокументМенеджер предназначен для управления документом:

  • программное создание новых документов (метод СоздатьДокумент());
  • поиск существующих документов (методы НайтиПоНомеру(), НайтиПоРеквизиту());
  • получение выборок (методы Выбрать(), ПолучитьДанныеВыбора());
  • получение ссылок (методы ПолучитьСсылку(), ПустаяСсылка());
  • получение макетов (метод ПолучитьМакет());
  • получение форм (методы ПолучитьФорму(), ПолучитьФормуВыбора(), ПолучитьФормуНовогоДокумента(), ПолучитьФормуСписка()).

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

Примеры объектов вида "Ссылка"

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

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

[свернуть]

Типичные свойства объектов вида «Ссылка»:

Методы объектов вида «Ссылка»:
  • <реквизит>
  • <табличная часть>
  • ПометкаУдаления
  • Дата
  • Предопределенный
  • Ссылка
  • Метаданные()
  • МоментВремени()
  • ПолучитьОбъект()
  • ПолучитьФорму()
  • Пустая()
  • Скопировать()
  • УникальныйИдентификатор()

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


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

Например, можно перебрать перебрать документы, входящие в конкретный журнал.

ВАЖНО! Данный объект не является коллекцией значений и, следовательно, нельзя использовать цикл «Для Каждого» для перебора элементов.

Примеры объектов вида "Выборка"

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

[свернуть]

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

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

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

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

Примеры объектов вида "Объект"

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

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

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

[свернуть]

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

ВАЖНО! У всех событий этого объекта назначены предопределенные процедуры-обработчики. Имена процедур соответствуют именам событий. Процедуры должны располагаться в модуле документа.

Методы ДокументОбъект:

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

ДокументСписок — объект предназначен для управления списком элементов в табличном поле (т.е. для решения интерфейсных задач). Позволяет управлять колонками, отбором и сортировкой в списке.

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

Примеры объектов вида "Список"

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

[свернуть]
Типичные свойства:
  • Колонки
  • Отбор
  • Порядок
Типичные методы:
  • Обновить()

 

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

Этот сайт использует Akismet для борьбы со спамом. Узнайте, как обрабатываются ваши данные комментариев.