Тип: Булево. Содержит признак абстрактного типа объекта.
Полное описание, параметры и ограничения
ТипОбъектаXDTO.Абстрактный (XDTOObjectType.Abstract)
ТипОбъектаXDTO (XDTOObjectType)
Абстрактный (Abstract)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Булево.
Содержит признак абстрактного типа объекта.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Истина - тип абстрактный.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Экспортировать свою модель XDTO и построить вторую фабрику
ЭкспортМоделиXDTO выдаёт описание типов Model, а не заказ. По нему создаётся вторая независимая фабрика, в которой снова проверяем собственные ограничения артикула.
Где и как запускать
Полный серверный общий модуль собственной отдельной учебной конфигурации.
Подготовка
Создайте отдельную собственную конфигурацию с именем УчебнаяКонфигурацияСинтаксиса. Не используйте рабочую КА2, УНФ, УТ или БП.
Создайте неглобальный общий модуль УчебнаяМодельXDTO85 с флагом Сервер. Вставьте весь выбранный пример, включая вспомогательные функции, если они присутствуют.
Из серверной команды своей учебной обработки вызовите УчебнаяМодельXDTO85.ВыполнитьПример(). Передавать неизвестный объект или реквизиты чужой конфигурации не нужно.
XSD целиком встроена в код: артикул Sku, цвет Color, список артикулов, объединение, абстрактный Base, строка Item, производный Order и смешанный Note.
Справочники, документы и пакеты XDTO метаданных создавать не нужно. Схема и фабрика принадлежат только этому выполнению в памяти.
urn:guide:model85 и URI стандартной XML Schema — идентификаторы пространств имён. Код не загружает их из Интернета; import/include, DTD и внешних файлов нет.
Проверки Истина относятся к приведённой неизменённой учебной XSD. После её изменения сначала пересмотрите ожидаемые типы, границы и обязательность.
Это полный учебный исходник с проверенными статически API, но запуск в 1С не проверялся. Ошибку подготовки схемы не следует принимать за успешную проверку данных.
Процедура ВыполнитьПример() Экспорт
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" xmlns:g=""urn:guide:model85"" targetNamespace=""urn:guide:model85"" elementFormDefault=""qualified"" attributeFormDefault=""unqualified"">
|<xs:simpleType name=""Sku""><xs:restriction base=""xs:string""><xs:length value=""4""/><xs:pattern value=""[A-Z][0-9]{3}""/></xs:restriction></xs:simpleType>
|<xs:simpleType name=""Color""><xs:restriction base=""xs:string""><xs:enumeration value=""red""/><xs:enumeration value=""blue""/></xs:restriction></xs:simpleType>
|<xs:simpleType name=""SkuList""><xs:list itemType=""g:Sku""/></xs:simpleType>
|<xs:simpleType name=""QuantityOrCode""><xs:union memberTypes=""xs:positiveInteger g:Sku""/></xs:simpleType>
|<xs:complexType name=""Base"" abstract=""true""><xs:attribute name=""code"" type=""g:Sku"" use=""required""/></xs:complexType>
|<xs:complexType name=""Item""><xs:sequence><xs:element name=""name"" type=""xs:string""/><xs:element name=""quantity"" type=""xs:nonNegativeInteger""/></xs:sequence></xs:complexType>
|<xs:complexType name=""Order""><xs:complexContent><xs:extension base=""g:Base""><xs:sequence><xs:element name=""item"" type=""g:Item"" minOccurs=""0"" maxOccurs=""unbounded""/></xs:sequence></xs:extension></xs:complexContent></xs:complexType>
|<xs:complexType name=""Note"" mixed=""true""><xs:sequence><xs:element name=""amount"" type=""xs:decimal"" minOccurs=""0"" maxOccurs=""unbounded""/></xs:sequence></xs:complexType>
|<xs:element name=""order"" type=""g:Order""/><xs:element name=""note"" type=""g:Note""/>
|</xs:schema>";
ЧтениеСхемы = Новый ЧтениеXML;
ЧтениеСхемы.УстановитьСтроку(XSD);
Попытка
Дерево = Новый ПостроительDOM;
ДокументСхемы = Дерево.Прочитать(ЧтениеСхемы);
Исключение
ОшибкаСхемы = ОписаниеОшибки();
Попытка
ЧтениеСхемы.Закрыть();
Исключение
ВызватьИсключение ОшибкаСхемы + Символы.ПС + "Закрытие: " + ОписаниеОшибки();
КонецПопытки;
ВызватьИсключение ОшибкаСхемы;
КонецПопытки;
ЧтениеСхемы.Закрыть();
ПостроительСхем = Новый ПостроительСхемXML;
Схема = ПостроительСхем.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не построена собственная схема коллекций";
КонецЕсли;
НаборСхем = Новый НаборСхемXML;
НаборСхем.Добавить(Схема);
Если НЕ НаборСхем.Проверить() Тогда
ВызватьИсключение "Собственная схема не прошла проверку";
КонецЕсли;
Фабрика = Новый ФабрикаXDTO(НаборСхем);
Модель = Фабрика.ЭкспортМоделиXDTO("urn:guide:model85");
Если ТипЗнч(Модель) <> Тип("ОбъектXDTO") Тогда
ВызватьИсключение "Ожидался составной экспорт модели";
КонецЕсли;
Модель.Проверить();
Сообщить(Модель.Тип().Имя = "Model");
Сообщить(Модель.Тип().URIПространстваИмен = "http://v8.1c.ru/8.1/xdto");
Пакет = Фабрика.Пакеты.Получить("urn:guide:model85");
Если Пакет = Неопределено Тогда
ВызватьИсключение "Не найден исходный собственный пакет";
КонецЕсли;
ОпорныеПакеты = Пакет.Зависимости;
Для Индекс = 0 По ОпорныеПакеты.Количество() - 1 Цикл
ОпорныйПакет = ОпорныеПакеты.Получить(Индекс);
Если ОпорныйПакет.URIПространстваИмен = "urn:guide:model85" Тогда
ВызватьИсключение "Не передавайте исходный пакет вместо восстановления модели";
КонецЕсли;
КонецЦикла;
ВтораяФабрика = Новый ФабрикаXDTO(Модель, ОпорныеПакеты);
ТипАртикула = ВтораяФабрика.Тип("urn:guide:model85", "Sku");
ТипЗаказа = ВтораяФабрика.Тип("urn:guide:model85", "Order");
Если ТипАртикула = Неопределено ИЛИ ТипЗаказа = Неопределено Тогда
ВызватьИсключение "В восстановленной собственной фабрике не найдены Sku/Order";
КонецЕсли;
ТипАртикула.Проверить("A001");
Артикул = ВтораяФабрика.Создать(ТипАртикула, "A001");
Сообщить(Артикул.Значение = "A001");
ПроверитьОтклонениеСвоегоЗначения(ВтораяФабрика, ТипАртикула, "A01");
ВторойЗаказ = ВтораяФабрика.Создать(ТипЗаказа);
КодВторого = ВторойЗаказ.Свойства().Получить("code");
Если КодВторого = Неопределено Тогда
ВызватьИсключение "Не получен собственный унаследованный code";
КонецЕсли;
ВторойЗаказ.Установить(КодВторого, Артикул);
ВторойЗаказ.Проверить();
Сообщить(ВторойЗаказ.Получить(КодВторого) = "A001");
Сообщить(ВторойЗаказ.Фабрика() = ВтораяФабрика);
Сообщить(ТипЗаказа.БазовыйТип.Имя = "Base");
Сообщить(НЕ ТипЗаказа.Абстрактный);
КонецПроцедуры
Процедура ПроверитьОтклонениеСвоегоЗначения(Фабрика, ТипЗначения, ЛексическоеЗначение)
Отклонено = Ложь;
Попытка
Неподходящее = Фабрика.Создать(ТипЗначения, ЛексическоеЗначение);
Сообщить("Неожиданно принято: " + Неподходящее.ЛексическоеЗначение);
Исключение
Отклонено = Истина;
КонецПопытки;
Если НЕ Отклонено Тогда
ВызватьИсключение "Не отклонено учебное значение: " + ЛексическоеЗначение;
КонецЕсли;
Сообщить("Отклонено по собственному контракту: " + ЛексическоеЗначение);
КонецПроцедурыРазбор по шагам
Экспортировать только пакет собственного URI, а не все пакеты рабочей конфигурации.
Проверить результат ОбъектXDTO и его модель. Имя Model и URI http://v8.1c.ru/8.1/xdto относятся к описанию типов.
Создать вторую ФабрикаXDTO из объекта Model по отдельной перегрузке конструктора. Для разрешения стандартных ссылок передать только зависимости собственного пакета, не сам исходный пакет.
Получить Sku/Order уже из второй фабрики. Не переносить в неё старые описатели СвойствоXDTO первой фабрики.
Проверить A001 и отклонить A01 во второй модели: экспорт сохранил ограничение длины/образца.
Создать заказ второй фабрикой и взять описатель code из него. Заполнить артикул, проверить объект; список item может быть пустым из-за minOccurs=0.
Сверить чтение артикула, происхождение фабрики, базовый тип и конкретность Order. Не выдавать Model за бизнес-заказ.
Экспорт не записывает метаданные конфигурации или файл. Обе фабрики существуют только в памяти этого выполнения.
Как проверить результат
Семь булевых сообщений дают Истина; A01 отклонён также восстановленной моделью.
Объект экспортированной модели имеет тип Model; второй заказ имеет собственный code A001 и не требует строк item.
Пакеты метаданных, товары и документы информационной базы не изменяются.
Ожидаемый результат
Описание своей модели экспортировано и использовано для второй фабрики с сохранённым учебным контрактом.
На что обратить внимание
ЭкспортМоделиXDTO экспортирует типы, не экземпляры заказов и не справочники базы.
Конструктор по модели типов отличается от конструктора по НаборСхемXML. Первый аргумент здесь ОбъектXDTO Model.
Модели с внешними импортами требуют согласованных пакетов; здесь опорные пакеты уже получены из своей фабрики в памяти, внешнего загрузчика нет.
Не считайте совпадение URI/имени гарантией объектной тождественности описателей разных фабрик.
Не заменяйте этот процесс обновлением конфигурации: это локальное построение в памяти, без записи рабочей базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить наследование своего заказа и отличить описание типа от объекта
Order наследует обязательный артикул абстрактного Base. Проверка выполняется на полностью созданном заказе, а направление ЭтоПотомок подтверждается двумя противоположными вызовами.
Где и как запускать
Полный серверный общий модуль собственной отдельной учебной конфигурации.
Подготовка
Создайте отдельную собственную конфигурацию с именем УчебнаяКонфигурацияСинтаксиса. Не используйте рабочую КА2, УНФ, УТ или БП.
Создайте неглобальный общий модуль УчебнаяМодельXDTO85 с флагом Сервер. Вставьте весь выбранный пример, включая вспомогательные функции, если они присутствуют.
Из серверной команды своей учебной обработки вызовите УчебнаяМодельXDTO85.ВыполнитьПример(). Передавать неизвестный объект или реквизиты чужой конфигурации не нужно.
XSD целиком встроена в код: артикул Sku, цвет Color, список артикулов, объединение, абстрактный Base, строка Item, производный Order и смешанный Note.
Справочники, документы и пакеты XDTO метаданных создавать не нужно. Схема и фабрика принадлежат только этому выполнению в памяти.
urn:guide:model85 и URI стандартной XML Schema — идентификаторы пространств имён. Код не загружает их из Интернета; import/include, DTD и внешних файлов нет.
Проверки Истина относятся к приведённой неизменённой учебной XSD. После её изменения сначала пересмотрите ожидаемые типы, границы и обязательность.
Это полный учебный исходник с проверенными статически API, но запуск в 1С не проверялся. Ошибку подготовки схемы не следует принимать за успешную проверку данных.
Процедура ВыполнитьПример() Экспорт
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" xmlns:g=""urn:guide:model85"" targetNamespace=""urn:guide:model85"" elementFormDefault=""qualified"" attributeFormDefault=""unqualified"">
|<xs:simpleType name=""Sku""><xs:restriction base=""xs:string""><xs:length value=""4""/><xs:pattern value=""[A-Z][0-9]{3}""/></xs:restriction></xs:simpleType>
|<xs:simpleType name=""Color""><xs:restriction base=""xs:string""><xs:enumeration value=""red""/><xs:enumeration value=""blue""/></xs:restriction></xs:simpleType>
|<xs:simpleType name=""SkuList""><xs:list itemType=""g:Sku""/></xs:simpleType>
|<xs:simpleType name=""QuantityOrCode""><xs:union memberTypes=""xs:positiveInteger g:Sku""/></xs:simpleType>
|<xs:complexType name=""Base"" abstract=""true""><xs:attribute name=""code"" type=""g:Sku"" use=""required""/></xs:complexType>
|<xs:complexType name=""Item""><xs:sequence><xs:element name=""name"" type=""xs:string""/><xs:element name=""quantity"" type=""xs:nonNegativeInteger""/></xs:sequence></xs:complexType>
|<xs:complexType name=""Order""><xs:complexContent><xs:extension base=""g:Base""><xs:sequence><xs:element name=""item"" type=""g:Item"" minOccurs=""0"" maxOccurs=""unbounded""/></xs:sequence></xs:extension></xs:complexContent></xs:complexType>
|<xs:complexType name=""Note"" mixed=""true""><xs:sequence><xs:element name=""amount"" type=""xs:decimal"" minOccurs=""0"" maxOccurs=""unbounded""/></xs:sequence></xs:complexType>
|<xs:element name=""order"" type=""g:Order""/><xs:element name=""note"" type=""g:Note""/>
|</xs:schema>";
ЧтениеСхемы = Новый ЧтениеXML;
ЧтениеСхемы.УстановитьСтроку(XSD);
Попытка
Дерево = Новый ПостроительDOM;
ДокументСхемы = Дерево.Прочитать(ЧтениеСхемы);
Исключение
ОшибкаСхемы = ОписаниеОшибки();
Попытка
ЧтениеСхемы.Закрыть();
Исключение
ВызватьИсключение ОшибкаСхемы + Символы.ПС + "Закрытие: " + ОписаниеОшибки();
КонецПопытки;
ВызватьИсключение ОшибкаСхемы;
КонецПопытки;
ЧтениеСхемы.Закрыть();
ПостроительСхем = Новый ПостроительСхемXML;
Схема = ПостроительСхем.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не построена собственная схема коллекций";
КонецЕсли;
НаборСхем = Новый НаборСхемXML;
НаборСхем.Добавить(Схема);
Если НЕ НаборСхем.Проверить() Тогда
ВызватьИсключение "Собственная схема не прошла проверку";
КонецЕсли;
Фабрика = Новый ФабрикаXDTO(НаборСхем);
ТипЗаказа = Фабрика.Тип("urn:guide:model85", "Order");
ТипСтроки = Фабрика.Тип("urn:guide:model85", "Item");
Если ТипЗаказа = Неопределено ИЛИ ТипСтроки = Неопределено Тогда
ВызватьИсключение "В собственной модели не найдены Order и Item";
КонецЕсли;
Заказ = Фабрика.Создать(ТипЗаказа);
СвойствоКода = Заказ.Свойства().Получить("code");
СвойствоСтрок = Заказ.Свойства().Получить("item");
СвойствоИмени = ТипСтроки.Свойства.Получить("name");
СвойствоКоличества = ТипСтроки.Свойства.Получить("quantity");
Если СвойствоКода = Неопределено ИЛИ СвойствоСтрок = Неопределено
ИЛИ СвойствоИмени = Неопределено ИЛИ СвойствоКоличества = Неопределено Тогда
ВызватьИсключение "В собственной модели не найдены четыре описателя";
КонецЕсли;
Заказ.Установить(СвойствоКода, Фабрика.Создать(СвойствоКода.Тип, "A001"));
СтрокиЗаказа = Заказ.ПолучитьСписок(СвойствоСтрок);
Книга = Фабрика.Создать(ТипСтроки);
Книга.Установить(СвойствоИмени, Фабрика.Создать(СвойствоИмени.Тип, "Книга"));
Книга.Установить(СвойствоКоличества, Фабрика.Создать(СвойствоКоличества.Тип, "3"));
Книга = СтрокиЗаказа.Добавить(Книга);
Если ТипЗнч(Книга) <> Тип("ОбъектXDTO") Тогда
ВызватьИсключение "Добавленная строка должна быть составным объектом";
КонецЕсли;
Заказ.Проверить();
Базовый = Фабрика.Тип("urn:guide:model85", "Base");
ТипПояснения = Фабрика.Тип("urn:guide:model85", "Note");
Если Базовый = Неопределено ИЛИ ТипПояснения = Неопределено Тогда
ВызватьИсключение "Не найдены собственные Base и Note";
КонецЕсли;
Сообщить(Базовый.Абстрактный);
Сообщить(НЕ ТипЗаказа.Абстрактный);
Сообщить(ТипЗаказа.БазовыйТип = Базовый);
Сообщить(Базовый.ЭтоПотомок(ТипЗаказа));
Сообщить(НЕ ТипЗаказа.ЭтоПотомок(Базовый));
Сообщить(НЕ ТипЗаказа.Открытый);
Сообщить(НЕ ТипЗаказа.Смешанный);
Сообщить(ТипПояснения.Смешанный);
Сообщить("У Order есть последовательность: " + Строка(ТипЗаказа.Последовательный));
Сообщить("Свойства Order упорядочены: " + Строка(ТипЗаказа.Упорядоченный));
Сообщить(ТипЗаказа.Свойства.Получить("code") = СвойствоКода);
Если НЕ ТипЗаказа.Проверить(Заказ) Тогда
ВызватьИсключение "Созданный заказ не соответствует своему типу";
КонецЕсли;
Сообщить(Заказ.Получить(СвойствоКода) = "A001");
Сообщить(СтрокиЗаказа.Количество() = 1);
КонецПроцедурыРазбор по шагам
Создать Order с артикулом A001 и настоящей вложенной строкой Книга, количество 3. Проверить его обязательные значения.
Получить Base и Note из той же фабрики. Абстрактный Base здесь описывает общую часть, экземпляр создаём только по конкретному Order.
Проверить ссылку Order.БазовыйТип. Вызов Базовый.ЭтоПотомок(ТипЗаказа) спрашивает, является ли переданный Order потомком получателя Base.
Сделать обратную проверку и получить Ложь. Это не проверка прав доступа и не проверка вида данных по строке имени.
Разделить открытость модели, смешанное содержимое, наличие последовательности и упорядоченность свойств. Для последних двух вывести реальное описание полученной модели.
Найти унаследованный code в коллекции описателей Order. Это свойство типа, а его значение читается у Заказа.
ТипЗаказа.Проверить(Заказ) возвращает Булево; Заказ.Проверить() выполняется без присваивания результата. Ошибку или Ложь не принимаем за успех.
В конце сопоставить прочитанный артикул и число строк с исходными учебными данными.
Как проверить результат
Все отдельные булевы сообщения дают Истина, артикул A001, одна строка Книга с количеством 3.
Проверка типа завершена без исключения. Признак смешанного содержания Истина только для собственного Note из этих двух показанных типов.
Сообщения о последовательности и упорядоченности показывают фактические флаги модели; не превращайте их в предполагаемое число строк.
Ожидаемый результат
На настоящем заказе показаны наследование, унаследованный артикул, признаки типа и проверка соответствия.
На что обратить внимание
ЭтоПотомок имеет направление получатель-база → аргумент-потомок. Обратный вызов не эквивалентен.
Нельзя создавать заказ из абстрактного Base или присваивать его readonly-флагам другие значения.
Свойства типа — описатели, а не заполненные значения объекта. Их получение само по себе не заполняет заказ.
Открытый=False означает отсутствие пользовательских свойств этого типа, не запрет изменения уже объявленного поля.
Смешанный=True допускает текст вместе с элементами; это отличается от повторяющегося списка Item.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.