XDTO в 1С: что это и как с ним работать

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

Основная задача XDTO — обеспечить обмен данными между 1С и внешними системами: веб-сервисами, другими базами 1С, банковскими клиентами, сайтами, государственными порталами. Когда вы настраиваете обмен с ЭДО, загружаете выписку из банка или публикуете веб-сервис, с высокой вероятностью внутри работает именно XDTO.

В отличие от «ручного» разбора XML через ЧтениеXML, XDTO опирается на схему данных (XSD): платформа знает, какие поля, типы и структуры допустимы, и проверяет соответствие автоматически. Это снижает количество ошибок при обмене, но требует понимания того, как устроены пакеты XDTO и фабрика.

Из чего состоит механизм XDTO

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

Фабрика XDTO — это объект встроенного языка, который «умеет» создавать и читать объекты по описанию из пакетов. Глобальная фабрика (ФабрикаXDTO) содержит все пакеты конфигурации плюс системные пакеты платформы. Можно создать и собственную фабрику из файла схемы XSD, если нужно работать со сторонним форматом, не добавляя его в конфигурацию.

Объект XDTO — это экземпляр данных, созданный по типу из пакета. Значение XDTO — простое значение (строка, число, дата). Разница важна: у объекта есть свойства, а значение — это просто данные без структуры.

Где XDTO применяется на практике

Самый массовый сценарий — веб-сервисы. Когда вы публикуете веб-сервис 1С, платформа автоматически строит WSDL-описание на основе XDTO-пакетов, а входящие и исходящие SOAP-сообщения разбираются и формируются через фабрику. То же происходит при вызове внешних веб-сервисов через WS-ссылки: платформа импортирует WSDL и создаёт пакеты XDTO по её схемам.

Второй сценарий — универсальный формат обмена EnterpriseData, который используется для синхронизации между конфигурациями 1С (например, между ERP и Бухгалтерией) и с сайтами. Сообщения этого формата — XML-документы, обрабатываемые через XDTO. Также XDTO работает «под капотом» планов обмена и типовых механизмов обмена с банками и ЭДО.

Третий сценарий — собственные интеграции. Если партнёр прислал XSD-схему своего формата, вы создаёте по ней пакет XDTO и пишете код чтения и записи документов без ручного разбора тегов.

Как сериализовать объект в XML и обратно

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

Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
ФабрикаXDTO.ЗаписатьXML(Запись, СсылкаНаДокумент);
СтрокаXML = Запись.Закрыть();

Обратная операция — чтение: создаётся ЧтениеXML, вызывается ФабрикаXDTO.ПрочитатьXML, и возвращается либо объект конфигурации, либо объект XDTO — в зависимости от того, по какому типу записаны данные. Если данные записаны по типу из пользовательского пакета, вы получите ОбъектXDTO, из которого значения читаются через свойства.

Для произвольных структур данных, которым не соответствует объект базы, создают объект XDTO вручную: получают тип из пакета методом ФабрикаXDTO.Тип, создают объект через ФабрикаXDTO.Создать, заполняют свойства и записывают. Перед записью полезно вызвать метод Проверить() у объекта — он сверит заполнение с ограничениями схемы.

1. 1
   Создайте XDTO-пакет в конфигураторе и опишите в нём типы объектов и свойств.
2. 2
   В коде получите тип: Тип = ФабрикаXDTO.Тип("http://ваше-пространство", "Заказ").
3. 3
   Создайте объект: Объект = ФабрикаXDTO.Создать(Тип) и заполните его свойства.
4. 4
   Вызовите Объект.Проверить() для контроля обязательных полей.
5. 5
   Запишите объект через ЗаписьXML и ФабрикаXDTO.ЗаписатьXML, сохраните результат.

XDTO против ручного разбора XML

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

Ручной разбор через ЧтениеXML оправдан, когда схемы нет, формат нестабилен или документ огромный и его нельзя целиком загружать в память. Объект XDTO строится в памяти полностью, поэтому для файлов в сотни мегабайт потоковое чтение может быть единственным рабочим вариантом.

Типичные ошибки и ограничения

Самая частая проблема — несовпадение пространств имён. Если при чтении XML пространство имён в файле отличается от объявленного в пакете, фабрика не найдёт тип и выдаст ошибку обнаружения неизвестного элемента. Проверяйте атрибут xmlns в корневом элементе файла и сопоставляйте с URI пакета.

Вторая типичная ситуация — ошибки проверки типов: строка длиннее ограничения, число вне диапазона, незаполненное обязательное свойство. Фабрика сообщает об этом при записи или при вызове Проверить(). Лечится корректным заполнением данных, а не отключением проверок.

Третья группа ошибок связана с производительностью: попытка сериализовать огромные таблицы значений одним объектом приводит к росту памяти и тайм-аутам веб-сервисов. В таких случаях данные разбивают на порции или передают ссылки на выгрузку.

Как проверить, что обмен работает правильно

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

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

Частые вопросы по XDTO в 1С