Обмен через универсальный формат. Обмен через универсальный формат Подготовительные действия для настройки обмена в БП

27.08.2015

Фирма "1С" выпустила первую версию нового формата обмена бизнес-данными EnterpriseData, базирующегося на XML. Формат позволяет эффективно организовать обмен данными между разнородными системами автоматизации бизнеса, использующимися в компании, независимо от того, кто является их разработчиком и для каких сфер деятельности они предназначены.

Выпуск стандарта стал для фирмы "1С" очередным шагом на пути повышения открытости своих продуктов для интеграции с ПО сторонних производителей. Фирма "1С" всегда уделяла особое внимание этому направлению. Продукты "1С" поддерживают формат CommerceML , используемый для обмена коммерческой информацией в формате XML. Заслуживает отдельного упоминания формат обмена финансовыми документами между системой "1С:Предприятие" и модулями систем дистанционного банковского обслуживания ("Клиент-банк"), разработанный фирмой "1С" совместно c ведущими разработчиками информационных банковских систем. Этот формат, который поддерживают на сегодня сотни российских банков (включая Сбербанк России, ВТБ 24, Газпромбанк, Россельхозбанк) стал, по сути, стандартом индустрии. Дальнейшее развитие это направление получило в технологии прямого обмена DirectBank , делающей взаимодействие с банком из 1С:Предприятие еще более удобным и безопасным.

При этом ранее форматы, поддерживаемые "1С", служили в основном для решения задач по обмену данными между разными организациями только в определенных областях деятельности (электронная коммерция, интеграция с банковскими системами). Теперь новый формат EnterpriseData покрывает все сферы деятельности предприятия - финансы, производство, закупки и продажи, складские операции и т.п. Первая версия формата включает в себя описание 94 типов документов из различных областей бизнеса. Формат является расширяемым, фирма "1С" будет добавлять в него новые документы и детализировать существующие.

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

В настоящее время формат Enterprise Data уже применяется для синхронизации данных между программными продуктами самой фирмы "1С", он поддерживается в продуктах:

• 1C:ERP Управление предприятием 2.0
• 1С:Бухгалтерия 8, редакция 3.0
• 1С:Бухгалтерия 8 КОРП, редакция 3.0
• 1С:Розница, редакция 2.0
• 1С:Управление торговлей, редакция 11

Одним из наиболее распространенных случаев интеграции продуктов "1С" является тандем "1С:Бухгалтерия" - "1С:Управление торговлей"; эти два популярных продукта компании обмениваются 73 типами документов в формате EnterpriseData, что позволяет поддерживать их данные в актуальном, синхронизированном между собой состоянии. Разработчики фирмы "1С" отмечают, что принятие формата EnterpriseData позволило повысить качество и скорость разработки прикладных решений системы "1С:Предприятие" за счет унификации кода.

Для сторонних продуктов, интегрирующихся с продуктами "1С", использование формата позволит снизить как объем разработки, так и трудозатраты на внедрение и поддержку систем. Раньше, когда каждый продукт поддерживал свой формат обмена данными, при наличии в системе обмена данными N продуктов добавление нового продукта требовало 2*N изменений (см рис.1); каждый существующий продукт нуждался в изменениях, чтобы поддержать импорт данных из нового продукта, и новый продукт должен был поддержать импорт данных из существующих продуктов. После введения единого формата добавление нового продукта потребует лишь реализации в нем импорта и экспорта в формате EnterpriseData и не вызовет изменений в существующих продуктах.

Рисунок 1 Обмен данными в отсутствие единого формата

Рисунок 2 Обмен данными через формат EnterpriseData

Формат поддерживает совместимость "снизу вверх" - все программы сторонних производителей, обменивающихся данными в формате EnterpriseData с ПО фирмы "1С", при выходе новых версий формата продолжат работу.

• для интеграции собственных разработок на платформе "1С:Предприятие" (как заказных, так и тиражных) с типовыми решениями 1С
• для интеграции других (не-1С) систем с решениями на платформе 1С:Предприятие
• для организации взаимодействия других (не-1С) систем между собой.

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

