1С: как прочитать XML из текста

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

Основной инструмент — объект ЧтениеXML в связке с методом УстановитьСтроку(). Он даёт последовательный доступ к узлам документа: элементам, атрибутам, тексту. Для типовых обменов по схеме удобнее механизм XDTO, а для простых разовых выборок иногда достаточно регулярного разбора — но именно ЧтениеXML остаётся универсальным и самым производительным способом.

Ниже разобран рабочий код, типовые сценарии обхода узлов, обработка ошибок формата, особенности кодировки и пространств имён, а также критерии выбора между ЧтениеXML и ЧтениеJSON/XDTO.

Базовый способ: ЧтениеXML и УстановитьСтроку

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

Минимальный рабочий пример выглядит так:

Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);

Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
ИмяУзла = Чтение.Имя;
// обработка начала элемента
ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.Текст Тогда
ЗначениеУзла = Чтение.Значение;
КонецЕсли;
КонецЦикла;

Чтение.Закрыть();

Метод Прочитать() возвращает Истина, пока в потоке есть очередной узел, и Ложь, когда документ закончился. После каждого вызова доступны свойства текущего узла: Имя, ЛокальноеИмя, Значение, ТипУзла, URIПространстваИмен, Глубина.

Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);
Пока Чтение.Прочитать() Цикл
    Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
        Сообщить(Чтение.Имя);
    КонецЕсли;
КонецЦикла;
Чтение.Закрыть();

Какие узлы встречаются и как их различать

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

Атрибуты читаются двумя способами: методом ЗначениеАтрибута("ИмяАтрибута") прямо на узле начала элемента или перебором через КоличествоАтрибутов() и ПрочитатьАтрибут(). Первый вариант удобнее, когда имена атрибутов известны заранее.

Обратите внимание: пустой элемент вида <Товар/> парсер вернёт как начало элемента со сразу следующим концом элемента, а текст внутри элемента может прийти несколькими узлами подряд, если в нём встречались спецсимволы или CDATA. Поэтому надёжнее собирать значение элемента накоплением, а не брать первый попавшийся текстовый узел.

Разбор вложенной структуры на примере документа

Типовая практическая задача — выгрузка с повторяющимися блоками: шапка документа и табличная часть. Потоковый разбор требует отслеживать «где мы сейчас находимся», обычно через текущую переменную-контекст.

Функция РазобратьДокумент(ТекстXML)
Результат = Новый Структура("Номер, Дата, Строки");
Результат.Строки = Новый Массив;

Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);

ТекущаяСтрока = Неопределено;

Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
Если Чтение.ЛокальноеИмя = "Документ" Тогда
Результат.Номер = Чтение.ЗначениеАтрибута("Номер");
Результат.Дата  = Чтение.ЗначениеАтрибута("Дата");
ИначеЕсли Чтение.ЛокальноеИмя = "Строка" Тогда
ТекущаяСтрока = Новый Структура("Номенклатура, Количество");
ИначеЕсли Чтение.ЛокальноеИмя = "Номенклатура"
И ТекущаяСтрока <> Неопределено Тогда
Чтение.Прочитать(); // переходим к тексту
ТекущаяСтрока.Номенклатура = Чтение.Значение;
КонецЕсли;
ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.КонецЭлемента
И Чтение.ЛокальноеИмя = "Строка" Тогда
Результат.Строки.Добавить(ТекущаяСтрока);
ТекущаяСтрока = Неопределено;
КонецЕсли;
КонецЦикла;

Чтение.Закрыть();
Возврат Результат;
КонецФункции

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

Числа и даты из XML всегда приходят строками. Даты в каноническом формате 2026-03-15T10:30:00 преобразуются функцией XMLЗначение(Тип("Дата"), СтрокаДаты), числа — обычным Число() с учётом того, что разделитель в XML — точка.

Обработка ошибок и невалидного XML

Если строка содержит битый XML — незакрытый тег, лишний символ, обрезанный ответ сервиса — метод Прочитать() выбросит исключение. В рабочем коде разбор всегда оборачивают в попытку, иначе один повреждённый пакет остановит всю загрузку.

Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(ТекстXML);
Пока Чтение.Прочитать() Цикл
// разбор
КонецЦикла;
Чтение.Закрыть();
Исключение
ТекстОшибки = ОписаниеОшибки();
// запись в журнал регистрации, пропуск пакета
КонецПопытки;

Текст исключения обычно содержит позицию ошибки — номер строки и колонки в XML. Это первое, что стоит смотреть при отладке: часто оказывается, что сервис вернул не XML, а HTML-страницу с ошибкой авторизации или текстовое сообщение.

Перед разбором полезна элементарная проверка: строка должна начинаться с < (после возможного BOM и пробелов) и не быть пустой. Это не заменяет попытку, но позволяет быстро отсеять заведомо неподходящие ответы и записать в лог понятную причину.

Кодировка, BOM и объявление XML

Когда XML читается из строки, кодировка уже определена — строка в 1С хранится в Unicode. Проблемы возникают на шаге раньше: при получении этой строки из файла или HTTP-ответа. Если файл в UTF-8 прочитать как ANSI, кириллица превратится в «кракозябры» ещё до разбора.

Для файлов используйте ЧтениеТекста с явным указанием кодировки: Новый ЧтениеТекста(ИмяФайла, КодировкаТекста.UTF8). Для HTTP-ответов метод ПолучитьТелоКакСтроку() сам подбирает кодировку по заголовкам, но при сомнениях её можно задать явно.

Отдельный нюанс — объявление <?xml version="1.0" encoding="UTF-8"?> внутри строки. При разборе из строки оно игнорируется в части кодировки, но его наличие не мешает. А вот BOM (невидимый символ в начале строки) иногда приводит к ошибке разбора — его стоит удалить через СтрЗаменить(Текст, Символ(65279), ""), если данные пришли из внешнего источника.

Когда вместо ЧтениеXML использовать XDTO

Ручной потоковый разбор оправдан, когда структура документа простая, нестабильная или заранее не описана схемой. Но если обмен идёт по формализованному формату — EnterpriseData, обмен с сайтом, ЭДО — платформа предоставляет более удобный путь.

Механизм XDTO позволяет прочитать XML из строки в объектную модель одной командой:

Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);
ОбъектXDTO = ФабрикаXDTO.ПрочитатьXML(Чтение);
Чтение.Закрыть();

После этого данные доступны как свойства объекта: ОбъектXDTO.Документ.Номер, а коллекции обходятся обычным циклом. Если в конфигурации описан пакет XDTO под конкретный формат, фабрика ещё и проверит соответствие схеме — невалидный документ будет отклонён с понятной диагностикой.

Проверка результата и отладка

После разбора убедитесь, что данные действительно извлечены: выведите ключевые поля через Сообщить() или запишите в журнал регистрации. Для тестирования удобно держать под рукой эталонный XML-фрагмент и прогонять функцию разбора на нём после каждого изменения кода.

Полезный отладочный приём — вывести полный дамп всех узлов, которые видит парсер. Это сразу показывает, где расходятся ожидания и реальность: не тот регистр имени, лишний уровень вложенности, пространство имён.

Пока Чтение.Прочитать() Цикл
Сообщить(Строка(Чтение.ТипУзла) + " | "
+ Чтение.Имя + " | " + Чтение.Значение);
КонецЦикла;

Если разбор работает на тестовом фрагменте, но падает на реальных данных, сравните документы построчно: чаще всего причина в необязательных элементах, которые в тесте присутствовали, а в бою отсутствуют, или наоборот — в неожиданных вложенных тегах там, где ожидался текст.

Частые вопросы