Проверяет зациклинность определения. Под зацикленностью определения понимается: зацикленность по базовым типам; зацикленность ссылок на определения групп атрибутов; зацикленность ссылок на определения групп модели.
Синтаксис
ЭтоОпределениеЗациклено()Полное описание, параметры и ограничения
ОпределениеГруппыМоделиXS.ЭтоОпределениеЗациклено (XSModelGroupDefinition.IsCircular)
ОпределениеГруппыМоделиXS (XSModelGroupDefinition)
ЭтоОпределениеЗациклено (IsCircular)
Доступен, начиная с версии 8.1.
Синтаксис:
ЭтоОпределениеЗациклено()
Возвращаемое значение:
Тип: Булево.
Истина - определение зациклено, Ложь - в противном случае.
Описание:
Проверяет зациклинность определения.
Под зацикленностью определения понимается:
зацикленность по базовым типам;
зацикленность ссылок на определения групп атрибутов;
зацикленность ссылок на определения групп модели.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Прочитать именованную группу поля цены
PriceFields — глобальное определение группы, а внутри находится модель sequence с полем price. Это не строка товара и не ссылка на группу.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте фрагменты отдельно на сервере учебной базы. Полная собственная XSD товара включена в код, external include/import и рабочие данные не используются.
Глобальная PriceFields содержит price типа decimal, OptionalAttributes содержит currency типа string. Product включает ссылки на обе группы, кроме собственных name, quantity, note и code.
Проверка набора проверяет схему. Эти уроки не утверждают, что был проверен 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:group ref=""g:PriceFields""/></xs:sequence><xs:attribute name=""code"" type=""g:Sku"" use=""required""/><xs:attributeGroup ref=""g:OptionalAttributes""/>
| </xs:complexType>
| <xs:element name=""product"" type=""g:Product""/>
| <xs:attribute name=""globalCode"" type=""g:Sku""/>
| <xs:group name=""PriceFields""><xs:sequence><xs:element name=""price"" type=""xs:decimal""/></xs:sequence></xs:group>
| <xs:attributeGroup name=""OptionalAttributes""><xs:attribute name=""currency"" type=""xs:string""/></xs:attributeGroup>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
ГруппаПолей = Схема.ОпределенияГруппМоделей.Получить("PriceFields", "urn:guide:product");
ГруппаАтрибутов = Схема.ОпределенияГруппАтрибутов.Получить("OptionalAttributes", "urn:guide:product");
Если ГруппаПолей = Неопределено Или ГруппаАтрибутов = Неопределено Тогда
ВызватьИсключение "Не найдены собственные глобальные группы";
КонецЕсли;
Если ТипЗнч(ГруппаПолей) <> Тип("ОпределениеГруппыМоделиXS") Или ТипЗнч(ГруппаАтрибутов) <> Тип("ОпределениеГруппыАтрибутовXS") Тогда
ВызватьИсключение "Получены неверные типы собственных групп";
КонецЕсли;
Сообщить(ГруппаПолей.Имя = "PriceFields");
Сообщить(ГруппаПолей.URIПространстваИмен = "urn:guide:product");
Сообщить(ГруппаПолей.Контейнер = Схема);
Сообщить(ГруппаПолей.КорневойКонтейнер <> Неопределено);
Сообщить(ГруппаПолей.Схема.ПространствоИмен = "urn:guide:product");
Сообщить(ГруппаПолей.Аннотация = Неопределено);
Сообщить(Не ГруппаПолей.ЭтоСсылка);
Сообщить(Не ГруппаПолей.ЭтоОпределениеЗациклено());
Сообщить("Тип компонента: " + Строка(ГруппаПолей.ТипКомпоненты));
Сообщить("Число компонентов: " + Строка(ГруппаПолей.Компоненты.Количество()));
Сообщить("Тип свойства Ссылка: " + Строка(ТипЗнч(ГруппаПолей.Ссылка)));
ГруппаПолей.ОбновитьЭлементDOM();
Сообщить(ГруппаПолей.ЭлементDOM.ПолучитьАтрибут("name") = "PriceFields");
Модель = ГруппаПолей.ГруппаМодели;
Если ТипЗнч(Модель) <> Тип("ГруппаМоделиXS") Тогда
ВызватьИсключение "Ожидалась модель собственной группы PriceFields";
КонецЕсли;
Если Модель.Фрагменты.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один фрагмент собственного поля цены";
КонецЕсли;
Цена = Модель.Фрагменты.Получить(0).Часть;
Если ТипЗнч(Цена) <> Тип("ОбъявлениеЭлементаXS") Тогда
ВызватьИсключение "Ожидалось объявление price";
КонецЕсли;
Сообщить(Цена.Имя = "price");
Сообщить(Цена.ОпределениеТипа().Имя = "decimal");
Сообщить(ГруппаПолей.Содержит(Модель));Разбор по шагам
Глобальная группа найдена по локальному имени и URI, не по порядку коллекции.
ЭтоСсылка=Ложь описывает определение, а не ref внутри Product.
Контейнер и URI связывают определение с собственной схемой, ОбновитьЭлементDOM позволяет проверить XML-имя.
ГруппаМодели даёт реальную sequence. Перед чтением единственного фрагмента проверяются тип и количество.
Поле price имеет тип decimal. Содержит проверяет модель внутри своего определения группы.
Как проверить результат
Двенадцать сравнений Истина и три диагностические строки.
В именованной группе одно поле price типа decimal.
Ожидаемый результат
Глобальное определение, его модель и конкретное поле цены разделены.
На что обратить внимание
Количество фрагментов не означает количество строк XML-документа.
Определение группы не создаёт цену товара в базе.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.