Компания уже давно практикует создание и использование открытых стандартов для информационного взаимодействия своих приложений с ПО независимых разработчиков, но до сих пор это касалось только отдельных специализированных предметных направлений. Именно таким является созданный почти пятнадцать лет назад формат CommerceML для решения задача электронной коммерции, а также «Клиент-банк» и DirectBank для общения приложений «1С» с внешними банковскими системами. EnterpriseData же представляется собой именно универсальный механизм, которые способен покрыть все сферы деятельности предприятия - финансы, производство, закупки и продажи, складские операции и т. п. Первая версия формата включает в себя описание 94 типов документов из различных областей бизнеса. «1С» планирует добавлять в него новые документы и детализировать существующие.

Как поясняют представители «1С», появление EnterpriseData объясняется необходимостью не только интеграции приложений фирмы в ПО других разработчиков, но и - возможно даже в первую очередь - создания унифицированного механизма информационного общения внутри семейства ПО «1С:Предприятие». До недавнего времени для решения этих задач использовался широкий спектр решений, часто создаваемых для каждого конкретного случая. Перевод продуктов «1С» на EnterpriseData уже начался, он применяется во всех последних версиях ее ключевых приложений («1C:ERP Управление предприятием 2.0», «1С:Бухгалтерия 8» 3.0, «1С:Бухгалтерия 8 КОРП» 3.0, «1С:Розница» 2.0, «1С:Управление торговлей» 11). В то же время, замена уже используемых стандартов (CommerceML, работа с банками) на EnterpriseData не предполагается, поскольку проверенные временем специализированные алгоритмы работают более эффективно, чем универсальные средства.

«1С» полагает, что новый формат найдет широкое применение среди независимых разработчиков, создающих приложения на платформе «1С:Предприятие», для них предлагаются готовые программные компоненты в составе Библиотеки стандартных подсистем (что-то вроде SDK для «1С:Предприятия»).

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

«1С» обещает дальнейшее развитие формата EnterpriseData и его поддержку во все большем количестве своих приложений. Этот стандарт будет находиться под управлением самой фирмы, никаких планов о его преобразовании в независимый отраслевой стандарт у его создателей пока нет.

Цель данной статьи - ответить на первые вопросы по КД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?

1. Доработать модуль с правилами обмена прямо в конфигурации. Этот вариант пока не рассматриваем, т.к. для понимания что и где нужно менять, необходимо хотя бы один раз сделать это в КД3. В этом случае будет проще в будущем оперативно решать проблемы, отлаживать в модуле и переносить в КД3 при необходимости.
2. Воспользоваться КД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\1.3 »

• Файл с модулем обмена: «D:\Правила БП3\БП 3.0.54.15\Общий модуль МенеджерОбменаЧерезУниверсальныйФормат13_ Модуль.txt »
• Конвертация: «БП 3.0.54.15 »

При загрузке правил синхронизации из файлов для УТ 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 можно установить в конфигурацию тремя способами

1. Снять конфигурацию с поддержки и внести изменения в общий модуль МенеджерОбменаЧерезУниверсальныйФормат ;
2. На конфигурациях, работающих в режиме совместимости с платформой 8.3.10 и выше можно вносить исправления в общий модуль с помощью расширения.
3. Подключить расширение, которое полностью подменяет общий модуль с правилами.
4. Не снимая конфигурацию с поддержки подключить к узлу внешнюю обработку с правилами;

С первым вариантом всё понятно, он описан в документации, недостаток - нужно снимать конфигурацию с поддержки. Второй вариант - исправление выбранной процедуры расширением тоже не составит труда для программиста 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 |Процедура: ПолучитьВерсииФорматаОбмена(<ВерсииФорматаОбмена>)""), УзелИнформационнойБазы.Метаданные().Имя); КонецЕсли; Результат = Новый Соответствие; Для Каждого Версия Из ВерсииФорматаОбмена Цикл Результат.Вставить(СокрЛП(Версия.Ключ), Версия.Значение); КонецЦикла; Возврат Результат; КонецФункции

