Добавление своего нового объекта в синхронизацию данными через универсальный формат Enterprise Data

27.01.23

Интеграция - Обмен между базами 1C

Добавление своего нового объекта в синхронизацию данными через универсальный формат Enterprise Data, не снимая (или снимая) конфигурацию с поддержки.

Итак, у нас есть "стандартный" обмен между 1С:Комплексная автоматизация 2 (2.5.10.74) и Комплексная автоматизация, редакция 1.1 (1.1.40.2), во второй конфигурации, понятно, обмен был допилен с помощью кода из УПП и КА2. Обмен работает, нужно добавить в него новый документ.

Видится два способа реализации:

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

2. Добавление нового типа в пакет XDTO.

Второй вариант и будем рассматривать. Он имеет подварианты:

2.1 Просто добавить тип в существующий пакет. В КА1 на этом можно было бы остановиться, так как что такое поддержка, она уже не помнит, однако разрешать изменения пакета в КА2 конечно не хочется.

2.2 Напрашивается вариант добавить пакет в расширение, но, к сожалению, мы попали не в тот год, и такой маневр невозможен (как минимум, в платформе 8.3.19.1399).

2.3 Скопировать пакет, повысить версию и как-то заставить платформу использовать его

Тут я остановился на третьем варианте но внезапно, при ковырянии в коде, обнаружилось, что в КА2 есть поддержка добавления новых пакетов в обмен!

И вот у нас вариант 2.4: использование дополниельного XDTO-пакета в расширении (можно и в основной конфигурации, это гораздо проще!).

Порядок действий довольно прост:

1. Придумаем пространство имен. Пусть будет http://my.name/EnterpriseData/1.8.6.1 (тут не важно, как назовём)

2. В процедуре ОбменДаннымиПереопределяемый.ПриПолученииДоступныхРасширенийФормата(РасширенияФормата) добавим наше пространство имен:
РасширенияФормата.Вставить("http://my.name/EnterpriseData/1.8.6.1", "1.8")
второй аргумент - это версия формата, для которой используется расширение формата, у меня 1.8. Если делаем в расширении - то заимствуем эту процедуру в расширение.

3. Если мы в расширении - то нужно заимствовать в расширение все типы нашего базового пакета, которые мы собираемся использовать, это самый муторный момент:

 





Если же мы делаем это в основной конфигурации, то этот шаг пропускаем - именно поэтому в основной конфигурации добавлять пакет проще. Вторая справа кнопка - проверка пакета. Проверка должна проходить без ошибок.

4. Добавляем новый пакет и импортируем в него используемые пакеты. Теперь в нём можно использовать типы из этих пакетов. Встроенные типы, понятно, можно использовать и так:

 

 

Здесь почти все свойства имеют типы пакета EnterpriseData 1.8:


 

5. Теперь добавляем процедуры ДобавитьПОД_..., ДобавитьПКО_... и обработчики.

В добавлении ПКО нужно указать, что это объект из расширения формата:

Процедура ДобавитьПКО_Документ_ОрдерНаОтражениеПересортицыТоваров_Отправка(ПравилаКонвертации) Экспорт
	
	ПравилоКонвертации = ОбменДаннымиXDTOСервер.ИнициализироватьПравилоКонвертацииОбъекта(ПравилаКонвертации);
	ПравилоКонвертации.ИмяПКО                       = "_ПКО_Документ_ОрдерНаОтражениеПересортицыТоваров_Отправка";
	ПравилоКонвертации.ОбъектДанных                 = Метаданные.Документы.ОрдерНаОтражениеПересортицыТоваров;
	ПравилоКонвертации.ОбъектФормата                = "_Документ.ОрдерНаОтражениеПересортицыТоваров";
	ПравилоКонвертации.ПриОтправкеДанных 			= "_ПКО_Документ_ОрдерНаОтражениеПересортицыТоваров_Отправка_ПриОтправкеДанных";
	ПравилоКонвертации.ПространствоИмен 			= "http://my.name/EnterpriseData/1.8.6.1";
	ОбменДаннымиXDTOСервер.ИнициализироватьРасширениеПравилаКонвертацииОбъекта(ПравилоКонвертации, ПравилоКонвертации.ПространствоИмен);
	
	СвойстваШапки = ПравилоКонвертации.Свойства;
	ДобавитьПКС(СвойстваШапки, "Дата",               "Дата");
	ДобавитьПКС(СвойстваШапки, "Комментарий",        "Комментарий");
	ДобавитьПКС(СвойстваШапки, "Номер",              "Номер");
	ДобавитьПКС(СвойстваШапки, "Ответственный",      "Ответственный", , "Справочник_Пользователи");
	ДобавитьПКС(СвойстваШапки, "Склад",              "Склад", , "Справочник_Склады_Отправка");
	ДобавитьПКС(СвойстваШапки, "",				   "Организация", 1, "Справочник_Организации_Отправка");
	
	СвойстваТЧ = ДобавитьПКТЧ(ПравилоКонвертации, , "Товары");
    ДобавитьПКС(СвойстваТЧ, , "НомерСтроки");
	ДобавитьПКС(СвойстваТЧ, , "Номенклатура", 1, "Справочник_Номенклатура_Отправка");
	ДобавитьПКС(СвойстваТЧ, ,	"Качество", 1);
	ДобавитьПКС(СвойстваТЧ, , "КачествоНовое", 1);
	ДобавитьПКС(СвойстваТЧ, , "ЕдиницаИзмерения", 1, "Справочник_ЕдиницыИзмерения");
	ДобавитьПКС(СвойстваТЧ, , "Количество", 1);

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

 

