Создает фабрику XDTO из схем, которые расположены по переданным путям и на основе указанных пакетов XDTO.
Синтаксис
СоздатьФабрикуXDTO(<Путь>, <Пакеты>)СоздатьФабрикуXDTO(<Пути>, <Пакеты>)Примеры платформы
Схемы = Новый Массив;
Схемы.Добавить("путь1");
Схемы.Добавить("путь2");
Пакеты = Новый Массив;
Пакеты.Добавить(ФабрикаXDTO.Пакеты.Получить("URI пространства имен пакета из конфигурации 1"));
Пакеты.Добавить(ФабрикаXDTO.Пакеты.Получить("URI пространства имен пакета из конфигурации 2"));
МояФабрика = СоздатьФабрикуXDTO(Схемы, Пакеты);Полное описание, параметры и ограничения
Глобальный контекст.СоздатьФабрикуXDTO (Global context.CreateXDTOFactory)
Глобальный контекст (Global context)
СоздатьФабрикуXDTO (CreateXDTOFactory)
Доступен, начиная с версии 8.1.
Вариант синтаксиса: По имени файла
Синтаксис:
СоздатьФабрикуXDTO(<Путь>, <Пакеты>)
Параметры:
<Путь> (обязательный)
Тип: Строка.
Строка, представляющая собой путь к файлу, содержащему XML схему.
<Пакеты> (необязательный)
Тип: Массив.
Массив пакетов XDTO, которые используются при разыменовании директив импорта.
Описание варианта метода:
Создание фабрики XDTO по имени файла схемы XML.
Вариант синтаксиса: По списку имен файлов
Синтаксис:
СоздатьФабрикуXDTO(<Пути>, <Пакеты>)
Параметры:
<Пути> (обязательный)
Тип: Массив.
Массив путей к XML схемам, на основании которых необходимо создать фабрику XDTO.
<Пакеты> (необязательный)
Тип: Массив.
Массив пакетов XDTO, которые используются для разыменования директив импорта.
Описание варианта метода:
Создание фабрики XDTO по массиву переданных имен, а также пакетов, которые необходимо включить в состав фабрики XDTO.
Возвращаемое значение:
Тип: ФабрикаXDTO.
Описание:
Создает фабрику XDTO из схем, которые расположены по переданным путям и на основе указанных пакетов XDTO.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Схемы = Новый Массив;
Схемы.Добавить("путь1");
Схемы.Добавить("путь2");
Пакеты = Новый Массив;
Пакеты.Добавить(ФабрикаXDTO.Пакеты.Получить("URI пространства имен пакета из конфигурации 1"));
Пакеты.Добавить(ФабрикаXDTO.Пакеты.Получить("URI пространства имен пакета из конфигурации 2"));
МояФабрика = СоздатьФабрикуXDTO(Схемы, Пакеты);
Использование в версии:
Доступен, начиная с версии 8.1.
Описание изменено в версии 8.3.20.
Методическая информация
Практические примеры
Создать фабрику из одного собственного временного XSD-файла
Глобальный СоздатьФабрикуXDTO принимает путь или массив путей. Записываем только собственную схему в уникальный временный файл и сравниваем оба варианта.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
Это единственное файловое упражнение блока: создаётся новый временный XSD на стороне сервера. Не запускайте его без разрешения на учебную временную папку; рабочие файлы не указываются.
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 не прошла проверку";
КонецЕсли;
ИмяXSD = ПолучитьИмяВременногоФайла("xsd");
ТекстСхемы = Новый ТекстовыйДокумент;
ТекстСхемы.УстановитьТекст(XSD);
ТекстСхемы.Записать(ИмяXSD, КодировкаТекста.UTF8);
ФабрикаОдногоФайла = СоздатьФабрикуXDTO(ИмяXSD);
Пути = Новый Массив;
Пути.Добавить(ИмяXSD);
ФабрикаМассива = СоздатьФабрикуXDTO(Пути);
ПервыйТип = ФабрикаОдногоФайла.Тип("urn:guide:product", "Product");
ВторойТип = ФабрикаМассива.Тип("urn:guide:product", "Product");
Сообщить(ПервыйТип <> Неопределено);
Сообщить(ВторойТип <> Неопределено);
Если ПервыйТип = Неопределено Или ВторойТип = Неопределено Тогда
ВызватьИсключение "Не найден Product в фабриках из собственного файла";
КонецЕсли;
Сообщить(ПервыйТип.Имя = ВторойТип.Имя);
Сообщить(ПервыйТип.URIПространстваИмен = ВторойТип.URIПространстваИмен);
Сообщить("Создан только собственный временный XSD: " + ИмяXSD);Разбор по шагам
Сначала разбираем и проверяем собственную XSD из текста. Затем уникальное имя временного файла формируется платформой.
ТекстовыйДокумент записывает именно эту строку XSD в UTF8. Не подставляйте имя рабочего файла: единственная запись урока — новый временный XSD.
Один вызов СоздатьФабрикуXDTO получает строковый путь, второй — массив с тем же путём. Каждый создаёт свою фабрику.
Сравниваем имена и URI типов, а не идентичность объектов из двух фабрик. Файл намеренно оставлен для исследования, без автоматического удаления.
Как проверить результат
Четыре проверки дают Истина; последнее сообщение содержит созданный путь.
Откройте только этот XSD на машине выполнения серверного кода: в нём собственная схема Product/Sku. После упражнения удалите вручную только указанный учебный файл.
Ожидаемый результат
Две фабрики из одного собственного локального файла с явной границей файловой операции.
На что обратить внимание
В клиент-серверной базе временный файл создаётся на сервере, не на компьютере тонкого клиента.
Права безопасного режима/сервера могут запретить запись или чтение: тогда сохраните диагностику, не отключайте защиту ради урока.
Повторный запуск создаёт новый временный файл; контролируйте учебные файлы и удаляйте только точно указанные.
Не используйте XSD с внешними import/include по этому образцу без отдельной проверки разрешённых источников.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.