Как выполнять отладку правил во внешней обработке

В конфигураторе "Сервис -> Параметры -> Запуск 1С:Предприятия -> Параметр запуска ", указать параметр " ".

• Ниже приведён код для расширения, для УТ 11.4, КА 2.4, ERP 2.4. Код для БП 3.0 приведён выше. Модуль менеджера плана обмена СинхронизацияДанныхЧерезУниверсальныйФормат.

Код расширения 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.

Сэкономить время и воспользоваться готовыми правилами для последних версий конфигураций можно здесь

• - расширенный функционал, исправления замеченных ошибок.

Печать (Ctrl+P)

Обмен через универсальный формат

Подсистема «Обмен данными» библиотеки стандартных подсистем содержит 4 варианта (технологии) обмена информацией между различными информационными базами:

• распределенные информационные базы (РИБ);
• обмен данными через универсальный формат;
• обмен данными по правилам обмена (правила обмена создаются при помощи конфигурации «Конвертация данных», редакция 2.1);
• обмен данными без правил обмена.

В этой статьи рассматривается технология обмена данными через универсальный формат EnterpriseData . Данная технология доступна в “Библиотеке стандартных подсистем”, начиная с версии 2.3.1.62. выпущенной в начале 2016 году. На текущий момент, последняя редакция БСП 2.3 (для использования с платформой “1С:Предприятие 8.3” не ниже версии 8.3.8.1652 с отключенным режимом совместимости) имеет релиз 2.3.6.17 .

Рис. 1 Последние релизы БСП 2.3

Среди файлов поставки прикладных решений 1С имеется текстовый файл “Версии библиотек”, где написана на базе какой версии БСП разработано приложение, например, на основе прикладного решения УТ 11.3.3.231 легло БСП 2.3.5.65.

Отметим, что для использования с платформой “1С:Предприятие 8.3” не ниже версии 8.3.10.2168 с отключенным режимом совместимости выпущена редакция БСП 2.4.

Описание формата EnterpriseData

Что такое формат EnterpriseData ?

Это формат, позволяющий описать объект информационной базы (контрагента, накладную и т.п.) или сообщить о факте удаления этого объекта. Ожидается, что конфигурация, получившая файл в формате EnterpriseData, отреагирует соответствующим образом – создаст у себя новые объекты и удалит те, которые в файле помечены как удаленные. Он предназначен для обмена информацией между конфигурациями УТ, РТ, УНФ, БП. Также формат может использоваться для обмена информацией с любыми другими информационными системами: он не зависит от особенностей собственного программного обеспечения или структур информационных баз, которые участвуют в обмене и не содержит в себе явных ограничений использования.

Версия формата EnterpriseData

Данные формата хранятся в XDTO – пакетах в ветки общие конфигурации базы данных, как показано на рис. 2

На рис. 2 видно, что существуют несколько XDTO – пакетов. Это разные версии формата. Номер версии формата состоит из X.Y.Z, где X.Y – версия, Z – это Minor версия. Minor версия увеличивается в случае исправления ошибок и прочих изменениях, при которых: сохраняется работоспособность логики конвертации данных, основанной на предыдущей версии формата (сохранение обратной совместимости текущих алгоритмов передачи данных через формат); поддержка новых возможностей формата для логики конвертации носит добровольный характер. Примером таких изменений может быть исправление ошибки, изменения свойств объектов формата, добавление свойств, использование которых при конвертации данных не является обязательным. В остальных случаях при изменении формата увеличивается Major версия: X – в случае глобальной реструктуризации, Y – в остальных случаях.
Формат описывает представление объектов (документов или элементов справочников) в виде XML-файлов. Версия 1.0.1 содержит описание 94-х объектов из различных областей (финансы, производство, закупки и продажи, складские операции). Названия типов, как правило, хорошо понятны и не нуждаются в дополнительных объяснениях: например, «Документ.АктВыполненныхРабот» или «Справочник.Контрагенты». Как можно заметить, описание типов документов начинается с префикса «Документ.», элемента справочника – с префикса «Справочник.». Подробнее описание формата можно посмотреть
Последняя версия 1.3, однако, чаще всего используется версия 1.0. Нет большой разницы между версиями. Формат EnterpriseDataExchange_1_0_1_1 используется при обмене через веб-сервис.
Отметим, что вместе с пакетом формата данных EnterpriseData используется пакет ExchangeMessage при создании правилах конвертации. Именно этот пакет содержит тип объект AdditionalInfo, который может иметь любой тип значения и используется при при создании правила конвертации между объектами конфигураций. которые отсутствуют в формате данных. Именно, благодаря AdditionalInfo, можно адаптировать и настраивать правила обмена без изменения данных формата в XDTO-пакетах.

