1С и XML: структура файлов обмена и практическая работа с форматом

XML в 1С — это не просто «ещё один формат файла», а основной способ обмена данными между конфигурациями, сайтами, банками, ЭДО-операторами и внешними системами. Практически любая выгрузка — от каталога товаров на сайт до отчётности в контролирующие органы — внутри представляет собой XML-документ со строго определённой структурой.

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

Материал ориентирован на тех, кто работает с типовыми и самописными конфигурациями: разберём, из чего состоит XML-документ 1С, какие стандартные форматы используются, как программно читать и записывать XML, как проверить файл перед отправкой и какие ошибки встречаются чаще всего.

Из чего состоит XML-документ в контексте 1С

Базовая единица XML — элемент с открывающим и закрывающим тегом: <Номенклатура>...</Номенклатура>. Элементы вкладываются друг в друга, образуя дерево, а дополнительные свойства записываются атрибутами внутри открывающего тега. 1С активно использует оба способа: ссылочные значения и идентификаторы чаще уходят в атрибуты, а составные данные — во вложенные элементы.

Критически важное понятие — пространство имён (namespace). Оно задаётся атрибутом xmlns и отделяет элементы одного формата от другого. Например, в выгрузках между конфигурациями 1С встречается пространство http://v8.1c.ru/data, а в обмене с сайтами — urn:1C.ru:commerceml_2. Если пространство имён в файле не совпадает с ожидаемым, типовая загрузка пройдёт «молча»: файл прочитается, но ни один объект не распознается.

Корневой элемент у файлов обмена 1С обычно несёт служебную информацию: версию формата, дату и время формирования, идентификаторы отправителя и получателя. Уже по этим атрибутам можно понять, каким механизмом создан файл и подходит ли он для конкретной базы-приёмника, не разбирая всё содержимое.

Стандартные форматы обмена: EnterpriseData, CommerceML и форматы конфигураций

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

Практический вывод: прежде чем разбирать «нерабочий» файл, определите его формат по корневому элементу и пространству имён. Файл CommerceML не загрузится механизмом EnterpriseData и наоборот, даже если оба содержат одни и те же товары.

XDTO-пакеты: как 1С описывает структуру XML

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

Работа через XDTO даёт два ключевых преимущества перед «ручным» разбором. Во-первых, платформа сама проверяет соответствие данных схеме: если обязательное свойство отсутствует или тип не совпадает, вы получите понятную ошибку до записи в базу. Во-вторых, сериализация и десериализация выполняются одной строкой — через СериализаторXDTO или фабрику XDTO.

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

Программное чтение и запись XML без схемы

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

Типовой цикл чтения выглядит так: открыть файл, в цикле вызывать Прочитать(), анализировать ТипУзла (начало элемента, текст, конец элемента) и локальное имя узла. Атрибуты читаются через ЗначениеАтрибута() или ПолучитьАтрибут() в момент, когда текущий узел — начало элемента.

Чтение = Новый ЧтениеXML;
Чтение.ОткрытьФайл("C:\обмен\catalog.xml");
Пока Чтение.Прочитать() Цикл
    Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента
        И Чтение.ЛокальноеИмя = "Товар" Тогда
        Ид = Чтение.ПолучитьАтрибут("Ид");
        // обработка товара
    КонецЕсли;
КонецЦикла;
Чтение.Закрыть();

При записи соблюдайте парность: каждому ЗаписатьНачалоЭлемента() должен соответствовать ЗаписатьКонецЭлемента(). Пропущенный закрывающий тег делает весь файл невалидным, причём ошибка проявится только на стороне приёмника. После записи вызывайте Закрыть() — иначе буфер может не сброситься в файл.

1. 1
   Определите структуру: какие объекты выгружаете, какие поля обязательны, какие типы данных у каждого поля
2. 2
   Решите, нужна ли схема: для регулярного обмена создайте XDTO-пакет, для разовой задачи достаточно ЗаписьXML
3. 3
   Сформируйте файл: запишите корневой элемент с пространством имён, затем объекты с атрибутами-идентификаторами
4. 4
   Проверьте файл валидатором или повторным чтением в тестовой базе
5. 5
   Передайте файл приёмнику и зафиксируйте результат загрузки в журнале обмена

Как проверить XML-файл перед загрузкой или отправкой

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

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

Отдельно проверяйте специальные символы в текстовых значениях. Символы &, <, > и кавычки обязаны быть экранированы. Если выгрузка формируется конкатенацией строк (что само по себе плохая практика), неэкранированный амперсанд в наименовании товара сломает весь файл.

Типичные ошибки при работе с XML в 1С

Большинство проблем с XML-обменом сводится к нескольким повторяющимся сценариям. Их знание позволяет диагностировать сбой за минуты, а не за часы.

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

Когда XML не подходит: альтернативы и ограничения

XML остаётся стандартом для обменов, регламентированных форматами, но в произвольных интеграциях у него есть альтернативы. JSON компактнее и быстрее разбирается, поэтому веб-сервисы и HTTP-API чаще работают именно с ним — платформа 1С поддерживает ЧтениеJSON/ЗаписьJSON аналогично XML.

Для обмена между двумя базами 1С без промежуточных файлов эффективнее сериализация через СериализаторXDTO в хранилище значения или прямые COM/HTTP-вызовы. А для больших табличных данных (прайсы, остатки) плоский CSV иногда практичнее: его проще формировать и проверять глазами, хотя он не передаёт иерархию и типы.

Главное ограничение XML — объём и скорость. Файл на несколько гигабайт нереально ни сформировать, ни загрузить за разумное время; такие задачи решаются порционной выгрузкой (пакетами по N объектов) или прямым подключением к базе-источнику.

Частые вопросы