Еще нужно подумать о регистрации объекта к обмену - то есть, его нужно добавить в план обмена, в обработчики (в моём случае это СинхронизацияДанныхЧерезУниверсальныйФорматРегистрацияДокумента)
 

Важно: чтобы объект выгрузился, нужно, чтобы узел-приёмник поддерживал получение такого типа. То есть, пока на стороне приемника не добавлены ПОД и ПКО, выгрузка самого объекта не произойдёт!

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

В итоге объект выгружается, теперь в файле обмена два пространства имён:

    <msg:ObjectType>
        <msg:Name>_Документ.ОрдерНаОтражениеПересортицыТоваров</msg:Name>
        <msg:Sending>*</msg:Sending>
        <msg:Receiving/>
    </msg:ObjectType>
....
	<Body xmlns="http://v8.1c.ru/edi/edi_stnd/EnterpriseData/1.8" xmlns:ext1="http://my.name/EnterpriseData/1.8.6.1">
		<ext1:_Документ.ОрдерНаОтражениеПересортицыТоваров>
			<ext1:КлючевыеСвойства>
				<ext1:Дата>2023-01-24T15:27:04</ext1:Дата>
				<ext1:Номер>ЦБ-00000001</ext1:Номер>
				<ext1:Организация>
					<Ссылка>e273e630-5669-11e7-b7d7-005056b63591</Ссылка>
					<Наименование>ОНЛАЙН ДОЗОР ООО (с 14.06.17)</Наименование>
					<НаименованиеСокращенное>ООО "ВЕКТОР"</НаименованиеСокращенное>
					<НаименованиеПолное>Общество с ограниченной ответственностью "ВЕКТОР"</НаименованиеПолное>
					<ИНН>7205356421</ИНН>
					<КПП>720501001</КПП>
					<ЮридическоеФизическоеЛицо>ЮридическоеЛицо</ЮридическоеФизическоеЛицо>
				</ext1:Организация>
			</ext1:КлючевыеСвойства>
...

Что интересно, если не указать своё пространство имён в списке расширений формата, то у нового объекта не будет указано пространство имён, а его вложенных свойств, которые заимствованы из пакета EnterpriseData 1.8, наоборот, будет.

После доработки на стороне КА1 такой файл корректно загружается и все механизмы работают в штатном режиме.

У меня пока нет необходимости делать обмен в обратную сторону, вероятно, потребуются еще какие-то доработки в КА1.

Никакого кода не выкладываю, потому что если у вас актуальная БСП, то код в ней уже есть, а если у вас какое-то легаси, то как его обновлять - всё равно знаете только вы

Тестировалось на 1С:Комплексная автоматизация 2 (2.5.10.74) и доработанной Комплексная автоматизация, редакция 1.1 (1.1.40.2) на платформе 8.3.19.1399.

Обновление от 22.04.2023: Совсем забыл написать: почему-то при выгрузке файла обмена процесс построен таким образом, что настройки обмена переинициализируются и информация о расширении теряется, и новый объект не появляется в списке получаемых (Receiving). Чтобы появился, нужно добавить расширение в обработчике ПриПолученииНастроек в модуле менеджера плана обмена:
Настройки.РасширенияФорматаОбмена.Вставить("моё пространство имен/1.11.7.1", "1.11");

СинхронизацияДанныхЧерезУниверсальныйФормат обмен EnterpriseData конвертация данных бсп стандартные механизмы

См. также

SALE! 20%