Как обмениваться данными в формате EnterpriseData?

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

• через выделенный файловый каталог,
• через каталог FTP,
• через веб-сервис, развернутый на стороне информационной базы. Файл с данными передается как параметр веб-методов.

Примечание . Для двустороннего обмена данными между сторонним приложением и конфигурацией на стороне информационной базы должен быть сделан ряд настроек – стороннее приложение должно быть зарегистрировано в информационной базе, для него должен быть определен канал обмена (через файловый или FTP-каталог) и т.п. Но для случаев простой интеграции, когда достаточно только передавать информацию от стороннего приложения в информационную базу и обратной передачи данных из информационной базы в стороннее приложение не требуется (например, интеграция онлайн-магазина, передающего информацию о продажах в «1С:Бухгалтерию»), есть упрощенный вариант работы через веб-сервис, не требующий настроек на стороне.

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

Следующий шаг за сторонним приложением – оно должно обработать информацию из XML-файла и при следующем сеансе синхронизации поместить в секцию информацию, что сообщение от конфигурации за определенным номером успешно принято (поместить в поле ReceivedNo номер полученного от конфигурации сообщения). Сообщение-квитанция является для конфигурации сигналом, что все объекты успешно обработаны внешним приложением и информацию о них передавать больше не нужно. Помимо квитанции XML-файл от стороннего приложения также может содержать данные для синхронизации (в секции ).

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

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

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

Более подробно об обмен данными с прикладными решениями на платформе «1С:Предприятие» в формате EnterpriseData можно посмотреть

Общий модуль “менеджера обмена через универсальный формат”.

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

Модуль создается автоматически с помощью конфигурации «Конвертация данных», редакция 3.0, на основе настроенных правил обмена либо вручную в конфигураторе.

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

1. Комментарий. Первая строка модуля содержит комментарий с наименованием конвертации. Эта строка необходима для идентификации модуля при использовании команды в программе «Конвертация данных», редакция 3.0., например. // Конвертация УП2.2.3 от 01.06.2017 19:51:50
2. Процедуры конвертации . Содержит предопределенные процедуры, которые выполняются на разных этапах синхронизации данных: перед конвертацией, после конвертации, перед отложенным заполнением.
3. Правила обработки данных (ПОД) . Содержит процедуры и функции, которые описывают правила обработки данных.
4. Правила конвертации объектов (ПКО) . Содержит процедуры и функции, которые описывают правила конвертации объектов, а также правила конвертации свойств данных объектов.
5. Правила конвертации предопределенных данных (ПКПД). Содержит процедуру, заполняющую правила конвертации предопределенных данных.
6. Алгоритмы . Содержит произвольные алгоритмы, которые вызываются из других правил (ПОД или ПКО).
7. Параметры. Содержит логику заполнения параметров конвертации.
8. Общего назначения . Содержит процедуры и функции, которые широко используются в правилах и алгоритмах.

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

КомпонентыОбмена. Тип – Структура . Содержит параметры и правила обмена, инициализированные в рамках выполнения сеанса обмена.

НаправлениеОбмена. Тип – Строка . Либо «Отправка», либо «Получение».

ДанныеИБ. Тип – СправочникОбъект либо ДокументОбъект .

