Определяет, содержит ли данный компонент указанный.
Синтаксис
Содержит(<Компонент>)Полное описание, параметры и ограничения
ФасетМаксимальнойДлиныXS.Содержит (XSMaxLengthFacet.Contains)
ФасетМаксимальнойДлиныXS (XSMaxLengthFacet)
Содержит (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.
Методическая информация
Практические примеры
Проверить минимальную и максимальную длину описания товара
Учебное описание должно иметь от 3 до 20 символов. Проверяем обе границы, слишком короткий и слишком длинный текст.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Полностью вставьте код в серверную учебную процедуру. Короткие строки не содержат эмодзи или составных Unicode-символов.
Диапазон 3–20 нужен только для упражнения, не для загрузки в реальный сервис.
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:limits"" targetNamespace=""urn:guide:limits"">
| <xs:simpleType name=""Price""><xs:restriction base=""xs:decimal"">
| <xs:minInclusive value=""0""/><xs:maxInclusive value=""9999.99""/>
| <xs:totalDigits value=""6""/><xs:fractionDigits value=""2""/>
| </xs:restriction></xs:simpleType>
| <xs:simpleType name=""Discount""><xs:restriction base=""xs:decimal"">
| <xs:minExclusive value=""0""/><xs:maxExclusive value=""1""/>
| </xs:restriction></xs:simpleType>
| <xs:simpleType name=""Status""><xs:restriction base=""xs:string"">
| <xs:whiteSpace value=""collapse""/>
| <xs:enumeration value=""draft""/><xs:enumeration value=""published""/>
| <xs:enumeration value=""closed""/>
| </xs:restriction></xs:simpleType>
| <xs:simpleType name=""Description""><xs:restriction base=""xs:string"">
| <xs:minLength value=""3""/><xs:maxLength value=""20""/>
| </xs:restriction></xs:simpleType>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
Документ = Новый ПостроительDOM;
DOM = Документ.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(DOM.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не построена собственная схема ограничений";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Не прошла проверка собственной схемы";
КонецЕсли;
Фабрика = Новый ФабрикаXDTO(Набор);
Определение = Схема.ОпределенияТипов.Получить("Description", "urn:guide:limits");
ТипМодели = Фабрика.Тип("urn:guide:limits", "Description");
Сообщить(Определение.Фасеты.Количество() = 2);
Для Каждого Фасет Из Определение.Фасеты Цикл
Сообщить(Строка(Фасет.ТипКомпоненты) + ": " + Фасет.ЛексическоеЗначение);
Сообщить("Типизированное значение: " + Строка(Фасет.Значение));
Сообщить("Фиксирован в потомках: " + Строка(Фасет.Фиксированный));
Сообщить(Фасет.ОпределениеПростогоТипа.Имя = Определение.Имя);
Сообщить(Фасет.Контейнер <> Неопределено);
Сообщить(Фасет.КорневойКонтейнер <> Неопределено);
Сообщить(Фасет.Схема.ПространствоИмен = "urn:guide:limits");
Сообщить(Фасет.Аннотация = Неопределено);
Сообщить(Фасет.Компоненты.Количество() = 0);
Фасет.ОбновитьЭлементDOM();
Сообщить("XML-тег ограничения: " + Фасет.ЭлементDOM.ИмяЭлемента);
КопияФасета = Фасет.КлонироватьКомпоненту(Истина);
Сообщить(ТипЗнч(КопияФасета) = ТипЗнч(Фасет));
Сообщить(КопияФасета.ЛексическоеЗначение = Фасет.ЛексическоеЗначение);
Сообщить(Не Фасет.Содержит(КопияФасета));
КонецЦикла;
Случаи = Новый Массив;
Случаи.Добавить(Новый Структура("Текст,Ожидается", "Аб", Ложь));
Случаи.Добавить(Новый Структура("Текст,Ожидается", "ABC", Истина));
Случаи.Добавить(Новый Структура("Текст,Ожидается", "12345678901234567890", Истина));
Случаи.Добавить(Новый Структура("Текст,Ожидается", "123456789012345678901", Ложь));
Для Каждого Случай Из Случаи Цикл
Допустимо = Ложь;
Попытка
ЗначениеМодели = Фабрика.Создать(ТипМодели, Случай.Текст);
Допустимо = Истина;
Исключение
Сообщить("Отклонено: " + Случай.Текст + "; "
+ КраткоеПредставлениеОшибки(ИнформацияОбОшибке()));
КонецПопытки;
Если Допустимо <> Случай.Ожидается Тогда
ВызватьИсключение "Не совпал результат проверки значения: " + Случай.Текст;
КонецЕсли;
Сообщить(СтрШаблон("%1: допустимо = %2", Случай.Текст, Допустимо));
КонецЦикла;Разбор по шагам
minLength и maxLength дают два разных компонента ограничения, а не одну произвольную проверку в комментарии.
Лексические значения 3/20 читаются как строки; типизированные Значение фасетов — числа.
Обе длины границ включены: строка из трёх и из двадцати символов допустима.
Проверка выполняется при создании ЗначениеXDTO. Отклонённый текст не обрезается автоматически.
Чтение владельцев и XML-тегов позволяет увидеть связь бизнес-ограничения с исходной схемой.
Как проверить результат
Найдены два фасета со значениями 3 и 20.
Два символа и 21 символ отклоняются; 3 и 20 символов принимаются.
Ожидаемый результат
Границы длины описания проверены на четырёх конкретных строках без потери данных и неявного обрезания.
На что обратить внимание
Длина строки, размер UTF-8 в байтах и число визуально воспринимаемых знаков могут различаться.
Этот тип не удаляет разметку, не экранирует HTML и не проверяет смысл описания.
Пробелы для xs:string не удаляются этим контрактом: пустоту бизнес-поля при необходимости проверяйте отдельно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.