Интеграция нетиповой конфигурации «1С: Предприятия» с ТСД с помощью Клеверенс

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

Что нужно, чтобы сделать интеграцию самописной конфигурации 1С с продуктом на платформе Mobile SMARTS

1. Написать СКД для номенклатуры, справочников и регистров, которые будут использоваться мобильной программой.
   Для большинства нужных справочников и регистров в продукте на платформе Mobile SMARTS («Магазин 15», «Склад 15» и т. п.) уже есть свои метаданные, нужно только написать СКД, который выдаст информацию в заранее определенном жестком формате.
   Это делается один раз и для онлайн, и для оффлайн сценариев интеграции, т. е. в любом сценарии интеграции используются одни и те же СКД.

2. Настроить в специальной обработке «Клеверенс» правила обмена документами между 1С и мобильной программой.
   Это называется «настройкой бизнес-процессов». Бизнес-процесс в интеграции с платформой Mobile SMARTS определяет всё: от отбора нужных документов, до их выгрузки/ загрузки, правил заполнения и постобработки.
   Это тоже делается один раз и для онлайн-режима работы, и для офлайн, т. е. для любых способов обмена используются одни и те же общие правила, даже если конкретные настройки для онлайна и офлайна разные.

3. Написать так называемые «обработчики» для обработки ситуаций, с которыми не справляется СКД или настройка бизнес-процесса.
   Не всё можно сделать отбором или настройкой, поэтому в обработке интеграции предусмотрены обработчики, где можно «поправить интеграцию». Как правило, они что-то дозаполняют перед выгрузкой или после загрузки, вызывают механизмы модулей конфигурации.

Порядок действий для подключения терминала сбора данных к 1С

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

2. Скачиваем и устанавливаем продукт по инструкции (см. инструкцию для Склада 15, Магазина 15). При установке продукта ОБЯЗАТЕЛЬНО выбираем либо вариант «под самостоятельную интеграцию», либо под ту конфигурацию 1С, которая наиболее подходит по метаданным к вашей конфигурации.

3. После установки у вас на ПК появится база Mobile SMARTS, с которой будут работать мобильные устройства и будет происходить обмен данными с 1С.

4. Начнем адаптацию вашей учетной системой с изменения реквизитов интеграционной обработки. Берем за основу наиболее подходящую по метаданным конфигурации 1С интеграционную обработку из поставляемых с продуктом. Копируем её и переименовываем.
   Обработки интеграции находятся в папке базы: «\Обработки 1С\Интеграционные обработки».

   
   

5. Открываем конфигуратором общий модуль скопированной обработки.

6. Изменяем проверяемую конфигурацию и версию в начальных функциях обработки, в области #Область ИнформацияОСовместимости на свои версии и наименования.
   

   Функция ПоддерживаемаяКонфигурация()
   Функция ПоддерживаемыеВерсииКонфигурации (ИмяТекущейКонфигурации)
   Функция СведенияОВнешнейОбработке() Экспорт
   Функция Конф_ПрефиксКонфигурации() Экспорт

7. Для работы основного функционала интеграции потребуется привести метаданные вашей конфигурации к метаданным нашей обработки КлеверенсТСД. Это происходит в области: #Область МетаданныеКонфигурации.

   

   Указываем имена справочников, к которым будет обращаться (по каким реквизитам) в конфигурацию из нашей интеграции.

   

8. Необходимо изменить все экспортные функции общего модуля для работы с вашей конфигурацией, за исключением экспортных функций обработчиков событий бизнес-процессов в области.
   #Область ОбработчикиВыгрузкиДокументов.

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

   • СведенияОВнешнейОбработке.
   • ИнформацияСовместимости.
   • Конф_ПроверкаСоответствияИспользуемойКонфигурации.
   • Конф_ПрефиксКонфигурации.
   • Конф_ПолучитьМетаданныеНСИ.
   • Конф_ИспользоватьХарактеристикиНоменклатуры.
   • Конф_ПолучитьПустуюСсылкуСправочника.
   • Конф_ПолучитьСписокИспользуемыхСправочников.
   • ПолучитьМакетСКД.

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

    

11. Интеграционная обработка готова. Если всё было сделано правильно, то она сможет загрузится в основной обработке КлеверенсТСД.

12. В функции Функция Конф_ПолучитьСписокИспользуемыхСправочников () Экспорт нужно указать список выгружаемых справочников из 1С в соответствующие таблицы базы Mobile SMARTS.
    

    

13. Для каждой выгружаемой таблицы из 1С в базу Mobile SMARTS, создаем в обработке макет системы компоновки данных (СКД).

    

    После создания макетов СКД, в функции ПолучитьМакетСКД указываем в каких случаях и какой макет СКД нужно использовать.

    

14. В режиме 1С предприятия открываем основную обработку КлеверенсТСД, и в открывшемся окне подключаем созданную интеграционную обработку. Если всё сделано правильно, то обработка подцепится и покажет поддерживаемые версии и конфигурации.

    

15. Интеграционная обработка может быть использована в виде файла внешней обработки, добавлена в справочник с реквизитом типа ХранилищеЗначения для хранения обработки (например справочник «Дополнительные отчеты и обработки» в УТ 11.4) или как обработка, встроенная в конфигурацию.

    
    

16. В обработке КлеверенсТСД в окне настройки обмена справочников можно настроить дополнительные отборы справочников и посмотреть предварительный список выгружаемых данных по каждой таблице.

    

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

    

    В настройках БП обязательно нужно указать название, тип документа MS, тип исходящего документа 1С (для выгрузки) или тип результирующего документа 1С (для загрузки).

    Указываем правила загрузки/ выгрузки реквизитов шапки и табличных частей документов в виде соответствий реквизитов.

    

18. Для более тонкой настройки операции загрузки и заполнения документа в базу 1С, можно использовать обработчики из интеграционной обработки.

    

    Названия обработчиков событий являются названием экспортных процедур в модуле интеграционной обработки. При возникновения события будет вызвано выполнение данных процедур:

    

    При настройке правил загрузки полей шапки есть возможность указать обработчик события «После открытия формы». Обработчик события «После открытия формы» выполняется в момент окончания заполнения документа и после открытия формы загружаемого документа и вызывает экспортную процедуру из модуля формы интеграционной обработки.

    

    
    

19. Вместо настраиваемой в бизнес-процессе выгрузки документа 1С в базу Mobile SMARTS полями, есть возможность использовать полностью произвольный алгоритм выгрузки и загрузки.

    

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

    

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

    

    Настройка отборов документов нужна для указания диапазона документов, с которыми будут работать пользователи в интерактивном и онлайн режимах. После настройки отбора можно нажать на кнопку «Показать результат отбора», и, если все настроено верно, появится список документов, соответствующий отбору.

21. Интерактивный обмен документами происходит на форме «Обмен документами». Онлайн-отбор происходит при вызове функции «ПолучитьСписокДокументов» с мобильного устройства, для получения результата отбора при работе в онлайне.