1С:Конвертация данных 2 и 3: правила обмена и универсальный обмен XML

Интеграция и веб-сервисыОпубликовано

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

Что такое конвертация данных и когда она нужна

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

Сейчас в ходу два подхода, и путать их не стоит:

Конвертация данных 2 (КД 2)Конвертация данных 3 (КД 3)
Что получается на выходеXML-файл правил обменаКод модуля менеджера обмена на встроенном языке
Посредник между базамиНет: правила описывают прямое сопоставление «источник → приёмник»Универсальный формат EnterpriseData
Что знает каждая сторонаПравила содержат структуру обеих конфигурацийКаждая конфигурация знает только себя и формат
Чем выполняется обменОбработка «Универсальный обмен данными в формате XML» или механизмы обмена типовой конфигурацииПодсистема «Обмен данными» БСП, «Синхронизация данных» в типовых
Где применяетсяПереносы со старых и нетиповых конфигураций, разовые миграции, обмены с самописными базамиСинхронизация между современными типовыми решениями (УТ, КА, ERP, Бухгалтерия, Розница)

КД 3 не является новой версией КД 2 в смысле «замены»: это другой инструмент для другой схемы обмена. Обе конфигурации поставляются фирмой 1С и устанавливаются как отдельные информационные базы разработчика. Общая теория обменов, регистрация изменений и план обмена разобраны в статье про обмены в 1С.

Конвертация данных 2: правила обмена в XML

Состав поставки

Вместе с конфигурацией «Конвертация данных» редакции 2.1 устанавливаются внешние обработки, которые понадобятся в работе. Они лежат в подкаталоге tmplts\1c\Conversion\<версия>\ каталога шаблонов 1С:Предприятия:

ФайлНазначение
MD83Exp.epfВыгрузка описания структуры метаданных конфигурации на платформе 8.3
V8Exchan83.epf«Универсальный обмен данными в формате XML» — выполняет выгрузку и загрузку по правилам
ВыгрузкаЗагрузкаДанныхXML83.epfПеренос между базами с одинаковой структурой метаданных, правила не нужны
V77Exp.ert, MD77.ertВыгрузка данных и структуры из баз 1С:Предприятия 7.7

Порядок разработки правил

  1. В базе-источнике и базе-приёмнике откройте MD83Exp.epf («Файл → Открыть») и выгрузите структуру метаданных в XML-файлы.
  2. В конфигурации «Конвертация данных» создайте конвертацию и загрузите обе структуры: источника и приёмника.
  3. Создайте правила конвертации объектов (ПКО). Для объектов с совпадающими именами помощник может построить их автоматически; остальные сопоставьте вручную.
  4. Внутри каждого ПКО настройте правила конвертации свойств (ПКС) — какой реквизит в какой переходит — и поиск объекта в приёмнике: по уникальному идентификатору, коду, наименованию или ИНН.
  5. Создайте правила выгрузки данных (ПВД): что именно выгружать, с какими отборами и по какому ПКО. При необходимости — правила очистки данных (ПОД).
  6. Сохраните правила в XML-файл. Этот файл и есть «правила обмена 1С», которые потом загружаются в базу-источник.

Обработчики событий

Где сопоставления «поле в поле» не хватает, пишется код. Обработчики есть у конвертации в целом, у ПКО, ПКС и ПВД: «Перед выгрузкой», «При выгрузке», «После выгрузки», «Перед загрузкой», «При загрузке», «После загрузки». Код хранится в правилах и выполняется обработкой обмена. Пример — не выгружать помеченные на удаление элементы и заполнять комментарий при загрузке документа:

Пример кода
// ПКО "Номенклатура", обработчик "Перед выгрузкой"
Если Источник.ПометкаУдаления Тогда
	Отказ = Истина;
КонецЕсли;

// ПКО "РеализацияТоваровУслуг", обработчик "После загрузки"
Если Не ЗначениеЗаполнено(Объект.Комментарий) Тогда
	Объект.Комментарий = "Загружено из торговой базы";
КонецЕсли;

