Синтаксис и применение XDTO в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
XDTO
XDTO
Механизм XDTO позволяет создать модель представления данных (модель типов и значений), которая, с одной стороны, обеспечивает возможность просто и естественно манипулировать данными в среде 1С:Предприятия 8, а с другой стороны, данная модель хорошо приспособлена для прозрачного преобразования данных в другие форматы, главным образом XML.
Для типов, определяемых конфигурацией, имя совпадает с именем типа, определенного в пространстве имен {http://v8.1c.ru/8.1/data/enterprise/current-config}.
Соответствие имен типов платформы и XDTO указывается в описании объектов.
Для примитивных типов используется следующее соответствие имен:
Булево:
{http://www.w3.org/2001/XMLSchema}boolean
Дата:
{http://www.w3.org/2001/XMLSchema}date
{http://www.w3.org/2001/XMLSchema}dateTime
{http://www.w3.org/2001/XMLSchema}time
Число:
{http://www.w3.org/2001/XMLSchema}decimal
{http://www.w3.org/2001/XMLSchema}double
float {http://www.w3.org/2001/XMLSchema}
Строка:
{http://www.w3.org/2001/XMLSchema}anySimpleType
{http://www.w3.org/2001/XMLSchema}anyURI
{http://www.w3.org/2001/XMLSchema}duration
{http://www.w3.org/2001/XMLSchema}gDay
{http://www.w3.org/2001/XMLSchema}gMonth
{http://www.w3.org/2001/XMLSchema}gMonthDay
{http://www.w3.org/2001/XMLSchema}gYear
{http://www.w3.org/2001/XMLSchema}gYearMonth
{http://www.w3.org/2001/XMLSchema}NOTATION
{http://www.w3.org/2001/XMLSchema}string
Тип:
{http://v8.1c.ru/8.1/data/core}Type
Методическая информация
Практические примеры
Создать XDTO decimal и отделить число от его лексической формы
Стандартный XML Schema decimal не является произвольным объектом товара. Фабрика создаёт типизированное значение по заданному скалярному типу.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используется стандартная фабрика созданного сериализатора и стандартное пространство имён XML Schema.
Свой пакет XDTO, WSDL и внешняя XSD для этого скалярного примера не нужны.
СтандартныйСериализатор = Новый СериализаторXDTO;
Фабрика = СтандартныйСериализатор.Фабрика;
ТипDecimal = Фабрика.Тип("http://www.w3.org/2001/XMLSchema", "decimal");
Если ТипDecimal = Неопределено Тогда
ВызватьИсключение "Стандартный тип decimal не найден в фабрике";
КонецЕсли;
Значение = Фабрика.Создать(ТипDecimal, "1234.50");
Сообщить(ТипЗнч(Значение) = Тип("ЗначениеXDTO"));
Сообщить(Значение.Значение = 1234.5);
Сообщить(Значение.Тип().Имя = "decimal");
Сообщить(Значение.Тип().URIПространстваИмен = "http://www.w3.org/2001/XMLSchema");
Сообщить("Лексическая форма: " + Значение.ЛексическоеЗначение);
Если ТипDecimal.БазовыйТип <> Неопределено Тогда
Сообщить("Базовый тип: " + ТипDecimal.БазовыйТип.Имя);
КонецЕсли;
Сообщить(Значение.Фабрика() = Фабрика);
ДругойСериализатор = Новый СериализаторXDTO(Фабрика);
Сообщить(ДругойСериализатор.XMLЗначение(Тип("Число"), Значение.ЛексическоеЗначение) = 1234.5);Разбор по шагам
Фабрика содержит модель типов, а Тип ищет конкретный тип по двум частям: URI и имени.
Создать по ТипЗначенияXDTO и лексической строке возвращает ЗначениеXDTO, не ОбъектXDTO.
Значение содержит число 1234.5; ЛексическоеЗначение — допустимое текстовое представление, которое не обязано сохранять все исходные нули.
Тип() и Фабрика() возвращают происхождение значения. БазовыйТип может отсутствовать, поэтому обращение защищено.
Создаём второй сериализатор на той же фабрике и проверяем числовое чтение лексического представления.
Как проверить результат
Тип результата ЗначениеXDTO, числовое значение 1234.5 и имя типа decimal.
URI соответствует http://www.w3.org/2001/XMLSchema, фабрика значения совпадает с использованной.
Повторное чтение лексического числа даёт 1234.5. Не требуйте посимвольного сохранения 1234.50.
Ожидаемый результат
Стандартное значение XDTO проверено по типу, числовому значению и происхождению фабрики.
На что обратить внимание
decimal здесь не устанавливает ограничения цены 12.2, валюту или правила округления конкретного приложения.
ЗначениеXDTO имеет свойства только для чтения; для другого значения вызовите Создать заново.
Для составного товарного объекта нужна собственная согласованная схема и ТипОбъектаXDTO.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.