Сэкономить время и воспользоваться готовыми правилами для последних версий конфигураций можно здесь
Цель данной статьи - ответить на первые вопросы по КД3 и на простом примере показать как доработать типовые правила. Информация полезна начинающим и тем, кто уже приступил к освоению и появились новые вопросы.
Принятые сокращения в этой публикации
КД2
- конфигурация Конвертация данных, редакция 2.0.
КД3
- конфигурация Конвертация данных, редакция 3.0, конфигурация 3.0.5.3.
ED
- универсальный формат обмена EnterpriseData.
Ответы на вопросы после поверхностного знакомства с КД3. Если Вы знаете зачем нужна КД3 можно не читать этот абзац;)
Вопросы и ответы
- КД3 это новая версия КД2? Нет! Это другой инструмент, который решает аналогичные КД2 задачи. Каждому инструменту своё применение.
- КД3 лучше КД2? Их нельзя сравнивать, т.к. это разные инструменты и у каждого есть свои плюсы и минусы.
- Для изменения правил обмена КД3 нужно снимать конфигурацию с поддержки? Нет НЕ нужно снимать с поддержки! В типовых конфигурациях можно штатно подключить внешнюю обработку с правилами, а на конфигурациях поддерживающих платформу 8.3.10 и выше можно редактировать правила с помощью расширения.
- Нужно перенести данные из конфигураций собственного изготовления. Для целей изучения можно воспользоваться КД3? Если Вы задаёте этот вопрос, скорее всего нельзя. Для КД3 в составе конфигурации должна быть БСП 2.3 и выше с синхронизацией через универсальный формат. КД2 вам подойдёт 100%, КД3 под вопросом.
- Можно ли использовать КД3 для типовых доработанных конфигураций? Да, можно. Если ваши нетиповые данные можно передать используя ED или реквизит AdditionalInfo, то хорошо. Иначе есть вариант изменения формата обмена (XML схемы). В этом случае возможности КД3 почти сравняются с КД2, но пропадёт основной плюс КД3 - универсальность формата обмена.
- Конфигурации, поддерживающие ED, могут обмениваться между собой? Да! Но для обмена БП 3.0 - БП 3.0 при создании синхронизации нельзя выбрать БП 3.0. Ничего страшного, выбирайте «Другая программа». Если нужен разовый обмен, достаточно воспользоваться обработкой «Выгрузка загрузка EnterpriseData» в меню Все функции.
- После обновления конфигурации нужно загрузить свежие правила из комплекта поставки? Нет! Правила содержаться в модуле конфигурации. Для обмена с другими базами 1С не требуется загружать правила другой базы. Почему? Подробности в этой статье.
- После обновления одной базы необходимо привести в актуальное состояние другую базу, участвующую в обмене? Нет! Не требуется синхронно обновлять все базы, участвующие в обмене. Это один из плюсов КД3.
- Наши конфигурации сильно доработаны, там новые виды документов и справочников, КД3 может их перенести? Есть вероятность, что без изменения формата не сможет. Это один из "минусов" КД3 по сравнению с КД2.
Зачем тогда нужна КД3? Плюсы и минусы
Плюсы КД3
Рассмотрим основной плюс КД3 на примере часто встречающейся задачи. Есть конфигурация УТ 11.3, которая не обновляется по каким либо причинам. Необходимо организовать обмен с БП 3.0, которая постоянно обновляется до актуального релиза.
Нет проблем.
- Универсальный формат обмена, который используется в КД3 предназначен для решения подобных задач.
- Правила обмена в УТ создаются не для обмена с БП а для обмена с универсальным форматом EnterpriseData.
- Если оперировать понятиями КД2, то УТ обменивается с конфигурацией ED, которая не меняется. БП 3.0 тоже обменивается с ED.
У каждой конфигурации свои правила обмена с ED. Таким образом УТ выгружает данные всегда в один и тот же формат. Конфигурация БП 3.0, какая бы она новая не была должна уметь принимать данные из этого формата.
Получается что в УТ не нужно заботится о том, что БП поменяются какие-то реквизиты. Задача простая - выгрузить в ED, а конфигурация БП должна уметь принять данные из этого формата.
- В связи с тем, что конфигурация источник выгружает всегда в одном формате, любая конфигурация приемник может загрузить в себя данные из этого универсального формата.
Т.е. для произвольной комбинации обменов УТ - БП, УТ - КА, УТ - ERP, КА- БП, ERP - БП. не нужно писать индивидуальные правила. В КД3 правила универсальны. Любая конфигурация, поддерживающая обмен в универсальном формате может обмениваться с любой конфигурацией, поддерживающей формат ED.
Отладка алгоритмов и правил доступна в самой конфигурации, т.к. все правила это код общего модуля или внешней обработки. Можно обойтись без КД3 для оперативного исправления ошибки.
Минусы КД2
Правила обмена индивидуальны для каждой пары конфигураций. Для всех вышеперечисленных комбинаций обмена между разными видами конфигураций и разными версиями конфигураций нужны свои правила обмена. Поэтому для решения вышеозвученной задачи обмена УТ 11.3 и БП 3.0 потребуется почти после каждого обновления БП 3.0 отлаживать и дорабатывать правила обмена.
Отладка алгоритмов и правил затруднена для начинающего программиста или для того, кто редко сталкивается с этой задачей. Правила хранятся в xml файле. Быстрое исправление ошибки недоступно. Необходимо загрузить правила в КД2, исправить и выгрузить обратно.
Минусы КД3
Универсальный формат накладывает ограничения на виды документов и справочников. Он разработан для типовых конфигураций. Если у Вас нетиповой реквизит или вид документа, могут возникнуть сложности при обмене.
Для осуществления синхронизации в формате ED конфигурация должна поддерживать эти механизмы. Всё это есть в БСП 2.3 и выше. Это не совсем минус, это скорее особенность.
Основной плюс немного меркнет из-за ограниченных сроков поддержки формата. Это уже ощутили на себе пользователи УТ 11.1, УТ 11.2, которые обмениваются с БП 3.0. Сроки поддержки указаны по этой ссылке . Там сказано, что минимальный гарантированный срок поддержки формата составляет год, фактически около 3-х лет. Таким образом если Вы настроите синхронизацию сегодня, то минимум год можно не обновлять базу УТ 11, а потом либо обновить конфигурацию, либо просто добавить новый формат, внести небольшое изменение в БСП и в правила при необходимости. Как это сделать? Будет указано позднее в этой статье.
Плюсы КД2
Возможности КД2 безграничны. Можно создать правила обмена для любых конфигураций на любой платформе. От 1С 7.7 до последней 8.3. От конфигурации ничего не требуется, БСП не обязательна. Правила могут быть созданы в автоматическом режиме и доработаны.
В связи с вышесказанными плюсами и минусами рекомендуется использовать КД3 для типовых конфигураций. КД2 можно использовать для любых конфигураций, но учитывая её минусы не забывать, что иногда целесообразнее использовать КД3.
Надеюсь пришло понимание зачем нужна КД3, продолжаем по существу.
Принятые сокращения далее
БСП
- Библиотека стандартных подсистем.
ПОД
- правило обработки данных.
ПКО
- правило конвертации объекта.
ПКПД
- правило конвертации предопределенных данных.
ПКС
- правило конвертации свойства.
Рассмотрим пример - необходимо изменить типовые правила обмена БП 3.0 и УТ 11.3
На желтом фоне указаны шаги из инструкции, которая открывается в КД3. Предложенная в этой статье последовательность шагов другая, чтобы не запутаться и сразу логически завершить начатое действие.
Как изменить правила ED?
- Доработать модуль с правилами обмена прямо в конфигурации. Этот вариант пока не рассматриваем, т.к. для понимания что и где нужно менять, необходимо хотя бы один раз сделать это в КД3. В этом случае будет проще в будущем оперативно решать проблемы, отлаживать в модуле и переносить в КД3 при необходимости.
- Воспользоваться КД3
.
Как это делается в КД2? Выгружаем метаданные обеих конфигураций и загружаем в КД2.
Шаг 1. Для КД3 делаем аналогично - в каждой конфигурации в режиме предприятия обработкой \tmplts\1c\Conversion\3_0_5_3\MD83Exp.epf выгружаем метаданные конфигураций,
например, в папку «D:\Правила БП3\БП 3.0.54.15\ », имя файла «МД.xml ».
Непонятно с какой целью скрыты настройки этой обработки, в результате по умолчанию не выгружаются данные по регистрам сведений. Устраняем этот недочет.
В процедуре ИзменитьРежимОбработки() основной формы комментируем строку
// Элементы.Настройки.Видимость = Ложь;
Сохраняем обработку, открываем в режиме предприятия, ставим флаг на «Выгружать регистры сведений», выгружаем.
Шаг 3.
Загружаем ранее созданный файл «МД.xml
» в КД3, раздел флаг «В новую версию конфигурации
».
Т.к. в КД3 для обмена используется «промежуточная конфигурация» (ED), загружаем и её «метаданные», которые представляют собой XML схему, файл с расширением «xsd». Шаг 2.
Взять её можно из конфигурации УТ 11 или БП 3.0. Они одинаковы. Открываем конфигурацию, в строке поиска вводим «enter
», видим в дереве Общие - XDTO-пакеты
примерно такие пакеты: EnterpriseData_1_3_8, EnterpriseData_1_4_4
и подобные.. Это версии формата 1.3 и 1.4 соответственно и 1.2, 1.1, 1.0 если есть. Правая кнопка мыши на пакете, в контекстном меню выбираем «».
Шаг 4.
В КД3 раздел , выбираем ранее выгруженные файлы с расширением «xsd». Нужно выбирать один файл
! Множественный выбор совместно с ExchangeMessage не нужен
! Это предлагалось в старых инструкциях КД3 предыдущих версий. В последних КД3 этого не требуется.
После загрузки формата в разделе Формат данных - Дерево объектов формата
, выберите версию формата. Если там есть документы и справочники, значит Вы загрузили правильный файл. Если нет, начните всё сначала с новой пустой КД3 и первым делом загрузите формат и проверьте дерево.
Этап 2.
После загрузки метаданных в КД3 приступаем к загрузке типовых правил обмена.
Как это делается в КД2? Правила загружаются в конвертацию.
В КД3 почти так же. Выгружаем правила из типовой, создаём конвертацию, а потом загружаем в неё правила.
Выгрузка типовых правил из конфигурации для загрузки в КД3
Конфигурации обмениваются на максимальной общей версии формата обмена. Например, одна конфигурация имеет максимальный формат 1.5, другая 1.6, значит они будут между собой обмениваться в формате 1.5. Поэтому достаточно выгрузить из обеих конфигураций формат 1.5 и загрузить в правила.
Открываем конфигурацию БП 3.0 или УТ 11.3 в режиме конфигуратора, в строке поиска можно ввести «мен уни
», открываем общий модуль . Если это БП 3.0, то открываем . В открытом модуле переходим в меню Файл - Сохранить копию
, сохраняем файл с произвольным именем, например, «D:\Правила БП3\БП 3.0.54.15\Общий модуль МенеджерОбменаЧерезУниверсальныйФормат_ Модуль
».
Открываем конфигурацию БП 3.0 или УТ 11.3 в режиме предприятия, открываем обработку \tmplts\1c\Conversion\3_0_5_3\Выгрузка правил синхронизации.epf
Недостаток типовой обработки:
- часто завершается с ошибкой;
- выгружает правила из внешней обработки, подключенной к узлу, а нам нужны типовые правила;
- не работает в БП 3.0.53 и выше.
Доработка модуля основной формы обработки. Вносим изменения в процедуры ПриСозданииНаСервере .
&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) // Список выбора версий формата. ВерсииФормата = Новый Соответствие; ОбменДаннымиПереопределяемый.ПриПолученииДоступныхВерсийФормата(ВерсииФормата); Для Каждого ПланОбмена Из ОбменДаннымиПовтИсп.ПланыОбменаБСП() Цикл Если ОбменДаннымиПовтИсп.ЭтоПланОбменаXDTO(ПланОбмена) Тогда ВерсииФорматаПланаОбмена = Новый Соответствие; ВерсияБСП243 = ОбщегоНазначенияКлиентСервер.СравнитьВерсии(СтандартныеПодсистемыСервер.ВерсияБиблиотеки(), "2.4.3.1") >= 0; МодульОбменДаннымиСервер = ОбщегоНазначения.ОбщийМодуль("ОбменДаннымиСервер"); Если ВерсияБСП243 Тогда ВерсииФорматаПланаОбмена = МодульОбменДаннымиСервер.ЗначениеНастройкиПланаОбмена(ПланОбмена, "ВерсииФорматаОбмена"); Иначе ПланыОбмена[ПланОбмена].ПолучитьВерсииФорматаОбмена(ВерсииФорматаПланаОбмена); КонецЕсли; Для Каждого ВерсияПланаОбмена Из ВерсииФорматаПланаОбмена Цикл МодульМенеджера = ВерсииФормата.Получить(ВерсияПланаОбмена.Ключ); Если МодульМенеджера = Неопределено Или МодульМенеджера <> ВерсияПланаОбмена.Значение Тогда ВерсииФормата.Вставить(ВерсияПланаОбмена.Ключ, ВерсияПланаОбмена.Значение); КонецЕсли; КонецЦикла; КонецЕсли; КонецЦикла; Для Каждого ВерсияФормата ИЗ ВерсииФормата Цикл Элементы.НомерВерсииФормата.СписокВыбора.Добавить(ВерсияФормата.Ключ); КонецЦикла; АдресХранилищаВерсииФормата = ПоместитьВоВременноеХранилище(ВерсииФормата, УникальныйИдентификатор); КонецПроцедуры
- Выбираем «Номер версии формата», например, «1.3 »,
- «Каталог обмена» - создадим папку, например, «»
- Нажимаем кнопку «Выгрузить ».
Повторяем эти действия для других версий формата и сохраняем в соответствующие папки "1.4", "1.5" и т.п.. Для БП 3.0 достаточно выгрузить все форматы от 1.3 и выше. Для других конфигураций от 1.2 и выше.
Правила выгружены, теперь нужно загрузить их в КД3. В КД2 правила загружаются одновременно с созданием конвертации. В КД3 нужно создать конвертацию и загрузить в неё правила.
В КД3 Раздел Конвертации - Конвертации - Создать
. . Выбираем конфигурацию. Для удобства можно изменить наименование конфигурации, перейдя в режим редактирования элемента. Например, вместо БухгалтерияПредприятия
указать «БП 3.0.54.15
». Реквизит Имя
не нужно менять! Наименование
конвертации можно указать таким же, например, «БП 3.0.54.15
». В табличную часть выбираем поддерживаемые версии формата. Версии формата те, которые мы выгрузили из базы выше. Сохраняем конвертацию.
Переходим в раздел Конвертация - Загрузка правил синхронизации из файлов
.
:
- Файл с модулем обмена: «D:\Правила БП3\БП 3.0.54.15\Общий модуль МенеджерОбменаЧерезУниверсальныйФормат13_ Модуль.txt »
- Конвертация: «БП 3.0.54.15 »
Место загрузки: «В существующую конвертацию »
Каталог обмена: «D:\Правила БП3\БП 3.0.54.15\1.3 »
При загрузке правил синхронизации из файлов для УТ 11.3 появляется ошибка "Поле объекта не обнаружено ". Причина - для ТекПКО.ИспользоватьДляПолучения=Ложь КД3 требует наличия информации по варианту идентификации при получении. Если в файле правил этого нет, возникает ошибка. Исправляем это недоразумение. Либо снимаем эту форму с поддержки, либо используем расширение.
// Основная форма обработки ЗагрузкаПравилСинхронизацииИзФайлов // До внесения изменений: // Процедура загружает правила конвертации объектов &НаСервере Процедура ЗагрузитьПКО() ... ЗаполнитьЗначенияСвойств(ТекПКО, СтруктураАтрибутов); // Вариант идентификации - особая логика. ТекПКО.ВариантИдентификации = Перечисления.ВариантыИдентификацииОбъектов[СтруктураАтрибутов.ВариантИдентификации]; ИначеЕсли ЧтениеXML.ТипУзла = ТипУзлаXML.КонецЭлемента Тогда // Запись загруженного ПКО. ... // Изменения помечены "//ED" // Процедура загружает правила конвертации объектов &НаСервере Процедура ЗагрузитьПКО() ... ЗаполнитьЗначенияСвойств(ТекПКО, СтруктураАтрибутов); // Вариант идентификации - особая логика. Если ТекПКО.ИспользоватьДляПолучения Тогда //ED ТекПКО.ВариантИдентификации = Перечисления.ВариантыИдентификацииОбъектов[СтруктураАтрибутов.ВариантИдентификации]; КонецЕсли; ИначеЕсли ЧтениеXML.ТипУзла = ТипУзлаXML.КонецЭлемента Тогда // Запись загруженного ПКО. ...
Нажимаем кнопку «Загрузить
». «Обработчики предназначены для другой конвертации: БП 3.0.44 (формат 1.4). Продолжить загрузку?
» Нажимаем «Да
».
Не закрывая форму выбираем другой «Каталог обмена
» и нажимаем кнопку « ». Повторяем несколько раз загрузку правил для каждого формата в текущую конвертацию.
После успешной загрузки переходим в раздел «Конвертации» - «Настройка правил конвертации
», открываем нашу конвертацию из формы списка.
Если видим , ПОД и т.п., значит загрузка в КД3 удалась.
Проверка корректности загрузки правил
Это не обязательная операция! Если Вы будете использовать одну версию формата в правилах, добиваться идентичности текста модуля не требуется.
- Открываем конфигуратор БП, создаём новую внешнюю обработку, например, Имя «СинхронизацияEDБП », синоним «Синхронизация ED БП 3.0 ».
- В КД3 в форме «Настройка правил обмена » нажимаем кнопку «» и вставляем этот код из буфера обмена в нашу новую обработку.
- В конфигураторе БП проверяем модуль на синтаксические ошибки. Сохраняем обработку.
- создаём в БП ещё одну пустую обработку, например, Имя «СинхронизацияEDБПтиповая », синоним «Синхронизация ED БП 3.0 типовая ». Копируем текст общего модуля БП МенеджерОбменаЧерезУниверсальныйФормат13 в модуль обработки и сохраняем её.
Сравниваем обе обработки. Меню Файл - Сравнить файлы .
Если в типовом модуле есть процедуры, отсутствующие в наших правилах, значит не для всех форматов данных Вы загрузили правила в конвертацию. При необходимости загружаем в конвертацию правила в недостающем формате и повторяем сравнение наших правил с типовыми. Когда добились идентичности можно смело приступать к доработкам правил . Полной идентичности добиваться не обязательно если Вы знаете какой из форматов обмена не будет использоваться при синхронизации.
Аналогичным способом создаём в КД3 конвертацию для УТ 11.3.
БП 3.0.54.15
- Замечена некорректная загрузка ПКО "Справочник_Пользователи ". Необходимо исправить . Должно .
- В ПКО "Документ_ИнвентаризацияТоваров_Отправка " для ПКС "ОтветственноеЛицо " не указано ПКО. Откройте , перевыберите свойство конфигурации и свойство формата чтобы заполнился их тип, после чего будет доступен выбор в поле "Правило конвертации свойства ". Выберите "Справочник_ФизическиеЛица_Отправка ".
Рассмотрим пример доработки
Основная цель примера - показать возможности доработок для переноса дополнительных данных, которые не укладываются в формат обмена.
Необходимо перенести реквизит "ВидНоменклатуры " справочника "Номенклатура", тип реквизита "Справочник.ВидыНоменклатуры ". Этот вид справочника не переносится типовыми правилами КД3 и не поддерживается форматом ED версии ниже 1.6.
Есть несколько вариантов решения подобной задачи
- Доработка XDTO пакета , добавление в формат объекта "Справочник.ВидыНоменклатуры". В результате теряется основное преимущество универсального формата - он перестаёт быть универсальным. Доработка XDTO пакета потребуется во всех базах, участвующих в обмене.
- Использовать свойство формата "ДополнительныеРеквизиты ", которое есть во многих объектах. Этот вариант рассматривать в данной статье не будем ввиду некоторой сложности. Примем к сведению что есть такой способ.
- Реквизит AdditionalInfo. Он присутствует в шапке всех объектов формата. Тип anyType. Предназначен для подобных случаев. Воспользуемся им как самым простым способом.
Перед тем как приступить к доработке типовых правил, создадим в группе правил две группы «Добавлено
», «Изменено
». Это делается в "Конвертации -
".
Новые ПОД, ПКО, Алгоритмы и т.п. будем создавать в группе «Добавлено», типовые объекты, в которые вносим изменения, переносим в группу «Изменено». Это облегчит последующую поддержку изменённых правил.
Итак, приступим.
Изменения правил в УТ 11.3
В КД3 в форме «УТ 11.3.4.12 Настройка правил обмена » на вкладке Алгоритмы создаём новый алгоритм
- Имя алгоритма «AdditionalInfoВставить»
- Группа: "Добавлено"
Параметры: «ДанныеXDTO, Имя, ДопЗначение»
Код алгоритма
Если ДанныеXDTO.Свойство("AdditionalInfo") И ТипЗнч(ДанныеXDTO.AdditionalInfo)=Тип("Структура") Тогда ДопДанные = ДанныеXDTO.AdditionalInfo; Иначе ДопДанные = Новый Структура; КонецЕсли; ДопДанные.Вставить(Имя, ДопЗначение); ДанныеXDTO.Вставить("AdditionalInfo", ДопДанные);
Сохраняем алгоритм и переходим на вкладку «Правила конвертации объектов »
По кнопке «Найти
» ищем «Номенклатура», открываем ПКО «Справочник_Номенклатура_Отправка
». Переходим на вкладку «При отправке
». Там видим поле «Имя обработчика:» «». Можно прямо туда внести изменения.
Более сложный код, требующий отладки можно писать в конфигурации. Ищем в модуле обмена в УТ 11.3 процедуру с именем «ПКО_Справочник_Номенклатура_Отправка_ПриОтправкеДанных
» и дорабатываем там.
Для переноса изменений из УТ 11.3 в КД3 копируем всю процедуру в буфер обмена, в КД3 в форме «Настройка правил обмена
» нажимаем кнопку «».
Для нашего примера код такой
Если ЗначениеЗаполнено(ДанныеИБ.ВидНоменклатуры) Тогда //ED AdditionalInfoВставить(ДанныеXDTO, "ВидНоменклатуры", Строка(ДанныеИБ.ВидНоменклатуры.УникальныйИдентификатор())); AdditionalInfoВставить(ДанныеXDTO, "ВидНоменклатурыНаименование", ОбщегоНазначения.ЗначениеРеквизитаОбъекта(ДанныеИБ.ВидНоменклатуры, "Наименование")); // AdditionalInfoВставить... //добавляем другие служебные реквизиты КонецЕсли;
После переноса изменений в КД3 нажимаем кнопку "Сохранить модуль менеджера обмена " и переносим код из буфера в модуль УТ 11.3.
Изменения правил в БП 3.0
Вносим изменения в ПКО "Справочник_Номенклатура_Получение ", на вкладке "При конвертации данных XDTO ", имя процедуры "ПКО_Справочник_Номенклатура_Получение_ПриКонвертацииДанныхXDTO ".
Код, добавляемый в модуль "ПКО_Справочник_Номенклатура_Получение_ПриКонвертацииДанныхXDTO"
Если ДанныеXDTO.Свойство("AdditionalInfo") И ТипЗнч(ДанныеXDTO.AdditionalInfo)=Тип("Структура") Тогда //ED ДопДанные = ДанныеXDTO.AdditionalInfo; Если ДопДанные.Свойство("ВидНоменклатуры") Тогда ВидНоменклатуры = ОбменДаннымиXDTOСервер.СсылкаОбъектаПоУИДОбъектаXDTO(ДопДанные.ВидНоменклатуры, Тип("СправочникСсылка.ВидыНоменклатуры"), КомпонентыОбмена); Если ВидНоменклатуры.ПолучитьОбъект()=Неопределено И ДопДанные.Свойство("ВидНоменклатурыНаименование") Тогда //Создаём новый ВидНоменклатурыОбъект = Справочники.ВидыНоменклатуры.СоздатьЭлемент(); ВидНоменклатурыОбъект.УстановитьСсылкуНового(ВидНоменклатуры); ВидНоменклатурыОбъект.Наименование = ДопДанные.ВидНоменклатурыНаименование; // заполняем другие служебные реквизиты ЗаполнитьЗначенияСвойств(ВидНоменклатурыОбъект,ДопДанные); ВидНоменклатурыОбъект.Записать(); ВидНоменклатуры = ВидНоменклатурыОбъект.Ссылка; КонецЕсли; ПолученныеДанные.ВидНоменклатуры = ВидНоменклатуры; КонецЕсли; КонецЕсли;
Одного кода недостаточно. Необходимо на вкладке "Правила конвертации свойств" добавить ПКС со свойством конфигурации " " и флажком "Используется алгоритм конвертации ".
Переносим модуль менеджера обмена в модуль конфигурации БП 3 или во внешнюю обработку.
Как загрузить доработанные правила КД3 в базу?
В конфигурациях, обменивающихся правилами на КД2 это делается в настройках узла. Для правил, созданных в КД3 мы там увидим только возможность поменять правила регистрации.
Правила, подготовленные в КД3 можно установить в конфигурацию тремя способами
- Снять конфигурацию с поддержки и внести изменения в общий модуль МенеджерОбменаЧерезУниверсальныйФормат ;
- На конфигурациях, работающих в режиме совместимости с платформой 8.3.10 и выше можно вносить исправления в общий модуль с помощью расширения.
- Подключить расширение, которое полностью подменяет общий модуль с правилами.
- Не снимая конфигурацию с поддержки подключить к узлу внешнюю обработку с правилами;
С первым вариантом всё понятно, он описан в документации, недостаток - нужно снимать конфигурацию с поддержки. Второй вариант - исправление выбранной процедуры расширением тоже не составит труда для программиста 1С - необходимо сравнить две обработки с типовыми правилами и с доработанными так, как описано выше в этой статье, и внести изменение в нужную процедуру.
Третий вариант - использование расширения с правилами обмена в универсальном формате в настоящее время самый оптимальный. Недостаток пока один - необходимо снимать флаг "Безопасный режим" при подключении данного расширения. Это ограничивает его использование в облачных сервисах. Ждём решения от 1С о порядке замены правил обмена в универсальном формате в 1С фреш.
Суть в том, что необходимо найти в конфигурации участок кода, который отвечает за выбор общего модуля в зависимости от версии формата обмена и заменить выбор модуля на свой модуль. Пример для БП 3.0.67:
//////// // Общий модуль ОбменДаннымиПереопределяемый &Вместо("ПриПолученииДоступныхВерсийФормата") Процедура ED_ПриПолученииДоступныхВерсийФормата(ВерсииФормата) ED_ОбменДаннымиСервер.ПриПолученииДоступныхВерсийФормата(ВерсииФормата); КонецПроцедуры //////// // План обмена СинхронизацияДанныхЧерезУниверсальныйФормат: Модуль менеджера #Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда &Вместо("ПриПолученииНастроек") Процедура ED_ПриПолученииНастроек(Настройки) Настройки.ИмяКонфигурацииИсточника = ОбщегоНазначенияБП.ИмяКонфигурацииИсточника(); Настройки.ЭтоПланОбменаXDTO = Истина; Настройки.ПредупреждатьОНесоответствииВерсийПравилОбмена = Ложь; Настройки.ФорматОбмена = "http://v8.1c.ru/edi/edi_stnd/EnterpriseData"; ВерсииФормата = Новый Соответствие; ED_ОбменДаннымиСервер.ПриПолученииДоступныхВерсийФормата(ВерсииФормата); //ED Настройки.ВерсииФорматаОбмена = ВерсииФормата; Настройки.ПланОбменаИспользуетсяВМоделиСервиса = Истина; Настройки.Алгоритмы.ПриПолученииВариантовНастроекОбмена = Истина; Настройки.Алгоритмы.ПриПолученииОписанияВариантаНастройки = Истина; Настройки.Алгоритмы.ПредставлениеОтбораИнтерактивнойВыгрузки = Истина; Настройки.Алгоритмы.НастроитьИнтерактивнуюВыгрузку = Истина; КонецПроцедуры #КонецЕсли //////// // Общий модуль в расширении ED_ОбменДаннымиСервер Процедура ПриПолученииДоступныхВерсийФормата(ВерсииФормата) Экспорт ВерсииФормата.Вставить("1.2", МенеджерОбменаЧерезУниверсальныйФормат); ВерсииФормата.Вставить("1.3", ED_МенеджерОбменаЧерезУниверсальныйФормат); ВерсииФормата.Вставить("1.4", ED_МенеджерОбменаЧерезУниверсальныйФормат); ВерсииФормата.Вставить("1.5", ED_МенеджерОбменаЧерезУниверсальныйФормат); ВерсииФормата.Вставить("1.6", ED_МенеджерОбменаЧерезУниверсальныйФормат); КонецПроцедуры //////// // Общий модуль в расширении ED_МенеджерОбменаЧерезУниверсальныйФормат // Конвертация БП3.0.44 (формат 1.6) от 27.11.2018 11:23:58 // Доработка для БП 3.0.67.х от 31.12....
Рассмотрим 4-й вариант, который не описан в документации, т.к. в БСП нет такой возможности. Данный вариант уже устарел. Внешняя обработка с правилами применялась в первых версиях с универсальным форматом обмена. Сейчас 1С постепенно избавляется от этого функционала.
В режиме предприятия, в разделе администрирования переходим по ссылке Синхронизация данных - Настройки синхронизации данных
, нажимаем кнопку "Настроить...
" если настройка одна или "Изменить
", если настроек несколько. Переходим в режим редактирования формы через меню " "
, Разворачиваем "Группа
", там включаем скрытый элемент формы " ", "ОК
".
На вкладке "Служебная информация
" выбираем "Путь к менеджеру обмена
", подставляем туда нашу обработку с правилами.
Подключение внешней обработки с правилами к БП 3.0.52 и выше
В БП 3.0.52 и выше по неизвестным причинам внешняя обработка с правилами не используется. Интерфейс для подключения обработки остался. Хотя бы на этом спасибо.
Задействовать обработку с правилами можно с помощью расширения. Необходимо внести исправление в общий модуль "ОбменДаннымиXDTOСервер ", функцию "ВерсииФорматаОбмена ".
Процедура EDм_ПолучитьВерсиюФорматаОбмена(ВерсииФормата, Знач УзелИнформационнойБазы) Запрос = Новый Запрос("ВЫБРАТЬ РАЗЛИЧНЫЕ | СинхронизацияДанныхЧерезУниверсальныйФормат.ПутьКМенеджеруОбмена КАК ПутьКМенеджеруОбмена, | СинхронизацияДанныхЧерезУниверсальныйФормат.ВерсияФорматаОбмена КАК ВерсияФорматаОбмена |ИЗ | ПланОбмена.СинхронизацияДанныхЧерезУниверсальныйФормат КАК СинхронизацияДанныхЧерезУниверсальныйФормат |ГДЕ | СинхронизацияДанныхЧерезУниверсальныйФормат.ПутьКМенеджеруОбмена <> """" | И СинхронизацияДанныхЧерезУниверсальныйФормат.Ссылка = &Ссылка"); Запрос.УстановитьПараметр("Ссылка", УзелИнформационнойБазы); Выборка = Запрос.Выполнить().Выбрать(); Пока Выборка.Следующий() Цикл ИмяОбработки = Выборка.ПутьКМенеджеруОбмена; Если НЕ ОбщегоНазначенияКлиентСервер.РежимОтладки() Тогда ДанныеОбработки = Новый ДвоичныеДанные(ИмяОбработки); АдресОбработки = ПоместитьВоВременноеХранилище(ДанныеОбработки); Если ОбщегоНазначения.ЕстьЗащитаОтОпасныхДействий() Тогда ИмяОбработки = ВнешниеОбработки.Подключить(АдресОбработки, ОбщегоНазначения.ОписаниеЗащитыБезПредупреждений()); Иначе ИмяОбработки = ВнешниеОбработки.Подключить(АдресОбработки); КонецЕсли; КонецЕсли; МенеджерОбмена = ВнешниеОбработки.Создать(ИмяОбработки); ВерсииФормата.Вставить(Выборка.ВерсияФорматаОбмена, МенеджерОбмена); КонецЦикла; КонецПроцедуры &Вместо("ВерсииФорматаОбмена") Функция EDм_ВерсииФорматаОбмена(Знач УзелИнформационнойБазы) ВерсииФорматаОбмена = Новый Соответствие; Если ЗначениеЗаполнено(УзелИнформационнойБазы) Тогда ИмяПланаОбмена = УзелИнформационнойБазы.Метаданные().Имя; ВерсииФорматаОбмена = ОбменДаннымиСервер.ЗначениеНастройкиПланаОбмена(ИмяПланаОбмена,"ВерсииФорматаОбмена"); EDм_ПолучитьВерсиюФорматаОбмена(ВерсииФорматаОбмена, УзелИнформационнойБазы); Иначе ОбменДаннымиПереопределяемый.ПриПолученииДоступныхВерсийФормата(ВерсииФорматаОбмена); КонецЕсли; Если ВерсииФорматаОбмена.Количество() = 0 Тогда ВызватьИсключение СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(НСтр("ru = "Не заданы версии формата обмена. |Имя плана обмена: %1 |Процедура: ПолучитьВерсииФорматаОбмена(<ВерсииФорматаОбмена>)""), УзелИнформационнойБазы.Метаданные().Имя); КонецЕсли; Результат = Новый Соответствие; Для Каждого Версия Из ВерсииФорматаОбмена Цикл Результат.Вставить(СокрЛП(Версия.Ключ), Версия.Значение); КонецЦикла; Возврат Результат; КонецФункции
Как выполнять отладку правил во внешней обработке
- Ниже приведён код для расширения, для УТ 11.4, КА 2.4, ERP 2.4. Код для БП 3.0 приведён выше. Модуль менеджера плана обмена СинхронизацияДанныхЧерезУниверсальныйФормат.
В конфигураторе "Сервис -> Параметры -> Запуск 1С:Предприятия -> Параметр запуска ", указать параметр " ".
Код расширения EDОтладка
&Вместо("ПолучитьВерсииФорматаОбмена") Процедура ED_ПолучитьВерсииФорматаОбмена(ВерсииФормата) ОбменДаннымиУТ.ДоступныеВерсииУниверсальногоФормата(ВерсииФормата); Запрос = Новый Запрос("ВЫБРАТЬ РАЗЛИЧНЫЕ | СинхронизацияДанныхЧерезУниверсальныйФормат.ПутьКМенеджеруОбмена, | СинхронизацияДанныхЧерезУниверсальныйФормат.ВерсияФорматаОбмена |ИЗ | ПланОбмена.СинхронизацияДанныхЧерезУниверсальныйФормат КАК СинхронизацияДанныхЧерезУниверсальныйФормат |ГДЕ | СинхронизацияДанныхЧерезУниверсальныйФормат.ПутьКМенеджеруОбмена <> """""); Выборка = Запрос.Выполнить().Выбрать(); Пока Выборка.Следующий() Цикл ИмяОбработки = Выборка.ПутьКМенеджеруОбмена; Если НЕ ОбщегоНазначенияКлиентСервер.РежимОтладки() Тогда //ED ДанныеОбработки = Новый ДвоичныеДанные(ИмяОбработки); АдресОбработки = ПоместитьВоВременноеХранилище(ДанныеОбработки); Если ОбщегоНазначения.ЕстьЗащитаОтОпасныхДействий() Тогда ИмяОбработки = ВнешниеОбработки.Подключить(АдресОбработки, ОбщегоНазначения.ОписаниеЗащитыБезПредупреждений()); Иначе ИмяОбработки = ВнешниеОбработки.Подключить(АдресОбработки); КонецЕсли; КонецЕсли; МенеджерОбмена = ВнешниеОбработки.Создать(ИмяОбработки); ВерсииФормата.Вставить(Выборка.ВерсияФорматаОбмена, МенеджерОбмена); КонецЦикла; КонецПроцедуры &Вместо("ДоступныеВерсииФорматаОбмена") Процедура ED_ДоступныеВерсииФорматаОбмена(ВерсииФормата) ОбменДаннымиУТ.ДоступныеВерсииУниверсальногоФормата(ВерсииФормата); Запрос = Новый Запрос("ВЫБРАТЬ РАЗЛИЧНЫЕ | СинхронизацияДанныхЧерезУниверсальныйФормат.ПутьКМенеджеруОбмена, | СинхронизацияДанныхЧерезУниверсальныйФормат.ВерсияФорматаОбмена |ИЗ | ПланОбмена.СинхронизацияДанныхЧерезУниверсальныйФормат КАК СинхронизацияДанныхЧерезУниверсальныйФормат |ГДЕ | СинхронизацияДанныхЧерезУниверсальныйФормат.ПутьКМенеджеруОбмена <> """""); Выборка = Запрос.Выполнить().Выбрать(); Пока Выборка.Следующий() Цикл ИмяОбработки = Выборка.ПутьКМенеджеруОбмена; Если НЕ ОбщегоНазначенияКлиентСервер.РежимОтладки() Тогда //ED ДанныеОбработки = Новый ДвоичныеДанные(ИмяОбработки); АдресОбработки = ПоместитьВоВременноеХранилище(ДанныеОбработки); Если ОбщегоНазначения.ЕстьЗащитаОтОпасныхДействий() Тогда ИмяОбработки = ВнешниеОбработки.Подключить(АдресОбработки, ОбщегоНазначения.ОписаниеЗащитыБезПредупреждений()); Иначе ИмяОбработки = ВнешниеОбработки.Подключить(АдресОбработки); КонецЕсли; КонецЕсли; МенеджерОбмена = ВнешниеОбработки.Создать(ИмяОбработки); ВерсииФормата.Вставить(Выборка.ВерсияФорматаОбмена, МенеджерОбмена); КонецЦикла; КонецПроцедуры
Отладку проще всего вести в файловой базе. Точку останова ставим в обработке с правилами. Чтобы найти нужную процедуру, используем КД3. Находим ПКО, ПОД или Алгоритм, смотрим "Имя обработчика " или "Имя алгоритма ", ищем эту процедуру в модуле правил. После правки модуля не забываем скопировать процедуру в буфер и в КД3 нажать кнопку "". Будьте внимательны, должна быть открыта эта же конвертация.
На этом пока всё. Данной информации для программиста 1С уже достаточно чтобы самостоятельно освоить КД3 и поддерживать в рабочем состоянии современный способ синхронизации между базами 1С. Если остались белые пятна, спрашивайте, статья будет дополняться и Вы можете вернуться к ней если что-то забыли.
Общеизвестные ссылки на документацию по КД3:
- 1С-Учебный центр №3, "Конвертация данных 3.0" - http://www.1c-uc3.ru/konvert30.html
Расширить сферу применения КД3 Вы можете используя эти публикации:
- - конфигурации предыдущих версий на платформе 8.2 и ниже превращаются в совместимые с ED.
Сэкономить время и воспользоваться готовыми правилами для последних версий конфигураций можно здесь
- - расширенный функционал, исправления замеченных ошибок.
1. Вступление.
2. Что понадобится: конфигурация 1С: Конвертация данных 2.* и обработки из пакета. Для Примера задач возьмем конфигурации 1С: Управление торговлей 11 и 1С: БП 3.*.
Итак, для разработки правил выгрузки данных в 1С потребуется конфигурация 1С: Конвертация объектов 2, а также обработки, входящие в пакет.
Например, у нас уже развернута база конвертации и запущена.
Разработку правил обмена будем писать между конфигурацией 1С: Управление торговлей 11 и 1С: Бухгалтерия предприятия 3 (правила обмена УТ / БУХ).
3. Нам понадобятся Обработки для выгрузки структуры метаданных и обмена.
Первое, что нужно получить для разработки - это файлы со структурой метаданных. Выполняется это с помощью обработок выгрузки структуры метаданных, входящих в пакет конвертации объектов.
Собственно, в распакованном каталоге конфигураций для конфигураций на управляемых формах нас интересует обработка MD83Exp.epf. Если выгрузку нужно сделать из конфигураций на обычных формах, тогда используется обработка MD82Exp.epf. Это если, например, нужно получить структуру из таких конфигураций, как 1С: УТ 10, 1С: Управление производственным предприятием 1.3, 1С: Комплексная автоматизация 1.1, 1С: Зуп 2.5 и так далее.
Далее уже для выгрузки-загрузки данных в 1С с помощью наших правил понадобится обработка «Универсальный обмен данными в формате XML» V8Exchan83.epf для конфигураций на управляемых формах таких как 1С: Управление торговлей 11.*, 1С БП 3, 1С: ERP 2.* и подобных. И соответственно V8Exchan83.epf - для конфигураций на обычных формах.
4. Выгрузка структуры метаданных конфигурации 1С: Управление торговлей 11.3 и 1С: Бухгалтерия предприятия 3.0.*
Начнем с выгрузки структуры метаданных из конфигурации 1С: Бухгалтерия предприятия 3.
Откроем обработку MD83Exp.epf
В форме обработки имеются дополнительные настройки, где мы можем включить или отключить параметр выгружать регистры и движения в 1С. Также есть выбор, где будет проходить выгрузка: на сервере 1С или «на клиенте.» Указываем название файла, куда выгрузится структура данных. Аналогичным образом делаем выгрузку структуры метаданных конфигурации Управление торговлей 11.
Теперь необходимо загрузить конфигурацию в базу конвертаций. К данному пункту можно прийти и из списка конфигураций, и из списка конвертаций. Сделаем просто загрузку из рабочего стола:
В диалоговом окне загружаем структуру БП:
И аналогично - структуру Управления торговлей.
По окончании загрузки появится диалоговое окно, где можно указать удобное для вас наименование.
6. Создание правил конвертации в 1С на конкретном примере задачи.
Далее переходим в «Настройка правил объекта», где создаем новую настройку.
В диалоговом окне создания конвертации выбираем конфигурацию «источник» и конфигурацию «приемник» (которые ранее загрузили) и нажимаем ОК.
Так как в этой статье планировал показать создание «с нуля» и «без мусора», напоминаю, что ничего автоматически не создаем. Никаких прототипов.
В этом диалоговом окне ничего выполнять не будем, просто нажмем - «Закрыть».
Создадим правила для выгрузки не один документ в один, а один вид в другой, например, документ РеализацииТоваровУслуг из УТ 11 с необходимыми справочниками в документ ПоступлениеТоваровУслуг в БП 3.
Итак, создаем новое ПКО (правило конвертации объектов в 1С)
Выбираем источник РеализацияТоваровУслуг и приемник ПоступлениеТоваровУслуг и нажимаем ОК.
При этом появится диалоговое окно, где опять отказываемся от автоматического создания ПКС (Правил конвертации свойств). Далее выберем только необходимые.
А вот на предложение создать ПВД (правил выгрузки данных) отвечаем «Да».
Создаются ПВД, которые и будут отражаться в обработке универсального обмена XML для выбора:
Создадутся так же правила конвертации данных с пустыми правилами конвертации свойств.
Причем видно, что ПКО по умолчанию предлагается искать по внутреннему идентификатору объекта. На это указывает лупа возле ПКО. Мы же будем делать свой поиск, и сделаем его по номеру документа и дате на начало дня.
Снимаем поиск по УИО:
Теперь начнем сопоставление необходимых свойств (реквизитов) объекта. Для этого жмем «СинхронизацияСвойств» (метка «1» на скрине). Убираем рекурсивное создание правил («2»). Снимаем все отмеченные реквизиты ("3"). И выберем самостоятельно, что нам нужно.
Для примера выбираем необходимое:
Обращаю внимание на то, что мы сделаем ПКС контрагента в организацию, а организацию в контрагента, и еще сопоставим некоторые реквизиты, которые не совпадают по имени, например, «Валюта» и «Валюта документа».
Где видим, что еще нет правил конвертации.
Начнем по реквизитам проходить и описывать. Сначала настраиваем поиск документа так, как писал ранее, делаем выгрузку и поиск документа на начало даты, и сделаем подмену нумерации. Первые три символа будем подменять на свой префикс «УТБ». А так как в БП и УТ нумерация по 11 символов, делаем составной номер: наш префикс и 8 символов от источника. Пример на скрине ниже.
Выгрузку документов делаем всегда не проведенные и без движения. Предполагаем, что документы будут в приемнике проводиться после проверки пользователем.
Для этого ПКС установив, как не проведен, 0 или 1, используем как булево.
На примере валюты создаем для ПКС правило конвертации объекта. При этом считаем, что в обеих базах валюты имеются, и они должны синхронизироваться по коду. Поэтому в ПКО валют не будем создавать все ПКС, а только добавим Код для поиска. Т.е. от предложения создать ПКС для объекта - отказываемся.
В ПКО документа для ПКС подставилось созданное Правило конвертации. А само правило по умолчанию предлагается по уникальному идентификатору. Исправляем, делаем поиск по коду и устанавливаем свойство, чтобы не создавать новый объект.
В итоге получаем вариант:
Далее по аналогии создаем для остальных реквизитов ПКО и ПКС. Причем поиск организации по контрагенту и наоборот устанавливаем по ИНН. Примерно так это выглядит с минимальными реквизитами (можно добавлять при необходимости).
Для ПКО Договоры контрагентов делаем поиск по ПКС Контрагент, наименование и владелец.
Посмотрим, как указать в ПКС нужное значение в типе перечисления. Например, реквизит «ВидОперации». Тут можно использовать различные условия и подставлять значения. Например, нам нужно, чтобы «вид операции» выгружался всегда «Товары», в этом случае достаточно в «лоб» написать нужное значение строкой.
Ниже показано, как установить без сложностей и в большинстве случаев ПКС для КратностьВзаиморасчетов, КурсВзаиморасчетов, Счета учета.
Для ПКО Номенклатура оставим поиск по внутреннему уникальному идентификатору. Но обращу внимание на то, как можно переопределить свою группу. Например, мы согласны, что будет выгружаться новая номенклатура из конфигурации 1С: Управление торговлей 11, но нужно, чтобы номенклатура собиралась в определенной группе «НашаГруппа».
Для реализации данной задачи создаем ещё одно ПКО. Назовем его «НоменклатураРодитель», которое укажем в ПКС родителя в правиле конвертации.
Устанавливаем два поиска: по наименованию, где наименование жестко указываем нашей группы, и обязательное свойство признака «ЭтоГруппа» в истина.
Поскольку мы приняли решение, что у нас вся номенклатура падает в нашу группу, то нет необходимости при выгрузке выгружать группы из УТ 11. Для этого в ПКО Номенклатура в обработчике событий «ПередВыгрузкой» поставим фильтр, что не нужно выгружать группы «Отказ = Источник.ЭтоГруппа;».
В ПВД (правила выгрузки данных) РеализацииТоваровУслуг, добавим фильтр, чтобы не выгружались помеченные на удаление документы. Для этого в ПВД в обработчиках событий «ПередВыгрузкой» пропишем фильтр «Отказ = Объект.ПометкаУдаления;».
Сохраним разработанные правила в файл.
7. Подводим итоги: Выгрузка и загрузка данных с помощью разработанных правил обмена данными.
Открываем в 1С:Управление торговлей 11 обработку «Универсальный обмен данными в формате XML» V8Exchan83.epf.
Выгрузка прошла, теперь этой же обработкой делаем загрузку в 1С: Бухгалтерия предприятия 3.
Загрузка прошла. Проверяем, что как загрузилось. Итак, документ загружен, как мы и добивались - у нас Организация загружена в контрагента, а контрагент в организацию. Счета учета все загружены и установлены. Номер документа у нас получился с нашим префиксом и на начало дня. Все реквизиты, которые прописали, заполнены.
Проверяем загрузку номенклатуры. Видим, что всё получилось так, как мы и планировали.
У нас создались и заполнились реквизиты так, как мы это задумывали. В конвертации имеется множество тонкостей и каких-то простых, но нужных вещей, которые помогают точно написать конвертацию. А это позволяет минимизировать ошибки, не испортить существующие данные и избавиться от лишнего мусора. Это один из самых простых примеров. Можно так же делать конвертации одного объекта во многие или же наоборот многие - в один.
Сейчас есть конвертация данных 3, она решает другие задачи. Поэтому конвертация 2, так же нужна. Всем удачи в изучении и освоении.
Конечно, если Вы программист и это - основная ваша работа, Вы можете сами попробовать написать конвертацию. Но если нет, то стоит ценить Ваше время в своей сфере деятельности, а данную задачу попросить выполнить профессионалов.
Конвертация данных 2.0 и 2.1 — технологическая конфигурации фирмы 1С, реализованная на версии платформы от 8.1 до 8.3.
Главная задача инструмента — написание правил обмена между прикладными решениями 1С 8 и 7. Актуальная версия конвертации данных сегодня — 3.0.
Конвертация данных — очень полезная конфигурация, с помощью неё можно решить не только вопрос переноса информации из одной информационной базы в другую, но и, например, преобразование информации внутри одной базы.
Конфигурацию очень удобно использовать при .
Конвертация данных будет полезна любому программисту: наличие навыков создания правил обмена — это серьезный плюс к профессиональным навыкам.
Для обучения работы с конфигурации лучше всего подойдет решение практических задач. Попробуйте придумать себе задачи, например: перенести какую-либо информацию из одной базы в другую, превратить документ реализации в документ поступления, «загнать» текущие остатки по бухгалтерскому учету в документ «ввода остатков» и другие задачки.
Очень полезно будет разобраться в «типовых» правилах обмена 1С 8.3, там зачастую можно найти интересные примеры реализации задач.
Для постижения основ вам потребуются материалы, рассмотрим их ниже.
Видео инструкция по конвертации
Азы настройки обмена данными в 1С с помощью конфигурации «1С Конвертации данных» на примере смотрите в видео:
Материалы, учебники для изучения 1С Конвертации данных 2.0
Материалов и документации в сети не слишком большое множество, я попробовал собрать самые важные и интересные материалы:
0. Первым делом советую бесплатный видеокурс Ильи Леонтьева, он доступен по ссылке .
1. Я бы посоветовал прежде всего пользоваться встроенной справкой в конфигурацию. Она действительно неплохо написана и грамотно реализована технически:
2. Второй по важности источник информации — сайт http://www.mykod.info/ (сайт закрылся), специализированный как раз на конвертации данных. Там Вы сможете скачать большое количество материалов по конвертации.
3. Отдельно хотелось бы выделить методичку учебник — (автор — Ольга Кузнецова).
Миграция данных между различными конфигурациями – задача не из тривиальных. Путей решения как всегда несколько, но не все они оптимальны. Попробуем разобраться в нюансах переноса данных и выбрать универсальную стратегию решения подобных вопросов.
Проблема миграции данных (речь сугубо о продуктах компании 1С) из одного решение в другое возникла не вчера. Компания «1С» прекрасно понимает, с какими трудностями сталкиваются разработчики во время создания миграций, поэтому всячески старается помогать инструментами.
За время развития платформы, компания представила ряд универсальных инструментов, а также технологий, упрощающих перенос данных. Они встроены во все типовые решения и проблема миграций между идентичными конфигурациями в целом решилась. Победу лишний раз подтверждает тесная интеграция типовых решений.
С миграциями между не типовыми решениями ситуация несколько сложней. Широкий выбор технологий позволяет разработчикам самостоятельно выбирать оптимальный с их точки зрения способ решения задачи.
Рассмотрим некоторые из них:
- обмен через текстовые файлы;
- использование планов обмена;
- и т.д.
У каждого из них свои плюсы и минусы. Если резюмировать, то главным минусом будет – многословность. Самостоятельная реализация алгоритмов миграции чревата существенными временными затратами, а также долгим процессом отладки. Про дальнейшее сопровождение подобных решений даже говорить не хочется.
Сложность, дороговизна сопровождения, подтолкнули компанию «1С» на создание универсального решения. Технологии, позволяющей максимально упростить разработку и поддержку миграций. В итоге идея реализовалась в виде отдельной конфигурации – «Конвертация данных».
Конвертация данных - типовое решение, самостоятельная конфигурация. Любой пользователь, обладающий подпиской “ИТС:Проф” может совершенно бесплатно загрузить этот пакет с сайта поддержки пользователей или диска ИТС. Установка выполняется стандартным способом - как и все остальные типовые решения от 1С.
Теперь немного о плюсах решения. Начнем с самого главного - универсальность. Решение не заточено на определенные конфигурации/версии платформы. Одинаково хорошо работает как с типовыми конфигурациями, так и самописными. Разработчики получают в распоряжение универсальную технологию и стандартизированный подход к созданию новых миграций. Универсальность решения позволяет подготавливать миграции даже для отличных от «1С:Предприятие» платформ.
Второй жирный плюс - визуальные средства. Простые миграции создаются без программирования. Да-да, без единой строчки кода! Только ради этого стоит один раз потратить время на изучение технологии, а потом использовать бесценные навыки многократно.
Третьим плюсов я бы отметил отсутствие ограничений на дистрибуцию данных. Разработчик сам выбирает способ доставки данных в конфигурацию приемник. Из коробки доступно два варианта: выгрузка в xml файл и прямое соединение с информационной базой (COM/OLE).
Изучаем архитектуру
Мы уже знаем, конвертация данных способна творить чудеса, но пока не совсем понятно, в чем же выражаются технические плюсы. Первое, что необходимо усвоить - в основе любой миграции данных (конвертации) лежат правила обмена. Правила обмена - обычный xml файл с описанием структуры, в которую будут выгружаться данные из ИБ. Сервисная обработка, осуществляющая выгрузку/загрузку данных, анализирует правила обмена и на их основании выполняет выгрузку. Во время загрузки происходит обратный процесс.
Конфигурация “КД” – своего рода визуальный конструктор, с помощью которого разработчик создает правила обмена. Выполнять выгрузку данных она не умеет. За это отвечают дополнительные внешние сервисные обработки, входящие в дистрибутив КД. Их несколько (XX в имени файла - номер версии платформы):
- MDXXExp.epf - обработка позволяет выгружать описание структуры информационной базы в xml файл. Описание структуры загружается в КД для дальнейшего анализа и создания правил обмена.
- V8ExchanXX.epf - осуществляет выгрузку/загрузку данных из информационной базы в соответствии с правилами обмена. В большинстве типовых конфигураций обработка присутствует из коробки (см. пункт меню “Сервис”). Обработка универсальна и не привязывается к каким-то определенным конфигурациям/правилам.
Хорошо, теперь на основании всего вышесказанного, определим этапы разработки новой конвертации:
- Определение задачи. Необходимо четко понимать какие данные требуется переносить (из каких объектов конфигурации) и самое главное куда переносить.
- Подготовка описания структур конфигураций (Источника/Приемника) для последующей загрузки в КД. Задача решается сервисной обработкой MDXXExp.epf.
- Загрузка подготовленных описаний структур в ИБ.
- Создание правил обмена при помощи визуальных средства КД.
- Выполнение выгрузки/загрузки по созданным правилам конвертации данных путем использования обработки V8ExchanXX.epf.
- Отладка правил обмена (при необходимости).
Простейшая конвертация
Для демонстрации нам потребуется две развернутые конфигурации. Я решил остановиться на варианте: “Управление торговлей” 10-й редакции и небольшим самописным решением. Задача будет заключаться в переносе данных из типовой конфигурации «УТ». Для краткости назовем самописное решение “Приемник”, а управление торговлей “Источником”. Решать задачу начнем с переноса элементов справочника «Номенклатура».
Первым делом взглянем на схему конвертации данных и перечитаем список действий, которые необходимо проделать. Затем запускаем конфигурацию “Источник” и открываем в ней сервисную обработку MD82Exp.epf.
Интерфейс обработки не блещет изобилием настроек. Пользователю лишь требуется указать типы объектов метаданных, которые не попадут в описание структуры. В большинстве случае эти настройки изменять не приходится, т.к. особого смысла в выгрузки движений по регистрам накопления (как пример) нет.
Движение правильней формировать во время проведения документов в приемнике. Все движения будут сделаны документом самостоятельно после переноса. Второй аргумент в защиту настроек по умолчанию - сокращение размера файла с выгрузкой.
Некоторые документы (особенно в типовых конфигурациях) формируют движения по множеству регистров. Выгрузка всего этого хозяйства сделает результирующий XML файл чересчур большим. Это может затруднить последующую транспортировку и загрузку в базу приемник. Чем больше файл с данными, тем больше потребуется оперативной памяти для его обработки. За свое практику мне довелось столкнуться с неприлично большими файлами выгрузки. Такие файлы напрочь отказывались разбираться стандартными средствами.
Итак, оставляем все настройки по умолчанию и делаем выгрузку описания конфигурации в файл. Аналогичную процедуру повторяем для второй базы.
Открываем КД и в главном меню выбираем “Справочники” -> “Конфигурации” . Справочник хранит описания структур всех конфигураций, которые помогут быть использованы для создания конвертаций. Мы один раз загружаем описание конфигурации, а потом можем использовать ее многократно для создания различных конвертаций.
В окне справочника нажмем кнопку “Добавить ” и в появившемся окне выберем файл с описанием конфигурации. Отмечаем флажок “Загрузить в новую конфигурацию” и кликаем по кнопке “Выполнить загрузку”. Аналогичные действия проделываем с описанием структуры второй конфигурации.
Теперь все готово для создания правил обмена. В главном меню КД выбираем “Справочники” -> “Конвертации”. Добавляем новый элемент. В окне создания новой конвертации требуется указать: конфигурацию источник (выбираем УТ) и конфигурацию приемник (выбираем «Приемник»). Далее открываем вкладку “Дополнительно” и заполняем следующие поля:
- имя файла правил обмена - под таким именем будут сохраняться созданные правила обмена. Имя файла можно менять в любое время, но выгодней задать его сейчас. В будущем это сэкономит время. Правила для демонстрационного примера я назвал: «rules-ut-to-priemnik.xml».
- наименование - название конвертации. Название может быть абсолютно любым, я ограничился “Демо. УТ в Приемник”.
Все, нажимаем “Ok”. Сразу же перед нами появляется окно с вопросом создать все правила автоматически. Согласие на столь заманчивое предложение даст мастеру команду автоматически проанализировать описание выбранных конфигураций и самостоятельно сгенерировать правила обмена.
Сразу расставим точки над “и”. Ничего серьезного мастер сгенерировать не сможет. Однако, со счетов эту возможность сбрасывать не стоит. Если необходимо наладить обмен между идентичными конфигурациями, то услуги мастера будут весьма кстати. Для нашего примере предпочтительней ручной режим.
Рассмотрим подробней окно “Настройки правил обмена”. Интерфейс может показаться слегка запутанным - большое количество вкладок, напичканных элементами управления. На самом деле все не так сложно, к этому безумству начинаешь привыкать через несколько часов работы с приложением.
На данном этапе нас интересуют две вкладки: “Правила конвертации объектов” и “Правила выгрузки данных”. На первой мы должны настраивать правила соответствия, т.е. сопоставлять объекты двух конфигураций. На второй же, определять возможные объекты, которые будут доступны пользователю для выгрузки.
Во второй половине вкладки “Правила конвертации объектов” расположена дополнительная панель с двумя вкладками: “Конвертация свойств” и “Конвертация значений ”. Первая будет отбирать свойства (реквизиты) выбранного объекта, а вторая необходима для работы с предопределенными значениями (например, предопределенные элементы справочников или элементы перечисления).
Отлично, теперь создадим правила конвертации для справочников. Выполнить это действие можно двумя вариантами: воспользоваться мастером синхронизации объектов (кнопка “”) или добавить соответствия для каждого объекта вручную.
Для экономии места воспользуемся первым вариантом. В окне мастера снимаем флажки с группы “Документы ” (нас интересуют только справочники) и раскрываем группу “Справочники ”. Внимательно пролистываем список и смотрим названия справочников, которые можно сопоставить.
В моем случае таких справочников три: Номенклатура, Организации и Склады. Есть еще справочник Клиенты, выполняющий ту же самую смысловую нагрузку, что и “Контрагенты ” из конфигурации “УТ ”. Правда, мастер не смог их сопоставить в силу отличных имен.
Исправить эту недоработку мы можем самостоятельно. Находим в окне «Соответствия объектов » справочник «Клиенты », а в колонке «Источник» выбираем справочник «Контрагенты». Затем устанавливаем флажок в колонке «Тип» и нажимаем кнопку “Ok”.
Мастер синхронизации объектов предложит автоматически создать правила конвертации свойств всех выбранных объектов. Сопоставление свойств будет происходить по именам и для нашей демонстрации этого будет вполне достаточно, соглашаемся. Следующим вопросом будет предложение создания правил выгрузки. Согласимся и на него.
Основа для правил обмена готова. Объекты для синхронизации выбрали мы, а правила для конвертации свойств и правила выгрузки были созданы автоматом. Сохраним правила обмена в файл, затем откроем ИБ “Источник” (в моем случае это УТ) и в ней запустим сервисную обработку V8Exchan82.epf .
Первым делом в окне обработки выбираем созданные нами правила обмена. На вопрос загрузки правил отвечаем положительно. Обработка проанализирует правила обмена и построит одноименное дерево объектов, доступных для выгрузки. Для этого дерева мы можем устанавливать всевозможные отборы или узлы обмена, по изменения которых требуется выбирать данные. Мы хотим выгрузить абсолютно все данные, поэтому в установке фильтров необходимость отсутствует.
После завершения процесса выгрузки данных в файл переходим в ИБ “Приемник ”. В ней также открываем обработку V8Exchan82.epf , только на этот раз переходим на закладку “Загрузка данных”. Выбираем файл с данными и нажимаем кнопку “Загрузить”. Все, данные успешно перенесены.
Задачи из реального мира
Первый демонстрационный пример мог ввести в заблуждение. Все выглядит достаточно простым и логичным. На самом деле это не совсем так. В реальной работе возникают задачи, решить которые одними визуальными средствами (без программирования) трудно или совсем невозможно.
Чтобы не разочароваться в технологии, я приготовил несколько реальных задач. С ними обязательно сталкиваешься при работе. Они не выглядят столь тривиальными и заставляют посмотреть на конвертацию данных под новым углом. Внимательно рассмотрите представленные примеры, и смело используйте как сниппеты при решении реальных задач.
Задача №1. Заполняем отсутствующие реквизиты
Предположим, нам требуется перенести из УТ справочник “Контрагенты ”. В приемнике для этого есть похожий справочник “Клиенты”. Он полностью подходит для хранения данных, но в нем есть реквизит “Организация ”, позволяющий разделять контрагентов по принадлежности к организации. По умолчанию все контрагенты должны относиться к текущей организации (ее можно получить из одноименной константы).
Решений у задачи несколько. Мы рассмотрим вариант заполнения реквизита “Организация ” прямо в базе “Приемник ”, т.е. в момент загрузки данных. Текущая организация хранится в константе, следовательно, нет никаких преград в получении этого значения. Откроем правило конвертации объекта (далее ПКО) “Клиенты ” (двойной клик по объекту) и в мастере настройки правил перейдем до раздела “Обработчики событий”. В списке обработчиков найдем “После загрузки ”.
Опишем код получения текущей организации с последующим присвоением реквизиту. На момент срабатывания обработчика “После загрузки”, объект будет полностью сформирован, но еще не записан в БД. Никто не запрещает нам его изменять по своему усмотрению:
Если НЕ Объект.ЭтоГруппа Тогда Объект.Организация = Константы.ТекущаяОрганизация.Получить(); КонецЕсли;
Перед заполнением реквизита «Организация » обязательно необходимо проверить значение реквизита «ЭтоГруппа ». Для справочника «Клиенты » установлен признак иерархичности, поэтому проверка на группу необходима. Подобным образом выполняется заполнение любых реквизитов. Обязательно прочтите справку по другим параметрам обработчика «ПослеЗагрузки ». Например, среди них есть параметр «Отказ ». Если ему присвоить значение «Истина», то объект в базу записан не будет. Таким образом, появляется возможность ограничивать объекты для записи в момент загрузки.
Задача №2. Реквизиты в регистр сведений
В справочнике “Контрагенты ” конфигурации УТ, есть реквизиты “Покупатель ” и “Поставщик ”. Оба реквизита имеют тип “Булево ” и служат для определения типа контрагента. В ИБ “Приемник ”, у справочника “Клиенты ” аналогичных реквизитов нет, но есть регистр сведений “ВидыКлиентов ”. Он выполняет аналогичную функцию и может хранить для одного клиента несколько признаков. Наша задача заключается в переносе значений реквизитов в отдельные записи регистра сведений.
Одними визуальными средствами здесь, к сожалению, тоже не справиться. Начнем с малого, создадим новое ПКО для регистра сведений “ВидыКлиентов ”. В качестве источника ничего не указывайте. От автоматического создания правил выгрузки откажитесь.
Следующим шагом сформируем правила выгрузки. Переходим на соответствующую вкладку и нажимаем кнопку “Добавить ”. В окне добавления правил выгрузки заполняем:
- Способ выборки. Меняем на “Произвольный алгоритм”;
- Правило конвертации. Выбираем регистр сведений “ВидыКлиентов”;
- Код (имя) правила. Записываем как “ВыгрузкаВидовКлиентов”;
Теперь необходимо написать код для отбора данных для выгрузки. Здесь нам поможет параметр “ВыборкаДанных ”. В него мы можем поместить коллекцию с подготовленным набором данных. Параметр “ВыборкаДанных ” может принимать различные значения - результат запроса, выборка, коллекции значений и т.д. Мы его инициализируем в виде таблицы значений с двумя колонками: клиент и тип клиента.
Ниже приведен код обработчика событий “Перед обработкой ”. В нем выполняется инициализация параметра “ВыборкаДанных ” с последующим заполнением данными из справочника “Контрагенты ”. Здесь стоит обратить внимание на заполнение колонки “ТипКлиента ”. В “УТ” у нас признаки имеют тип “Булево”, а в получателе перечисление.
На данном этапе мы их не можем привести к нужному типу (его же нет в УТ), поэтому пока оставим в виде строк. Этого можно и не делать, но мне сразу хочется показать, как приводить к отсутствующему типу в источнике.
ВыборкаДанных = Новый ТаблицаЗначений(); ВыборкаДанных.Колонки.Добавить("Клиент"); ВыборкаДанных.Колонки.Добавить("ТипКлиента"); ВыборкаДанныхИзСправочника = Справочники.Контрагенты.Выбрать(); Пока ВыборкаДанныхИзСправочника.Следующий() Цикл Если ВыборкаДанныхИзСправочника.ЭтоГруппа Тогда Продолжить; КонецЕсли; Если ВыборкаДанныхИзСправочника.Покупатель Тогда НоваяСтрока = ВыборкаДанных.Добавить(); НоваяСтрока.Клиент = ВыборкаДанныхИзСправочника.Ссылка; НоваяСтрока.ТипКлиента = "Покупатель"; КонецЕсли; Если ВыборкаДанныхИзСправочника.Поставщик Тогда НоваяСтрока = ВыборкаДанных.Добавить(); НоваяСтрока.Клиент = ВыборкаДанныхИзСправочника.Ссылка; НоваяСтрока.ТипКлиента = "Поставщик"; КонецЕсли; КонецЦикла;
Сохраним правило выгрузки данных и вернемся на вкладку “Правила конвертации объектов ”. Добавим для регистра сведений “ВидыКлиентов ” правила конвертации свойств: клиент и тип клиента. Источник оставим пустым, а в обработчике событий “Перед выгрузкой” пишем:
//Для свойства “Клиент” Значение = Источник.Клиент; //Для свойства “ТипКлиента” Если Источник.Клиент = "Покупатель" Тогда Выражение = "Перечисления.ТипыКлиентов.Покупатель" ИначеЕсли Источник.Клиент = "Поставщик" Тогда Выражение = "Перечисления.ТипыКлиентов.Поставщик"; КонецЕсли;
В листинге выполняется заполнение реквизитов на основе произведенной выборки данных. Клиента мы передаем просто в виде ссылки, а тип клиента записываем в параметр «Выражение ». Данные этого параметра будут интерпретированы в приемнике, и при выполнении реквизит будет заполненным корректным значением из перечисления.
Все, правила обмена готовы Рассмотренный пример получился достаточно универсальным. Подобный подход частенько применяется при переносе данных из конфигураций, созданных на платформе 7.7. Яркий тому пример – перенос периодических реквизитов.
Задача №3. Трюки с табличными частями
Нередко попадаются задачи, требующие разноски строк одной табличной части в несколько. Например, в исходной конфигурации услуги и товары оформляются в одной табличной части, а приемнике хранение этих сущностей разделено. Визуальными средствами задачу опять же не решить. Здесь за основу удобно брать решение второй задачи.
Делаем правило выгрузки данных, указываем произвольный алгоритм и в обработчике “Перед выгрузкой” пишем запрос для получения данных из табличной части.
Для экономии места я не стану приводить код (вы всегда можете обратиться к исходникам) запроса - ничего необычного в нем нет. Полученную выборку перебираем, и отсортированные результаты размещаем в уже знакомый параметр “ВыборкаДанных ”. В качестве коллекции опять же удобно использовать таблицу значений:
ВыборкаДанных = Новый ТаблицаЗначений(); //Здесь будет еще одна табличная часть ВыборкаДанных.Колонки.Добавить(“Товары”); //Здесь тоже будет табличная часть ВыборкаДанных.Колонки.Добавить(“Услуги”); ВыборкаДанныз.Колонки.Добавить(“Ссылка”);
Задача №4. Перенос данных в операцию
Если в организации используется несколько учетных систем, то рано или поздно возникнет необходимость в миграции данных с последующим формированием проводок.
В конфигурации “БП ” есть универсальный документ “Операция ” и он идеально подходит для формирования большего количества проводок. Вот только одна не задача - документ сделан хитро, и так просто данные в него не перенести.
Пример подобной конвертации вы найдете в исходниках к статье. Объем кода получился достаточно большим, поэтому нет никого смысла его публиковать к статье. Скажу лишь, что выгрузка опять же использует произвольный алгоритм в правилах выгрузки данных.
Задача №5. Синхронизация данных по нескольким реквизитам
Мы уже рассмотрели несколько примеров, но до сих пор не поговорили о синхронизации объектов во время переноса. Вот представим, что нам требуется перенести контрагентов и часть из них наверняка имеется в базе приемнике. Как перенести данные и не допустить появления дублей? На этот счет КД предлагает несколько способов синхронизации переносимых объектов.
Первый из них - по уникальному идентификатору. Многие объекты обладают уникальным идентификатором, который гарантирует уникальность в пределах таблицы. Например, в справочнике “Контрагенты ” не может быть двух элементов с одинаковыми идентификаторами. КД делает на это расчет и для всех создаваемые ПКО сразу по умолчанию включается поиск по идентификатору. Во время создания ПКО вы должны были обратить внимание на изображение лупы возле имени объекта.
Синхронизировать по уникальному идентификатору - способ надежный, но уместен он далеко не всегда. При объединении справочников “Контрагенты ” (из нескольких разных систем) он мало, чем поможет.
В таких случаях правильней синхронизировать объекты по нескольким критериям. Контрагентов правильней искать по ИНН, КПП, Наименованию или разбивать поиск на несколько этапов.
Конвертация данных не ограничивает разработчика в определении критерием поиска. Рассмотрим абстрактный пример. Пусть нам требуется синхронизировать справочники “Контрагенты ” из разных информационных баз. Подготовим ПКО и в настройках правил конвертации объекта установим флажок “Продолжить поиск полям поиска, если по идентификатору объект приемник не найден ”. Этим действием мы сразу определи два критерия поиска - по уникальному идентификатору и произвольным полям.
Поля мы вправе выбирать сами. Отметив ИНН, КПП, Наименование мы сразу укажем несколько критериев поиска. Удобно? Вполне, но опять же этого бывает мало. А что ели мы захотим изменять критерии поиска? Например, сначала ищем по связке ИНН+КПП, а если ничего не находим, то начинаем пытать счастье с наименованием.
Подобный алгоритм реализовать вполне по силам. В обработчике события “Поля поиска ” мы можем указать до 10 критериев поиска и для каждого из них определить свой состав полей поиска:
Если НомерВариантаПоиска = 1 тогда СтрокаИменСвойствПоиска = “ИНН, КПП”; ИначеЕсли НомерВариантаПоиска = 2 Тогда СтрокаИменСвойствПоиска = “Наименование”; КонецЕсли;
Решений всегда несколько
Любая задача имеет несколько решений и перенос данных между различными конфигурациями не исключение. Каждый разработчик вправе выбирать свой путь решения, но если вам постоянно приходится разрабатывать сложные миграции данных, то настоятельно рекомендую обратить внимание на конфигурацию “”. Пусть вначале придется инвестировать ресурсы (время) в обучение, но они с лихвой окупятся на первом более-менее серьезном проекте.
На мой взгляд, компания 1С незаслуженно обходит тему применения конвертации данных. За все время существования технологии, по ней вышла всего одна книга: “1С:Предприятие 8. Конвертация данных: обмен между прикладными решениями ”. Книга достаточно старая (2008 г.), но ознакомиться с ней все же желательно.
Знание платформ все же необходимо
» - универсальный инструмент, но если вы планируете применять его для создания миграций данных с конфигураций, разработанных для платформы 1С:Предприятие 7.7, то вам придется потратить время на знакомство со встроенным языком. Синтаксис и идеология языка сильно отличается, поэтому придется потратить время на изучение. В остальном принцип остается тем же.