Глобальный контекст.ИмпортМоделиXDTO

Методы · ImportXDTOModel

Осуществляет импорт переданного набора схем XML в модель типов XDTO. Возвращаемое значение – ОбъектXDTO, имеющий тип {http://v8.1c.ru/8.1/xdto}Model. При импорте никакой проверки правильности схемы не производится. При импорте производится преобразование структуры типов схемы в структуру типов модели. Полученная модель может быть не идентична структуре типов схемы.

Синтаксис

ИмпортМоделиXDTO(<НаборСхемXML>)
Полное описание, параметры и ограничения

Глобальный контекст.ИмпортМоделиXDTO (Global context.ImportXDTOModel)

Глобальный контекст (Global context)

ИмпортМоделиXDTO (ImportXDTOModel)

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

Синтаксис:
ИмпортМоделиXDTO(<НаборСхемXML>)
Параметры:

<НаборСхемXML> (обязательный)
Тип: НаборСхемXML.
Импортируемый набор схем XML.
Возвращаемое значение:
Тип: ОбъектXDTO.

Описание:

Осуществляет импорт переданного набора схем XML в модель типов XDTO. Возвращаемое значение – ОбъектXDTO, имеющий тип {http://v8.1c.ru/8.1/xdto}Model. При импорте никакой проверки правильности схемы не производится. При импорте производится преобразование структуры типов схемы в структуру типов модели. Полученная модель может быть не идентична структуре типов схемы.

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

Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

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

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

Описание изменено в версии 8.3.20.

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

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

Создать фабрику XDTO через импорт собственной проверенной XSD

ИмпортМоделиXDTO преобразует набор схем в модель типов, но не проверяет его правильность. Сначала проверяем собственную схему, затем создаём фабрику по модели.

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

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

Подготовка

  1. Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.

  2. XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.

  3. Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.

  4. Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.

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 не прошла проверку";
КонецЕсли;
Модель = ИмпортМоделиXDTO(Набор);
Сообщить(ТипЗнч(Модель) = Тип("ОбъектXDTO"));
ФабрикаИзМодели = Новый ФабрикаXDTO(Модель);
ТипТовара = ФабрикаИзМодели.Тип("urn:guide:product", "Product");
ТипКода = ФабрикаИзМодели.Тип("urn:guide:product", "Sku");
Сообщить(ТипТовара <> Неопределено);
Сообщить(ТипКода <> Неопределено);
Если ТипТовара = Неопределено Или ТипКода = Неопределено Тогда
    ВызватьИсключение "В собственной фабрике отсутствуют Product или Sku";
КонецЕсли;
Сообщить(ТипТовара.Имя = "Product");
Сообщить(ТипТовара.URIПространстваИмен = "urn:guide:product");
Код = ФабрикаИзМодели.Создать(ТипКода, "A001");
Сообщить(Код.ЛексическоеЗначение = "A001");

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

  1. В исходнике полностью приведена XSD со строковым кодом Sku и объектом Product. ПостроительDOM и ПостроительСхемXML создают схему в памяти.

  2. Набор.Проверить выполняется до ИмпортМоделиXDTO. Сам импорт не делает эту проверку автоматически.

  3. Конструктор ФабрикаXDTO на основе модели получает объект Модель, не массив путей к файлам.

  4. Находим два типа по собственному URI и создаём значение кода A001, соответствующее ограничениям длины/шаблона.

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

  1. Шесть проверок дают Истина.

  2. В отладчике Модель — ОбъектXDTO, фабрика содержит Product и Sku; Код.ЛексическоеЗначение = A001.

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

Проверенная собственная XSD преобразована в модель и использована для создания фабрики.

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

  1. Импорт может преобразовать структуру схемы: не обещайте буквальную идентичность дерева XSD и модели XDTO.

  2. Это не импорт пакета XDTO в конфигурацию и не изменение метаданных базы.

  3. URI модели не является подключением к внешнему сервису; схема не содержит import/include внешних файлов.

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

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

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

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

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