Создает значение или объект XDTO указанного типа в соответствии с переданными параметрами.
Синтаксис
Создать(<Тип>, <Значение>)Создать(<Тип>, <Строка>)Создать(<Тип>)Полное описание, параметры и ограничения
ФабрикаXDTO.Создать (XDTOFactory.Create)
ФабрикаXDTO (XDTOFactory)
Создать (Create)
Доступен, начиная с версии 8.1.
Вариант синтаксиса: Создание значения из значения
Синтаксис:
Создать(<Тип>, <Значение>)
Параметры:
<Тип> (обязательный)
Тип: ТипЗначенияXDTO.
Тип, значение которого необходимо создать.
<Значение> (обязательный)
Тип: Произвольный.
Произвольное значение, на основе которого должно быть создано значение XDTO.
Описание варианта метода:
Создает значение XDTO по произвольному значению.
Вариант синтаксиса: Создание значения по лексическому представлению
Синтаксис:
Создать(<Тип>, <Строка>)
Параметры:
<Тип> (обязательный)
Тип: ТипЗначенияXDTO.
Тип, значение которого необходимо создать.
<Строка> (обязательный)
Тип: Строка.
Лексическое представление значения.
Описание варианта метода:
Создает значение XDTO по лексическому представлению значения. Лексическое представление значения должно удовлетворять ограничениям, определяемым данным типом значения XDTO.
Вариант синтаксиса: Создание объекта
Синтаксис:
Создать(<Тип>)
Параметры:
<Тип> (обязательный)
Тип: ТипОбъектаXDTO.
Тип, объект которого необходимо создать.
Описание варианта метода:
Создает объект XDTO указанного типа.
При этом метод вернет значение типа ОбъектXDTO.
Возвращаемое значение:
Тип: ЗначениеXDTO, ОбъектXDTO.
Описание:
Создает значение или объект XDTO указанного типа в соответствии с переданными параметрами.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Описание изменено в версии 8.5.1.
Методическая информация
Практические примеры
Создать свой учебный адрес по типу из конфигурации
Три поля настоящего АдресРФ заполняются вымышленными строками. Объект не сохраняется в контактную информацию базы.
Где и как запускать
Полный серверный модуль учебной копии КА2 Progress 2.5.20.75; чтение метаданных и собственная память.
Подготовка
Отдельная учебная копия КА2 Progress 2.5.20.75 из C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS, платформа 8.5.1.1343. Не рабочая база и не произвольная другая КА2.
Создайте серверный общий модуль УчебныеПаспортаМетаданных. Вставьте полный текст одного урока и вызовите УчебныеПаспортаМетаданных.ВыполнитьПример() из своей учебной команды.
Источники: CommandGroups\Документы.xml; Catalogs\Номенклатура.xml; XDTOPackages\Адрес.xml и Адрес\Ext\Package.bin; SessionParameters\АвторизованныйПользователь.xml.
Исходники и база не меняются. Код не выполняет команды интерфейса, не заполняет параметры настоящего сеанса, не отправляет адрес и не читает персональные данные пользователя.
URI пакета является идентификатором уже установленного XDTO, не адресом для HTTP-запроса. Учебный город и улица вымышленные, объект XDTO создаётся только в памяти.
Активные расширения и язык представлений могут менять сведения. Диагностические строки о расширениях не имеют фиксированного ожидаемого значения.
Процедура ВыполнитьПример() Экспорт
ОписаниеПакета = Метаданные.ПакетыXDTO.Найти("Адрес");
Если ОписаниеПакета = Неопределено Тогда
ВызватьИсключение "Нет подтверждённого пакета Адрес";
КонецЕсли;
ТипАдреса = ФабрикаXDTO.Тип(ОписаниеПакета.ПространствоИмен, "АдресРФ");
Если ТипАдреса = Неопределено Тогда
ВызватьИсключение "Нет типа АдресРФ в подтверждённом пакете";
КонецЕсли;
УчебныйАдрес = ФабрикаXDTO.Создать(ТипАдреса);
УчебныйАдрес.СубъектРФ = "Учебная область";
УчебныйАдрес.Город = "Учебный город";
УчебныйАдрес.Улица = "Учебная улица";
Сообщить(ОписаниеПакета.Имя = "Адрес");
Сообщить(ОписаниеПакета.Пакет = Неопределено);
Сообщить(ТипЗнч(УчебныйАдрес) = Тип("ОбъектXDTO"));
Сообщить(УчебныйАдрес.СубъектРФ = "Учебная область");
Сообщить(УчебныйАдрес.Город = "Учебный город");
Сообщить(УчебныйАдрес.Улица = "Учебная улица");
Сообщить(ОписаниеПакета.Синоним);
Сообщить(ОписаниеПакета.Комментарий);
Сообщить(ОписаниеПакета.ПолноеИмя());
Сообщить(ОписаниеПакета.Представление());
Сообщить(ОписаниеПакета.ПринадлежностьОбъекта);
Сообщить(ТипЗнч(ОписаниеПакета.ОбъектРасширяемойКонфигурации));
Сообщить(ОписаниеПакета.ЕстьИзмененияРасширениямиКонфигурации());
Сообщить(ТипЗнч(ОписаниеПакета.РасширениеКонфигурации()));
Сообщить(ОписаниеПакета.Родитель() = Метаданные);
КонецПроцедурыРазбор по шагам
Получить подтверждённый тип АдресРФ из namespace пакета Адрес.
Создать ОбъектXDTO через ФабрикаXDTO.Создать с типом, а не через Новый АдресРФ.
Заполнить СубъектРФ, Город и Улица. Эти свойства есть в исходном Package.bin и допускают строку.
Сравнить три собственных значения и вывести сведения метаданных. Передача по API, сериализация и полная валидация адреса здесь не выполняются.
Как проверить результат
Семь фиксированных булевых проверок дают Истина; сведения расширений диагностические.
В памяти УчебныйАдрес, у которого три вымышленных значения. Это образец конструирования, не юридически/почтово подтверждённый адрес.
Ожидаемый результат
Реальный объект XDTO из КА2 с конкретными подтверждёнными свойствами.
На что обратить внимание
Имя свойства чувствительно к модели XDTO: не используйте произвольные ключи структуры.
Другой релиз пакета может иметь другую модель. Проверка версии базы и сверка Package.bin обязательны.
Не считайте три заполненных поля полным договором обмена: родительский тип и требования получателя надо проверять отдельно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Создать фабрику XDTO через импорт собственной проверенной XSD
ИмпортМоделиXDTO преобразует набор схем в модель типов, но не проверяет его правильность. Сначала проверяем собственную схему, затем создаём фабрику по модели.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. 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");Разбор по шагам
В исходнике полностью приведена XSD со строковым кодом Sku и объектом Product. ПостроительDOM и ПостроительСхемXML создают схему в памяти.
Набор.Проверить выполняется до ИмпортМоделиXDTO. Сам импорт не делает эту проверку автоматически.
Конструктор ФабрикаXDTO на основе модели получает объект Модель, не массив путей к файлам.
Находим два типа по собственному URI и создаём значение кода A001, соответствующее ограничениям длины/шаблона.
Как проверить результат
Шесть проверок дают Истина.
В отладчике Модель — ОбъектXDTO, фабрика содержит Product и Sku; Код.ЛексическоеЗначение = A001.
Ожидаемый результат
Проверенная собственная XSD преобразована в модель и использована для создания фабрики.
На что обратить внимание
Импорт может преобразовать структуру схемы: не обещайте буквальную идентичность дерева XSD и модели XDTO.
Это не импорт пакета XDTO в конфигурацию и не изменение метаданных базы.
URI модели не является подключением к внешнему сервису; схема не содержит import/include внешних файлов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.