Список доступных в обработчике переменных (Источник, Объект, Отказ, входящие и исходящие данные и т.д.) показывается в окне редактирования обработчика в КД — сверяйтесь с ним, состав зависит от вида события. Повторяющиеся куски выносите в «Алгоритмы» конвертации, а запросы — в раздел «Запросы».

Универсальный обмен данными в формате XML

Обработка «Универсальный обмен данными в формате XML» исполняет правила КД 2. Внешняя версия берётся из поставки КД (V8Exchan83.epf), а в конфигурациях на БСП аналогичная обработка часто уже встроена — найдите её через «Все функции → Обработки». Порядок работы:

  1. В базе-источнике откройте обработку, вкладка «Выгрузка». Укажите файл правил обмена и загрузите их.
  2. Задайте период и отборы, отметьте нужные правила выгрузки. Укажите имя файла данных.
  3. Нажмите «Выгрузить данные». Получится XML-файл с данными, к которому приложены сами правила.
  4. В базе-приёмнике откройте ту же обработку на вкладке «Загрузка», выберите файл данных и загрузите его. Правила отдельно указывать не нужно — они уже внутри файла.

Если обе базы на 8.3 и доступны одной машине, обработка умеет загружать данные в приёмник сразу через COM-соединение, без промежуточного файла. Это удобно при миграциях, но требует зарегистрированной компоненты comcntr.dll.

Полезные настройки

  • Режим отладки — позволяет выполнять обработчики через внешнюю обработку и ставить в них точки останова. Без этого ошибки в коде правил ищутся долго.
  • Загрузка в режиме обмена данными — объекты записываются с ОбменДанными.Загрузка = Истина: без лишних проверок и без регистрации изменений обратно. Документы при этом можно не проводить, а провести позже пакетно.
  • Протокол обмена — включите вывод в файл, чтобы видеть, на каком объекте прервалась загрузка.

Конвертация данных 3 и формат EnterpriseData

В КД 3 логика другая. Есть универсальный формат EnterpriseData (часто пишут раздельно — Enterprise Data) — набор XDTO-пакетов с описанием объектов «Справочник.Номенклатура», «Документ.РеализацияТоваровУслуг» и т.д. Каждая конфигурация умеет переводить свои данные в этот формат и обратно. Правила для одной конфигурации ничего не знают о структуре корреспондента: если торговая база и бухгалтерия обе понимают EnterpriseData, они могут обмениваться, хотя устроены по-разному.

Формат поставляется в составе Библиотеки стандартных подсистем, в подсистеме «Обмен данными». У него есть версии (например, 1.10, 1.11 и более новые); по политике фирмы 1С актуальная версия гарантированно поддерживается ещё год после выхода следующей. Обе стороны обмена должны поддерживать общую версию — иначе синхронизация не настроится.

Из чего состоят правила КД 3

  • ПОД — правила обработки данных. Определяют, какие объекты отправлять и какие получать, и позволяют отбирать или подменять данные.
  • ПКО — правила конвертации объектов с вложенными ПКС. Описывают перевод объекта конфигурации в объект формата и обратно.
  • ПКПД — правила конвертации предопределённых данных: перечислений и предопределённых элементов.
  • Алгоритмы — общие процедуры, вызываемые из обработчиков.

Результат разработки — текст модуля менеджера обмена, который вставляется в общий модуль конфигурации (в типовых — модуль с именем вида МенеджерОбменаЧерезУниверсальныйФормат). Каждый обработчик превращается в процедуру с префиксом правила, например ПКО_<ИмяПравила>_ПриОтправкеДанных или ПКО_<ИмяПравила>_ПередЗаписьюПолученныхДанных.

Пример обработчика отправки — передать в формат значение, которое не заполняется автоматически:

Пример кода
Процедура ПКО_Справочник_Номенклатура_ПриОтправкеДанных(ДанныеИБ, ДанныеXDTO,
		КомпонентыОбмена, СтекВыгрузки)

	Если ЗначениеЗаполнено(ДанныеИБ.Артикул) Тогда
		ДанныеXDTO.Вставить("Артикул", СокрЛП(ДанныеИБ.Артикул));
	КонецЕсли;

КонецПроцедуры

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

Как дорабатывать типовую синхронизацию