Перенос данных из УПП 1.3 в ERP 2 / УТ 11 / КА 2. Переносятся документы, справочная информация и остатки

Обмен между базами 1C Платформа 1С v8.3 1С:Управление производственным предприятием 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Россия Платные (руб)

Перенос документов, начальных остатков и справочной информации из УПП 1.3 в ERP 2 | из УПП 1.3 в УТ 11 | из УПП в КА 2 | Правила конвертации (КД 2) в продаже с 2015 года, постоянно работаем над их развитием | Более 360 предприятий выполнили переход с использованием этого продукта! | Сэкономьте время - используйте готовое решение для перехода! | Позволяет перенести из УПП 1.3 в ERP / УТ 11 / КА 2 всю возможную информацию | В переносе есть фильтр по организации и множество других опциональных параметров выгрузки | Есть несколько алгоритмов выгрузки остатков на выбор

45650 36520 руб.

04.08.2015    159726    364    267    

345

SALE! 15%

[ED3] Обмен для ERP 2.5, КА 2.5, УТ 11.5 БП 3.0, Розница, УНФ и других с EnterpriseData (универсальный формат обмена), правила обмена

Обмен между базами 1C Файловый обмен (TXT, XML, DBF), FTP Платформа 1С v8.3 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Россия Платные (руб)

Правила в универсальном формате обмена для ERP 2.5, КА 2.5, УТ 11.5, БП 3.0, Розница, УНФ, для последних версий конфигураций. Ссылки на другие конфигурации в описании публикации. Правила совместимы со всеми другими версиями конфигураций новыми и старыми, поддерживающими обмен в формате EnterpriseData. Не требуется синхронного обновления правил после обновления другой конфигурации, участвующей в обмене. Типовой обмен через планы обмена кнопкой Синхронизация вручную или автоматически по расписанию, или вручную обработкой.

25080 22572 руб.

12.06.2017    134971    721    291    

388

SALE! 20%

Перенос данных из ERP 2 / КА 2 / УТ 11 в БП 3.0. Переносятся документы, начальные остатки и справочники

Обмен между базами 1C Файловый обмен (TXT, XML, DBF), FTP Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Россия Платные (руб)

Перенос данных из ERP в БП 3 | из КА 2 в БП 3 | из УТ 11 в БП 3 | из ЕРП в БП 3 | В продаже с 2019г. | Воспользовались более 176 предприятий! | Сэкономьте время - используйте готовое решение для перехода! | Перенос разработан в формате КД 2 (правила конвертации данных) | Переносятся все возможные виды документов, начальных остатков и нормативно-справочная информация| Можно опционально выгружать каждую пару "номенклатура+характеристика" как отдельную номенклатуру | Есть выгрузка настроек счетов учета и зарплатных данных из ERP / КА 2 | Можно проверить на вашем сервере перед покупкой, обращайтесь!

34650 27720 руб.

15.04.2019    68442    180    138    

111

SALE! 20%

Перенос данных из ERP 2 / КА 2 в ЗУП 3. Переносятся остатки, документы и справочники

Обмен между базами 1C Файловый обмен (TXT, XML, DBF), FTP Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Комплексная автоматизация 2.х 1С:Зарплата и Управление Персоналом 3.x Россия Бухгалтерский учет Управленческий учет Платные (руб)

Перенос данных из ERP в ЗУП 3 | из КА 2 в ЗУП | Воспользовались более 79 предприятий! | Предлагаем приобрести готовые правила конвертации данных (КД 2) для переноса остатков, документов с движениями и справочной информации 3 | В продаже с 2020г. | Оперативно обновляем правила до актуальных релизов 1С | Есть перенос начальной задолженности по зарплате и начальной штатной расстановки на выбранную дату | Обороты за прошлые годы (данные для расчета среднего) переносятся свернуто в документ "Перенос данных" | Есть фильтр по организациям | Документы за текущий период переносятся сразу с движениями, поэтому не потребуется делать перерасчеты | Перенос можно проверить перед покупкой, обращайтесь!

43450 34760 руб.

03.12.2020    34179    80    58    

78

SALE! 10%

Перенос данных из УТ 10.3 в УТ 11.5. Переносятся документы (обороты за период), справочная информация и остатки

Обмен между базами 1C Файловый обмен (TXT, XML, DBF), FTP Платформа 1С v8.3 Оперативный учет 1С:Управление торговлей 10 1С:Управление торговлей 11 Россия Управленческий учет Платные (руб)

