К статье
Практический материал

Администрирование · 11 мин

Как выгрузить формат обмена из 1С

Разбираем, как выгрузить формат обмена из 1С: правила конвертации, файлы XDTO и EnterpriseData, выгрузка через планы обмена и типовые ошибки при обмене данными.

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

Под «выгрузкой формата обмена» на практике понимают несколько разных операций: выгрузку правил конвертации в файл XML, получение описания формата EnterpriseData (XDTO-пакеты), экспорт структуры плана обмена и выгрузку самих данных в формате обмена для тестирования. Все эти задачи решаются штатными средствами платформы и типовых конфигураций, без сторонних программ.

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

Что именно нужно выгрузить: определяем задачу

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

Что нужно получитьГде выгружаетсяРезультат
Правила конвертации данныхОбработка «Универсальный обмен данными XML», настройки синхронизацииXML-файл правил
Описание формата EnterpriseDataПлан обмена, механизм XDTO, конфигураторСхема формата (XDTO-пакеты)
Данные в формате обменаУниверсальная обработка обмена, узел плана обменаXML-файл с данными
Правила регистрации объектовНастройка синхронизации данныхXML-файл правил регистрации

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

Выгрузка правил обмена из настроек синхронизации

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

Как выгрузить правила из синхронизации
  1. 1
    Откройте раздел «Администрирование» → «Синхронизация данных»
  2. 2
    Откройте нужную настройку синхронизации (узел обмена)
  3. 3
    Найдите команду загрузки/выгрузки правил — обычно «Ещё» → «Загрузить правила» или пункт про правила конвертации
  4. 4
    Выберите вариант «Сохранить правила в файл» и укажите каталог
  5. 5
    Проверьте, что файл создан и открывается как XML

В некоторых конфигурациях правила расположены в макете плана обмена. Тогда их можно получить через конфигуратор: откройте дерево конфигурации, найдите нужный план обмена, перейдите к макетам и сохраните макет с правилами на диск. Название макета обычно содержит слова «ПравилаКонвертации» или «ПравилаРегистрации».

Обратите внимание: правила конвертации и правила регистрации — разные файлы. Первые описывают, как объекты преобразуются при выгрузке и загрузке, вторые — какие изменения вообще регистрируются к отправке. Для полноценного переноса настройки обмена в другую базу нужны оба.

Выгрузка данных через универсальную обработку обмена XML

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

Порядок выгрузки

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

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

Отладочный режим

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

Выгрузка описания формата EnterpriseData

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

В конфигураторе откройте ветку «Общие → XDTO-пакеты» и найдите пакеты с пространством имён вида «http://v8.1c.ru/edi/edi_stnd/EnterpriseData/…». Через контекстное меню пакета доступна выгрузка схемы. Также схемы формата публикуются в документации и поставках конфигураций, поддерживающих обмен.

Для интеграции со сторонней системой удобнее выгрузить не абстрактную схему, а реальный файл обмена: выполните синхронизацию через файл (в настройках обмена выберите вариант «через каталог») и возьмите сформированный XML. По нему разработчики внешней системы увидят фактическую структуру данных с заполненными значениями.
ПЗ
Практическое замечание

При обмене через каталог или веб-сервис файл сообщения формируется автоматически при выполнении синхронизации. Найдите его в указанном каталоге обмена — это и есть данные в формате EnterpriseData, готовые для анализа или ручной передачи.

Выгрузка через конфигуратор и планы обмена

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

Откройте конфигуратор, найдите в дереве объектов ветку «Планы обмена» и выберите нужный. На закладке «Основные» и в составе плана видно, какие объекты метаданных включены в обмен. Макеты плана обмена (правила, схемы) сохраняются на диск через команду «Сохранить как» при открытом макете.

Для выгрузки самой конфигурации с описаниями форматов используется команда «Конфигурация → Выгрузить конфигурацию в файлы» — она выгружает все объекты, включая XDTO-пакеты и макеты, в виде XML-файлов в указанный каталог. Это удобно для версионирования и поиска по тексту.

Проверка результата выгрузки

После выгрузки убедитесь, что файл корректен и содержит ожидаемое. Минимальная проверка занимает пару минут и избавляет от передачи в приёмник заведомо битого файла.

Контрольные точки

Как проверить результат

Файл создан и имеет ненулевой размер
Норма

Размер соответствует объёму выгружаемых данных

Тревожный признак

Файл пустой или подозрительно мал

Структура XML
Норма

Файл открывается в браузере без ошибок парсинга, видны корневые элементы формата

Тревожный признак

Браузер сообщает об ошибке синтаксиса XML

Содержимое
Норма

В файле присутствуют выгружаемые объекты (документы, справочники) с заполненными реквизитами

Тревожный признак

Объектов нет или они без данных

Пробная загрузка
Норма

Файл загружается в копию базы-приёмника без критических ошибок протокола

Тревожный признак

Загрузка прерывается ошибками или объекты не создаются

Ключевой критерий успеха — успешная загрузка в тестовую копию приёмника. Только она показывает, что правила применимы к реальным данным, а не просто синтаксически верны.

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

Типичные ошибки
01
Путать правила конвертации и правила регистрации — загрузка не того файла в настройку синхронизации ломает обмен
02
Использовать правила от другой версии конфигурации — структура объектов изменилась, реквизиты не сопоставляются
03
Выгружать без отборов весь справочник за все время — файл получается огромным, загрузка длится часами
04
Редактировать типовые правила прямо в базе — при обновлении конфигурации изменения затрутся; правильно выгрузить правила в файл, доработать и подключить как внешние
05
Игнорировать протокол обмена — без него невозможно понять, на каком объекте произошла ошибка

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

Маршрут решения

Как выбрать способ выгрузки

Нужно посмотреть или перенести правила типовой синхронизацииВыгрузите правила из настройки синхронизации в разделе «Администрирование»
Нужно разово перенести данные между разными конфигурациямиИспользуйте «Универсальный обмен данными XML» с файлом правил
Нужна схема формата для сторонних разработчиковВыгрузите XDTO-пакеты EnterpriseData из конфигуратора или возьмите реальный файл обмена через каталог
Нужно доработать логику обменаВыгрузите правила в файл, доработайте в «Конвертации данных» и подключите как внешние
Итог

Что важно запомнить

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

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

Чем отличается выгрузка формата обмена от выгрузки данных?

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

Можно ли выгрузить правила обмена без конфигуратора?

Да. В типовых конфигурациях правила выгружаются из настройки синхронизации данных в режиме «Предприятие» — через команду работы с правилами в карточке настройки. Конфигуратор нужен только для доступа к макетам и XDTO-пакетам напрямую.

Где взять обработку «Универсальный обмен данными в формате XML»?

Она входит в поставку конфигурации «Конвертация данных» и доступна подписчикам на портале 1С. Также аналогичные обработки встроены в некоторые типовые решения — поищите «Универсальный обмен данными» через поиск в разделе «Все функции».

Почему файл выгрузки не открывается в браузере?

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

Как выгрузить данные в формате CommerceML для обмена с сайтом?

Используйте штатный узел обмена с сайтом (в конфигурациях с подсистемой обмена) или обработку обмена с сайтом: при выполнении обмена файлы CommerceML формируются автоматически в указанном каталоге. Их можно сохранить и передать разработчикам сайта как образец.

Что делать, если типовые правила не подходят?

Выгрузите правила в файл, доработайте их в конфигурации «Конвертация данных» (версии 2 для классических правил или 3 для EnterpriseData) и подключите в настройке синхронизации как внешние правила. Типовые правила внутри конфигурации при этом не изменяйте — они перезапишутся при обновлении.