Тип: Строка. Содержит локальное имя для текущего узла XML. Имя зависит от типа текущего узла: Атрибут - локальное имя атрибута; ОпределениеТипаДокумента - имя типа документа; НачалоЭлемента - локальное имя элемента; КонецЭлемента - локальное имя элемента; СсылкаНаСущность - имя ссылки на сущность; ИнструкцияОбработки - адрес инструкции обработки; ОбъявлениеXML - строка xml.
Полное описание, параметры и ограничения
ЧтениеFastInfoset.ЛокальноеИмя (FastInfosetReader.LocalName)
ЧтениеFastInfoset (FastInfosetReader)
ЛокальноеИмя (LocalName)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит локальное имя для текущего узла XML. Имя зависит от типа текущего узла:
Атрибут - локальное имя атрибута;
ОпределениеТипаДокумента - имя типа документа;
НачалоЭлемента - локальное имя элемента;
КонецЭлемента - локальное имя элемента;
СсылкаНаСущность - имя ссылки на сущность;
ИнструкцияОбработки - адрес инструкции обработки;
ОбъявлениеXML - строка xml.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Для узлов, для которых локальное имя не определено, – пустая строка.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Записать значение атрибута частями и прочитать ПрочитатьАтрибут
Атрибут label содержит Книга A&B. Запись его начала и конца отделена от элементов; амперсанд передаётся текстом, а не конкатенацией XML-разметки.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база на платформе 8.5.1.1343. Создайте серверный общий модуль УчебныеЗадачи и процедуру ВыполнитьПример() Экспорт; код урока без директив вставляйте в её тело. Каждый урок запускайте отдельно.
Все документы создаются из собственных строк и чисел в памяти. Не подставляйте файл XML, бинарный архив обмена, ссылки или данные рабочей базы вместо учебных значений.
Fast Infoset — двоичное представление XML. Для чтения нужен соответствующий reader, а не преобразование байтов в UTF-8-строку. Это не формат API Avito и не автоматическое сжатие произвольного JSON.
Запуск в 1С ещё не подтверждён; выполните контрольные проверки в учебной базе. Не сравнивайте точные байты двух кодировщиков: в заданиях проверяется восстановленная структура и значения.
Запись = Новый ЗаписьFastInfoset;
Запись.УстановитьДвоичныеДанные();
Попытка
Запись.ЗаписатьНачалоЭлемента("product");
Запись.ЗаписатьНачалоАтрибута("label");
Запись.ЗаписатьТекст("Книга ");
Запись.ЗаписатьТекст("A&B");
Запись.ЗаписатьКонецАтрибута();
Запись.ЗаписатьТекст("Учебный товар");
Запись.ЗаписатьКонецЭлемента();
Данные = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Если ТипЗнч(Данные) <> Тип("ДвоичныеДанные") Тогда
ВызватьИсключение "Не получены собственные Fast Infoset-данные";
КонецЕсли;
Сообщить(Данные.Размер() > 0);
Чтение = Новый ЧтениеFastInfoset;
Чтение.УстановитьДвоичныеДанные(Данные);
Попытка
НайденКорень = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
НайденКорень = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденКорень Тогда
ВызватьИсключение "Не найден собственный корневой элемент";
КонецЕсли;
Подпись = "";
Атрибутов = 0;
Пока Чтение.ПрочитатьАтрибут() Цикл
Атрибутов = Атрибутов + 1;
Если Чтение.ЛокальноеИмя = "label" Тогда
Подпись = Чтение.Значение;
КонецЕсли;
КонецЦикла;
Сообщить(Атрибутов = 1);
Сообщить(Подпись = "Книга A&B");
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Разбор по шагам
ЗаписатьНачалоАтрибута вызывается на незавершённом начале элемента до текстового содержимого.
Два вызова ЗаписатьТекст внутри атрибута образуют одну строку label.
ЗаписатьКонецАтрибута завершает атрибут; следующий текст уже относится к элементу.
ПрочитатьАтрибут возвращает очередной атрибут и меняет текущие свойства reader.
Как проверить результат
Три проверки Истина: непустые байты, один атрибут и восстановленная подпись Книга A&B.
Строка ampersand не превратилась в потерянный разделитель и не требует ручного чтения &.
Ожидаемый результат
Реальный текст восстановлен после поэтапной записи атрибута.
На что обратить внимание
Каждому началу атрибута обязателен конец; нельзя начать дочерний элемент, пока атрибут открыт.
Не заменяйте безопасную запись текста сборкой внешней XML-разметки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Найти атрибут единицы по URI, не по его порядковому номеру
Префиксы g и m принадлежат двум собственным пространствам имён. Все индексные методы вызываются только на НачалоЭлемента.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база на платформе 8.5.1.1343. Создайте серверный общий модуль УчебныеЗадачи и процедуру ВыполнитьПример() Экспорт; код урока без директив вставляйте в её тело. Каждый урок запускайте отдельно.
Все документы создаются из собственных строк и чисел в памяти. Не подставляйте файл XML, бинарный архив обмена, ссылки или данные рабочей базы вместо учебных значений.
Fast Infoset — двоичное представление XML. Для чтения нужен соответствующий reader, а не преобразование байтов в UTF-8-строку. Это не формат API Avito и не автоматическое сжатие произвольного JSON.
Запуск в 1С ещё не подтверждён; выполните контрольные проверки в учебной базе. Не сравнивайте точные байты двух кодировщиков: в заданиях проверяется восстановленная структура и значения.
Запись = Новый ЗаписьFastInfoset;
Запись.УстановитьДвоичныеДанные();
Попытка
Запись.ЗаписатьНачалоЭлемента("g:product");
Запись.ЗаписатьСоответствиеПространстваИмен("g", "urn:guide:product");
Запись.ЗаписатьСоответствиеПространстваИмен("m", "urn:guide:units");
Запись.ЗаписатьАтрибут("code", "A-01");
Запись.ЗаписатьАтрибут("unit", "urn:guide:units", "шт");
Сообщить(Запись.НайтиПрефикс("urn:guide:units") = "m");
Сообщить(Запись.КонтекстПространствИмен.НайтиURIПространстваИмен("g") = "urn:guide:product");
Запись.ЗаписатьТекст("Книга");
Запись.ЗаписатьКонецЭлемента();
Данные = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Если ТипЗнч(Данные) <> Тип("ДвоичныеДанные") Тогда
ВызватьИсключение "Не получены собственные Fast Infoset-данные";
КонецЕсли;
Сообщить(Данные.Размер() > 0);
Чтение = Новый ЧтениеFastInfoset;
Чтение.УстановитьДвоичныеДанные(Данные);
Попытка
НайденКорень = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
НайденКорень = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденКорень Тогда
ВызватьИсключение "Не найден собственный корневой элемент";
КонецЕсли;
Сообщить(Чтение.ЛокальноеИмя = "product");
Сообщить(Чтение.Префикс = "g");
Сообщить(Чтение.URIПространстваИмен = "urn:guide:product");
Сообщить(Чтение.КонтекстПространствИмен.НайтиURIПространстваИмен("m") = "urn:guide:units");
Сообщить(Чтение.ПолучитьАтрибут("unit", "urn:guide:units") = "шт");
Сообщить(Чтение.ЗначениеАтрибута("code") = "A-01");
НайденаЕдиница = Ложь;
Для Индекс = 0 По Чтение.КоличествоАтрибутов() - 1 Цикл
Сообщить(СтрШаблон("Атрибут %1; тип %2", Чтение.ИмяАтрибута(Индекс), Чтение.ТипАтрибута(Индекс)));
Если Чтение.ЛокальноеИмяАтрибута(Индекс) = "unit"
И Чтение.URIПространстваИменАтрибута(Индекс) = "urn:guide:units" Тогда
НайденаЕдиница = Истина;
Сообщить(Чтение.ЗначениеАтрибута(Индекс) = "шт");
Сообщить("Префикс по индексу: " + Чтение.ПрефиксАтрибута(Строка(Индекс)));
КонецЕсли;
КонецЦикла;
Сообщить(НайденаЕдиница);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Разбор по шагам
Записываем соответствия префиксов после начала элемента и до дочерних данных.
Идентичность элемента и атрибута определяем парой локальное имя/URI; g и m лишь выбранные сокращения.
Перебор индексов не меняет текущую позицию reader: все методы вызываются на НачалоЭлемента.
Не считаем xmlns и порядок атрибутов стабильным контрактом. У ПрефиксАтрибута локальная справка задаёт строковый индекс, поэтому здесь Строка(Индекс).
Как проверить результат
Проверки URI, префиксов, кода и единицы Истина; НайденаЕдиница Истина.
Если замените m на u во всех соответствиях источника, поиск unit по URI остаётся правильным; текст префикса изменится.
Ожидаемый результат
Разобраны пространства имён и безопасный индексный обход атрибутов.
На что обратить внимание
URI вида urn:guide:units — идентификатор, не URL для скачивания.
Справка ПрефиксАтрибута указывает Строка для индекса, в отличие от соседних методов; отдельно проверьте этот вызов в своём runtime.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.