Тип: Строка. Имя узла DOM. Имя узла присутствует не у каждого типа узла DOM. Узел Имя узла Атрибут - Attribute.name; СекцияCDATA - "#cdata-section"; Комментарий - "#comment"; Документ - "#document"; ФрагментДокумента - "#document-fragment"; ОпределениеТипаДокумента - DocumentType.name; Элемент - Element.tagName; Сущность - имя сущности; СсылкаНаСущность - имя ссылки на сущность; Нотация - имя нотации; ИнструкцияОбработки - ProcessingInstruction.target; Текст - "#text".
Полное описание, параметры и ограничения
ПространствоИменXPath.ИмяУзла (XPathNamespace.NodeName)
ПространствоИменXPath (XPathNamespace)
ИмяУзла (NodeName)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Имя узла DOM. Имя узла присутствует не у каждого типа узла DOM.
Узел Имя узла
Атрибут - Attribute.name;
СекцияCDATA - "#cdata-section";
Комментарий - "#comment";
Документ - "#document";
ФрагментДокумента - "#document-fragment";
ОпределениеТипаДокумента - DocumentType.name;
Элемент - Element.tagName;
Сущность - имя сущности;
СсылкаНаСущность - имя ссылки на сущность;
Нотация - имя нотации;
ИнструкцияОбработки - ProcessingInstruction.target;
Текст - "#text".
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Отличить namespace ссылки от namespace её родителя
Имя guideProduct не имеет пространства имён. Поиск объявленного g от прикреплённой ссылки может найти namespace корня, но это не переименовывает ссылку.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
DOCTYPE создан собственным конструктором с пустыми PUBLIC/SYSTEM. Внутренних сущностей/нотаций нет; guideProduct — намеренно неопределённая ссылка, а не загруженный товар.
Этот документ исследуется только в памяти. Не сохраняйте и не передавайте его как готовый XML обмена: ссылка guideProduct не объявлена.
XPath namespace::g возвращает специализированный узел, а не строку URI и не обычный атрибут xmlns.
ОписаниеТипа = Новый ОпределениеТипаДокументаDOM("products", "", "");
Документ = Новый ДокументDOM("urn:guide:special", "g:products", ОписаниеТипа);
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:special");
Ссылка = Документ.СоздатьСсылкуНаСущность("guideProduct");
Корень.ДобавитьДочерний(Ссылка);
Разыменователь = Документ.СоздатьРазыменовательПИ();
Результат = Документ.ВычислитьВыражениеXPath("namespace::g", Корень,
Разыменователь, ТипРезультатаDOMXPath.НеупорядоченныйСнимокУзлов);
Если Результат.РазмерСнимка <> 1 Тогда
ВызватьИсключение "Ожидался ровно один собственный namespace g";
КонецЕсли;
Пространство = Результат.ЭлементСнимка(0);
Если ТипЗнч(Пространство) <> Тип("ПространствоИменXPath") Тогда
ВызватьИсключение "Ожидался настоящий узел ПространствоИменXPath";
КонецЕсли;
Узлы = Новый Массив;
Узлы.Добавить(ОписаниеТипа);
Узлы.Добавить(Ссылка);
Узлы.Добавить(Пространство);
Для Каждого Узел Из Узлы Цикл
Сообщить(Узел.ИмяУзла);
Сообщить(Узел.НайтиURIПространстваИмен("g"));
Сообщить(Узел.НайтиПрефикс("urn:guide:special"));
Сообщить(Узел.ПространствоИменПоУмолчанию("urn:guide:special"));
КонецЦикла;
Сообщить(Ссылка.НайтиURIПространстваИмен("g") = "urn:guide:special");
Сообщить(Ссылка.НайтиПрефикс("urn:guide:special") = "g");
Сообщить(Не Ссылка.ПространствоИменПоУмолчанию("urn:guide:special"));
Сообщить(ОписаниеТипа.НайтиURIПространстваИмен("g") = Неопределено);
Сообщить(ОписаниеТипа.НайтиПрефикс("urn:guide:special") = Неопределено);Разбор по шагам
У корня объявлен только именованный g; namespace по умолчанию специально не задан.
У ссылки поиск использует контекст родителя. Это не означает, что сама ссылка имеет URI имени.
DOCTYPE не участвует в поиске объявлений namespace; у специализированного namespace диагностируем ответы отдельно от его собственного URI.
Как проверить результат
Пять финальных сравнений дают Истина: найден g от ссылки, default отсутствует, DOCTYPE не находит объявления.
Цикл показывает фактические ответы трёх видов; для namespace не приравнивайте алгоритм поиска к собственному URIПространстваИмен.
Ожидаемый результат
Разделены имя узла, его URI и контекст поиска объявления.
На что обратить внимание
Префикс — псевдоним, а не сетевой адрес. Метод ничего не скачивает.
Не превращайте НайтиПрефикс в поиск XML-элемента или товара по коду.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Получить три специальных узла XML и сравнить их паспорт
Создаём DOCTYPE, неопределённую ссылку и объявление namespace из результата XPath. Отсутствие атрибутов/детей у этих узлов не означает повреждение документа.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
DOCTYPE создан собственным конструктором с пустыми PUBLIC/SYSTEM. Внутренних сущностей/нотаций нет; guideProduct — намеренно неопределённая ссылка, а не загруженный товар.
Этот документ исследуется только в памяти. Не сохраняйте и не передавайте его как готовый XML обмена: ссылка guideProduct не объявлена.
XPath namespace::g возвращает специализированный узел, а не строку URI и не обычный атрибут xmlns.
ОписаниеТипа = Новый ОпределениеТипаДокументаDOM("products", "", "");
Документ = Новый ДокументDOM("urn:guide:special", "g:products", ОписаниеТипа);
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:special");
Ссылка = Документ.СоздатьСсылкуНаСущность("guideProduct");
Корень.ДобавитьДочерний(Ссылка);
Разыменователь = Документ.СоздатьРазыменовательПИ();
Результат = Документ.ВычислитьВыражениеXPath("namespace::g", Корень,
Разыменователь, ТипРезультатаDOMXPath.НеупорядоченныйСнимокУзлов);
Если Результат.РазмерСнимка <> 1 Тогда
ВызватьИсключение "Ожидался ровно один собственный namespace g";
КонецЕсли;
Пространство = Результат.ЭлементСнимка(0);
Если ТипЗнч(Пространство) <> Тип("ПространствоИменXPath") Тогда
ВызватьИсключение "Ожидался настоящий узел ПространствоИменXPath";
КонецЕсли;
Узлы = Новый Массив;
Узлы.Добавить(ОписаниеТипа);
Узлы.Добавить(Ссылка);
Узлы.Добавить(Пространство);
Для Каждого Узел Из Узлы Цикл
Сообщить(ТипЗнч(Узел));
Сообщить(Узел.ТипУзла);
Сообщить(Узел.ИмяУзла);
Сообщить(Узел.ЛокальноеИмя);
Сообщить(Узел.URIПространстваИмен);
Сообщить(Узел.Префикс);
Сообщить(Узел.ЗначениеУзла);
Сообщить(Узел.ТекстовоеСодержимое);
Сообщить(Узел.БазовыйURI);
Сообщить(Узел.ДокументВладелец);
Сообщить(Узел.РодительскийУзел);
Сообщить(Узел.ПервыйДочерний);
Сообщить(Узел.ПоследнийДочерний);
Сообщить(Узел.ПредыдущийСоседний);
Сообщить(Узел.СледующийСоседний);
Сообщить(Узел.ДочерниеУзлы.Количество() = 0);
Сообщить(Не Узел.ЕстьДочерниеУзлы());
Сообщить(Узел.Атрибуты = Неопределено);
Сообщить(Не Узел.ЕстьАтрибуты());
КонецЦикла;
Сообщить(Ссылка.ИмяУзла = "guideProduct");
Сообщить(ОписаниеТипа.РодительскийУзел = Документ);
Сообщить(Ссылка.РодительскийУзел = Корень);
Сообщить(Пространство.ИмяУзла = "#namespace");
Сообщить(Пространство.Префикс = "g");
Сообщить(Пространство.ЛокальноеИмя = "g");
Сообщить(Пространство.ЗначениеУзла = "urn:guide:special");
Сообщить(Пространство.URIПространстваИмен = "urn:guide:special");
Сообщить(Пространство.ЭлементВладелец.УзелИдентичен(Корень));Разбор по шагам
Описание типа получает документ-владелец при создании ДокументDOM; это отдельный ребёнок документа, не корня products.
Ссылка guideProduct находится в корне, но у неё нет содержимого, потому что такого объявления сущности нет.
Специализированный namespace получаем осью namespace::g. Его имя #namespace, префикс/локальное имя g, значение и URI совпадают.
Пустые связи и строковые свойства выводим диагностически: не вызываем методы у Неопределено. Атрибуты проверяем до Количество.
Как проверить результат
По четыре логических проверки в каждой из трёх итераций дают Истина; девять финальных сравнений дают Истина.
Показаны разные родители DOCTYPE и ссылки; у namespace отдельно проверен ЭлементВладелец, это не строка xmlns.
Ожидаемый результат
Разобраны настоящие значения специальных узлов без внешнего XML или DTD.
На что обратить внимание
БазовыйURI — не адрес товара; пустой URI у узла не равен отсутствию объявленного namespace в окружающем дереве.
Непустая СсылкаНаСущностьDOM не доказывает существование СущностьDOM: создание ссылки само не создаёт объявление.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.