Производит проверку возможности чтения из XML значения указанного типа. Данный метод получает тип данных XML из объекта ЧтениеXML, а затем пытается определить, имеется ли соответствующий тип 1С:Предприятия, аналогично тому как это делает метод ПолучитьXMLТип.
Синтаксис
ВозможностьЧтенияXML(<ЧтениеXML>)Полное описание, параметры и ограничения
Глобальный контекст.ВозможностьЧтенияXML (Global context.CanReadXML)
Глобальный контекст (Global context)
ВозможностьЧтенияXML (CanReadXML)
Доступен, начиная с версии 8.0.
Синтаксис:
ВозможностьЧтенияXML(<ЧтениеXML>)
Параметры:
<ЧтениеXML> (обязательный)
Тип: ЧтениеXML.
Объект, через который производится чтение XML.
Возвращаемое значение:
Тип: Булево.
Истина - тип 1С:Предприятия существует; Ложь - в противном случае.
Описание:
Производит проверку возможности чтения из XML значения указанного типа.
Данный метод получает тип данных XML из объекта ЧтениеXML, а затем пытается определить, имеется ли соответствующий тип 1С:Предприятия, аналогично тому как это делает метод ПолучитьXMLТип.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Сериализовать число 123,45 и прочитать его обратно
ЗаписатьXML создаёт XML-представление значения. Для варианта без имени элемент получает имя типа; результат читается обратно как число, не строка.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
ЗаписатьXML(Запись, 123.45);
XML = Запись.Закрыть();
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XML);
НайденЭлемент = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
НайденЭлемент = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденЭлемент Тогда
Чтение.Закрыть();
ВызватьИсключение "В собственном XML не найден корневой элемент";
КонецЕсли;
Попытка
Сообщить(ВозможностьЧтенияXML(Чтение));
ОписаниеТипа = ПолучитьXMLТип(Чтение);
Сообщить(ИзXMLТипа(ОписаниеТипа) = Тип("Число"));
Значение = ПрочитатьXML(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(ТипЗнч(Значение) = Тип("Число"));
Сообщить(Значение = 123.45);
Сообщить(Значение + 0.55 = 124);
Сообщить(XML);Разбор по шагам
ЗаписьXML настроена на строку: файл не создаётся. В глобальный ЗаписатьXML передаём одно собственное число.
Чтение доводим до начала корневого элемента, пропуская возможное объявление/прочие узлы.
На позиции начала элемента проверяем возможность чтения и сопоставление XML-типа. Затем ПрочитатьXML возвращает числовое значение.
Чтение закрывается на успешном и ошибочном пути. Арифметическая проверка подтверждает, что восстановлена не строка.
Как проверить результат
Пять проверок дают Истина, затем выводится XML.
В русской форме число может показываться с запятой, но XML-лексика числа использует точку; не заменяйте её вручную.
Ожидаемый результат
Числовой XML round-trip полностью в памяти.
На что обратить внимание
ВозможностьЧтенияXML проверяет распознавание типа, а не полную валидность содержимого и не соответствие произвольной XSD.
ЗаписатьXML поддерживает только типы с XML-сериализацией.
Передача объекта метаданных в ЗаписатьXML может выгрузить доступные записи: это не безобидная замена числа и в уроке запрещена.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать число, когда XML не содержит распознаваемого типа
В собственном XML есть текст 750, но нет xsi:type, а имя total не встроенный тип. Отличаем отсутствие определения типа от невозможности явно прочитать известный формат.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<total xmlns=""urn:guide:totals"">750</total>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XML);
НайденЭлемент = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
НайденЭлемент = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденЭлемент Тогда
Чтение.Закрыть();
ВызватьИсключение "В собственном XML не найден корневой элемент";
КонецЕсли;
Попытка
Сообщить(ПолучитьXMLТип(Чтение) = Неопределено);
Сообщить(Не ВозможностьЧтенияXML(Чтение));
Сумма = ПрочитатьXML(Чтение, Тип("Число"));
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(ТипЗнч(Сумма) = Тип("Число"));
Сообщить(Сумма = 750);Разбор по шагам
ПолучитьXMLТип не находит явного типа или встроенного имени элемента. Возвращается Неопределено.
ВозможностьЧтенияXML также опирается на определение XML-типа, поэтому автоматическое распознавание даёт Ложь.
Для полностью известного собственного формата передаём ожидаемый тип Число в ПрочитатьXML. Текст 750 соответствует его XML-лексике.
При несоответствии текста ожидаемому типу будет исключение. Не проглатываем его и не заменяем произвольно нулём.
Как проверить результат
Четыре проверки дают Истина.
Замените только 750 на нечисловой текст: ожидайте исключение чтения и диагностику, а не успешную сумму 0.
Ожидаемый результат
Явное чтение собственного числового формата с отличием от автоматического распознавания.
На что обратить внимание
Задавать Число для любого неизвестного XML нельзя: нужен известный контракт содержимого.
Неопределено у XML-типа — не число 0, не пустая сумма и не успешная валидация.
Не передавайте произвольные типы объектов базы ради пробного чтения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.