Определяет, содержит ли данный компонент указанный.
Синтаксис
Содержит(<Компонент>)Полное описание, параметры и ограничения
АннотацияXS.Содержит (XSAnnotation.Contains)
АннотацияXS (XSAnnotation)
Содержит (Contains)
Доступен, начиная с версии 8.1.
Синтаксис:
Содержит(<Компонент>)
Параметры:
<Компонент> (обязательный)
Тип: АннотацияXS, СхемаXML, ИнформацияДляПриложенияXS, ДокументацияXS, ФасетМинимальногоИсключающегоЗначенияXS, ФасетМинимальногоВключающегоЗначенияXS, ФасетМаксимальногоИсключающегоЗначенияXS, ФасетМаксимальногоВключающегоЗначенияXS, ФасетДлиныXS, ФасетМинимальнойДлиныXS, ФасетМаксимальнойДлиныXS, ФасетОбщегоКоличестваРазрядовXS, ФасетКоличестваРазрядовДробнойЧастиXS, ФасетПеречисленияXS, ФасетОбразцаXS, ФасетПробельныхСимволовXS, ОпределениеПростогоТипаXS, ОпределениеСоставногоТипаXS, ОпределениеГруппыАтрибутовXS, ОпределениеГруппыМоделиXS, ОбъявлениеАтрибутаXS, ОбъявлениеЭлементаXS, ОпределениеОграниченияИдентичностиXS, ОпределенияXPathXS, ОбъявлениеНотацииXS, МаскаXS, ИмпортXS, ВключениеXS, ПереопределениеXS, ИспользованиеАтрибутаXS, ГруппаМоделиXS, ФрагментXS.
Искомый компонент схемы XML.
Возвращаемое значение:
Тип: Булево.
Описание:
Определяет, содержит ли данный компонент указанный.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Собрать новое объявление из собственных компонентов
Создаём нотацию, аннотацию, документацию и appinfo конструкторами. Присоединяем их к собственной схеме и проверяем владельцев.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD с urn:guide:product и нотацией BookImage включена в код.
Это xs:notation внутри XSD, не узел НотацияDOM из DTD. В коде нет DOCTYPE, внешних сущностей, импорта схемы, чтения файла или сетевого запроса.
public и system — вымышленные собственные URN. Объявление метки не загружает изображение и не подтверждает существование файла.
Проверить у НаборСхем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:notation name=""BookImage"" public=""urn:guide:book-image:public"" system=""urn:guide:book-image:system"">
| <xs:annotation><xs:documentation source=""urn:guide:notation-note"" xml:lang=""ru"">Учебная метка изображения, не загрузка картинки</xs:documentation></xs:annotation>
| </xs:notation>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
Если Схема.ОбъявленияНотаций.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная нотация";
КонецЕсли;
Нотация = Схема.ОбъявленияНотаций.Получить(0);
Если ТипЗнч(Нотация) <> Тип("ОбъявлениеНотацииXS") Или Нотация.Имя <> "BookImage" Тогда
ВызватьИсключение "Не найдена собственная BookImage";
КонецЕсли;
Аннотация = Нотация.Аннотация;
Если Аннотация = Неопределено Тогда
ВызватьИсключение "У BookImage нет собственной аннотации";
КонецЕсли;
Если Аннотация.Документация.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная документация нотации";
КонецЕсли;
Документация = Аннотация.Документация.Получить(0);
НоваяНотация = Новый ОбъявлениеНотацииXS;
НоваяНотация.Имя = "BookImageExtra";
НоваяНотация.ПубличныйИдентификатор = "urn:guide:book-image:extra:public";
НоваяНотация.СистемныйИдентификатор = "urn:guide:book-image:extra:system";
НоваяАннотация = Новый АннотацияXS;
НоваяДокументация = Новый ДокументацияXS;
НоваяДокументация.Источник = "urn:guide:notation-note:extra";
НоваяДокументация.Язык = "ru";
НоваяИнформация = Новый ИнформацияДляПриложенияXS;
НоваяИнформация.Источник = "urn:guide:application-note:extra";
НоваяАннотация.Состав.Добавить(НоваяДокументация);
НоваяАннотация.Состав.Добавить(НоваяИнформация);
НоваяНотация.Аннотация = НоваяАннотация;
Схема.Содержимое.Добавить(НоваяНотация);
Схема.ОбновитьЭлементDOM();
Сообщить(Схема.ОбъявленияНотаций.Количество() = 2);
Сообщить(НоваяАннотация.Документация.Количество() = 1);
Сообщить(НоваяАннотация.ИнформацияДляПриложения.Количество() = 1);
Сообщить(НоваяДокументация.Контейнер = НоваяАннотация);
Сообщить(НоваяИнформация.Контейнер = НоваяАннотация);
Сообщить(НоваяНотация.Содержит(НоваяАннотация));
Сообщить(НоваяАннотация.Содержит(НоваяДокументация));
Сообщить(НоваяДокументация.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:notation-note:extra");
Сообщить(НоваяИнформация.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:application-note:extra");
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Собственная схема с новыми компонентами не прошла проверку";
КонецЕсли;
Схема.Содержимое.Удалить(НоваяНотация);
Сообщить(Схема.ОбъявленияНотаций.Количество() = 1);
Сообщить(Нотация.Имя = "BookImage");Разбор по шагам
Четыре конструктора создают отдельные объекты: до присоединения они не являются частью схемы.
Документация и appinfo добавляются в изменяемый Состав аннотации. Два readonly-списка отражают соответствующие виды компонентов.
Аннотация назначается новому объявлению, затем объявление добавляется в собственное Содержимое схемы.
Обновление DOM выполняется после построения связей. source — метка происхождения, не запрос по адресу.
Проверяем владельцев и принадлежность, затем удаляем только новую нотацию вместе с её собственным поддеревом.
Новые documentation/appinfo здесь содержат метки источников, без текста правил валидации; исходная документация BookImage сохраняется.
Как проверить результат
Одиннадцать сообщений Истина; глобальные нотации 1→2→1.
У новой аннотации по одному documentation и appinfo. После удаления нового поддерева остаётся исходная BookImage.
Ожидаемый результат
Конструкторы показаны в полном цикле сборки, присоединения и безопасного удаления своих компонентов.
На что обратить внимание
Не используйте НоваяНотация и её дочерние объекты после удаления из схемы.
Аннотация и служебные source не заменяют ограничения типов или проверку XML-экземпляра.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Изменить язык и источник только в копии документации
Копируем собственную аннотацию рекурсивно. Новые source и язык задаём дочерней документации копии, исходные ru и URN остаются прежними.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD с urn:guide:product и нотацией BookImage включена в код.
Это xs:notation внутри XSD, не узел НотацияDOM из DTD. В коде нет DOCTYPE, внешних сущностей, импорта схемы, чтения файла или сетевого запроса.
public и system — вымышленные собственные URN. Объявление метки не загружает изображение и не подтверждает существование файла.
Проверить у НаборСхем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:notation name=""BookImage"" public=""urn:guide:book-image:public"" system=""urn:guide:book-image:system"">
| <xs:annotation><xs:documentation source=""urn:guide:notation-note"" xml:lang=""ru"">Учебная метка изображения, не загрузка картинки</xs:documentation></xs:annotation>
| </xs:notation>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
Если Схема.ОбъявленияНотаций.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная нотация";
КонецЕсли;
Нотация = Схема.ОбъявленияНотаций.Получить(0);
Если ТипЗнч(Нотация) <> Тип("ОбъявлениеНотацииXS") Или Нотация.Имя <> "BookImage" Тогда
ВызватьИсключение "Не найдена собственная BookImage";
КонецЕсли;
Аннотация = Нотация.Аннотация;
Если Аннотация = Неопределено Тогда
ВызватьИсключение "У BookImage нет собственной аннотации";
КонецЕсли;
Если Аннотация.Документация.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная документация нотации";
КонецЕсли;
Документация = Аннотация.Документация.Получить(0);
Сообщить(Документация.Источник = "urn:guide:notation-note");
Сообщить(Документация.Язык = "ru");
Сообщить(Документация.Контейнер = Аннотация);
Сообщить(Не Документация.Содержит(Аннотация));
КопияАннотации = Аннотация.КлонироватьКомпоненту(Истина);
Если ТипЗнч(КопияАннотации) <> Тип("АннотацияXS") Тогда
ВызватьИсключение "Не получена копия своей аннотации";
КонецЕсли;
Если КопияАннотации.Документация.Количество() <> 1 Тогда
ВызватьИсключение "В копии ожидалась одна документация";
КонецЕсли;
КопияДокументации = КопияАннотации.Документация.Получить(0);
КопияДокументации.Источник = "urn:guide:notation-note:copy";
КопияДокументации.Язык = "en";
Сообщить(КопияАннотации.Содержит(КопияДокументации));
Сообщить(Не Аннотация.Содержит(КопияАннотации));
Сообщить(Документация.Источник = "urn:guide:notation-note");
Сообщить(Документация.Язык = "ru");
ОтдельнаяКопия = Документация.КлонироватьКомпоненту(Истина);
Если ТипЗнч(ОтдельнаяКопия) <> Тип("ДокументацияXS") Тогда
ВызватьИсключение "Не получена отдельная копия документации";
КонецЕсли;
ОтдельнаяКопия.Язык = "de";
Сообщить(Документация.Язык = "ru");
Сообщить(Не Документация.Содержит(ОтдельнаяКопия));Разбор по шагам
Документация принадлежит аннотации, но сама не содержит своего родителя; направление Содержит важно.
Рекурсивная копия аннотации проверяется по типу и количеству документации до индекса 0.
Новый язык en не переводит текст автоматически. Источник copy — только собственная метка.
Меняются только скалярные свойства дочернего объекта копии. Проверяется сохранность исходных ru и source.
Отдельное клонирование ДокументацияXS тоже не присоединяет результат к исходной аннотации.
Как проверить результат
Десять сообщений Истина.
Исходная документация остаётся ru и urn:guide:notation-note; изменения копий не добавлены в схему.
Ожидаемый результат
Проверена независимость скалярных меток модели документации и направление владения.
На что обратить внимание
Язык — языковая метка, не механизм перевода.
Этот пример не обещает независимость всех DOM-узлов после клонирования и не проверяет их изменение.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.