Тип: Строка. Имя узла DOM. Имя узла присутствует не у каждого типа узла DOM. Узел Имя узла Атрибут - Attribute.name; СекцияCDATA - "#cdata-section"; Комментарий - "#comment"; Документ - "#document"; ФрагментДокумента - "#document-fragment"; ОпределениеТипаДокумента - DocumentType.name; Элемент - Element.tagName; Сущность - имя сущности; СсылкаНаСущность - имя ссылки на сущность; Нотация - имя нотации; ИнструкцияОбработки - ProcessingInstruction.target; Текст - "#text".
Полное описание, параметры и ограничения
СекцияCDATADOM.ИмяУзла (DOMCDATASection.NodeName)
СекцияCDATADOM (DOMCDATASection)
ИмяУзла (NodeName)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Имя узла DOM. Имя узла присутствует не у каждого типа узла DOM.
Узел Имя узла
Атрибут - Attribute.name;
СекцияCDATA - "#cdata-section";
Комментарий - "#comment";
Документ - "#document";
ФрагментДокумента - "#document-fragment";
ОпределениеТипаДокумента - DocumentType.name;
Элемент - Element.tagName;
Сущность - имя сущности;
СсылкаНаСущность - имя ссылки на сущность;
Нотация - имя нотации;
ИнструкцияОбработки - ProcessingInstruction.target;
Текст - "#text".
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Сравнить восемь видов узлов XML на одном созданном дереве
Получаем настоящие документ, элемент, атрибут, текст, комментарий, CDATA, инструкцию и фрагмент. Таблица объясняет, почему одни свойства имеют значение, а другие — Неопределено.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Выполняйте на сервере учебной базы; документ и все восемь узлов полностью создаются в памяти.
Фрагмент намеренно не вставляется в основной документ: это отдельный контейнер с элементом note.
Поставьте точку останова после цикла и откройте Диагностика в отладчике, чтобы сравнить все шестнадцать колонок.
Документ = Новый ДокументDOM("urn:guide:nodes", "g:guide");
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:nodes");
Атрибут = Документ.СоздатьАтрибут("code");
Атрибут.Значение = "A-01";
Корень.УстановитьУзелАтрибута(Атрибут);
Текст = Документ.СоздатьТекстовыйУзел("Книга");
Комментарий = Документ.СоздатьКомментарий("учебный комментарий");
CDATA = Документ.СоздатьСекциюCDATA("<данные>");
Инструкция = Документ.СоздатьИнструкциюОбработки("guide", "mode=test");
Корень.ДобавитьДочерний(Текст);
Корень.ДобавитьДочерний(Комментарий);
Корень.ДобавитьДочерний(CDATA);
Корень.ДобавитьДочерний(Инструкция);
Фрагмент = Документ.СоздатьФрагментДокумента();
Фрагмент.ДобавитьДочерний(Документ.СоздатьЭлемент("note"));
Узлы = Новый Массив;
Узлы.Добавить(Документ);
Узлы.Добавить(Корень);
Узлы.Добавить(Атрибут);
Узлы.Добавить(Текст);
Узлы.Добавить(Комментарий);
Узлы.Добавить(CDATA);
Узлы.Добавить(Инструкция);
Узлы.Добавить(Фрагмент);
Диагностика = Новый ТаблицаЗначений;
Для Каждого ИмяКолонки Из СтрРазделить("Тип,Имя,ЛокальноеИмя,URI,Префикс,Значение,Текст,БазовыйURI,ДокументВладелец,Родитель,Предыдущий,Следующий,Первый,Последний,Детей,Атрибутов", ",") Цикл
Диагностика.Колонки.Добавить(ИмяКолонки);
КонецЦикла;
Для Каждого Узел Из Узлы Цикл
СтрокаДиагностики = Диагностика.Добавить();
СтрокаДиагностики.Тип = Узел.ТипУзла;
СтрокаДиагностики.Имя = Узел.ИмяУзла;
СтрокаДиагностики.ЛокальноеИмя = Узел.ЛокальноеИмя;
СтрокаДиагностики.URI = Узел.URIПространстваИмен;
СтрокаДиагностики.Префикс = Узел.Префикс;
СтрокаДиагностики.Значение = Узел.ЗначениеУзла;
СтрокаДиагностики.Текст = Узел.ТекстовоеСодержимое;
СтрокаДиагностики.БазовыйURI = Узел.БазовыйURI;
СтрокаДиагностики.ДокументВладелец = Узел.ДокументВладелец;
СтрокаДиагностики.Родитель = Узел.РодительскийУзел;
СтрокаДиагностики.Предыдущий = Узел.ПредыдущийСоседний;
СтрокаДиагностики.Следующий = Узел.СледующийСоседний;
СтрокаДиагностики.Первый = Узел.ПервыйДочерний;
СтрокаДиагностики.Последний = Узел.ПоследнийДочерний;
СтрокаДиагностики.Детей = Узел.ДочерниеУзлы.Количество();
Если Узел.Атрибуты = Неопределено Тогда
СтрокаДиагностики.Атрибутов = 0;
Иначе
СтрокаДиагностики.Атрибутов = Узел.Атрибуты.Количество();
КонецЕсли;
Сообщить(СтрШаблон("%1 / %2: детей %3, атрибутов %4", Узел.ТипУзла, Узел.ИмяУзла,
СтрокаДиагностики.Детей, СтрокаДиагностики.Атрибутов));
Сообщить(Узел.ЕстьДочерниеУзлы() = (СтрокаДиагностики.Детей > 0));
Сообщить(Узел.ЕстьАтрибуты() = (СтрокаДиагностики.Атрибутов > 0));
КонецЦикла;
Сообщить(Диагностика.Количество() = 8);
Сообщить(Документ.ДокументВладелец = Неопределено);
Сообщить(Атрибут.РодительскийУзел = Неопределено);
Сообщить(Атрибут.ЭлементВладелец.УзелИдентичен(Корень));
Сообщить(Текст.ЗначениеУзла = "Книга");
Сообщить(Корень.ЗначениеУзла = Неопределено);
Сообщить(Корень.ТекстовоеСодержимое = "Книга<данные>");
Сообщить(Комментарий.ТекстовоеСодержимое = "учебный комментарий");
Сообщить(Фрагмент.РодительскийУзел = Неопределено);Разбор по шагам
Свойства общего узла доступны у разных конкретных видов, но их значения отличаются: ИмяУзла #text — не имя товара.
ЗначениеУзла содержит значение текста и атрибута, но не текст элемента. ТекстовоеСодержимое элемента объединяет текст и CDATA, исключая комментарии и инструкции.
РодительскийУзел и ДокументВладелец — разные связи. У атрибута нет родителя дерева, но есть ЭлементВладелец; у документа нет документа-владельца.
Первый/ПоследнийДочерний и соседние узлы могут быть Неопределено. ДочерниеУзлы всё равно предоставляет список, в том числе пустой.
Атрибуты предоставляет коллекцию только у элемента. Проверяем Неопределено до вызова Количество.
URIПространстваИмен, ЛокальноеИмя и Префикс описывают квалифицированное имя; БазовыйURI относится к разрешению URI, а не к адресу товара.
Как проверить результат
Диагностика содержит восемь строк разных видов; проверки наличия детей и атрибутов совпадают с размерами коллекций.
У корня четыре дочерних узла, а ТекстовоеСодержимое равно Книга<данные>, без комментария и mode=test.
Атрибут A-01 не является дочерним узлом корня; его ЭлементВладелец совпадает с корнем.
Фрагмент имеет одного ребёнка note, но пока не имеет родителя в основном дереве.
Ожидаемый результат
Построена диагностическая таблица реальных узлов, которая разделяет имя, значение, текст, связи и пространства имён.
На что обратить внимание
ТекстовоеСодержимое — не сериализованный XML; для разметки используйте ЗаписьDOM.
Значение Неопределено не означает повреждение: для некоторых видов узлов это предусмотренное поведение.
Коллекция атрибутов не обязана сохранять порядок. XML-префикс — псевдоним URI, а не идентификатор бизнес-объекта.
Нельзя произвольно назначать родителя или владельца: эти связи управляются методами дерева.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Найти пространство имён от текста, атрибута и отсоединённого фрагмента
Поиск namespace учитывает положение узла, а не только его ДокументВладелец. Восемь видов узлов показывают наследование от корня и отсутствие такого контекста у отдельного фрагмента.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Документ = Новый ДокументDOM("urn:guide:nodes", "g:guide");
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:nodes");
Атрибут = Документ.СоздатьАтрибут("code");
Атрибут.Значение = "A-01";
Корень.УстановитьУзелАтрибута(Атрибут);
Текст = Документ.СоздатьТекстовыйУзел("Книга");
Комментарий = Документ.СоздатьКомментарий("учебный комментарий");
CDATA = Документ.СоздатьСекциюCDATA("<данные>");
Инструкция = Документ.СоздатьИнструкциюОбработки("guide", "mode=test");
Корень.ДобавитьДочерний(Текст);
Корень.ДобавитьДочерний(Комментарий);
Корень.ДобавитьДочерний(CDATA);
Корень.ДобавитьДочерний(Инструкция);
Фрагмент = Документ.СоздатьФрагментДокумента();
Фрагмент.ДобавитьДочерний(Документ.СоздатьЭлемент("note"));
Узлы = Новый Массив;
Узлы.Добавить(Документ);
Узлы.Добавить(Корень);
Узлы.Добавить(Атрибут);
Узлы.Добавить(Текст);
Узлы.Добавить(Комментарий);
Узлы.Добавить(CDATA);
Узлы.Добавить(Инструкция);
Узлы.Добавить(Фрагмент);
URI = "urn:guide:nodes";
Корень.УстановитьСоответствиеПространстваИмен("", URI);
Для Каждого Узел Из Узлы Цикл
НайденныйURI = Узел.НайтиURIПространстваИмен("g");
НайденныйПрефикс = Узел.НайтиПрефикс(URI);
ЭтоПоУмолчанию = Узел.ПространствоИменПоУмолчанию(URI);
Сообщить(СтрШаблон("%1 / %2: g → %3, префикс URI → %4", ТипЗнч(Узел), Узел.ИмяУзла,
Строка(НайденныйURI), Строка(НайденныйПрефикс)));
Если Узел.УзелИдентичен(Фрагмент) Тогда
Сообщить(НайденныйURI = Неопределено);
Сообщить(Не ЭтоПоУмолчанию);
Иначе
Сообщить(НайденныйURI = URI);
Сообщить(НайденныйПрефикс = "g");
Сообщить(ЭтоПоУмолчанию);
КонецЕсли;
КонецЦикла;
Сообщить(Фрагмент.ДокументВладелец = Документ);
Сообщить(Фрагмент.РодительскийУзел = Неопределено);Разбор по шагам
Корень g:guide объявляет g и пространство по умолчанию с одним URI. Текст, комментарий, CDATA и инструкция являются его детьми; атрибут принадлежит корню через ЭлементВладелец.
НайтиURIПространстваИмен ищет соответствие от данного узла. Для документа используется корневой элемент, для атрибута — его элемент-владелец, для прикреплённых листьев — родитель.
НайтиПрефикс ищет именно именованный префикс g; пустой префикс по умолчанию не заменяет его. ПространствоИменПоУмолчанию отдельно проверяет URI.
Фрагмент не присоединён к корню. Наличие того же ДокументВладелец не заставляет его наследовать объявления корня.
Как проверить результат
Для первых семи видов проверки URI, g и пространства по умолчанию дают Истина.
Для отсоединённого фрагмента URI по g не найден, проверка пространства по умолчанию ложная; две проверки этой ветки дают Истина.
В конце подтверждаются общий документ-владелец фрагмента и отсутствие родителя.
Ожидаемый результат
На конкретном дереве разобраны контекст поиска namespace у разных видов DOM-узлов.
На что обратить внимание
URIПространстваИмен самого текстового/комментарного узла не равен результату поиска объявленного URI от его родителя.
После перемещения узла к другому родителю результат поиска может измениться. Не храните соответствие как неизменный глобальный справочник.
Присвоение объявления namespace не переименовывает уже созданные элементы и атрибуты; их собственные имена/URI задаются отдельно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.