Архитектура XDTO в платформе 1С

XDTO (XML Data Transfer Objects) — это универсальный механизм платформы 1С для работы с типизированными данными на основе схем XML (XSD). Объект ФабрикаXDTO является диспетчером, который знает структуру всех типов данных, описанных в конфигурации (в ветке XDTO-пакеты) и базовых типов платформы. Бизнес-риски: сбои при интеграции со сторонними веб-сервисами (SOAP/REST), государственными системами (ЕГАИС, Меркурий, Честный ЗНАК) из-за несоответствия пространств имен.

Базовые (встроенные) пространства имен 1С

Алгоритм работы с Фабрикой XDTO

Сценарий 1: Создание объекта простого типа и его сериализация

Для корректной работы веб-сервисов необходимо правильно инициализировать переменные через базовое пространство имен (namespace).

// 1. Получаем базовый тип XDTO "string" из пространства имен core
ТипСтрока = ФабрикаXDTO.Тип("http://v8.1c.ru/8.1/data/core", "string");

// 2. Создаем значение XDTO
ЗначениеXDTO = ФабрикаXDTO.Создать(ТипСтрока, "Тестовое сообщение");

// 3. Сериализуем объект в XML (через ЗаписьXML)
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
ФабрикаXDTO.ЗаписатьXML(Запись, ЗначениеXDTO);
XMLСтрока = Запись.Закрыть(); // Возвращает валидный XML узел

Сценарий 2: Чтение данных из сторонней XSD-схемы (Парсинг)

Если сервис (например, банк) прислал XML и свою схему (XSD), нужно создать локальную Фабрику XDTO, чтобы 1С знала структуру документа.

// Чтение стороннего XSD файла и создание фабрики
ЧтениеXSD = Новый ЧтениеXML;
ЧтениеXSD.ОткрытьФайл("C:\Integration\BankSchema.xsd");

Построитель = Новый ПостроительDOM;
СхемаXSD = Построитель.Прочитать(ЧтениеXSD);
ЧтениеXSD.Закрыть();

НаборСхем = Новый НаборСхемXML;
НаборСхем.Добавить(СхемаXSD);

// Локальная фабрика, не затрагивающая глобальную конфигурацию
ЛокальнаяФабрика = Новый ФабрикаXDTO(НаборСхем);

// Теперь можно безопасно читать XML по правилам банка
ТипОбъекта = ЛокальнаяФабрика.Тип("http://bank.ru/api/v1", "PaymentDocument");

Типовые ошибки разработчиков

• Путаница между Глобальной и Локальной фабрикой: Использование глобальной ФабрикаXDTO для парсинга сторонних XML без добавления XDTO-пакета в конфигуратор приводит к ошибке «Тип не определен». Для временных структур используйте Новый ФабрикаXDTO(НаборСхемXML).
• Несовпадение регистра (Case Sensitivity): URI пространств имен чувствительны к регистру. http://v8.1C.ru/8.1/data/core (большая 'C') выдаст ошибку, так как платформа ожидает строго http://v8.1c.ru/8.1/data/core.