1С: как прочитать объект XDTO

Объект XDTO в 1С — это представление XML-документа в виде дерева объектов, с которым можно работать как с обычными структурами данных: обращаться к свойствам, перебирать списки, проверять типы. Технология XDTO (XML Data Transfer Objects) лежит в основе обмена данными с веб-сервисами, загрузки выписок, интеграции по форматам EnterpriseData и CommerceML, а также работы с любыми XML-файлами, для которых известна схема.

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

Ниже разобраны оба сценария с рабочим кодом, способы проверки типов и свойств, обработка списков и ошибок, а также критерии выбора между XDTO и последовательным чтением XML.

Что такое объект XDTO и когда его читают

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

Объект XDTO приходится читать в типовых сценариях: загрузка ответа веб-сервиса, импорт файла обмена (например, CommerceML от сайта или EnterpriseData из другой информационной базы), разбор XML, полученного от банка или оператора ЭДО, чтение настроек и пакетов обмена. Во всех случаях исходные данные — это XML-документ, а результат — дерево объектов XDTO.

Чтение XML в объект XDTO через ФабрикаXDTO

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

Пример чтения из файла:

ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.ОткрытьФайл("C:\Обмен\order.xml");
ОбъектXDTO = ФабрикаXDTO.ПрочитатьXML(ЧтениеXML);
ЧтениеXML.Закрыть();

Сообщить(ОбъектXDTO.Тип().Имя); // имя корневого типа

Если XML находится в строке (например, тело ответа HTTP-запроса), вместо ОткрытьФайл используется УстановитьСтроку:

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

ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.ОткрытьФайл(ИмяФайла);
ОбъектXDTO = ФабрикаXDTO.ПрочитатьXML(ЧтениеXML);
ЧтениеXML.Закрыть();

Если корневой тип документа заранее известен, его можно передать вторым параметром: ФабрикаXDTO.ПрочитатьXML(ЧтениеXML, ТипXDTO). Это полезно, когда фабрика не может однозначно определить тип по пространству имён или требуется строгая проверка соответствия схеме.

Обращение к свойствам объекта XDTO

После чтения данные доступны как свойства объекта: ОбъектXDTO.Номер, ОбъектXDTO.Дата, ОбъектXDTO.Контрагент.Наименование. Имена свойств совпадают с именами элементов и атрибутов в схеме. Вложенные элементы образуют вложенные объекты XDTO, обращение к ним идёт через точку.

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

Если ОбъектXDTO.Установлено("Контрагент") Тогда
Наименование = ОбъектXDTO.Контрагент.Наименование;
Иначе
Наименование = "";
КонецЕсли;

Метод Установлено() возвращает Истина, если свойство присутствует в документе. Альтернатива — сравнение значения свойства с Неопределено, но Установлено() надёжнее, поскольку явно отражает факт наличия элемента в XML.

Работа со списками и коллекциями XDTO

Элементы, которые в схеме могут повторяться (maxOccurs больше 1), фабрика возвращает как СписокXDTO. Его обходят циклом Для Каждого, а количество элементов узнают через Количество().

Для Каждого СтрокаТовара Из ОбъектXDTO.Товары.Товар Цикл
Сообщить(СтрокаТовара.Наименование + " — " + СтрокаТовара.Количество);
КонецЦикла;

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

Значение = ОбъектXDTO.Товар;
Если ТипЗнч(Значение) = Тип("СписокXDTO") Тогда
Для Каждого Элемент Из Значение Цикл
// обработка элемента списка
КонецЦикла;
ИначеЕсли Значение <> Неопределено Тогда
// обработка одиночного объекта
КонецЕсли;

Проверка типов и диагностика структуры

При разборе незнакомого XML полезно сначала изучить полученное дерево. Метод ОбъектXDTO.Тип() возвращает ТипОбъектаXDTO с именем и пространством имён. Список свойств типа доступен через коллекцию Свойства, а собственные значения объекта — через метод Свойства() самого объекта.

Для Каждого Свойство Из ОбъектXDTO.Свойства() Цикл
Сообщить(Свойство.Имя + " : " + Свойство.Тип.Имя);
КонецЦикла;

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

1. 1
   Получите XML: файл, строка ответа сервиса или поток обмена
2. 2
   Создайте ЧтениеXML и откройте источник (ОткрытьФайл или УстановитьСтроку)
3. 3
   Вызовите ФабрикаXDTO.ПрочитатьXML(ЧтениеXML) и закройте чтение
4. 4
   Проверьте тип корневого объекта через Тип() — убедитесь, что прочитан нужный документ
5. 5
   Обходите свойства с проверкой Установлено(), списки — циклом с проверкой ТипЗнч
6. 6
   Перенесите значения в объекты конфигурации и зафиксируйте результат

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

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

Попытка
ОбъектXDTO = ФабрикаXDTO.ПрочитатьXML(ЧтениеXML);
Исключение
Сообщить("Ошибка чтения XML: " + ОписаниеОшибки());
ЧтениеXML.Закрыть();
Возврат;
КонецПопытки;

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

Когда XDTO не нужен: альтернативы

XDTO оправдан, когда есть схема данных и нужна типизация: обмены по стандартным форматам, веб-сервисы, пакеты EnterpriseData. Если XML простой и разбирается один раз, проще использовать последовательное чтение через ЧтениеXML с проверкой ТипУзла — код длиннее, но не требует пакетов XDTO и экономит память.

Для произвольного XML без схемы есть ещё вариант — ФабрикаXDTO.ПрочитатьXML с нестрогой моделью: фабрика построит объекты по фактической структуре документа. Свойства будут доступны по именам элементов, но без контроля типов. Это компромисс между удобством и строгостью.

FAQ