Тип: Строка. Имя текущего узла XML. Содержит квалифицированное имя для текущего узла. Имя зависит от типа текущего узла: Атрибут - имя атрибута; ОпределениеТипаДокумента - имя типа документа; НачалоЭлемента - имя элемента; КонецЭлемента - имя элемента; СсылкаНаСущность - имя ссылки на сущность; ИнструкцияОбработки - адрес инструкции обработки; ОбъявлениеXML - строка xml. Для узлов, для которых имя не определено, свойство содержит пустую строку.
Полное описание, параметры и ограничения
ЧтениеXML.Имя (XMLReader.Name)
ЧтениеXML (XMLReader)
Имя (Name)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Имя текущего узла XML.
Содержит квалифицированное имя для текущего узла. Имя зависит от типа текущего узла:
Атрибут - имя атрибута;
ОпределениеТипаДокумента - имя типа документа;
НачалоЭлемента - имя элемента;
КонецЭлемента - имя элемента;
СсылкаНаСущность - имя ссылки на сущность;
ИнструкцияОбработки - адрес инструкции обработки;
ОбъявлениеXML - строка xml.
Для узлов, для которых имя не определено, свойство содержит пустую строку.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Записать и прочитать XML с пространством имён
Префикс p — сокращение, URI urn:amadesk:products — настоящее имя пространства. Для поиска проверяем URI и локальное имя.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст, документ формируется в памяти.
URI здесь — идентификатор учебного формата, а не адрес, на который будет выполнен сетевой запрос.
URI = "urn:amadesk:products";
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Попытка
Запись.ЗаписатьНачалоЭлемента("p:product");
Запись.ЗаписатьСоответствиеПространстваИмен("p", URI);
Запись.ЗаписатьАтрибут("code", "A-01");
Запись.ЗаписатьАтрибут("p:status", "active");
Сообщить(Запись.НайтиПрефикс(URI));
Запись.ЗаписатьНачалоЭлемента("p:name");
Запись.ЗаписатьТекст("Книга");
Запись.ЗаписатьКонецЭлемента();
Запись.ЗаписатьКонецЭлемента();
ТекстXML = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);
Попытка
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента
И Чтение.URIПространстваИмен = URI
И Чтение.ЛокальноеИмя = "product" Тогда
Сообщить(Чтение.Имя);
Сообщить(Чтение.Префикс);
Сообщить(Чтение.ЗначениеАтрибута("status", URI));
Для Номер = 0 По Чтение.КоличествоАтрибутов() - 1 Цикл
Сообщить(Чтение.ЛокальноеИмяАтрибута(Номер));
Сообщить(Чтение.URIПространстваИменАтрибута(Номер));
Сообщить(Чтение.ПрефиксАтрибута(Номер));
Сообщить(Чтение.ТипАтрибута(Номер));
КонецЦикла;
КонецЕсли;
КонецЦикла;
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();Разбор по шагам
Создаём имя p:product и объявляем соответствие префикса p пространству URI.
Непрефиксный code не принадлежит этому пространству; p:status принадлежит.
При чтении сравниваем ЛокальноеИмя и URIПространстваИмен, не только текст p:product.
Для атрибутов смотрим локальное имя, URI и префикс по индексу.
Как проверить результат
НайтиПрефикс выдаёт p; значение атрибута status в заданном URI — active.
Согласованно замените префикс p на item при записи: проверка по URI и локальному имени продолжит находить товар.
Ожидаемый результат
Товар найден независимо от выбранного сокращения пространства имён.
На что обратить внимание
Порядок аргументов ЗначениеАтрибута здесь: локальное имя, URI. У DOM аналогичный метод может принимать URI раньше имени.
Пространство по умолчанию для элементов не распространяется автоматически на непрефиксные атрибуты.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Обойти атрибуты курсором и затем перейти к дочернему элементу
ПервыйАтрибут/СледующийАтрибут изменяют текущий узел чтения. Собираем code/quantity по имени, не предполагая порядок атрибутов.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<product code=""A-01"" quantity=""3""><title>Книга</title></product>";
Параметры = Новый ПараметрыЧтенияXML;
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
Атрибуты = Новый Соответствие;
ЕстьАтрибут = Чтение.ПервыйАтрибут();
Пока ЕстьАтрибут Цикл
Сообщить(Чтение.ТипУзла = ТипУзлаXML.Атрибут);
Сообщить(Чтение.ИмеетИмя И Чтение.ИмеетЗначение);
Сообщить(Не Чтение.ЭтоАтрибутПоУмолчанию);
Атрибуты.Вставить(Чтение.Имя, Чтение.Значение);
ЕстьАтрибут = Чтение.СледующийАтрибут();
КонецЦикла;
Сообщить(Атрибуты.Количество() = 2);
Сообщить(Атрибуты.Получить("code") = "A-01");
Сообщить(Атрибуты.Получить("quantity") = "3");
Если Не Чтение.Прочитать() Тогда
ВызватьИсключение "Ожидался дочерний title";
КонецЕсли;
Сообщить(Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента И Чтение.Имя = "title");
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Создаём соответствие и начинаем позиционирование только на начале product.
После перехода свойства относятся к текущему атрибуту, не к product.
Значение quantity остаётся строкой "3": числовую конверсию для обмена делают отдельно.
После окончания атрибутов Прочитать продолжает чтение узлов документа; проверяем title.
Как проверить результат
Все десять сравнений Истина: по три на каждый явный атрибут, три для соответствия и одно для title.
Перестановка code/quantity в XML не изменяет итоговое соответствие.
Ожидаемый результат
Отработано позиционирование на атрибутах без зависимости от их порядка.
На что обратить внимание
ЭтоАтрибутПоУмолчанию имеет смысл именно на узле Атрибут.
Прочитать не заменяет СледующийАтрибут: это переход по узлам документа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.