Как создать XML-файл в 1С: способы и примеры кода

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

Выбор способа зависит от задачи. Для простого файла с произвольной структурой достаточно объекта ЗаписьXML — он пишет теги напрямую. Если файл должен соответствовать строгой схеме (например, требованиям ФНС или формату контрагента), надежнее использовать XDTO: платформа сама проверит обязательные поля и типы данных. Для обмена между базами 1С удобнее встроенные планы обмена и универсальный формат EnterpriseData.

Ниже разобраны все три подхода с примерами кода, способами проверки результата и разбором ошибок, которые чаще всего ломают выгрузку.

Какой способ создания XML выбрать под задачу

Прежде чем писать код, определите, кто будет читать файл. Если это ваша же обработка или простая интеграция, подойдет прямая запись через ЗаписьXML — быстро и без лишних объектов. Если файл уходит во внешнюю систему с формализованным форматом (банк, ФНС, маркетплейс), ошибка в одном теге приведет к отказу приема, поэтому нужна валидация через XDTO.

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

Создание XML через объект ЗаписьXML

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

Минимальный пример кода

Запись = Новый ЗаписьXML;
Запись.ОткрытьФайл("C:\Обмен\Товары.xml", "UTF-8");

Запись.ЗаписатьОбъявлениеXML();
Запись.ЗаписатьНачалоЭлемента("Каталог");

Запись.ЗаписатьНачалоЭлемента("Товар");
Запись.ЗаписатьАтрибут("Код", "000001");
Запись.ЗаписатьНачалоЭлемента("Наименование");
Запись.ЗаписатьТекст("Номенклатура из 1С");
Запись.ЗаписатьКонецЭлемента(); // Наименование
Запись.ЗаписатьКонецЭлемента(); // Товар

Запись.ЗаписатьКонецЭлемента(); // Каталог
Запись.Закрыть();

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

Запись = Новый ЗаписьXML;
Запись.ОткрытьФайл(ИмяФайла, "UTF-8");
Запись.ЗаписатьОбъявлениеXML();
Запись.ЗаписатьНачалоЭлемента("Данные");
Запись.ЗаписатьТекст("Содержимое");
Запись.ЗаписатьКонецЭлемента();
Запись.Закрыть();

Запись данных из запроса

На практике XML чаще всего строится по данным базы. Типовой прием: выполнить запрос, обойти выборку и записать каждый элемент в цикле. Даты сериализуйте функцией XMLСтрока(), чтобы получить формат ISO 8601, а ссылки на справочники при необходимости преобразуйте в GUID через XMLСтрока(Ссылка).

Пока Выборка.Следующий() Цикл
Запись.ЗаписатьНачалоЭлемента("Документ");
Запись.ЗаписатьАтрибут("Номер", Выборка.Номер);
Запись.ЗаписатьАтрибут("Дата", XMLСтрока(Выборка.Дата));
Запись.ЗаписатьАтрибут("Сумма", XMLСтрока(Выборка.Сумма));
Запись.ЗаписатьКонецЭлемента();
КонецЦикла;

Создание XML через XDTO по схеме

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

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

// Пример обобщенный: имена типов зависят от вашей схемы
Пакет = ФабрикаXDTO.Пакеты.Получить("http://example.org/schema");
ТипЗаказ = Пакет.Получить("Заказ");
Заказ = ФабрикаXDTO.Создать(ТипЗаказ);
Заказ.Номер = "А-101";
Заказ.Дата = ТекущаяДатаСеанса();

Запись = Новый ЗаписьXML;
Запись.ОткрытьФайл(ИмяФайла, "UTF-8");
Запись.ЗаписатьОбъявлениеXML();
ФабрикаXDTO.ЗаписатьXML(Запись, Заказ);
Запись.Закрыть();

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

Создание XML без программирования

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

1. 1
   Откройте раздел с нужной функцией: например, «Администрирование → Синхронизация данных» или «Обмен электронными документами».
2. 2
   Настройте узел обмена: укажите каталог или способ передачи и состав выгружаемых данных.
3. 3
   Выполните выгрузку штатной командой — конфигурация сама сформирует XML-файл.
4. 4
   Откройте созданный файл в текстовом редакторе и убедитесь, что структура и данные соответствуют ожиданиям.

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

Как проверить созданный файл

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

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

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

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

Отдельно учитывайте ограничение на размер: при выгрузке сотен тысяч элементов держать весь XML в памяти (например, через ЗаписьXML.УстановитьСтроку()) рискованно — пишите сразу в файл потоково. Для обмена большими массивами данных между базами надежнее разбивать выгрузку на порции или использовать планы обмена.

FAQ