Формирует полный список атрибутов данной группы.
Синтаксис
ИспользованиеАтрибутов()Полное описание, параметры и ограничения
ОпределениеГруппыАтрибутовXS.ИспользованиеАтрибутов (XSAttributeGroupDefinition.AttributeUses)
ОпределениеГруппыАтрибутовXS (XSAttributeGroupDefinition)
ИспользованиеАтрибутов (AttributeUses)
Доступен, начиная с версии 8.1.
Синтаксис:
ИспользованиеАтрибутов()
Возвращаемое значение:
Тип: ФиксированныйСписокКомпонентXS.
Описание:
Формирует полный список атрибутов данной группы.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Прочитать группу необязательного атрибута currency
Группа OptionalAttributes содержит один необязательный currency. Получаем фактические использования атрибутов, а маску anyAttribute не придумываем.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте фрагменты отдельно на сервере учебной базы. Полная собственная 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") Тогда
ВызватьИсключение "Получены неверные типы собственных групп";
КонецЕсли;
Сообщить(ГруппаАтрибутов.Имя = "OptionalAttributes");
Сообщить(ГруппаАтрибутов.URIПространстваИмен = "urn:guide:product");
Сообщить(ГруппаАтрибутов.Контейнер = Схема);
Сообщить(ГруппаАтрибутов.КорневойКонтейнер <> Неопределено);
Сообщить(ГруппаАтрибутов.Схема.ПространствоИмен = "urn:guide:product");
Сообщить(ГруппаАтрибутов.Аннотация = Неопределено);
Сообщить(Не ГруппаАтрибутов.ЭтоСсылка);
Сообщить(Не ГруппаАтрибутов.ЭтоОпределениеЗациклено());
Сообщить("Тип компонента: " + Строка(ГруппаАтрибутов.ТипКомпоненты));
Сообщить("Число компонентов: " + Строка(ГруппаАтрибутов.Компоненты.Количество()));
Сообщить("Тип свойства Ссылка: " + Строка(ТипЗнч(ГруппаАтрибутов.Ссылка)));
ГруппаАтрибутов.ОбновитьЭлементDOM();
Сообщить(ГруппаАтрибутов.ЭлементDOM.ПолучитьАтрибут("name") = "OptionalAttributes");
Сообщить(ГруппаАтрибутов.Содержимое.Количество() = 1);
Если ГруппаАтрибутов.Содержимое.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один компонент собственной группы атрибутов";
КонецЕсли;
Сообщить("Тип маски дополнительных атрибутов: " + Строка(ТипЗнч(ГруппаАтрибутов.Маска)));
Использования = ГруппаАтрибутов.ИспользованиеАтрибутов();
Если Использования.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалось одно фактическое использование currency";
КонецЕсли;
Использование = Использования.Получить(0);
Если ТипЗнч(Использование) <> Тип("ИспользованиеАтрибутаXS") Тогда
ВызватьИсключение "Ожидалось использование собственного атрибута";
КонецЕсли;
Объявление = Использование.ОбъявлениеАтрибута;
Если Объявление = Неопределено Тогда
ВызватьИсключение "Не получено объявление currency";
КонецЕсли;
Сообщить(Объявление.Имя = "currency");
Сообщить(Не Использование.Обязательный);
Сообщить(ГруппаАтрибутов.Содержит(ГруппаАтрибутов.Содержимое.Получить(0)));Разбор по шагам
Содержимое показывает собственный состав группы, ИспользованиеАтрибутов — фактические использования атрибутов.
До Получить(0) проверено количество, тип использования проверен перед чтением объявления.
currency объявлен без use=required, поэтому не является обязательным.
Маска предназначена для дополнительных атрибутов. В полной XSD нет anyAttribute: тип значения диагностируется без выдуманного содержимого.
Оригинальная группа и её компоненты остаются в своей схеме.
Как проверить результат
Тринадцать сравнений Истина и четыре диагностические строки.
Фактическое использование currency одно и необязательное.
Ожидаемый результат
Определение атрибута и его использование разобраны отдельно.
На что обратить внимание
Атрибут currency не становится глобальным только потому, что входит в глобальную группу.
Не используйте Маска как свидетельство разрешения произвольных полей, когда anyAttribute не задан.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Скопировать две группы и удалить только свои копии
Копии получают новые имена и присоединяются к той же собственной схеме. После проверки удаляем только копии, исходные ссылки Product сохранены.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте фрагменты отдельно на сервере учебной базы. Полная собственная 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") Тогда
ВызватьИсключение "Получены неверные типы собственных групп";
КонецЕсли;
КопияПолей = ГруппаПолей.КлонироватьКомпоненту(Истина);
КопияАтрибутов = ГруппаАтрибутов.КлонироватьКомпоненту(Истина);
Если ТипЗнч(КопияПолей) <> Тип("ОпределениеГруппыМоделиXS") Или ТипЗнч(КопияАтрибутов) <> Тип("ОпределениеГруппыАтрибутовXS") Тогда
ВызватьИсключение "Получены неверные типы копий собственных групп";
КонецЕсли;
КопияПолей.Имя = "PriceFieldsCopy";
КопияАтрибутов.Имя = "OptionalAttributesCopy";
Схема.Содержимое.Добавить(КопияПолей);
Схема.Содержимое.Добавить(КопияАтрибутов);
Сообщить(Схема.ОпределенияГруппМоделей.Количество() = 2);
Сообщить(Схема.ОпределенияГруппАтрибутов.Количество() = 2);
Сообщить(КопияПолей.ГруппаМодели.Фрагменты.Количество() = 1);
Сообщить(КопияАтрибутов.ИспользованиеАтрибутов().Количество() = 1);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Схема с копиями собственных групп не прошла проверку";
КонецЕсли;
Схема.Содержимое.Удалить(КопияПолей);
Схема.Содержимое.Удалить(КопияАтрибутов);
Сообщить(Схема.ОпределенияГруппМоделей.Количество() = 1);
Сообщить(Схема.ОпределенияГруппАтрибутов.Количество() = 1);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Исходная схема после удаления копий не прошла проверку";
КонецЕсли;
Сообщить(ГруппаПолей.Имя = "PriceFields" И ГруппаАтрибутов.Имя = "OptionalAttributes");Разбор по шагам
Рекурсивно копируем собственные определения, не объекты ссылок из Product.
Новые имена предотвращают конфликт с глобальными оригиналами.
Добавление в Содержимое присоединяет модели к своей схеме; их именованные коллекции содержат по два определения.
Структура копий проверяется по одному полю и одному атрибуту; затем проверяется весь набор.
Удаляются ровно созданные копии. После удаления их объекты не используются, оригинальные определения и схема проверяются снова.
Как проверить результат
Семь сообщений Истина.
Число каждой группы меняется 1→2→1, оригинальные имена не изменены.
Ожидаемый результат
Проверен безопасный жизненный цикл двух собственных копий.
На что обратить внимание
Удаление глобального оригинала сломало бы ссылки Product; в коде удаляются только копии.
Проверяется модель схемы, не данные внешней системы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.