Формирует фактический список атрибутов данного типа (включает атрибуты базовых типов).
Синтаксис
ИспользованиеАтрибутов()Полное описание, параметры и ограничения
ОпределениеСоставногоТипаXS.ИспользованиеАтрибутов (XSComplexTypeDefinition.AttributeUses)
ОпределениеСоставногоТипаXS (XSComplexTypeDefinition)
ИспользованиеАтрибутов (AttributeUses)
Доступен, начиная с версии 8.1.
Синтаксис:
ИспользованиеАтрибутов()
Возвращаемое значение:
Тип: ФиксированныйСписокКомпонентXS.
Описание:
Формирует фактический список атрибутов данного типа (включает атрибуты базовых типов).
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Разрешить ссылки Product на обе именованные группы
В Product находим настоящие ref, а затем их определения. Имя из расширенной ссылки сравниваем с разрешённым объектом.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте фрагменты отдельно на сервере учебной базы. Полная собственная 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") Тогда
ВызватьИсключение "Получены неверные типы собственных групп";
КонецЕсли;
ТипТовара = Схема.ОпределенияТипов.Получить("Product", "urn:guide:product");
Если ТипЗнч(ТипТовара) <> Тип("ОпределениеСоставногоТипаXS") Тогда
ВызватьИсключение "Нет собственного составного типа Product";
КонецЕсли;
СсылкаПолей = Неопределено;
Для Каждого Фрагмент Из ТипТовара.Содержимое.Часть.Фрагменты Цикл
Если ТипЗнч(Фрагмент.Часть) = Тип("ОпределениеГруппыМоделиXS") Тогда
СсылкаПолей = Фрагмент.Часть;
КонецЕсли;
КонецЦикла;
СсылкаАтрибутов = Неопределено;
Для Каждого Часть Из ТипТовара.Атрибуты Цикл
Если ТипЗнч(Часть) = Тип("ОпределениеГруппыАтрибутовXS") Тогда
СсылкаАтрибутов = Часть;
КонецЕсли;
КонецЦикла;
Если СсылкаПолей = Неопределено Или СсылкаАтрибутов = Неопределено Тогда
ВызватьИсключение "В Product не найдены собственные ссылки на группы";
КонецЕсли;
Сообщить(СсылкаПолей.ЭтоСсылка И СсылкаАтрибутов.ЭтоСсылка);
Сообщить(СсылкаПолей.Ссылка.ЛокальноеИмя = "PriceFields");
Сообщить(СсылкаАтрибутов.Ссылка.ЛокальноеИмя = "OptionalAttributes");
РазрешённыеПоля = СсылкаПолей.РазрешитьСсылку();
РазрешённыеАтрибуты = СсылкаАтрибутов.РазрешитьСсылку();
Если РазрешённыеПоля = Неопределено Или РазрешённыеАтрибуты = Неопределено Тогда
ВызватьИсключение "Не разрешились ссылки собственных групп";
КонецЕсли;
Сообщить(РазрешённыеПоля.Имя = "PriceFields");
Сообщить(РазрешённыеАтрибуты.Имя = "OptionalAttributes");
Сообщить(ТипТовара.ИспользованиеАтрибутов().Количество() = 2);Разбор по шагам
Ссылки добавлены в исходный текст Product до построения и проверки схемы.
Фрагменты последовательности обходятся по типу Часть; произвольный индекс для ref не предполагается.
Ссылка на группу атрибутов отдельно ищется в собственных Атрибуты составного типа.
ЭтоСсылка относится к найденным ссылкам, тогда как глобальные определения предыдущих уроков имеют Ложь.
РазрешитьСсылку возвращает определения после проверки отсутствия. Фактических атрибутов Product два: собственный code и currency из группы.
Как проверить результат
Шесть сообщений Истина.
Обе ссылки разрешаются в собственные именованные определения.
Ожидаемый результат
Показана разница ref и глобального определения группы.
На что обратить внимание
Ссылка не является копией группы; изменение определения может влиять на все использующие его типы.
Фактические атрибуты типа могут включать группы, не только локальные объявления.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отличить объявление атрибута code от его обязательного использования
У Product один обязательный атрибут code типа Sku. Читаем фактический список атрибутов и определение типа, не ищем локальный code среди глобальных атрибутов схемы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В схеме code объявлен внутри Product с use=required; глобальных xs:attribute в ней нет.
Запустите код на сервере учебной базы с исходной схемой из начала примера.
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:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
ТипТовара = Схема.ОпределенияТипов.Получить("Product", "urn:guide:product");
Сообщить(ТипТовара.Атрибуты.Количество() = 1);
ФактическиеАтрибуты = ТипТовара.ИспользованиеАтрибутов();
Сообщить(ФактическиеАтрибуты.Количество() = 1);
ИспользованиеКода = ФактическиеАтрибуты.Получить(0);
Сообщить(ФактическиеАтрибуты.Содержит(ИспользованиеКода));
Сообщить(ИспользованиеКода.Обязательный);
Сообщить("Категория использования: " + Строка(ИспользованиеКода.Использование));
Сообщить("Ограничение fixed/default: " + Строка(ИспользованиеКода.Ограничение));
Код = ИспользованиеКода.ОбъявлениеАтрибута;
Сообщить(Код.Имя = "code");
Сообщить(Не Код.ЭтоГлобальноеОбъявление);
Сообщить(Не Код.ЭтоСсылка);
Сообщить(Код.АнонимноеОпределениеТипа = Неопределено);
Сообщить("Форма атрибута: " + Строка(Код.Форма));
Сообщить("URI атрибута: [" + Код.URIПространстваИмен + "]");
ТипКода = Код.ОпределениеТипа();
Сообщить(ТипКода.Имя = "Sku");
Сообщить(ТипКода.URIПространстваИмен = "urn:guide:product");
Сообщить(ТипКода.Фасеты.Количество() = 2);
Сообщить(Схема.ОбъявленияАтрибутов.Количество() = 0);Разбор по шагам
Атрибуты показывает собственное описание типа, ИспользованиеАтрибутов — фактический список, включая наследуемые атрибуты.
Из фиксированного списка получаем использование атрибута. Обязательный отражает use=required.
ОбъявлениеАтрибута описывает имя, форму и тип. Обязательность использования не следует угадывать по имени code.
Атрибут не ссылка ref и не анонимный тип: ОпределениеТипа возвращает именованный Sku.
По умолчанию атрибуты этой схемы неквалифицированные, даже при qualified для элементов. URI самого атрибута отличается от URI его типа.
Глобальная коллекция ОбъявленияАтрибутов пуста — это не означает, что у Product нет атрибутов.
Как проверить результат
Один собственный и один фактический атрибут; обязательность Истина.
Имя code, тип Sku в urn:guide:product, два фасета типа.
Атрибут локальный, не ref, глобальных объявлений атрибутов ноль.
Ожидаемый результат
На конкретном обязательном атрибуте отделены использование, объявление, пространство имени и определение типа.
На что обратить внимание
Унаследованные атрибуты могут входить в фактический список, но не в собственный список нового типа.
Отсутствующий атрибут и атрибут с пустой строкой — разные случаи; Sku дополнительно ограничен длиной/образцом.
URI типа атрибута не нужно переносить на имя самого XML-атрибута автоматически.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.