Выполняет преобразование из строки, полученной из текста элемента или значения атрибута XML, в значение в соответствии с указанным типом.
Синтаксис
XMLЗначение(<Тип>, <СтрокаXML>)Полное описание, параметры и ограничения
СериализаторXDTO.XMLЗначение (XDTOSerializer.XMLValue)
СериализаторXDTO (XDTOSerializer)
XMLЗначение (XMLValue)
Доступен, начиная с версии 8.1.
Синтаксис:
XMLЗначение(<Тип>, <СтрокаXML>)
Параметры:
<Тип> (обязательный)
Тип: Тип.
Тип, значение которого надо получить при преобразовании из строки.
<СтрокаXML> (обязательный)
Тип: Строка.
Строка, содержащая строковое представление значения, полученное из XML.
Возвращаемое значение:
Тип: Null, Булево, Число, Строка, Дата, УникальныйИдентификатор, ДвоичныеДанные, ХранилищеЗначения; значения перечислений, значения системных перечислений (ВидСчета, ВидДвиженияБухгалтерии, ВидДвиженияНакопления, ДопустимыйЗнак, ДопустимаяДлина, ЧастиДаты), Неопределено или все ссылки на объекты базы данных.
Описание:
Выполняет преобразование из строки, полученной из текста элемента или значения атрибута XML, в значение в соответствии с указанным типом.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Выполняет действие, обратное действию метода XMLСтрока.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать 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.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Получить XML-представление числа без локальных разделителей
1234.5 остаётся числом. XMLСтрока даёт лексическое представление с точкой, но не добавляет XML-теги и не экранирует произвольный текст.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Число и логические значения заданы в коде; HTTP, файл и прикладные объекты не используются.
Для первого запуска оставьте число 1234.5. Не применяйте Формат с группировкой разрядов к машинному представлению.
Сериализатор = Новый СериализаторXDTO;
ЧислоДляОбмена = 1234.5;
ЛексическоеЗначение = Сериализатор.XMLСтрока(ЧислоДляОбмена);
Восстановленное = Сериализатор.XMLЗначение(Тип("Число"), ЛексическоеЗначение);
Сообщить(ЛексическоеЗначение = "1234.5");
Сообщить(ТипЗнч(Восстановленное) = Тип("Число"));
Сообщить(Восстановленное = ЧислоДляОбмена);
ТипXML = Сериализатор.XMLТипЗнч(ЧислоДляОбмена);
Если ТипXML = Неопределено Тогда
ВызватьИсключение "У учебного числа ожидалось XML-представление типа";
КонецЕсли;
Сообщить("Тип XML: {" + ТипXML.URIПространстваИмен + "}" + ТипXML.ИмяТипа);
Сообщить(Сериализатор.ИзXMLТипа(ТипXML) = Тип("Число"));
Сообщить(Сериализатор.ИзXMLТипа(ТипXML.ИмяТипа, ТипXML.URIПространстваИмен) = Тип("Число"));
Сообщить(Сериализатор.XMLСтрока(Истина) = "true");
Сообщить(Сериализатор.XMLЗначение(Тип("Булево"), "false") = Ложь);Разбор по шагам
Создаём стандартный сериализатор платформы, не отдельный формат обмена Авито или другого сервиса.
XMLСтрока и XMLЗначение переводят отдельное скалярное значение в лексическую форму и обратно по известному типу.
XMLТипЗнч возвращает описание XML-типа или Неопределено. Проверяем наличие перед чтением ИмяТипа и URIПространстваИмен.
Оба варианта ИзXMLТипа сопоставляют XML-тип с типом платформы. URI является частью идентичности типа.
Логические значения имеют лексические true/false, не русские слова Истина/Ложь.
Как проверить результат
XML-число равно строке 1234.5, восстановленный результат — Число и равен исходному.
Оба варианта сопоставления типа возвращают Тип("Число").
Булево сериализуется как true; чтение false даёт Ложь.
Ожидаемый результат
Проверен обратимый скалярный обмен без влияния локального представления для пользователя.
На что обратить внимание
XMLСтрока не является полноценным XML-документом. Теги и экранирование делайте через ЗаписьXML/сериализатор документа.
Внешний сервис может требовать другое имя элемента и контракт; внутреннее представление платформы не заменяет его спецификацию.
Ссылки из другой информационной базы нельзя считать существующими только по их XML-представлению.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.