Работа с XML-данными в 1С:Предприятие — одна из самых востребованных задач при интеграции с внешними системами, обмене данными между базами или обработке файлов в формате XML. Часто данные приходят в виде строки, и их нужно преобразовать в полноценный XML-документ для дальнейшего парсинга. Однако этот процесс не всегда проходит гладко: ошибки разбора, некорректные символы или неверная кодировка могут привести к сбоям.

В этой статье мы разберём три основных способа чтения строки как XML в 1С (включая актуальные методы для платформы 8.3.20+), типичные ошибки и их решения, а также приведём практические примеры кода с обработкой исключений. Особое внимание уделим нюансам работы с кодировками UTF-8/windows-1251 и валидации структуры XML перед парсингом.

1. Почему строку нужно преобразовывать в XML?

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

  • 🔍 Использовать методы ПолучитьАтрибут() или Узлы для навигации по документу.
  • 📊 Применять XSL-преобразования или XPath-запросы.
  • 🔄 Сериализовать/десериализовать данные для обмена с веб-сервисами.
  • ⚡ Автоматически валидировать структуру по XSD-схеме.

Например, если вы получаете ответ от API в виде строки <Root><Item id="1">Товар</Item></Root>, то без преобразования не сможете извлечь значение атрибута id или текст узла Item стандартными средствами 1С.

📊 Какой метод чтения XML вы используете чаще?
ЗагрузкаXML()
Новый ЧтениеXML
Парсинг через DOM
Другой

2. Метод 1: ЗагрузкаXML() — классический подход

Самый распространённый способ — использование встроенной функции ЗагрузкаXML(). Она доступна как в тонком клиенте, так и на сервере, и поддерживает основные кодировки. Синтаксис:

Попытка

XMLДокумент = ЗагрузкаXML(СтрокаXML);


Исключение


Сообщить("Ошибка разбора XML: " + ОписаниеОшибки());


КонецПопытки;

Особенности метода:

  • ✅ Простота использования — одна строка кода.
  • ✅ Автоматическая обработка кодировки (если указана в заголовке XML).
  • ⚠️ Не обрабатывает ошибки невалидного XML — требуется блок Попытка...Исключение.
  • ⚠️ В старых версиях платформы (до 8.3.10) могли возникать проблемы с символами & или <.

Пример с обработкой кодировки UTF-8:

СтрокаXML = "Тест";

XMLДокумент = ЗагрузкаXML(СтрокаXML);


Если XMLДокумент.Имя <> "Root" Тогда


Сообщить("Ошибка: корневой узел не найден!");


КонецЕсли;

💡

Если XML содержит спецсимволы (например, < или &), предварительно замените их на HTML-сущности с помощью функции СтрЗаменить() или используйте CDATA.

3. Метод 2: ЧтениеXML — для потоковой обработки

Если XML-данные поступают из файла, HTTP-запроса или другого потока, удобнее использовать объект ЧтениеXML. Этот метод позволяет:

  • 📥 Чтить XML порциями (полезно для больших файлов).
  • 🔄 Контролировать процесс разбора через события.
  • 🛠 Гибко обрабатывать ошибки на уровне узлов.

Пример чтения XML из строки:

Чтение = Новый ЧтениеXML;

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


XMLДокумент = Чтение.Прочитать();

Для работы с файлом:

Чтение = Новый ЧтениеXML;

Чтение.ОткрытьФайл("C:\data.xml");


XMLДокумент = Чтение.Прочитать();


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

⚠️ Внимание: При чтении из файла убедитесь, что путь указан корректно (в серверных процедурах используйте КаталогВременныхФайлов() или КаталогДокументов()). В тонком клиенте доступ к файловой системе может быть ограничен.
Метод Преимущества Недостатки Когда использовать
ЗагрузкаXML() Простота, одна строка кода Нет контроля над процессом разбора Для небольших XML-строк
ЧтениеXML Потоковая обработка, события Более сложный код Для больших файлов или HTTP-потоков
DOMParser (через COM) Поддержка XSD, XPath Только для Windows, требует прав Для сложной валидации

