К статье
Практический материал

Другое · 5 мин

Что такое DOM в 1С:Предприятие

Что такое DOM в 1С: объектная модель XML в платформе, когда применять Документ DOM вместо потокового чтения и какие ограничения учитывать при обмене данными.

DOM — это объектная модель документа, которая представляет структуру XML в виде дерева узлов. В терминах 1С:Предприятие речь идёт о работе с XML-документами через специальные встроенные объекты, а не о веб-верстке. Понимание различий помогает выбрать подходящий способ обмена данными с внешними системами.

В 1С DOM реализуется через объекты, которые позволяют загрузить XML в память, перемещаться по элементам и атрибутам, читать и менять значения, создавать новые узлы. Такой подход удобен, когда документ нужно обработать нелинейно или сохранить изменения в том же файле.

Основное применение — импорт и экспорт данных, интеграция с сайтами и сервисами, работа с файлами обмена из внешних систем. При этом DOM не является единственным вариантом: для простого последовательного чтения часто достаточно потокового объекта, а DOM выбирают, когда нужна случайный доступ к узлам.

Малый или средний XML-файлDOM допустим

Проверьте, что файл открывается и корректно парсится

Большой файл обменаПотоковое чтение предпочтительнее

Убедитесь, что память не перегружается при загрузке

Нужно изменить узел и сохранитьDOM подходит

Сравните исходный и полученный XML после записи

Что представляет собой DOM в 1С

В платформе DOM ассоциируется с объектами для обработки XML, например Документ DOM и Узел DOM. Загруженный документ становится иерархией: корневой элемент, дочерние узлы, атрибуты и текстовое содержимое. Каждый узел можно найти по имени, перебрать в цикле или получить значение без прохождения всего файла с начала.

Такой подход подходит, если структура заранее известна и нужно обращаться к разным частям документа в произвольном порядке. Например, прочитать значение из конца файла, изменить промежуточный узел и записать результат обратно, не пересоздавая документ заново.

Порядок действий
  1. 1
    Загрузите XML-файл в объект DOM
  2. 2
    Найдите нужные узлы и проверьте их значения
  3. 3
    Внесите изменения или создайте новые элементы
  4. 4
    Запишите результат в файл и сравните с исходником

Отличие DOM от потокового чтения XML

Потоковое чтение проходит документ последовательно и не хранит всё дерево в памяти. Это экономно по ресурсам, но не позволяет вернуться к уже пройденному узлу или легко вставить элемент в середину. DOM загружает документ целиком, поэтому доступ к любому узлу возможен в любой момент.

Выбор зависит от размера файла и задачи. Для небольших файлов обмена и сложной трансформации DOM удобнее, а для больших выгрузок потоковый режим снижает нагрузку на память. При обработке документов неопределённого размера стоит заранее оценить объём данных и доступные ресурсы.

Практические сценарии использования

Типичный сценарий — получение XML от контрагента, извлечение реквизитов и запись их в справочники или документы 1С. С помощью DOM можно найти нужный элемент по имени, прочитать дочерние значения и выполнить проверку перед сохранением. Это полезно при интеграции с интернет-магазинами, банками или государственными сервисами.

Другой сценарий — формирование исходящего XML. Программно создаётся документ, добавляются элементы и атрибуты, заполняются значения, после чего результат записывается в файл или отправляется по протоколу обмена. DOM позволяет собрать структуру пошагово и проверить её перед отправкой.

Ограничения и риски при работе с DOM

Главное ограничение — память. Поскольку DOM строит дерево всего документа, обработка больших файлов может привести к истощению ресурсов и остановке процесса. Поэтому для крупных выгрузок стоит использовать последовательное чтение или разбивать файл на части, если это поддерживается форматом.

Ещё один риск — некорректный XML. Повреждённый файл, неверная кодировка или отсутствие обязательных элементов вызовут ошибку при чтении. Перед массовой обработкой рекомендуется протестировать сценарий на копии данных и проверить результат на нескольких образцах, включая пустые и ошибочные файлы.

Контрольные точки

Как проверить результат

Открытие XML через DOM
Норма

Документ загружается без ошибок

Тревожный признак

Ошибка чтения или неверная кодировка

Запись изменённого XML
Норма

Файл открывается и содержит ожидаемые узлы

Тревожный признак

Элементы отсутствуют или структура нарушена

Обработка большого файла
Норма

Память остаётся в пределах нормы

Тревожный признак

Процесс завершается с ошибкой нехватки ресурсов

Как проверить результат и избежать ошибок

После чтения XML убедитесь, что нужные элементы найдены, а значения соответствуют ожидаемым. При записи сравните полученный файл с эталоном: структура, порядок узлов и наличие обязательных атрибутов должны совпадать с требованиями приёмной системы.

Частые ошибки — попытка обратиться к отсутствующему узлу, неверная работа с регистром имён и потеря пробелов в текстовых значениях. Перед вводом в эксплуатацию проверьте сценарий на файлах с разной вложенностью, пустыми элементами и нестандартными символами.

Итог

Что важно запомнить

DOM в 1С удобен для нелинейной работы с XML, но требует памяти и корректного исходного файла; для больших данных выбирайте потоковое чтение.

Нужно ли всегда использовать DOM для XML в 1С?

Нет. DOM подходит, когда требуется случайный доступ к узлам или изменение документа в памяти. Для простого последовательного чтения больших файлов чаще рациональнее использовать потоковое чтение XML.

Можно ли изменить XML-файл через DOM и сохранить обратно?

Да. Объектная модель позволяет менять значения, добавлять и удалять узлы, после чего результат записывается в файл. Перед сохранением стоит проверить, что структура соответствует ожиданиям приёмной системы.

Какие ограничения у DOM при работе с большими файлами?

DOM загружает весь документ в память, поэтому при больших объёмах возможен исчерпание ресурсов и остановка обработки. В таких случаях предпочтительнее потоковое чтение или разбивка файла на части.

Что делать, если XML не открывается через DOM?

Проверьте целостность файла, кодировку и соответствие синтаксису XML. Повреждённый или некорректный документ вызовет ошибку при чтении, поэтому сначала протестируйте сценарий на исправном образце.