Перенос данных из 1С:Управление торговлей 10.3 в 1С:Управление торговлей 11.5 с помощью правил обмена. Переносятся остатки, документы (обороты за период), справочная информация. Правила проверены на конфигурациях УТ 10.3 (10.3.87.x) и УТ 11.5 (11.5.16.x).

28000 25200 руб.

23.07.2020    46319    196    64    

158

Перенос данных из Парус 10 в ЗГУ ред.3

Внешние источники данных Кадровый учет Файловый обмен (TXT, XML, DBF), FTP Обмен между базами 1C Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бухгалтерский учет Бюджетный учет Платные (руб)

Обработка позволяет перенести кадровую информацию и данные по заработной плате, фактических удержаниях, НДФЛ, вычетах, страховых взносах из базы Парус 10 учреждений в конфигурацию 1С:Зарплата и кадры государственного учреждения ред. 3 (ЗГУ) и начать с ней работать с любого месяца года.

60000 руб.

05.10.2022    9217    9    8    

10

SALE! 10%

Перенос данных из УПП 1.3 в БП 3.0. Переносятся документы (обороты за период), справочная информация и остатки

Обмен между базами 1C Файловый обмен (TXT, XML, DBF), FTP Платформа 1С v8.3 1С:Управление производственным предприятием 1С:Бухгалтерия 3.0 Россия Бухгалтерский учет Управленческий учет Платные (руб)

Перенос данных из 1С:Управление производственным предприятием 1.3 в 1С:Бухгалтерия предприятия 3.0 с помощью правил обмена. Переносятся остатки, документы (обороты за период), справочная информация. Правила проверены на конфигурациях УПП 1.3 (1.3.223.x) и БП 3.0 (3.0.149.x). Правила подходят для версии ПРОФ и КОРП.

28000 25200 руб.

15.12.2021    20261    132    38    

90

SALE! 10%

Перенос данных из БП 3.0 в УТ 11 / КА 2 / ERP 2. Переносятся начальные остатки, документы и справочники

Обмен между базами 1C Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Россия Платные (руб)

В продаже с 2014г. | Воспользовались более 122 предприятий! | Перенос данных из БП 3.0 в УТ 11 | из БП 3.0 в КА 2 | из БП 3.0 в ERP | Сэкономьте свое время - используйте готовое решение для перехода! | Постоянно работаем над развитием переноса данных | Обновляем на новые релизы 1С | Есть фильтр выгрузки по организациям | Переносятся начальные остатки на выбранную дату, документы за период времени и вся возможная справочная информация | Перенос сделан на технологии КД 2 (правила конвертации данных)

50722 45650 руб.

31.10.2014    231433    124    327    

296
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. quazare 3587 29.01.23 13:58 Сейчас в теме
По-моему нет никаких проблем добавить вебсервисы и их пакеты в расширения…..

Можете описать задачу, которую решали данным обменом?
4. alexey_kurdyukov 156 30.01.23 05:50 Сейчас в теме
(1) Ну собственно то, что в статье написано - документ добавлял
2. Алексей Воробьев 291 29.01.23 15:53 Сейчас в теме
Можно загнать пакет(ы) расширения формата в КД3 и работать с ними там. При этом списки объектов и их свойств будут дополняться объектами и свойствами из расширения формата.

Если использовать последнюю на текущий момент версию КД3 (3.1.2.21), то даже не придется самостоятельно дополнять код модуля, получаемый в КД3, вызовами процедуры ОбменДаннымиXDTOСервер.ИнициализироватьРасширениеПравилаКонвертацииОбъекта. В более ранних версиях приходилось "помогать" таким образом КД3, чтобы заработали "новые" свойства в существующих типах формата.
Еще приходилось явно указывать ПравилоКонвертации.ПространствоИмен = "http://my.name/EnterpriseData/myname_1.8" при добавлении правил для "новых" типов в расширении формата.

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

С другой стороны, можно попробовать модифицировать расширение формата прямо в КД3. По крайней мере, такая возможность декларируется, но мы этим не пользовались...пока)
JohnyDeath; quazare; +2 Ответить
3. alexey_kurdyukov 156 30.01.23 05:49 Сейчас в теме
(2) Но КД3.1, как мне кажется, не совсем КД3, оно больше похоже на помесь КД2 и КД3?
5. Алексей Воробьев 291 30.01.23 09:06 Сейчас в теме
(3) Вы про включение неполной функциональности КД2 в КД3? Я это не имел в виду...

Под КД3 в контексте текущей темы я понимаю и 3.1 в той ее части, когда обмен настраивается через общий формат данных Enterprise Data
Оставьте свое сообщение