Бесшовная интеграция между конфигурациями 1С:Документооборот (ДО) и 1С:ERP Управление предприятием является мощным инструментом, позволяющим пользователям работать в едином информационном пространстве. Однако типовой состав объектов, участвующих в обмене, не всегда покрывает потребности бизнеса. Рассмотрим ситуацию, когда нам необходимо добавить в этот процесс новый объект, например, справочник Проекты. Проанализируем техническую сторону вопроса и разберем по шагам, какие изменения необходимо внести в обе конфигурации.
Прежде чем приступать к кодингу, разберем, как работает механизм интеграции. В основе лежит Библиотека интеграции с документооборотом (БИД). Взаимодействие происходит через веб-сервис DMService, расположенный на стороне 1С:ДО. Передача данных осуществляется в формате XDTO, что требует строгого описания структуры объектов в соответствующих пакетах. Наша задача — не просто передать данные, но и обеспечить их автоматическую регистрацию при изменении объекта.
Для того чтобы система «понимала», что элемент справочника Проекты был изменен и его нужно отправить в 1С:ERP, необходимо включить его в механизм миграции данных. Рассмотрим последовательность действий:
ИнтеграцияС1СДокументооборотомПередаваемыеДанные. Нам необходимо включить наш справочник Проекты в состав этого плана обмена с авторегистрацией.ПриЗаписи:
Процедура ИнтеграцияДО_ЗарегистрироватьИзменениеПроекта(Источник, Отказ) Экспорт
Если Источник.ОбменДанными.Загрузка Тогда
Возврат;
КонецЕсли;
Узлы = ПланыОбмена.ИнтеграцияС1СДокументооборотомПередаваемыеДанные.Выбрать();
Пока Узлы.Следующий() Цикл
Если Узлы.Ссылка = ПланыОбмена.ИнтеграцияС1СДокументооборотомПередаваемыеДанные.ЭтотУзел() Тогда
Продолжить;
КонецЕсли;
ПланыОбмена.ЗарегистрироватьИзменения(Узлы.Ссылка, Источник.Ссылка);
КонецЦикла;
КонецПроцедуры
Поскольку обмен идет через веб-сервис, структура передаваемого объекта должна быть описана в XDTO-пакете DMService. Нам необходимо выполнить следующие действия:
Выясним, какие поля справочника Проекты критичны для передачи (например, Наименование, Код, Руководитель). В расширении для 1С:ДО добавим в XDTO-пакет новый тип объекта или дополним существующий тип DMObject, чтобы он мог содержать данные нашего справочника.
Проанализируем программные точки входа. Как было выявлено в процессе обсуждения, основным модулем для формирования данных является ОбработкаЗапросовXDTOДокументы. Нам необходимо найти или переопределить функцию ПолучитьДанныеВнутреннегоДокумента (или создать аналогичную для нашего типа объекта). Именно здесь происходит заполнение структуры XDTO данными из 1С:ДО.
// Пример логики в модуле ОбработкаЗапросовXDTOДокументы
Функция ПолучитьДанныеПроекта(СсылкаНаОбъект, ДанныеXDTO) Экспорт
// Заполняем свойства XDTO объекта данными из справочника
ДанныеXDTO.Description = СсылкаНаОбъект.Наименование;
ДанныеXDTO.Code = СсылкаНаОбъект.Код;
// ... заполнение остальных полей
Возврат ДанныеXDTO;
КонецФункции
Теперь перейдем к стороне потребителя — 1С:ERP. Здесь за получение данных отвечает модуль БесшовнаяИнтеграцияс1СДокументооборотОбмен. Рассмотрим метод ПолучитьДанные. Нам необходимо доработать логику так, чтобы при получении объекта типа «Проект» система знала, в какой справочник 1С:ERP эти данные должны быть записаны.
Важный момент: Бесшовная интеграция опирается на уникальные идентификаторы (UUID). Система сначала ищет соответствие по внутренним таблицам регистрации, а затем по GUID объекта. Проанализируем, как это реализовано в переопределяемых модулях БИД.
В ERP следует обратить внимание на модуль БесшовнаяИнтеграцияс1СДокументооборотОбменПереопределяемый. Именно здесь рекомендуется прописывать логику сопоставления типов:
// В расширении ERP, модуль БесшовнаяИнтеграцияс1СДокументооборотОбменПереопределяемый
&После("ЗаполнитьСоответствиеТипов")
Процедура Расш_ЗаполнитьСоответствиеТипов(СоответствиеТипов)
СоответствиеТипов.Вставить("DMProject", "СправочникСсылка.Проекты");
КонецПроцедуры
После внесения изменений в код, не забудем про настройки в режиме «1С:Предприятие»:
Чтение и Просмотр на новый справочник в ДО, а в ERP — права на запись соответствующих объектов.DMService.Для более глубокого понимания процесса рекомендуется обратиться к файлу Добавление новых объектов.htm. Этот файл входит в поставку библиотеки DMIL (папка DMIL в дистрибутиве 1С:Документооборот). В нем содержится эталонная инструкция от разработчиков 1С по расширению функций интеграции. Помните, что современные версии конфигураций позволяют выполнять большинство этих действий через Переопределяемые модули и Расширения, сохраняя при этом типовую конфигурацию на поддержке.
Таким образом, мы рассмотрели полный цикл добавления нового объекта в обмен: от регистрации изменений в плане обмена ДО до обработки полученного XDTO-пакета в ERP. Следуя этой структуре, вы сможете интегрировать любые необходимые объекты между системами.