Тип: ТипКомпонентыXS. Тип компонента схемы XML.
Полное описание, параметры и ограничения
ИнформацияДляПриложенияXS.ТипКомпоненты (XSAppInfo.ComponentType)
ИнформацияДляПриложенияXS (XSAppInfo)
ТипКомпоненты (ComponentType)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: ТипКомпонентыXS.
Тип компонента схемы XML.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Прочитать и изменить source у собственного appinfo
Служебная информация приложения живёт в аннотации XSD. Изменяем её метку источника и проверяем реальный атрибут DOM.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD с documentation и appinfo включена в код, внешние файлы и сервисы не используются.
source=urn:guide:training — метка собственного ресурса, не http URL. Текст g:lesson — учебная информация приложения, не требование XML-валидации.
Работа ведётся только со своей моделью и DOM. Проверка набора проверяет схему, а не документ с данными товара.
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:appinfo source=""urn:guide:training""><g:lesson>Учебный код товара</g:lesson></xs:appinfo></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 не прошла проверку";
КонецЕсли;
Аннотация = Схема.Аннотация;
Если Аннотация = Неопределено Тогда
ВызватьИсключение "Нет аннотации собственной схемы";
КонецЕсли;
Если Аннотация.ИнформацияДляПриложения.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный appinfo";
КонецЕсли;
Информация = Аннотация.ИнформацияДляПриложения.Получить(0);
Если ТипЗнч(Информация) <> Тип("ИнформацияДляПриложенияXS") Тогда
ВызватьИсключение "Ожидалось описание информации приложения";
КонецЕсли;
Сообщить(Информация.Источник = "urn:guide:training");
Сообщить(Информация.Контейнер = Аннотация);
Сообщить(Информация.КорневойКонтейнер <> Неопределено);
Сообщить(Информация.Схема.ПространствоИмен = "urn:guide:product");
Сообщить(Информация.Аннотация = Неопределено);
Сообщить("Тип компонента: " + Строка(Информация.ТипКомпоненты));
Сообщить("Компонентов XS внутри appinfo: " + Строка(Информация.Компоненты.Количество()));
Информация.Источник = "urn:guide:training:revised";
Информация.ОбновитьЭлементDOM();
Сообщить(Информация.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:training:revised");
Сообщить(Аннотация.Документация.Количество() = 1);Разбор по шагам
Аннотация проверяется на отсутствие до чтения списка appinfo. Количество проверено до Получить(0).
Контейнер appinfo — Аннотация, Схема указывает на собственный urn:guide:product.
Свойство Аннотация самого appinfo отдельно от его владельца; в исходном фрагменте оно отсутствует.
Источник здесь простой URN. Присваивание метки не является загрузкой данных по этой метке.
ОбновитьЭлементDOM переносит новую метку в XML-атрибут source. Соседнее documentation остаётся одним компонентом.
Как проверить результат
Семь сравнений Истина и две диагностические строки.
source изменён на собственную метку revised; описание документации не удалено.
Ожидаемый результат
Служебная метка связана с DOM без выдачи appinfo за правило валидации.
На что обратить внимание
ИнформацияДляПриложения не заменяет объявления элементов и фасеты типов.
Число Компоненты XS не является количеством произвольных DOM-тегов g:lesson.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.