Процедуры, связанные с событиями конвертации

Предусмотрены три предопределенные процедуры, которые вызываются в процессе конвертации:

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

Процедуры ПОД

ЗаполнитьПравилаОбработкиДанных. Экспортная процедура, в которой располагается логика заполнения правил обработки данных. Содержит вызовы других процедур, которые добавляют в таблицу правил правило обработки конкретного объекта (см. ниже процедуры ДобавитьПОД ). Параметры: НаправлениеОбмена , ПравилаОбработкиДанных

ДобавитьПОД_<ИмяПОД>. Набор процедур, которые наполняют таблицу ПОД правилами для конкретных объектов. Количество таких процедур соответствует количеству ПОД, предусмотренных для данной конвертации в программе «Конвертация данных», редакция 3.0. Параметры: ПравилаОбработкиДанных (таблица значений, инициализированная в рамках выполнения сеанса обмена).

ПОД_<ИмяПОД>_ПриОбработке. Процедура содержит текст обработчика ПриОбработке для конкретного ПОД. Обработчик предназначен для реализации логики конвертации на уровне объектов. Например, назначить конкретному объекту определенное ПКО в зависимости от содержимого объекта. Параметры:

• ДанныеИБ либо ДанныеXDTO (в зависимости от направления обмена):
• при отправке – объект (СправочникОбъект ,ДокументОбъект );
• при получении – структуру с описанием объекта XDTO.
• ИспользованиеПКО . Тип –Структура . Ключ содержит строку с именем ПКО, а значение типа Булево (Истина – ПКО используется, Ложь – ПКО не используется).
• КомпонентыОбмена .

ПОД_<ИмяПОД>_ВыборкаДанных. Функция содержит текст обработчика ПриВыгрузке . Обработчик предназначен для реализации произвольного алгоритма выборки объектов, подлежащих выгрузке. Возвращаемое значение: массив объектов, подлежащих выгрузке. В массиве могут содержаться как ссылки на объекты информационной базы, так и структура с данными для выгрузки. Параметры: КомпонентыОбмена .

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

ЗаполнитьПравилаКонвертацииОбъектов. Экспортная процедура, в которой располагается логика заполнения правил конвертации объектов. Содержит вызовы других процедур, которые добавляют в таблицу правил правило конвертации конкретного объекта (см. ниже процедуры ДобавитьПКО ). Параметры: НаправлениеОбмена , ПравилаКонвертации (таблица значений, инициализированная в рамках выполнения сеанса обмена).

ДобавитьПКО_<ИмяПКО>. Набор процедур, которые наполняют таблицу ПКО правилами для конкретных объектов. Количество таких процедур соответствует количеству ПКО, предусмотренных для данной конвертации в программе «Конвертация данных», редакция 3.0. Параметры: ПравилаКонвертации (таблица значений, инициализированная в рамках выполнения сеанса обмена).

ПКО_<ИмяПКО>_ПриОтправкеДанных. Процедура содержит текст обработчика ПриОтправке для конкретного ПКО. Обработчик используется при выгрузке данных. Предназначен для реализации логики конвертации данных, содержащихся в объекте информационной базы, в описание объекта XDTO. Параметры:

• ДанныеИБ . Тип –СправочникОбъект , ДокументОбъект . Обрабатываемый объект информационной базы.
• ДанныеXDTO . Тип –Структура . Предназначен для доступа к данным объекта XDTO.
• КомпонентыОбмена .
• СтекВыгрузки . Тип –Массив . Содержит ссылки на выгружаемые объекты с учетом вложенности.

ПКО_<ИмяПКО>_ПриКонвертацииДанныхXDTO. Процедура содержит текст обработчика ПриКонвертацииДанныхXDTO для конкретного ПКО. Обработчик используется при загрузке данных. Предназначен для реализации произвольной логики конвертации данных XDTO. Параметры:

