Руководство по интеграции произвольной конфигурации «1С: Предприятие» с Mobile SMARTS

Минимально необходимая версия платформы 1С для работы с продуктом — 8.3.10

Минимальная версия, поддерживающая работу основных и интеграционных обработок — 8.3.10

Минимальная версия для корректной работы расширений Клеверенс — 8.3.11

Интеграция произвольной конфигурации 1С с новыми продуктами на платформе Mobile SMARTS позволяет обеспечить полноценный обмен данными между учетной системой и мобильными устройствами. Для успешного подключения требуется выполнить ряд обязательных шагов: от настройки СКД и бизнес-процессов до создания собственных обработчиков и корректировки метаданных под формат Mobile SMARTS.

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

Статья не подходит для интеграции устаревших продуктов, таких как «Драйвер ТСД Wi-Fi ПРОФ» или «Драйвер инвентаризации ОС», если интеграция выполняется старыми методами (через промежуточные конфигурации, устаревшие обработки и т. п.).

Что потребуется для интеграции произвольной конфигурации 1С с новыми продуктами на базе платформы Mobile SMARTS:

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

В отраслевом продукте на платформе Mobile SMARTS для большинства справочников и регистров уже разработаны соответствующие метаданные. Необходимо лишь создать СКД, выдающий информацию в строго заданном формате.

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

Эта процедура называется «настройкой бизнес-процессов». Бизнес-процесс в интеграции с платформой Mobile SMARTS регулирует все: от отбора нужных документов до их выгрузки, загрузки, заполнения реквизитов и постобработки.

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

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

Как правило, они дополняют данные перед выгрузкой или после загрузки, вызывая соответствующие модули конфигурации.

Глоссарий

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

Mobile SMARTS — платформа компании «Клеверенс», позволяющая создавать и программировать алгоритмы работы (конфигурации) для мобильных устройств, подключенных к платформе, а также включающая веб-службу сервера, поставляемую в комплекте с платформой. (Аналог — платформа «1С: Предприятие» с её конфигурациями).

Интеграционная обработка — обработка, преобразующая метаданные конфигурации 1С в метаданные для обработки КлеверенсТСД. В ней содержатся обработчики, запускаемые при выгрузке и загрузке документов, а также СКД для выгрузки справочников и дополнительных таблиц в базу Mobile SMARTS.

Обработка КлеверенсТСД — обработка с реализованным функционалом и методами обмена с базой Mobile SMARTS, упрощающая работу программистов 1С. Все специфичные переменные и значения из конфигурации настраиваются через интеграционную обработку.

База Mobile SMARTS — база установленного продукта («Склад 15» или «Магазин 15»), в которой хранятся все настройки.

Подробнее о структуре папки с базой.

Последовательность действий для интеграции с учетной системой

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

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

ФункцияПоддерживаемаяКонфигурация()

ФункцияПоддерживаемыеВерсииКонфигурации(ИмяТекущейКонфигурации)

ФункцияСведенияОВнешнейОбработке() Экспорт

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

Укажите имена справочников и реквизиты, которые будут использоваться интеграцией.
Измените все экспортные функции общего модуля под вашу конфигурацию, кроме экспортных функций обработчиков событий бизнес-процессов в области #Область ОбработчикиВыгрузкиДокументов.
Перечень обязательных экспортных функций в интеграционной обработке:
- СведенияОВнешнейОбработке
- ИнформацияСовместимости
- Конф_ПроверкаСоответствияИспользуемойКонфигурации
- Конф_ПрефиксКонфигурации
- Конф_ПолучитьМетаданныеНСИ
- Конф_ИспользоватьХарактеристикиНоменклатуры
- Конф_ПолучитьПустуюСсылкуСправочника
- Конф_ПолучитьСписокИспользуемыхСправочников
- ПолучитьМакетСКД
Удалите или закомментируйте ненужные обработчики из интеграционной обработки, поскольку они могут обращаться к модулям типовой конфигурации, что вызовет ошибки подключения.
Интеграционная обработка готова. Если все сделано верно, она загрузится в основной обработке КлеверенсТСД.
В функции Функция Конф_ПолучитьСписокИспользуемыхСправочников() Экспорт укажите перечень справочников, которые будут выгружаться из 1С в таблицы базы Mobile SMARTS.
Для каждой выгружаемой таблицы создайте в обработке макет СКД.

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

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

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

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

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