В каких задачах 1С нельзя обойтись без XDTO-пакетов и когда их использование оправдано?

← На главную

Механизм XDTO (XML Data Transfer Objects) предназначен для описания структуры передаваемых данных с помощью стандартов XML Schema (XSD) и последующей сериализации объектов. Среди разработчиков нередко возникает вопрос: является ли XDTO обязательным инструментом платформы или абсолютно любую интеграцию можно реализовать классическими методами через ручной разбор текстовых форматов? Проанализируем архитектуру платформы, выясним сценарии жесткой технической необходимости XDTO и разберем практические приемы эффективной работы со схемами.

Сценарии, где XDTO технически обязателен на уровне платформы

Существуют задачи, в которых обойтись без объектов XDTO невозможно из-за требований системной архитектуры 1С:

Разработка собственных SOAP веб-сервисов (объект метаданных Web-сервисы): При создании точки интеграции по протоколу SOAP в дереве конфигурации платформа 1С безальтернативно требует указания типов входящих параметров и возвращаемых значений операций из пакетов XDTO (системных или созданных разработчиком). Без объявления XDTO-пакета опубликовать и настроить рабочий веб-сервис штатными средствами платформы нельзя.
Использование внешних SOAP веб-сервисов через объект WS-ссылки: При импорте стороннего WSDL-файла платформа автоматически генерирует дерево типов в виде внутренних пакетов XDTO. Взаимодействие с методами стороннего веб-сервиса и формирование тела запроса осуществляется строго через ОбъектXDTO.
Типовой обмен в рамках Конвертации данных редакции 3.0 (КД 3.0) и EnterpriseData: Архитектура формата EnterpriseData целиком базируется на предопределенном XDTO-пакете. Модули интеграции библиотек стандартных подсистем (БСП) ожидают и генерируют данные в формате XDTO, поэтому отказаться от пакета при реализации стандартного обмена невозможно без полного переписывания типового функционала.

Преимущества использования XDTO перед ручным разбором XML и JSON

Когда речь заходит о файловом обмене (произвольные XML-файлы, интеграция со сторонними учетными системами, государственными порталами, таможней и т.д.), теоретически задачу можно решить потоковым чтением ЧтениеXML или текстовыми методами. Однако применение XDTO дает существенные преимущества:

Автоматическая строгая типизация данных: При обычном чтении тегов через ЧтениеXML разработчик получает исключительно строковые значения. Приходится вручную приводить каждое поле к нужному типу (вызывать Число(), Дата(), парсить булевы флаги и GUID). Фабрика XDTO берет это на себя: даты автоматически становятся датами 1С, числа — числами, а булево — типом Булево.
Формальная валидация структуры и значений: С помощью метода ФабрикаXDTO.Проверить() можно проверить входящий или исходящий XML-документ на соответствие ограничениям схемы (длина строк, регулярные выражения, обязательность заполнения, диапазоны чисел). Это исключает необходимость написания сотен строк валидационного кода вручную.
Работа с JSON: Начиная с платформы 8.3, методы ФабрикаXDTO.ПрочитатьJSON() и ФабрикаXDTO.ЗаписатьJSON() позволяют использовать строгие XSD-схемы для работы с форматом JSON, компенсируя отсутствие в JSON нативного типа даты и предотвращая искажения типов.

Практический кейс: Динамическая загрузка схем из ZIP-архива без добавления в дерево метаданных

Часто внешние ведомства (например, таможенные органы или налоговые службы) предоставляют спецификации, состоящие из сотен взаимосвязанных XSD-файлов. Добавление 400 и более пакетов в дерево метаданных конфигурации неоправданно раздувает конфигурацию и усложняет поддержку. В этом случае правильным подходом является хранение архива схем во внешнем файле или общем макете с последующим программным созданием фабрики через метод СоздатьФабрикуXDTO().

Рассмотрим пример функции, которая извлекает набор схем XSD из макета с ZIP-архивом и формирует фабрику XDTO:


Функция ПолучитьФабрикуXDTOИзМакета(ИмяМакета = "СхемыОбмена") Экспорт
    
    ДанныеМакета = ПолучитьМакет(ИмяМакета);
    ИмяВременногоФайла = ПолучитьИмяВременногоФайла("zip");
    ДанныеМакета.Записать(ИмяВременногоФайла);
    
    Чтение = Новый ЧтениеZipФайла(ИмяВременногоФайла);
    ИмяВременногоКаталога = ПолучитьИмяВременногоФайла("");
    СоздатьКаталог(ИмяВременногоКаталога);
    Чтение.ИзвлечьВсе(ИмяВременногоКаталога, РежимВосстановленияПутейФайловZIP.НеВосстанавливать);
    
    Файлы = НайтиФайлы(ИмяВременногоКаталога, "*.xsd", Истина);
    МассивСхем = Новый Массив();
    Для Каждого Файл Из Файлы Цикл
        МассивСхем.Добавить(Файл.ПолноеИмя);
    КонецЦикла;
    
    Фабрика = СоздатьФабрикуXDTO(МассивСхем);
    
    // Удаляем временные файлы после успешной компиляции фабрики
    УдалитьФайлы(ИмяВременногоФайла);
    УдалитьФайлы(ИмяВременногоКаталога);
    
    Возврат Фабрика;
    
КонецФункции

После получения фабрики разбор входящего XML-файла сводится к вызову чтения, после чего все реквизиты становятся доступны через свойства типизированного объекта XDTO:


Фабрика = ПолучитьФабрикуXDTOИзМакета();

ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.ОткрытьФайл("C:\Exchange\CustomsData.xml");

ОбъектДанных = Фабрика.ПрочитатьXML(ЧтениеXML);
ЧтениеXML.Закрыть();

// Обращение к свойствам объекта без ручного парсинга типов
НомерДекларации = ОбъектДанных.DeclarationNumber;
ДатаРегистрации = ОбъектДанных.RegistrationDate; // Уже является типом Дата
СуммаПлатежа    = ОбъектДанных.TotalAmount;       // Уже является типом Число

Ограничения и ситуации, когда от XDTO следует отказаться

Несмотря на очевидные преимущества, существуют сценарии, в которых применение XDTO является неэффективным или технически невозможным:

Обработка больших файлов (сотни мегабайт и гигабайты): Метод Фабрика.ПрочитатьXML() загружает всё дерево документа в оперативную память целиком (подобно модели DOM). Для файлов большого размера это неизбежно приводит к ошибке «Недостаточно памяти» и аварийному завершению сеанса. В таких случаях необходимо использовать потоковое последовательное чтение через объект ЧтениеXML.
Высокие накладные расходы при компиляции схем: Метод СоздатьФабрикуXDTO() требует ощутимого времени на валидацию и компиляцию схем. Недопустимо вызывать создание динамической фабрики в цикле или при каждом входящем HTTP/SOAP-запросе без кэширования (например, фабрику следует кэшировать в модуле с повторным использованием возвращаемых значений).
Отсутствие схемы у контрагента: Если партнерская система не предоставляет XSD-описание и формат часто меняется, самостоятельное проектирование схемы «с нуля» может отнять больше времени, чем обработка данных через стандартные объекты разбора.