ОпределениеГруппыМоделиXS.РазрешитьСсылку

Методы · ResolveReference

Получает разыменованную группу модели.

Синтаксис

РазрешитьСсылку()
Полное описание, параметры и ограничения

ОпределениеГруппыМоделиXS.РазрешитьСсылку (XSModelGroupDefinition.ResolveReference)

ОпределениеГруппыМоделиXS (XSModelGroupDefinition)

РазрешитьСсылку (ResolveReference)

Доступен, начиная с версии 8.1.

Синтаксис:
РазрешитьСсылку()
Возвращаемое значение:
Тип: ОпределениеГруппыМоделиXS.

Описание:

Получает разыменованную группу модели.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Разрешить ссылки Product на обе именованные группы

В Product находим настоящие ref, а затем их определения. Имя из расширенной ссылки сравниваем с разрешённым объектом.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Запускайте фрагменты отдельно на сервере учебной базы. Полная собственная XSD товара включена в код, external include/import и рабочие данные не используются.

  2. Глобальная PriceFields содержит price типа decimal, OptionalAttributes содержит currency типа string. Product включает ссылки на обе группы, кроме собственных name, quantity, note и code.

  3. Проверка набора проверяет схему. Эти уроки не утверждают, что был проверен 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);

Разбор по шагам

  1. Ссылки добавлены в исходный текст Product до построения и проверки схемы.

  2. Фрагменты последовательности обходятся по типу Часть; произвольный индекс для ref не предполагается.

  3. Ссылка на группу атрибутов отдельно ищется в собственных Атрибуты составного типа.

  4. ЭтоСсылка относится к найденным ссылкам, тогда как глобальные определения предыдущих уроков имеют Ложь.

  5. РазрешитьСсылку возвращает определения после проверки отсутствия. Фактических атрибутов Product два: собственный code и currency из группы.

Как проверить результат

  1. Шесть сообщений Истина.

  2. Обе ссылки разрешаются в собственные именованные определения.

Ожидаемый результат

Показана разница ref и глобального определения группы.

На что обратить внимание

  1. Ссылка не является копией группы; изменение определения может влиять на все использующие его типы.

  2. Фактические атрибуты типа могут включать группы, не только локальные объявления.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.