Тип: Строка. Содержит имя атрибута.
Полное описание, параметры и ограничения
АтрибутDOM.Имя (DOMAttribute.Name)
АтрибутDOM (DOMAttribute)
Имя (Name)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит имя атрибута.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Назначить товару XML-идентификатор и работать с узлом атрибута
Атрибут id становится идентификатором только после явной отметки. Остальные атрибуты читаем и удаляем через элемент и коллекцию.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст. Все узлы принадлежат одному документу.
Идентификатор A-01 уникален в пределах учебного документа.
Документ = Новый ДокументDOM("", "products");
Товар = Документ.СоздатьЭлемент("product");
Документ.ЭлементДокумента.ДобавитьДочерний(Товар);
Атрибут = Документ.СоздатьАтрибут("id");
Атрибут.Значение = "A-01";
Товар.УстановитьУзелАтрибута(Атрибут);
Товар.УстановитьАтрибутИдентификатор("id", Истина);
Сообщить(Атрибут.Имя);
Сообщить(Атрибут.Значение);
Сообщить(Атрибут.ЯвляетсяИдентификатором);
Сообщить(Атрибут.Указан);
Сообщить(Атрибут.ЭлементВладелец = Товар);
Сообщить(Документ.ПолучитьЭлементПоИдентификатору("A-01").УзелИдентичен(Товар));
Сообщить(Товар.ЕстьАтрибут("id"));
Сообщить(Товар.ПолучитьАтрибут("id"));
Сообщить(Товар.ПолучитьУзелАтрибута("id").УзелИдентичен(Атрибут));
Товар.УстановитьАтрибут("quantity", "3");
Атрибуты = Товар.Атрибуты;
Сообщить(Атрибуты.Количество());
Для Номер = 0 По Атрибуты.Количество() - 1 Цикл
Текущий = Атрибуты.Элемент(Номер);
Сообщить(Текущий.Имя + "=" + Текущий.Значение);
КонецЦикла;
Сообщить(Атрибуты.ПолучитьИменованныйЭлемент("quantity").Значение);
Товар.УдалитьАтрибут("quantity");
Временный = Документ.СоздатьАтрибут("temporary");
Временный.Значение = "yes";
Атрибуты.УстановитьИменованныйЭлемент(Временный);
Атрибуты.УдалитьИменованныйЭлемент("temporary");
Сообщить(Атрибуты.Количество());Разбор по шагам
Создаём атрибут фабрикой документа, задаём значение и присоединяем к товару.
УстановитьАтрибутИдентификатор отмечает id; после этого документ может найти товар по его значению.
ПолучитьАтрибут возвращает строку, ПолучитьУзелАтрибута — объект атрибута.
Обходим коллекцию без предположения о порядке; удаляем quantity и временный атрибут.
Как проверить результат
Найденный по A-01 элемент идентичен товару; атрибут принадлежит товару и имеет признак идентификатора.
Перед удалением есть 2 атрибута, после всей последовательности остаётся только id: количество 1.
Ожидаемый результат
Товар имеет настоящий DOM-идентификатор, работа с атрибутом и его строковым значением различена.
На что обратить внимание
Имя id само по себе не гарантирует статус идентификатора: нужна отметка или соответствующее объявление схемы.
Порядок атрибутов XML незначим; не полагайтесь на то, что id имеет индекс 0.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Переименовать XML-товар и атрибут с сохранением нового узла
После переименования может вернуться прежний или новый объект. Поэтому продолжаем работу только с возвращённым узлом и проверяем его актуальные имя и URI.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Преобразования выполняются только над собственным XML в памяти. Примеры не читают файлы, внешние DTD, URL или данные информационной базы.
У методов DOM возвращаемый узел сохраняйте в переменную: исходная ссылка и результат операции не всегда обозначают один объект.
URI = "urn:guide:products";
Документ = Новый ДокументDOM(URI, "g:products");
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", URI);
Товар = Документ.СоздатьЭлемент(URI, "g:product");
Атрибут = Документ.СоздатьАтрибут("code");
Атрибут.Значение = "A-01";
Товар.УстановитьУзелАтрибута(Атрибут);
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Книга"));
Корень.ДобавитьДочерний(Товар);
Товар = Документ.ПереименоватьУзел(Товар, URI, "g:item");
Сообщить(Товар.ЛокальноеИмя = "item");
Сообщить(Товар.Префикс = "g");
Сообщить(Товар.URIПространстваИмен = URI);
Сообщить(Товар.РодительскийУзел = Корень);
Сообщить(Товар.ТекстовоеСодержимое = "Книга");
Атрибут = Товар.ПолучитьУзелАтрибута("code");
Атрибут = Документ.ПереименоватьУзел(Атрибут, "", "sku");
Сообщить(Атрибут.Имя = "sku");
Сообщить(Атрибут.Значение = "A-01");
Сообщить(Товар.ПолучитьАтрибут("code") = Неопределено);
Сообщить(Товар.ПолучитьАтрибут("sku") = "A-01");
Сообщить(Корень.ПервыйДочерний.УзелИдентичен(Товар));Разбор по шагам
Создаём namespace-aware product и обычный атрибут code; оба принадлежат собственному документу.
ПереименоватьУзел возвращает результат, который сразу присваиваем Товар. Имя становится g:item, URI не меняется, содержимое Книга сохраняется.
Заново получаем атрибут актуального элемента и переименовываем code в sku. Атрибут также сохраняем из результата операции.
Проверяем, что code исчез из актуального элемента, sku содержит A-01 и корень ссылается именно на актуальный Товар.
Как проверить результат
Все десять логических сообщений дают Истина.
Получена структура products/item с атрибутом sku=A-01 и текстом Книга.
Ожидаемый результат
Показан корректный шаблон переименования без предположения о сохранении идентичности исходного узла.
На что обратить внимание
Метод предназначен только для ЭлементDOM и АтрибутDOM. Для текста или комментария он вызывает исключение.
Узел должен принадлежать документу, вызывающему метод. Переименование не является импортом из другого документа.
Не сохраняйте старую ссылку на атрибут до переименования элемента как единственный источник истины: реализация может заменить элемент новым узлом.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.