• ДанныеXDTO . Тип –Структура . Свойства объекта XDTO, прошедшие предварительную обработку для упрощения доступа к ним.
• ПолученныеДанные . Тип –СправочникОбъект , ДокументОбъект . Объект информационной базы, сформированный путем конвертации данных XDTO. Не записан в информационную базу.
• КомпонентыОбмена .

ПКО_<ИмяПКО>_ПередЗаписьюПолученныхДанных. Процедура содержит текст обработчика ПередЗаписьюПолученныхДанных для конкретного ПКО. Обработчик используется при загрузке данных. Предназначена для реализации дополнительной логики, которую необходимо выполнить перед записью объекта в информационную базу. Например, нужно ли загрузить изменения в существующие данные ИБ либо следует загрузить их как новые данные. Параметры:

• ПолученныеДанные . Тип –СправочникОбъект , ДокументОбъект . Элемент данных, сформированный путем конвертации данных XDTO.

Записывается в случае, если эти данные являются для информационной базы новыми (параметр ДанныеИБ содержит значение Неопределено ).

В противном случае ПолученныеДанные замещают собой ДанныеИБ (все свойства из ПолученныеДанные переносятся в ДанныеИБ ).

Если стандартное замещение данных ИБ полученными данными не требуется, следует прописать свою логику переноса, после чего установить параметру ПолученныеДанные значение Неопределено :

• ДанныеИБ . Тип –СправочникОбъект , ДокументОбъект . Элемент данных информационной базы, соответствующий полученным данным. Если соответствующие данные не найдены, содержит Неопределено .
• КонвертацияСвойств . Тип –Таблица значений . Содержит правила конвертации свойств текущего объекта, инициализированные в рамках выполнения сеанса обмена.
• КомпонентыОбмена .

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

ЗаполнитьПравилаКонвертацииПредопределенныхДанных . Экспортная процедура, в которой располагается логика заполнения правил конвертации предопределенных данных. Параметры: НаправлениеОбмена , ПравилаКонвертации (таблица значений, инициализированная в рамках выполнения сеанса обмена).

Алгоритмы

В программе «Конвертация данных», редакция 3.0 есть возможность создавать произвольные алгоритмы, которые вызываются из обработчиков ПОД и ПКПД. Наименование, параметры и содержимое алгоритмов определяются при разработке правил.

Параметры

ЗаполнитьПараметрыКонвертации. Экспортная процедура, в которой происходит заполнение структуры с параметрами конвертации. Параметры: ПараметрыКонвертации (тип – Структура ).

Процедуры и функции общего назначения

ВыполнитьПроцедуруМодуляМенеджера. Параметры: ИмяПроцедуры (строка), Параметры (структура). Экспортная процедура, которая предназначена для вызова неэкспортной процедуры модуля, имя и параметры которой получены на вход. Позволяет выполнить вызов процедуры или функции по строке без использования метода Выполнить .

ВыполнитьФункциюМодуляМенеджера. Параметры: ИмяПроцедуры (строка), Параметры (структура). Функция, назначение аналогично ВыполнитьПроцедуруМодуляМенеджера . Отличие в том, что она вызывает функцию и возвращает ее значение.

Отправить эту статью на мою почту

Основные причины потребности внедрения обмена между базами 1С - это наличие филиалов и разделение видов учета, т.к. зачастую компании работают в нескольких информационных базах. Настройка обмена 1С 8.3 позволяет исключить ведение двойной работы – ввода одних и тех же документов и справочников в двух программах, а так же оперативно поставлять нужные объекты системы для различных филиалов и отделов.

В случае, когда нужно осуществлять обмен между филиалами, используется РИБ (Распределенная информационная база). Это механизм обмена между идентичными конфигурациями. Он представляем собой дерево, сверху которой находится самый главный корневой узел, ниже пары связанных между собой узлов. Вносить изменения можно в любом узле этой системы, и они будут переданы другим связанным узлам. Выполняется так же распространение не только данных, но и изменений конфигурации от корневого узла к подчиненным.

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

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

Реализацию обмена данными на предприятии можно представить в виде последовательных процедур.

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

