Каталог решений - Что такое конвертация данных 1С (статья написана исключительно для новичков)

Когда требуется из одной системы выгружать данные в другую систему, то как правило настраивается план обмена, который автоматически (по расписанию) выгружает/загружает данные по неким правилам. Эти самые правила обмена удобно написать в конфигурации 1С "Конвертация данных" 2.1 (КД 2.1).

Обменивающиеся системы могут быть совершенно разными или идентичными, ограничений нет. 

Другим применением КД 2.1 может быть написание правил для "ручной" выгрузки/загрузки данных с помощью обработки "Универсальный обмен данными XML", которая есть в любой типовой конфигурации. (Если в вашей системе вы не находите эту обработку, скачайте её и воспользуйтесь как внешней).

Если между системами настроен план обмена, то объект регистрируется к выгрузке, в случае его записи или проведении, и выполнении условий регистрации для данного объекта (ниже будет подробнее).

Эти условия регистрации для объекта могут быть прописаны в самой системе непосредственно в коде с помощью режима Конфигуратор, или в правилах обмена, в файле "RegistrationRules.xml" в типовых конфигурациях на УФ.

В качестве примера рассмотрим типовой обмен на управляемых формах (УФ) между ЗУП 3.1 и БУХ 3.0.

В ЗУП 3.1 в плане обмена "ОбменЗарплата3Бухгалтерия3" в реквизитах и табличных частях можно указать условия обмена, например, выгружаем только по определенным Организациям и не выгружаем персональные данные сотрудников. А в макетах плана обмена прописаны типовые правила (от разработчиков 1С), выделила для наглядности квадратом в Рис. 1.

Рис. 1

Пример формы плана обмена в режиме предприятия показан на Рис. 3.

Откройте Администрирование — Синхронизация данных Рис. 2:

Рис. 2

Учить настраивать обмен не буду, как это сделать легко найти в официальной документации.

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

 Рис. 3

Соответственно, если мы откроем обработку "Регистрация изменений для обмена" и выберем документ по другой организации, он не зарегистрируется для обмена и не выгрузится (на Рис.5 форма обработки).

Рис. 4

Рис. 5

Правила обмена могут быть типовыми (из конфигурации) или внешними (из файла на компьютере).

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

Для этого нажмите "Загрузить комплект правил":

Рис. 6

Правилами выгрузки является файл "ExchangeRules.xml", после его модификации, упаковываем три файла назад в архив и загружаем. Как загрузить "ExchangeRules.xml" в конвертацию данных показано на Рис. 19.

Рис. 7

Рис. 8

Так же изменять можно и правила регистрации "RegistrationRules.xml", например, если нужно выгрузить документ, не взирая на условие Плана обмена. Например, одно условие действует на 4 вида документов, но нам требуется всё же один документ выгрузить. Условие по этому документу можно просто закомментировать Рис. 8.

Рис. 8

В моём примере по документу "ВедомостьНаВыплатуЗарплатыПеречислением" игнорируется условие "НеВыгружатьПерсональныеДанныеФизическихЛиц". 

Открыть "RegistrationRules.xml" в конвертации данных не получится.

Файл "CorrespondentExchangeRules.xml" является правилами выгрузки базы корреспондента. То есть правила "CorrespondentExchangeRules.xml" и "ExchangeRules.xml" базы корреспондента (в моём примере это БУХ 3.0) должны совпадать.

Далее информация по самой конвертации данных.

Зарегистрированные объекты выгружаются по "Правилам выгрузки данных" (ПВД), стрелка 1 на Рис. 9.

Рис. 9

В ПВД можно указать дополнительные условия для выгрузки зарегистрированных объекта (ов), например, документов "НачислениеОценочныхОбязательствПоОтпускам" (как в Рис. 9).

Регистрировать для выгрузки все справочники, связанные с документом, и прописывать по ним ПВД не нужно. По ним сформируем ПКО при конвертации свойств (реквизитов объекта и реквизитов табличных частей объекта) (возможно станет яснее, посмотрев на Рис. 11).

