Устанавливает значение атрибута. Если атрибута с указанным именем нет в элементе, то он будет создан с указанным значением. В противном случае значение атрибута будет изменено. Значение атрибута при установке не разбирается.
Синтаксис
УстановитьАтрибут(<Имя>, <Значение>)УстановитьАтрибут(<URIПространстваИмен>, <ЛокальноеИмя>, <Значение>)Полное описание, параметры и ограничения
ЭлементDOM.УстановитьАтрибут (DOMElement.SetAttribute)
ЭлементDOM (DOMElement)
УстановитьАтрибут (SetAttribute)
Доступен, начиная с версии 8.1.
Вариант синтаксиса: По имени
Синтаксис:
УстановитьАтрибут(<Имя>, <Значение>)
Параметры:
<Имя> (обязательный)
Тип: Строка.
Имя атрибута.
<Значение> (обязательный)
Тип: Строка.
Значение атрибута.
Вариант синтаксиса: По имени и URI пространства имен
Синтаксис:
УстановитьАтрибут(<URIПространстваИмен>, <ЛокальноеИмя>, <Значение>)
Параметры:
<URIПространстваИмен> (обязательный)
Тип: Строка.
URI пространства имен атрибута.
<ЛокальноеИмя> (обязательный)
Тип: Строка.
Локальное имя атрибута.
<Значение> (обязательный)
Тип: Строка.
Значение атрибута.
Описание:
Устанавливает значение атрибута.
Если атрибута с указанным именем нет в элементе, то он будет создан с указанным значением. В противном случае значение атрибута будет изменено. Значение атрибута при установке не разбирается.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Если имя атрибута содержит символы, не допустимые стандартом XML данного документа, или данный узел в режиме Только для чтения, будет инициировано исключение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать DOM-документ с товарами и выгрузить его в XML
DOM хранит всё дерево документа. Создаём узлы фабрикой документа, связываем их с корнем и затем сериализуем.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Выполняйте на сервере. Конструктор ДокументDOM требует URI и имя корня: пустой URI означает отсутствие пространства имён.
Все создаваемые узлы принадлежат одному документу; пример не использует файловую систему.
Документ = Новый ДокументDOM("", "products");
Корень = Документ.ЭлементДокумента;
Для Номер = 1 По 2 Цикл
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", ?(Номер = 1, "A-01", "B-02"));
Название = Документ.СоздатьЭлемент("name");
ТекстНазвания = Документ.СоздатьТекстовыйУзел(?(Номер = 1, "Книга", "Ручка"));
Название.ДобавитьДочерний(ТекстНазвания);
Товар.ДобавитьДочерний(Название);
Корень.ДобавитьДочерний(Товар);
КонецЦикла;
Сообщить(Корень.ИмяЭлемента);
Сообщить(Корень.ЕстьДочерниеУзлы());
Сообщить(Документ.ПолучитьЭлементыПоИмени("product").Количество());
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Сериализатор = Новый ЗаписьDOM;
Попытка
Сериализатор.Записать(Документ, Запись);
ТекстXML = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(ТекстXML);
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);
Попытка
Построитель = Новый ПостроительDOM;
Прочитанный = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Сообщить(Прочитанный.ЭлементДокумента.ПолучитьЭлементыПоИмени("product").Количество());Разбор по шагам
Конструктор создаёт корень products; его получаем через ЭлементДокумента.
СоздатьЭлемент и СоздатьТекстовыйУзел создают отдельные узлы; ДобавитьДочерний присоединяет их к дереву.
ЗаписьDOM передаёт дерево в ЗаписьXML, а Закрыть возвращает готовый текст.
ПостроительDOM читает полученную строку обратно и позволяет проверить число товаров.
Как проверить результат
Корень называется products, ЕстьДочерниеУзлы возвращает Истина.
До и после сериализации найдено по 2 элемента product с названиями Книга и Ручка.
Ожидаемый результат
Корректный XML-документ создан из дерева и прочитан обратно без изменения числа товаров.
На что обратить внимание
СоздатьЭлемент сам не вставляет узел в документ: без ДобавитьДочерний товар не попадёт в XML.
DOM занимает память под весь документ. Для больших выгрузок часто подходит потоковая ЗаписьXML.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Клонировать весь XML-документ и сравнить структуру, а не ссылки
Полная копия документа — отдельный документ-владелец. XML-структура равна исходной, но идентичность и локальные служебные метки различаются.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Преобразования выполняются только над собственным XML в памяти. Примеры не читают файлы, внешние DTD, URL или данные информационной базы.
У методов DOM возвращаемый узел сохраняйте в переменную: исходная ссылка и результат операции не всегда обозначают один объект.
Документ = Новый ДокументDOM("", "products");
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", "A-01");
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Книга"));
Документ.ЭлементДокумента.ДобавитьДочерний(Товар);
Документ.УстановитьПользовательскиеДанные("training-tag", "original-document");
Сообщить(Документ.ПолучитьПользовательскиеДанные("training-tag") = "original-document");
Копия = Документ.КлонироватьУзел(Истина);
Сообщить(ТипЗнч(Копия) = Тип("ДокументDOM"));
Сообщить(Документ.УзелРавен(Копия));
Сообщить(Не Документ.УзелИдентичен(Копия));
Сообщить(Копия.ПолучитьПользовательскиеДанные("training-tag") = Неопределено);
КопияТовара = Копия.ЭлементДокумента.ПервыйДочерний;
Сообщить(КопияТовара.ДокументВладелец = Копия);
Сообщить(Товар.ДокументВладелец = Документ);
КопияТовара.УстановитьАтрибут("code", "COPY");
Сообщить(Товар.ПолучитьАтрибут("code") = "A-01");
Сообщить(Не Документ.УзелРавен(Копия));Разбор по шагам
Строим исходный документ целиком: products/product с атрибутом и текстовым ребёнком.
УстановитьПользовательскиеДанные записывает локальную метку документа, не XML-атрибут.
КлонироватьУзел(Истина) копирует весь документ. УзелРавен сравнивает структуру и значения, УзелИдентичен — тот же ли это узел.
У копии свои дети с владельцем Копия. Меняем code только там, после чего документы уже не равны; исходник сохраняет A-01.
Как проверить результат
Девять логических проверок дают Истина.
До изменения копии документы равны по структуре, но не идентичны. После изменения code копии они не равны.
У копии нет training-tag; XML-данные исходника не изменены.
Ожидаемый результат
Получена независимая полная копия собственного XML для безопасного преобразования.
На что обратить внимание
КлонироватьУзел элемента и всего документа — разные операции: копия отдельного элемента первоначально сохраняет исходный документ-владелец.
Не используйте УзелРавен как проверку подписи, бизнес-валидности или безопасности XML.
Служебные данные не являются частью переносимого XML-контракта и не клонируются автоматически.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.