Тип: СписокКомпонентXS. Содержит коллекцию, определяющую состав данного компонента.
Полное описание, параметры и ограничения
АннотацияXS.Состав (XSAnnotation.Content)
АннотацияXS (XSAnnotation)
Состав (Content)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: СписокКомпонентXS.
Содержит коллекцию, определяющую состав данного компонента.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать и удалить собственную копию appinfo
Рекурсивную копию информационного компонента добавляем в свою аннотацию, задаём другой source и удаляем только её. Оригинал остаётся прежним.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная 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") Тогда
ВызватьИсключение "Ожидалось описание информации приложения";
КонецЕсли;
Копия = Информация.КлонироватьКомпоненту(Истина);
Если ТипЗнч(Копия) <> Тип("ИнформацияДляПриложенияXS") Тогда
ВызватьИсключение "Не получена копия appinfo";
КонецЕсли;
Копия.Источник = "urn:guide:training:copy";
Сообщить(Не Информация.Содержит(Копия));
Аннотация.Состав.Добавить(Копия);
Сообщить(Аннотация.ИнформацияДляПриложения.Количество() = 2);
Сообщить(Копия.Контейнер = Аннотация);
Схема.ОбновитьЭлементDOM();
Сообщить(Копия.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:training:copy");
Сообщить(Информация.Источник = "urn:guide:training");
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Собственная схема с копией appinfo не прошла проверку";
КонецЕсли;
Аннотация.Состав.Удалить(Копия);
Сообщить(Аннотация.ИнформацияДляПриложения.Количество() = 1);
Сообщить(Аннотация.Документация.Количество() = 1);
Сообщить(Информация.Источник = "urn:guide:training");Разбор по шагам
Копия проверена на точный тип до записи Источник.
Само клонирование не присоединяет компонент к аннотации. Содержит оригинала не подтверждает принадлежность копии.
Состав — изменяемая коллекция всей аннотации. Добавить в неё увеличивает список appinfo, но не documentation.
DOM обновляется через собственную схему после присоединения; новая метка проверяется по атрибуту source.
Удалить получает ровно созданную копию. После удаления она не используется; оригинальная метка и documentation сохранены.
Как проверить результат
Восемь сообщений Истина.
Количество appinfo меняется 1→2→1, количество documentation остаётся 1.
Ожидаемый результат
Полный жизненный цикл собственной копии не повреждает оригинальную аннотацию.
На что обратить внимание
Не используйте удалённую копию и не очищайте всю аннотацию чужой схемы.
Служебная информация не доказывает корректность XML-экземпляра товара.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Импортировать тип цены из другого пространства имён
Основная схема содержит цену, собственная часть — тип Amount с ограничением неотрицательности. Импорт связывает разные namespace без загрузки.
Где и как запускать
Полный модуль серверного общего модуля УчебныеЗадачи (флаг Сервер) в учебной базе. Вызовите ВыполнитьПример() из серверного обработчика своей обработки. Вставляйте обе процедуры на уровне модуля.
Подготовка
Каждый урок выполните отдельно в учебной базе. Две XSD включены строками: основная схема и её собственная часть.
urn:guide:owned-xsd-part — условное расположение собственной части. РазрешеннаяСхема присваивается непосредственно, дополнительно передаётся собственный НаборСхемXML как разыменователь.
В коде нет файлового чтения, http URL, DTD или загрузки внешней XSD. Не заменяйте URN рабочими URL и не используйте непроверенную внешнюю схему.
Проверить проверяет схемы. Он не проверяет XML с фактической ценой или кодом; проверку экземпляра выполняйте отдельно.
Процедура ВыполнитьПример() Экспорт
ОсновнаяXSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" xmlns:m=""urn:guide:money"" targetNamespace=""urn:guide:directives""><xs:element name=""price"" type=""xs:decimal""/></xs:schema>";
ЧастьXSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" targetNamespace=""urn:guide:money""><xs:simpleType name=""Amount""><xs:restriction base=""xs:decimal""><xs:minInclusive value=""0""/></xs:restriction></xs:simpleType></xs:schema>";
Основная = ПрочитатьСвоюСхему(ОсновнаяXSD);
Часть = ПрочитатьСвоюСхему(ЧастьXSD);
Часть.РасположениеСхемы = "urn:guide:owned-xsd-part";
Директива = Новый ИмпортXS;
Директива.РасположениеСхемы = "urn:guide:owned-xsd-part";
Директива.РазрешеннаяСхема = Часть;
Если Основная.ПространствоИмен = Часть.ПространствоИмен Тогда
ВызватьИсключение "Для этого импорта нужны разные namespace";
КонецЕсли;
Директива.ПространствоИмен = "urn:guide:money";
Директива.Префикс = "m";
Сообщить(Директива.ПространствоИмен = Часть.ПространствоИмен);
Сообщить(Директива.Префикс = "m");
Аннотация = Новый АннотацияXS;
Пояснение = Новый ДокументацияXS;
Пояснение.Источник = "urn:guide:directive-note";
Пояснение.Язык = "ru";
Аннотация.Состав.Добавить(Пояснение);
Директива.Аннотация = Аннотация;
Основная.Содержимое.Вставить(0, Директива);
Корень = Основная.ОбъявленияЭлементов.Получить("price", "urn:guide:directives");
Если Корень = Неопределено Тогда
ВызватьИсключение "Не найден собственный корень price";
КонецЕсли;
Корень.ИмяТипа = Новый РасширенноеИмяXML("urn:guide:money", "Amount");
Директива.ОбновитьЭлементDOM();
Основная.ОбновитьЭлементDOM();
Разыменователь = Новый НаборСхемXML;
Разыменователь.Добавить(Часть);
Набор = Новый НаборСхемXML;
Набор.Добавить(Основная);
Если Не Набор.Проверить(Разыменователь) Тогда
ВызватьИсключение "Собственные связанные XSD не прошли проверку";
КонецЕсли;
Сообщить(Основная.Директивы.Количество() = 1);
Сообщить(Директива.Контейнер = Основная);
Сообщить(Директива.КорневойКонтейнер = Основная);
Сообщить(Директива.Схема = Основная);
Сообщить(Директива.ТипКомпоненты = ТипКомпонентыXS.Импорт);
Сообщить(Директива.ЭлементDOM <> Неопределено);
Сообщить(Директива.Содержит(Директива.Аннотация));
Сообщить(Директива.Компоненты.Количество() > 0);
Сообщить(Директива.РазрешеннаяСхема = Часть);
Сообщить(Директива.РасположениеСхемы = "urn:guide:owned-xsd-part");
Сообщить(Корень.ИмяТипа.URIПространстваИмен = "urn:guide:money" И Корень.ИмяТипа.ЛокальноеИмя = "Amount");
ИсходныйТип = Часть.ОпределенияТипов.Получить("Amount", "urn:guide:money");
Если ИсходныйТип = Неопределено Тогда
ВызватьИсключение "Не найден тип в собственной части";
КонецЕсли;
Копия = Директива.КлонироватьКомпоненту(Истина);
Если ТипЗнч(Копия) <> Тип("ИмпортXS") Или Копия.Аннотация = Неопределено Тогда
ВызватьИсключение "Не скопирована директива с аннотацией";
КонецЕсли;
Если Копия.Аннотация.Состав.Количество() <> 1 Тогда
ВызватьИсключение "В копии должна быть одна собственная документация";
КонецЕсли;
ПояснениеКопии = Копия.Аннотация.Состав.Получить(0);
Если ТипЗнч(ПояснениеКопии) <> Тип("ДокументацияXS") Тогда
ВызватьИсключение "В копии получен не тот компонент";
КонецЕсли;
ПояснениеКопии.Источник = "urn:guide:directive-note:copy";
ПояснениеКопии.Язык = "en";
Сообщить(Пояснение.Источник = "urn:guide:directive-note" И Пояснение.Язык = "ru");
Сообщить(ПояснениеКопии.Источник = "urn:guide:directive-note:copy" И ПояснениеКопии.Язык = "en");
Сообщить(Основная.Директивы.Количество() = 1);
КонецПроцедуры
Функция ПрочитатьСвоюСхему(ТекстXSD)
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXSD);
Попытка
ПостроительДерева = Новый ПостроительDOM;
ДокументСхемы = ПостроительДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
ПостроительСхем = Новый ПостроительСхемXML;
Результат = ПостроительСхем.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Результат = Неопределено Тогда
ВызватьИсключение "Не построена собственная схема";
КонецЕсли;
Возврат Результат;
КонецФункцииРазбор по шагам
Читаем две свои строки XSD в отдельные СхемаXML. Функция закрывает ЧтениеXML при успехе и исключении.
ИмпортXS создаётся конструктором. ПространствоИмен указывает urn:guide:money, Префикс m служит генерации XML и не меняет смысл namespace.
Директива вставляется в начало Содержимое: xs:import должен предшествовать глобальному элементу.
Корень price получает QName типа Amount: URI первым аргументом, локальное имя вторым.
РазрешеннаяСхема задаётся собственным объектом. Проверить получает собственный разыменователь с частью, а не URL.
Рекурсивная копия меняет только своё пояснение. Она не присоединяется: исходная схема сохраняет одну директиву.
Как проверить результат
Если проверки проходят, все шестнадцать сообщений Истина; корень ссылается на Amount из urn:guide:money.
Отдельно проверяйте экземпляр price: 12.50 соответствует ограничению Amount, -1 нарушает minInclusive. Этот BSL-код проверяет схему, не экземпляр.
Ожидаемый результат
Импортирован конкретный учебный тип цены с явно заданным источником в памяти.
На что обратить внимание
Импорт предназначен для другого namespace; включение работает иначе.
Рекурсивная копия директивы не выдается за глубокую независимую копию всей РазрешеннаяСхема.
Источник документации — маркер происхождения пустого поясняющего компонента, не URL для скачивания.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.