Править модуль менеджера обмена прямо в типовой конфигурации неудобно — изменения теряются при обновлении. Практичнее перехватывать нужные процедуры в расширении конфигурации аннотациями &После или &Вместо, а разработку новых правил вести в КД 3, загружая в неё структуру своей конфигурации и формата. Сама синхронизация в типовых настраивается в разделе «Администрирование → Синхронизация данных».

Типичные ошибки при конвертации данных

ПроблемаПричина и решение
Дубли справочников в приёмникеПоиск только по уникальному идентификатору, а в приёмнике объекты созданы вручную. Добавьте в ПКО поиск по коду, ИНН или наименованию как второй вариант
«Битые» ссылки (<Объект не найден>)Объект выгружен ссылкой без полной конвертации. Включите выгрузку ссылочных объектов или отдельное ПВД для справочника
Правила перестали работать после обновленияИзменились метаданные. Выгрузите новую структуру MD83Exp.epf, загрузите в КД и исправьте ПКО, помеченные как несоответствующие
Синхронизация не настраивается между типовымиНет общей версии EnterpriseData: обновите конфигурацию, которая отстаёт
Документы загрузились непроведённымиПри загрузке в режиме обмена проведение отключено. Проведите их пакетно после загрузки
Ошибка в обработчике без понятного текстаВключите режим отладки в обработке обмена и протокол в файл

Что выбрать

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

Актуальность для новых версий

Актуальны редакции «Конвертации данных» 2.1 и 3.x; КД 3.1 позволяет не только использовать, но и расширять и создавать версии формата EnterpriseData. Формат поставляется в составе БСП и регулярно получает новые версии, а старые выводятся из поддержки по графику, опубликованному на its.1c.ru. Состав внешних обработок КД 2 указан для поставки редакции 2.1; при установке другой версии проверьте файл ReadMe в каталоге шаблонов.

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

Чем Конвертация данных 2 отличается от Конвертации данных 3?

КД 2 создаёт XML-файл правил с прямым сопоставлением объектов двух конфигураций, его выполняет универсальная обработка обмена. КД 3 генерирует код модуля менеджера обмена, а базы обмениваются через промежуточный формат EnterpriseData, не зная структуры друг друга.

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

Она входит в поставку конфигурации «Конвертация данных» 2.1 (файл V8Exchan83.epf для платформы 8.3) и устанавливается в каталог шаблонов. В конфигурациях на БСП похожая обработка часто есть в составе и открывается через «Все функции».

Что такое EnterpriseData?

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

Как не создать дубли при загрузке по правилам?

Настройте в ПКО несколько вариантов поиска: сначала по уникальному идентификатору, затем по коду, ИНН или наименованию. Перед большой загрузкой проверьте результат на копии базы.

Нужно ли переделывать правила после обновления конфигурации?

Если изменились метаданные объектов из правил — да. Выгрузите новую структуру обработкой MD83Exp.epf, загрузите её в конвертацию, исправьте отмеченные правила и сохраните файл заново.

Интеграция и веб-сервисы

Как выгрузить УПД в XML из 1С: Бухгалтерия 3.0 и УТ 11

Пошаговая выгрузка УПД в XML по формату ФНС 5.03 из 1С:Бухгалтерии 3.0 и УТ 11 без подключённого ЭДО, что делать с ZIP-архивом, какие реквизиты проверить и как выгрузить документ в XML программно.

Интеграция и веб-сервисы

API 1С: интеграция через HTTP-сервисы, OData и веб-сервисы

Какие API есть у 1С:Предприятия 8.3 и как подключиться к базе: HTTP-сервисы с обработчиками GET и POST, стандартный интерфейс OData, веб-сервисы SOAP, публикация и аутентификация.

Интеграция и веб-сервисы

Веб-сервер 1С: публикация базы на Apache и IIS через Конфигуратор и webinst

Как подготовить Apache или IIS для 1С, опубликовать базу из Конфигуратора или утилитой webinst, настроить default.vrd, права и HTTPS и исправить типичные ошибки публикации.

Интеграция и веб-сервисы

Обмены в 1С: план обмена, регистрация и выгрузка изменений

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