Стандартная выборка (стрелка 2 Рис. 9) содержит в себе все реквизиты объекта, включая табличные части.

В ПВД указано Правило конвертации объекта (ПКО) (стрелка 3 Рис. 9), в данном примере ПКО называется "НачислениеОценочныхОбязательствПоОтпускам", все ПКО располагаются на первой закладке формы настроек правил обмена.

С левой стороны имеются обработчики: "Перед обработкой", "Перед выгрузкой", "После выгрузки", "После обработки" (стрелка 4 Рис. 9). В каждом из этих обработчиков при вызове "Информации по обработчикам" (стрелка 5 Рис. 9) можно получить сведения о выполняемых в нём действиях и возможных параметрах (в каждом обработчике список параметров немного различается).

Например, обработчик "Перед обработкой":

Рис. 11

В Информации по тексту ниже указан вот такой пример:

Если Объект.ЭтоГруппа() = 0 Тогда
 Отказ = 1;
КонецЕсли;

Можно написать своё условие: например, если реквизит "Флаг" установлен в Истину, тогда такой объект нужно выгрузить по другому ПКО:

Если Объект.Флаг Тогда
  ИмяПКО = "ИмяПравилаКонвертацииТакогоОбъекта";
КонецЕсли;

В случае, если при выгрузке вы пользуетесь произвольным алгоритмом, вам необходимо инициировать параметр ВыборкаДанных (стрелка 6 Рис. 10).

В рис. 11 указала связь всех правил. ПВД является ключевым триггером для выгрузки объекта по правилам конвертации, поэтому начинаем с него.

Рис. 11

ПКО

Теперь перейдем к ПКО "НачислениеОценочныхОбязательствПоОтпускам" (стрелка 7 Рис. 12), состоящему из правил конвертации свойств (ПКС):

Рис. 12

Ссылочные свойства выгружаются по указанным ПКО (стрелка 8 Рис. 12). То есть при выгрузке реквизитов "Организация" и "Ответственный" они будут выгружены согласно правилам ПКО с названиями "Организации" и "Пользователи".

В ПКО можно указать правила поиска объекта:

Рис. 13

Признак (Стрелка 10 Рис. 13) не задан, следовательно, в случае, если объект не найден, то он будет создан.

Дополнения:

Обратите внимание, на Рис. 11 я обозначила раздел "Важно" стрелкой 6, так вот стрелка 11 — это тот самый признак, который необходимо установить, если вы используете произвольный алгоритм для ПВД.

Не забывайте пользоваться информацией по обработчикам (стрелка 12).

Если вы решили выгружать все изменения справочников и документов, то обратите внимание в ПВД на закладку "Дополнительно", там задан "Порядок выполнения".

По ссылкам ниже вы можете почерпнуть дополнительную информацию:

//sale.itcity.ru/public/597573/

//sale.itcity.ru/public/413178/

Создание с нуля (кратко)

У нас есть конфигурация источник и конфигурация приемник (они могут быть идентичными).

В случае, если конфигурации различаются, в каждой из конфигураций нужно запустить обработку "MD82Exp.epf" или "MD83Exp.epf", в зависимости от версии платформы.

Рис.14

Как-то по особому называть файлик выгрузки не нужно. При загрузке система сама определит наименование конфигурации.

Далее выгруженную структуру (структуры) загружаем в конвертацию.

Рис. 15

Рис. 16

Далее выбираем на рабочем столе конвертации пиктограмму "Правила обмена данными", нажимаем "Добавить" и в открывшемся окне выбираем конфигурации.

Рис. 17

При появлении картинки ниже, жмите или "Закрыть" или "Создать новое правило обмена данными".

Рис. 18

Загрузка имеющихся правил (кратко)

В случае, если правила есть и их требуется исправить, загружаем правила в КД.

Рис. 19

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

Чтобы объекты добавить, вам нужно выгрузить структуру метаданных (описано в пункте "Создание с нуля" немного выше).

И далее загрузить эту структуру в имеющуюся конфигурацию.

Рис. 20