Синтаксис и применение ЗаписьУзловDOM.По умолчанию в платформе 1С:Предприятие. Описание и примеры кода.
Синтаксис
Новый ЗаписьУзловDOMПолное описание, параметры и ограничения
ЗаписьУзловDOM.По умолчанию
ЗаписьУзловDOM (DOMNodeWriter)
По умолчанию
Синтаксис:
Новый ЗаписьУзловDOM
Методическая информация
Практические примеры
ЗаписьУзловDOM: объявление XML и внутренний DTD
Запись открывается на собственном ДокументDOM. Объявление XML должно идти до остальных операций, DTD задан без внешнего файла.
Где и как запускать
Синтаксический пример в серверном обработчике или толстом клиенте. Дерево создаётся из собственной строки либо собственным конструктором в памяти. Здесь 1С, браузер, файлы и сеть не запускались.
Подготовка
Документ и запись создаются в памяти. Имя order одинаково в DTD и записываемом корневом элементе.
Используется двухаргументный вариант ЗаписатьТипДокумента с внутренним подмножеством, без SYSTEM- или PUBLIC-файла.
Документ = Новый ДокументDOM("", "order");
Запись = Новый ЗаписьУзловDOM;
Запись.Открыть(Документ);
Запись.ЗаписатьОбъявлениеXML();
Запись.ЗаписатьТипДокумента("order", "<!ELEMENT order (#PCDATA)>");
Запись.ЗаписатьНачалоЭлемента("order");
Запись.ЗаписатьТекст("BOOK");
Запись.ЗаписатьКонецЭлемента();
Фрагмент = Запись.УзелDOM;
Запись.Закрыть();
Сообщить("Узлов фрагмента: " + Строка(Фрагмент.ДочерниеУзлы.Количество()));Разбор по шагам
Откройте запись для своего документа.
Запишите объявление XML первым, затем внутренний DTD и элемент с текстом.
Получите собственный фрагмент и закройте объект записи.
Как проверить результат
Вызов объявления предшествует записи типа документа и элемента.
УзелDOM — результат записи в объектную модель, а не строка и не уже сохранённый файл.
Ожидаемый результат
Приведён короткий пример синтаксиса с указанными ограничениями. Он не выполнялся здесь в 1С; проверьте реальные результаты в своём учебном контексте.
На что обратить внимание
При неподдерживаемой операции или режиме записи возможно исключение; этот пример не обещает произвольную комбинацию узлов как валидный XML.
Само объявление DTD не выполняет проверку данных по DTD и не загружает внешнюю схему.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Копировать XML из DOM в DOM по одному событию чтения
ЗаписатьТекущий не читает следующий узел. Чтение продвигаем ровно один раз в условии цикла и копируем каждое событие; исходное дерево остаётся неизменным.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
В этом блоке каждый пример создаёт собственное дерево DOM в памяти. Файлы, сеть, данные документов и справочников не используются.
Открыть у ЧтениеУзловDOM принимает узел, а у ЗаписьУзловDOM — документ-владелец будущих узлов. Это не открытие файла.
Документ = Новый ДокументDOM("", "products");
Корень = Документ.ЭлементДокумента;
Для Номер = 1 По 2 Цикл
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", ?(Номер = 1, "A-01", "B-02"));
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел(?(Номер = 1, "Книга", "Ручка")));
Корень.ДобавитьДочерний(Товар);
КонецЦикла;
Копия = Новый ДокументDOM("", "container");
Чтение = Новый ЧтениеУзловDOM;
Запись = Новый ЗаписьУзловDOM;
Чтение.Открыть(Корень);
Запись.Открыть(Копия);
ЧислоСобытий = 0;
Попытка
Пока Чтение.Прочитать() Цикл
Запись.ЗаписатьТекущий(Чтение);
ЧислоСобытий = ЧислоСобытий + 1;
КонецЦикла;
Фрагмент = Запись.УзелDOM;
Исключение
Чтение.Закрыть();
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Запись.Закрыть();
Копия.ЭлементДокумента.ДобавитьДочерний(Фрагмент);
СкопированныеТовары = Копия.ЭлементДокумента.ПервыйДочерний;
Сообщить(ЧислоСобытий = 8);
Сообщить(СкопированныеТовары.ИмяЭлемента = "products");
Сообщить(СкопированныеТовары.ДочерниеУзлы.Количество() = 2);
Сообщить(СкопированныеТовары.ПервыйДочерний.ПолучитьАтрибут("code") = "A-01");
Сообщить(СкопированныеТовары.ПоследнийДочерний.ТекстовоеСодержимое = "Ручка");
Сообщить(Корень.ДочерниеУзлы.Количество() = 2);
Сообщить(СкопированныеТовары.ДокументВладелец = Копия);
Сообщить(Корень.ДокументВладелец = Документ);
СкопированныеТовары.ПервыйДочерний.УстановитьАтрибут("code", "COPY");
Сообщить(Корень.ПервыйДочерний.ПолучитьАтрибут("code") = "A-01");Разбор по шагам
Открываем чтение на корневом элементе исходного документа, а запись — на другом документе-владельце.
Прочитать в условии цикла выбирает событие, ЗаписатьТекущий переносит только текущее состояние. Начала, тексты и концы проходят в исходном порядке.
После окончания получаем фрагмент и включаем его под container целевого документа. Здесь обёртка container намеренная, не копия исходного корня документа.
Проверяем владельцев и меняем code только у копии. Исходный A-01 не меняется — узлы не перемещались между документами.
Как проверить результат
Все девять логических проверок дают Истина.
Восемь событий: начало products, начало product, текст, конец product, начало product, текст, конец product, конец products.
Копия имеет container/products с двумя товарами; у исходного первого товара после изменения копии остаётся A-01.
Ожидаемый результат
Продемонстрирован полный событийный перенос собственного XML с независимыми целевыми узлами.
На что обратить внимание
Не вызывайте Прочитать внутри тела дополнительно: тогда часть событий пропадёт. ЗаписатьТекущий сам чтение не продвигает.
Атрибуты начала элемента переносятся вместе с его состоянием, поэтому здесь не нужно отдельно обходить атрибуты и дублировать их запись.
Число восемь относится к этому дереву без форматирующих пробелов. Это не универсальное число событий двух товарных строк.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.