4. Метод 3: Парсинг через DOM (для сложных случаев)

Если вам нужна продвинутая обработка (валидация по XSD, XPath-запросы), можно использовать MSXML DOMDocument через COM-объект. Этот способ работает только на Windows и требует прав на создание COM-объектов.

Пример кода:

Попытка

DOMDocument = Новый COMОбъект("MSXML2.DOMDocument.6.0");


DOMDocument.async = Ложь;


DOMDocument.loadXML(СтрокаXML);



Если DOMDocument.parseError.errorCode <> 0 Тогда


Сообщить("Ошибка XML: " + DOMDocument.parseError.reason);


Иначе


// Успешный парсинг


КорневойУзел = DOMDocument.documentElement;


КонецЕсли;


Исключение


Сообщить("Ошибка COM: " + ОписаниеОшибки());


КонецПопытки;

Преимущества метода:

  • 🔍 Поддержка XPath для сложных запросов (например, //Item[@id=1]).
  • 📋 Валидация по XSD-схеме через schemas.
  • 🛠 Более детальная диагностика ошибок.
⚠️ Внимание: В веб-клиенте или на Linux этот метод не работает — используйте только для локальных решений под Windows. Для кроссплатформенных задач отдайте предпочтение ЗагрузкаXML().
Как проверить наличие COM-объекта MSXML?

Чтобы убедиться, что на компьютере установлен MSXML, выполните в 1С код: 

Попытка

Объект = Новый COMОбъект("MSXML2.DOMDocument");


Сообщить("MSXML доступен, версия: " + Объект.version);


Исключение


Сообщить("MSXML не установлен!");


КонецПопытки;

Если объект не создаётся, скачайте и установите Microsoft XML Parser (MSXML) с официального сайта Microsoft.

5. Обработка ошибок и типичные проблемы

При чтении XML из строки чаще всего возникают следующие ошибки:

  • 🔴 Невалидный XML: отсутствует корневой узел, незакрытые теги, специальные символы без экранирования.
  • 🔴 Проблемы с кодировкой: расхождение между заявленной кодировкой в заголовке XML и реальной кодировкой строки.
  • 🔴 Ограничения платформы: в старых версиях 1С (до 8.3.10) функция ЗагрузкаXML() могла обрезать длинные строки.
  • 🔴 COM-ошибки: отсутствие прав или неустановленный MSXML.

Пример обработки ошибок с детализацией:

Попытка

XMLДокумент = ЗагрузкаXML(СтрокаXML);


Исключение


Если Найти(ОписаниеОшибки(), "недопустимый символ") > 0 Тогда


Сообщить("Ошибка: XML содержит недопустимые символы. Проверьте кодировку!");


ИначеЕсли Найти(ОписаниеОшибки(), "корневой элемент") > 0 Тогда


Сообщить("Ошибка: отсутствует корневой элемент XML.");


Иначе


Сообщить("Неизвестная ошибка: " + ОписаниеОшибки());


КонецЕсли;


КонецПопытки;

Убедитесь, что строка начинается с

Проверьте закрытие всех тегов (например, ...)

Замените спецсимволы (& на &, < на <)

Совпадает ли кодировка в заголовке XML с реальной кодировкой строки?

-->

6. Практические примеры для типовой и управляемой формы

Рассмотрим два сценария: чтение XML в тонком клиенте (управляемые формы) и на сервере (для обмена данными).

Пример 1. Управляемая форма (тонкий клиент):

&Процедура ПрочитатьXMLНаКлиенте(СтрокаXML)

Попытка


XMLДокумент = ЗагрузкаXML(СтрокаXML);


Для Каждого Узел Из XMLДокумент.Узлы Цикл


Сообщить(Узел.Имя + ": " + Узел.Текст);


КонецЦикла;


Исключение


Сообщить("Ошибка: " + ОписаниеОшибки(), СтатусСообщения.Важное);


КонецПопытки;


КонецПроцедуры

Пример 2. Серверная процедура (для обмена с веб-сервисом):

&Процедура ОбработатьОтветAPI(СтрокаXML) Экспорт

Чтение = Новый ЧтениеXML;


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



Попытка


XMLДокумент = Чтение.Прочитать();


Возврат XMLДокумент;


Исключение


ЗаписатьЖурналРегистрации(НСтр("ru = 'Ошибка разбора XML'"), УровеньЖурналаОшибка,,,


Подробности = ОписаниеОшибки() + " | XML: " + Сред(СтрокаXML, 1, 100));


Возврат Неопределено;


КонецПопытки;


КонецПроцедуры

В серверных процедурах рекомендуется логировать ошибки в журнал регистрации, а не показывать их пользователю напрямую.

💡

Для обмена данными с внешними системами всегда проверяйте структуру XML на соответствие XSD-схеме. Это позволит избежать ошибок при изменении формата данных.

7. Оптимизация и производительность

При работе с большими XML-файлами (от 10 МБ) следует учитывать:

  • 📉 ЗагрузкаXML() загружает весь документ в память — может вызвать переполнение.
  • 📈 ЧтениеXML с потоковой обработкой экономнее по памяти.
  • ⚡ Для критичных задач рассмотрите использование SAX-парсера (через COM или внешние компоненты).

Пример оптимизированного чтения большого файла:

Чтение = Новый ЧтениеXML;

Чтение.ОткрытьФайл(ПутьКФайлу);


XMLДокумент = Чтение.Прочитать();


Чтение.Закрыть(); // Освобождаем ресурсы

Если XML содержит повторяющиеся узлы (например, список товаров), обрабатывайте их в цикле без хранения всего дерева:

Чтение = Новый ЧтениеXML;

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


Пока Чтение.Прочитать() Цикл


ТекущийУзел = Чтение.ТекущийУзел;


Если ТекущийУзел.ТипУзла = ТипУзлаXML.Элемент Тогда


// Обработка узла


КонецЕсли;


КонецЦикла;

FAQ: Частые вопросы по чтению XML в 1С

Как узнать кодировку XML-строки?

Кодировка обычно указана в заголовке XML: <?xml version="1.0" encoding="UTF-8"?>. Если заголовка нет, 1С по умолчанию использует windows-1251. Чтобы определить кодировку программно, можно использовать функцию:

Функция ОпределитьКодировку(СтрокаXML)

Если Найти(СтрокаXML, "encoding=") > 0 Тогда


Начало = Найти(СтрокаXML, "encoding=""") + 10;


Конец = Найти(СтрокаXML, """", Начало);


Возврат Сред(СтрокаXML, Начало, Конец - Начало);


Иначе


Возврат "windows-1251";


КонецЕсли;


КонецФункции

Можно ли прочитать XML из Base64?

Да. Если XML закодирован в Base64, сначала декодируйте строку:

Base64Строка = "PHJvb3Q+VGVzdDwvcm9vdD4=";

XMLСтрока = Base64СтрокаВСтроку(Base64Строка);


XMLДокумент = ЗагрузкаXML(XMLСтрока);

Почему 1С обрезает длинные XML-строки?

В версиях 1С до 8.3.10 существовало ограничение на длину строки (около 100 КБ). В современных версиях (8.3.20+) этого ограничения нет, но если проблема сохраняется:

  • Проверьте, не обрезается ли строка при передаче через параметры функции.
  • Используйте временные файлы для больших данных.
Как обработать XML с пространствами имён (namespaces)?

Для работы с XML, содержащим пространства имён (например, xmlns:ns="..."), используйте методы ПространстваИмен:

XMLДокумент = ЗагрузкаXML(СтрокаXML);

Пространство = XMLДокумент.ПространстваИмен.Получить("ns");


Узлы = XMLДокумент.ПолучитьУзлы("ns:Элемент");

Что делать, если XML содержит бинарные данные (например, картинки в Base64)?

Бинарные данные в XML обычно закодированы в Base64. Извлеките их и декодируйте:

XMLДокумент = ЗагрузкаXML(СтрокаXML);

БинарныеДанные = Base64СтрокаВДвоичныеДанные(XMLДокумент.Узлы.Элемент.Текст);


Картинка = Новый Картинка(БинарныеДанные);