Тип: МетодНаследованияXS. Содержит метод наследования составного типа схемы XML.
Полное описание, параметры и ограничения
ОпределениеСоставногоТипаXS.МетодНаследования (XSComplexTypeDefinition.DerivationMethod)
ОпределениеСоставногоТипаXS (XSComplexTypeDefinition)
МетодНаследования (DerivationMethod)
Доступен, начиная с версии 8.1.
Использование:
Чтение и запись.
Описание:
Тип: МетодНаследованияXS.
Содержит метод наследования составного типа схемы XML.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Прочитать порядок полей товара и кратность необязательного примечания
Разбираем составной тип Product собственной схемы: sequence, три элемента, обязательные name/quantity и необязательный note.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В начале приведена полная XSD. Не заменяйте её внешней схемой: проверки типов и количества рассчитаны на Product из этого урока.
Используйте серверную учебную процедуру. Составной тип не является объектом документа 1С.
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:product"" targetNamespace=""urn:guide:product""
| elementFormDefault=""qualified"" version=""1.0"" xml:lang=""ru"">
| <xs:annotation><xs:documentation>Учебный товар, не контракт внешнего API</xs:documentation></xs:annotation>
| <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:complexType name=""Product""><xs:sequence>
| <xs:element name=""name"" type=""xs:string""/>
| <xs:element name=""quantity"" type=""xs:nonNegativeInteger""/>
| <xs:element name=""note"" type=""xs:string"" minOccurs=""0""/>
| </xs:sequence><xs:attribute name=""code"" type=""g:Sku"" use=""required""/>
| </xs:complexType>
| <xs:element name=""product"" type=""g:Product""/>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
ТипТовара = Схема.ОпределенияТипов.Получить("Product", "urn:guide:product");
Сообщить(ТипТовара.Имя = "Product");
Сообщить(ТипТовара.URIПространстваИмен = "urn:guide:product");
Сообщить(Не ТипТовара.Абстрактный);
Сообщить(Не ТипТовара.Смешанный);
Сообщить(Не ТипТовара.ЭтоОпределениеЗациклено());
Сообщить("Модель содержимого: " + Строка(ТипТовара.МодельСодержимого));
Сообщить("Метод наследования: " + Строка(ТипТовара.МетодНаследования));
Фрагмент = ТипТовара.Содержимое;
Если ТипЗнч(Фрагмент) <> Тип("ФрагментXS") Тогда
ВызватьИсключение "Ожидался фрагмент sequence собственной схемы";
КонецЕсли;
Группа = Фрагмент.Часть;
Если ТипЗнч(Группа) <> Тип("ГруппаМоделиXS") Тогда
ВызватьИсключение "Ожидалась группа модели собственной схемы";
КонецЕсли;
Сообщить("Вид группы: " + Строка(Группа.ВидГруппы));
Сообщить(Группа.Фрагменты.Количество() = 3);
Для Каждого ЧастьПолей Из Группа.Фрагменты Цикл
Объявление = ЧастьПолей.Часть;
Если ТипЗнч(Объявление) <> Тип("ОбъявлениеЭлементаXS") Тогда
ВызватьИсключение "Ожидался элемент собственной последовательности";
КонецЕсли;
Сообщить(СтрШаблон("%1: минимум %2, максимум %3", Объявление.Имя,
ЧастьПолей.МинимальноВходит, ЧастьПолей.МаксимальноВходит));
Сообщить("Тип: " + Объявление.ОпределениеТипа().Имя);
Сообщить(Не Объявление.ЭтоГлобальноеОбъявление);
Сообщить(Не Объявление.ЭтоСсылка);
Сообщить(Не Объявление.ВозможноПустой);
Сообщить(Не Объявление.ЭтоОбъявлениеЗациклено());
Если Объявление.Имя = "note" Тогда
Сообщить(ЧастьПолей.МинимальноВходит = 0);
Сообщить(ЧастьПолей.ДопускаетсяПустой());
Иначе
Сообщить(ЧастьПолей.МинимальноВходит = 1);
Сообщить(Не ЧастьПолей.ДопускаетсяПустой());
КонецЕсли;
Сообщить(ЧастьПолей.МаксимальноВходит = 1);
КонецЦикла;Разбор по шагам
Содержимое составного типа даёт ФрагментXS, а Часть этого фрагмента — ГруппаМоделиXS последовательности.
Фрагменты группы содержат отдельные объявления name, quantity и note в порядке sequence.
Кратность относится к фрагменту: минимум 1 требует элемент, минимум 0 разрешает его отсутствие, максимум 1 запрещает повторение.
ОпределениеТипа раскрывает тип поля: string или nonNegativeInteger. Все три объявления локальные, без ref.
ВозможноПустой относится к xsi:nil. Отсутствующий note и элемент с xsi:nil — разные случаи; minOccurs=0 не включает nillable автоматически.
Как проверить результат
Выводятся name, quantity, note в таком порядке; фрагментов три.
Для name/quantity минимум 1 и пустой фрагмент не допускается; для note минимум 0 и допускается отсутствие.
Максимум у каждого поля 1; ВозможноПустой Ложь для всех трёх.
Ожидаемый результат
Порядок XML-полей, обязательность, повторяемость и xsi:nil разделены на конкретном контракте товара.
На что обратить внимание
Не путайте minimum occurrences и разрешение xsi:nil: это разные ограничения.
Группа sequence отличается от choice/all; этот пример не универсальный обход любой модели.
Поля схемы читаются, данные товара в базе не создаются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разобрать составной тип с простым содержимым
Price расширяет decimal атрибутом currency. Аннотация simpleContent и аннотация extension относятся к разным уровням модели.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD включена в код; используются только namespace urn:guide:product и встроенные типы языка XSD.
Sku описывает код, SkuList — список кодов, SkuOrQuantity — выбор допустимого типа значения. Product и Price — разные составные типы.
Нет DTD, include/import, чтения или записи файла и сетевого доступа. НаборСхемXML.Проверить проверяет собственную схему, не XML-экземпляр товара.
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:product"" targetNamespace=""urn:guide:product""
| elementFormDefault=""qualified"" version=""1.0"" xml:lang=""ru"">
| <xs:annotation><xs:documentation>Учебный товар, не контракт внешнего API</xs:documentation></xs:annotation>
| <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:complexType name=""Product""><xs:sequence>
| <xs:element name=""name"" type=""xs:string""/>
| <xs:element name=""quantity"" type=""xs:nonNegativeInteger""/>
| <xs:element name=""note"" type=""xs:string"" minOccurs=""0""/>
| </xs:sequence><xs:attribute name=""code"" type=""g:Sku"" use=""required""/>
| </xs:complexType>
| <xs:element name=""product"" type=""g:Product""/>
| <xs:simpleType name=""SkuList""><xs:list itemType=""g:Sku""/></xs:simpleType>
| <xs:simpleType name=""SkuOrQuantity""><xs:union memberTypes=""g:Sku xs:nonNegativeInteger""/></xs:simpleType>
| <xs:complexType name=""Price""><xs:simpleContent>
| <xs:annotation><xs:documentation source=""urn:guide:price-content"">Цена — число с атрибутом валюты</xs:documentation></xs:annotation>
| <xs:extension base=""xs:decimal"">
| <xs:annotation><xs:documentation source=""urn:guide:price-extension"">Расширение простого decimal</xs:documentation></xs:annotation>
| <xs:attribute name=""currency"" type=""xs:string"" default=""RUB""/>
| </xs:extension>
| </xs:simpleContent></xs:complexType>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
ТипЦены = Схема.ОпределенияТипов.Получить("Price", "urn:guide:product");
Если ТипЦены = Неопределено Тогда
ВызватьИсключение "В собственной схеме не найден тип Price";
КонецЕсли;
Если ТипЗнч(ТипЦены) <> Тип("ОпределениеСоставногоТипаXS") Тогда
ВызватьИсключение "У Price другой вид определения типа";
КонецЕсли;
Сообщить(ТипЦены.МетодНаследования = МетодНаследованияXS.Расширение);
ИмяБазы = ТипЦены.ИмяБазовогоТипа;
Если ИмяБазы = Неопределено Тогда
ВызватьИсключение "У Price не найдено имя базового типа";
КонецЕсли;
Сообщить(ИмяБазы.URIПространстваИмен = "http://www.w3.org/2001/XMLSchema");
Сообщить(ИмяБазы.ЛокальноеИмя = "decimal");
База = ТипЦены.ОпределениеБазовогоТипа;
Если База = Неопределено Тогда
ВызватьИсключение "Не разрешён базовый простой тип decimal";
КонецЕсли;
Сообщить(База.Имя = "decimal");
Сообщить(ТипЦены.Фасеты.Количество() = 0);
АннотацияСодержимого = ТипЦены.АннотацияМоделиСодержимого;
АннотацияРасширения = ТипЦены.АннотацияНаследования;
Если АннотацияСодержимого = Неопределено Или АннотацияРасширения = Неопределено Тогда
ВызватьИсключение "Не найдены две собственные аннотации Price";
КонецЕсли;
Сообщить(АннотацияСодержимого.Документация.Количество() = 1);
Сообщить(АннотацияРасширения.Документация.Количество() = 1);
Сообщить(ТипЦены.Содержит(АннотацияСодержимого));
Сообщить(ТипЦены.Содержит(АннотацияРасширения));
Сообщить("Базовый тип: " + Строка(ТипЦены.БазовыйТип));
Сообщить("Корневой тип: " + Строка(ТипЦены.КорневойТип));
Копия = ТипЦены.КлонироватьКомпоненту(Истина);
Если ТипЗнч(Копия) <> Тип("ОпределениеСоставногоТипаXS") Тогда
ВызватьИсключение "Не получена копия Price";
КонецЕсли;
Копия.Имя = "PriceCopy";
Сообщить(ТипЦены.Имя = "Price");
Сообщить(Не ТипЦены.Содержит(Копия));Разбор по шагам
Price — составной тип с simpleContent: текстовое числовое содержимое плюс атрибут currency, не последовательность дочерних полей.
Расширение добавляет атрибут, базовый простой тип — decimal. QName и связанное определение проверяются отдельно.
У собственной extension нет собственных фасетов ограничения, поэтому их количество ноль.
АннотацияМоделиСодержимого соответствует simpleContent, АннотацияНаследования — extension; обе заданы явно в собственной XSD.
Содержит проверяет принадлежность этих компонентов. Рекурсивная копия не присоединяется к исходному типу или схеме.
Диагностические БазовыйТип и КорневойТип не присваиваются и не объявляются одним и тем же компонентом.
Как проверить результат
Одиннадцать сообщений Истина и две диагностические строки иерархии.
Исходный Price сохраняет имя, копия PriceCopy не добавлена в схему.
Ожидаемый результат
Простое содержимое составного типа отделено от аннотаций и иерархии наследования.
На что обратить внимание
Не пытайтесь трактовать simpleContent как sequence элементов name/quantity.
Атрибут currency и значение по умолчанию описывают XML-контракт, не валютный справочник 1С.
Клонирование и сравнение имени не проверяют независимость DOM-узлов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.