Администрирование · 11 мин
Как выгрузить формат обмена из 1С
Разбираем, как выгрузить формат обмена из 1С: правила конвертации, файлы XDTO и EnterpriseData, выгрузка через планы обмена и типовые ошибки при обмене данными.
Формат обмена в 1С — это техническое описание того, в каком виде данные передаются между конфигурациями: какие объекты участвуют в обмене, как их реквизиты соотносятся между собой и в какой структуре файла это упаковывается. Выгрузить формат обмена требуется при настройке синхронизации между базами (например, «Управление торговлей» и «Бухгалтерия»), при разработке собственных правил обмена, при интеграции со сторонними системами и при разборе ошибок, когда данные «не доезжают» из одной базы в другую.
Под «выгрузкой формата обмена» на практике понимают несколько разных операций: выгрузку правил конвертации в файл XML, получение описания формата EnterpriseData (XDTO-пакеты), экспорт структуры плана обмена и выгрузку самих данных в формате обмена для тестирования. Все эти задачи решаются штатными средствами платформы и типовых конфигураций, без сторонних программ.
Ниже разобраны основные сценарии: где искать нужные механизмы в типовых решениях, как выгрузить правила обмена в файл, как получить описание формата EnterpriseData, как проверить результат и какие ошибки встречаются чаще всего.
Что именно нужно выгрузить: определяем задачу
Прежде чем открывать обработки, важно понять, какой именно артефакт обмена вам нужен. От этого зависит инструмент и порядок действий. Путаница на этом этапе — самая частая причина того, что «выгрузил, а не то».
| Что нужно получить | Где выгружается | Результат |
|---|---|---|
| Правила конвертации данных | Обработка «Универсальный обмен данными XML», настройки синхронизации | XML-файл правил |
| Описание формата EnterpriseData | План обмена, механизм XDTO, конфигуратор | Схема формата (XDTO-пакеты) |
| Данные в формате обмена | Универсальная обработка обмена, узел плана обмена | XML-файл с данными |
| Правила регистрации объектов | Настройка синхронизации данных | XML-файл правил регистрации |
Если задача — передать данные между типовыми конфигурациями, обычно достаточно настроить синхронизацию и при необходимости выгрузить правила из её настроек. Если вы разрабатываете собственный обмен или дорабатываете типовой — потребуется конфигурация «Конвертация данных» и работа с правилами напрямую.
Выгрузка правил обмена из настроек синхронизации
В типовых конфигурациях на платформе 8.3 с подсистемой «Синхронизация данных» правила обмена хранятся внутри информационной базы и выгружаются из настройки синхронизации. Это самый частый сценарий: правила нужны, чтобы посмотреть логику сопоставления объектов или загрузить их в другую базу.
- 1Откройте раздел «Администрирование» → «Синхронизация данных»
- 2Откройте нужную настройку синхронизации (узел обмена)
- 3Найдите команду загрузки/выгрузки правил — обычно «Ещё» → «Загрузить правила» или пункт про правила конвертации
- 4Выберите вариант «Сохранить правила в файл» и укажите каталог
- 5Проверьте, что файл создан и открывается как XML
В некоторых конфигурациях правила расположены в макете плана обмена. Тогда их можно получить через конфигуратор: откройте дерево конфигурации, найдите нужный план обмена, перейдите к макетам и сохраните макет с правилами на диск. Название макета обычно содержит слова «ПравилаКонвертации» или «ПравилаРегистрации».
Обратите внимание: правила конвертации и правила регистрации — разные файлы. Первые описывают, как объекты преобразуются при выгрузке и загрузке, вторые — какие изменения вообще регистрируются к отправке. Для полноценного переноса настройки обмена в другую базу нужны оба.
Выгрузка данных через универсальную обработку обмена XML
Обработка «Универсальный обмен данными в формате XML» (входит в поставку «Конвертации данных» и доступна на диске ИТС) — основной инструмент ручной выгрузки данных по правилам. Она работает в любой конфигурации на обычных формах, а версия для управляемых форм подходит для большинства современных решений.
Порядок выгрузки
Откройте обработку через «Файл → Открыть». На вкладке «Выгружаемые данные» укажите файл правил обмена — обработка прочитает его и покажет список доступных правил выгрузки данных. Отметьте нужные объекты, задайте отборы при необходимости (по периоду, организации, конкретным элементам), укажите имя файла выгрузки и нажмите «Выгрузить данные».
Результат — XML-файл, в котором данные структурированы согласно правилам. Его можно загрузить в базу-приёмник той же обработкой на вкладке «Загрузка данных» или использовать для анализа: файл открывается любым текстовым редактором или браузером.
Отладочный режим
Если обмен отрабатывает с ошибками, включите в обработке режим отладки: выгрузку можно выполнить с протоколом, где видно, какие объекты обработаны, а на каких возникли исключения. Протокол сохраняется в файл и является первым источником информации при разборе проблем.
Выгрузка описания формата EnterpriseData
EnterpriseData — универсальный формат обмена данными между приложениями на платформе 1С и сторонними системами. Его описание хранится в конфигурации как XDTO-пакеты, и его можно выгрузить для изучения или передачи разработчикам внешней системы.
В конфигураторе откройте ветку «Общие → XDTO-пакеты» и найдите пакеты с пространством имён вида «http://v8.1c.ru/edi/edi_stnd/EnterpriseData/…». Через контекстное меню пакета доступна выгрузка схемы. Также схемы формата публикуются в документации и поставках конфигураций, поддерживающих обмен.
Для интеграции со сторонней системой удобнее выгрузить не абстрактную схему, а реальный файл обмена: выполните синхронизацию через файл (в настройках обмена выберите вариант «через каталог») и возьмите сформированный XML. По нему разработчики внешней системы увидят фактическую структуру данных с заполненными значениями.
При обмене через каталог или веб-сервис файл сообщения формируется автоматически при выполнении синхронизации. Найдите его в указанном каталоге обмена — это и есть данные в формате EnterpriseData, готовые для анализа или ручной передачи.
Выгрузка через конфигуратор и планы обмена
План обмена — объект конфигурации, который определяет состав данных, участвующих в обмене, и узлы, между которыми идёт синхронизация. Через конфигуратор можно получить структуру плана обмена и связанные с ним макеты правил.
Откройте конфигуратор, найдите в дереве объектов ветку «Планы обмена» и выберите нужный. На закладке «Основные» и в составе плана видно, какие объекты метаданных включены в обмен. Макеты плана обмена (правила, схемы) сохраняются на диск через команду «Сохранить как» при открытом макете.
Для выгрузки самой конфигурации с описаниями форматов используется команда «Конфигурация → Выгрузить конфигурацию в файлы» — она выгружает все объекты, включая XDTO-пакеты и макеты, в виде XML-файлов в указанный каталог. Это удобно для версионирования и поиска по тексту.
Проверка результата выгрузки
После выгрузки убедитесь, что файл корректен и содержит ожидаемое. Минимальная проверка занимает пару минут и избавляет от передачи в приёмник заведомо битого файла.
Как проверить результат
Размер соответствует объёму выгружаемых данных
Файл пустой или подозрительно мал
Файл открывается в браузере без ошибок парсинга, видны корневые элементы формата
Браузер сообщает об ошибке синтаксиса XML
В файле присутствуют выгружаемые объекты (документы, справочники) с заполненными реквизитами
Объектов нет или они без данных
Файл загружается в копию базы-приёмника без критических ошибок протокола
Загрузка прерывается ошибками или объекты не создаются
Ключевой критерий успеха — успешная загрузка в тестовую копию приёмника. Только она показывает, что правила применимы к реальным данным, а не просто синтаксически верны.
Типичные ошибки и ограничения
Отдельное ограничение касается прав: для выгрузки правил и настройки синхронизации нужны права администратора обмена данными, для работы в конфигураторе — права на просмотр и изменение конфигурации. В файловом варианте базы при выгрузке больших объёмов убедитесь, что на диске достаточно места.
Как выбрать способ выгрузки
Что важно запомнить
Сначала определите, что выгружать: правила конвертации, схему формата или сами данные. Правила берутся из настроек синхронизации или макетов плана обмена, данные — через универсальную обработку обмена XML, схема EnterpriseData — из XDTO-пакетов конфигуратора. Результат всегда проверяйте пробной загрузкой в копию базы, а доработку правил ведите только во внешних файлах.
Частые вопросы
Чем отличается выгрузка формата обмена от выгрузки данных?
Формат обмена — это описание структуры (правила, схемы XDTO), а выгрузка данных — сами записи, упакованные по этому формату. Формат нужен разработчикам и для настройки обмена, данные — для фактического переноса информации между базами.
Можно ли выгрузить правила обмена без конфигуратора?
Да. В типовых конфигурациях правила выгружаются из настройки синхронизации данных в режиме «Предприятие» — через команду работы с правилами в карточке настройки. Конфигуратор нужен только для доступа к макетам и XDTO-пакетам напрямую.
Где взять обработку «Универсальный обмен данными в формате XML»?
Она входит в поставку конфигурации «Конвертация данных» и доступна подписчикам на портале 1С. Также аналогичные обработки встроены в некоторые типовые решения — поищите «Универсальный обмен данными» через поиск в разделе «Все функции».
Почему файл выгрузки не открывается в браузере?
Наиболее вероятные причины: файл обрезался при выгрузке (не хватило места или прервалось соединение), либо он сохранён в кодировке, которую программа-просмотрщик определила неверно. Откройте файл в текстовом редакторе с поддержкой UTF-8 и проверьте наличие закрывающих тегов в конце.
Как выгрузить данные в формате CommerceML для обмена с сайтом?
Используйте штатный узел обмена с сайтом (в конфигурациях с подсистемой обмена) или обработку обмена с сайтом: при выполнении обмена файлы CommerceML формируются автоматически в указанном каталоге. Их можно сохранить и передать разработчикам сайта как образец.
Что делать, если типовые правила не подходят?
Выгрузите правила в файл, доработайте их в конфигурации «Конвертация данных» (версии 2 для классических правил или 3 для EnterpriseData) и подключите в настройке синхронизации как внешние правила. Типовые правила внутри конфигурации при этом не изменяйте — они перезапишутся при обновлении.