Синтаксис и применение ЗаписьDOM.По умолчанию в платформе 1С:Предприятие. Описание и примеры кода.
Синтаксис
Новый ЗаписьDOMПолное описание, параметры и ограничения
ЗаписьDOM.По умолчанию
ЗаписьDOM (DOMWriter)
По умолчанию
Синтаксис:
Новый ЗаписьDOM
Методическая информация
Практические примеры
Создать 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.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Изменить текст CDATA и отличить его от XML-разметки
Создаём секцию со строкой A&B<C>. Операции выполняются над символами данных, а не над тегами XML.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Документ = Новый ДокументDOM("", "description");
Секция = Документ.СоздатьСекциюCDATA("A&B<C>");
Документ.ЭлементДокумента.ДобавитьДочерний(Секция);
Сообщить(Секция.Данные = "A&B<C>");
Сообщить(Секция.Размер = 6);
Сообщить(Секция.ВыбратьДанные(0, 3) = "A&B");
Секция.ВставитьДанные(0, "X");
Секция.ДобавитьДанные("!");
Сообщить(Секция.Данные = "XA&B<C>!");
Секция.ЗаменитьДанные(1, 3, "Книга");
Сообщить(Секция.Данные = "XКнига<C>!");
Секция.УдалитьДанные(0, 1);
Сообщить(Секция.Данные = "Книга<C>!");
Сообщить(Секция.ТекстовоеСодержимое = Секция.Данные);
Сообщить(Секция.ДокументВладелец = Документ);
Сообщить(Секция.РодительскийУзел = Документ.ЭлементДокумента);
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Сериализатор = Новый ЗаписьDOM;
Сериализатор.Записать(Документ, Запись);
ТекстXML = Запись.Закрыть();
Сообщить(ТекстXML);Разбор по шагам
СоздатьСекциюCDATA создаёт узел данных. Строка <C> внутри него не является дочерним XML-элементом.
Смещения в методах символьных данных начинаются с 0, в отличие от привычного Сред(), где начало строки задаётся 1.
Вставка, добавление, замена и удаление последовательно изменяют данные с указанными промежуточными проверками.
ЗаписьDOM сериализует дерево через ЗаписьXML. Текст внутри CDATA не нужно самостоятельно экранировать как тег.
Как проверить результат
Размер исходной строки равен 6, её первые три символа A&B.
После четырёх изменений данные равны Книга<C>!; все контрольные сравнения Истина.
В XML текст <C> находится в секции данных, а не представлен отдельным элементом C.
Ожидаемый результат
На фиксированной строке освоены операции символьных данных CDATA и их сериализация.
На что обратить внимание
Последовательность ]]> завершает CDATA: не вставляйте её в произвольный пользовательский текст без отдельного решения сериализации.
CDATA не защищает от опасной интерпретации текста получателем и не является способом очистки HTML.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.