Затем выбираем подходящий формат: РИБ, универсальный формат; обмен по правилам обмена; обмен без правил обмена.

Следующим шагом будет выбор транспорта для выполнения обмена. Доступен большой выбор технологий, выделим основные: каталог (локальный или сетевой), FTP-ресурс, COM соединения, веб-сервис, электронная почта.

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

И в заключении прописывается расписание периодичности обмена

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

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

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

Ниже приведем подробный пример настройки обмена 1С 8.3 в одностороннем порядке между типовыми конфигурациями Управление торговлей 11 (УТ) и Бухгалтерия предприятия 3.0 (БП). Пример актуален для многих компаний ведущих оптовую и розничную торговлю. В УТ ведется управленческий учет, в БП - регламентированный, обмен необходим для облегчения работы пользователей.

Такой алгоритм подходят и для других типовых конфигураций на платформе 1С 8.3

В первую очередь проведем подготовительную работу для приемника информации, т.е. для БП. Запускаем программу в режиме Предприятие. Надо установить константу Синхронизация данных (раздел Администрирование → Синхронизация данных).

Обратите внимание на поле Префикс, здесь требуется указать значение, которое позволит впоследствии различить (по значению кода справочника или номеру документа) в какой программе изначально были созданы объекты. В нашем примере подойдет обычное сокращение – БП и УТ, если настройка обмена 1С 8.3 выполняется для сложного обмена между большим количеством баз, а так же одинаковых конфигураций потребуется ввести каждой базе свое понятное обозначение.

Так как БП является только приемником информации, переходим к настройке УТ.

Здесь, так же как и в БП требуется включить синхронизацию и указать префикс. Доступны эти сведения в разделе НСИ и администрирование → Настройки синхронизации данных.

Выбираем способ настройки Указать настройки вручную. Далее.

Установим вариант прямого подключения, когда обе программы расположены в одной локальной сети, укажем параметры подключения к каталогу ИБ в этой сети, а так же заполним аутентификационные сведения о пользователе (в базе БП). Далее.

Система проверит правильность указанных данных и в случае положительного результата выведет окно настройки обмена 1С 8.3.

По ссылке Изменить правила выгрузки данных доступны настройки выполнения обмена. Внесем уточнения НСИ – выгружать только используемые в документах, выберем организации и вариант работы с договорами - без привязки, разделение документов в разрезе складов. Начало обмена с 1 марта текущего года.

Внесенные правила записываем и закрываем.

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

Теперь надо проверить введенные параметры и если они верны нажать Далее, в противном случае вернуться к предыдущему шагу нажав Назад.

Затем будет предложено провести синхронизацию. Жмем Готово.

При необходимости выполнить соотнесение одинаковых объекты двух конфигураций откроется окно для сопоставления данных. Выполняем сопоставление и жмем Далее.

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

После выполнения синхронизации будет выведено окно с подтверждением успешного завершения этого процесса.

Здесь же по команде Настроить или после, в сценарии синхронизации можно настроить расписание автоматического выполнения обмена.

Нужно настроить обмен данными?

15 ЛЕТ ПРОГРАММИРУЕМ 1С И ДЕЛАЕМ БЕСПЛАТНЫЕ ВИДЕО-ИНСТРУКЦИИ

У нас команда программистов, которые обладают большим опытом в настройке обмена 1С:

Между конфигурациями 1С,

В настройке обмена 1С с другими программами.

Почему выбирают нас?

До 2-х часов время реакции на срочные задачи, даже в выходные и праздничные дни.

40+ штатных программистов с опытом работы в «1С» от 5 до 20 лет.

Делаем видео-инструкции по выполненным задачам.

Живое общение через любые удобные клиенту мессенджеры.

99% задач выполняется через удаленный доступ (TeamViewer или RDP), что значительно сокращает время выполнения задач.

Официальные партнеры фирмы «1С» с 2006 года.

Опыт успешной автоматизации от небольших фирм, до больших корпораций.

99% клиентов довольны результатами, что подтверждается благодарственными письмами.