Что нужно, чтобы сделать интеграцию самописной конфигурации 1С со «Склад 15»
-
Написать СКД для номенклатуры, справочников и регистров, которые будут использоваться мобильной программой.
Для большинства нужных справочников и регистров в «Склад 15» уже есть свои метаданные, нужно только написать СКД, который выдаст информацию в заранее определенном жестком формате.
Это делается один раз и для онлайн, и для оффлайн сценариев интеграции, т. е. в любом сценарии интеграции используются одни и те же СКД. -
Настроить в специальной обработке правила обмена документами между 1С и мобильной программой.
Это называется «настройкой бизнес-процессов». Бизнес-процесс в интеграции со «Склад 15» определяет всё: от отбора нужных документов, до их выгрузки/ загрузки, правил заполнения и постобработки.
Это тоже делается один раз и для онлайн-режима работы, и для офлайн, т. е. для любых способов обмена используются одни и те же общие правила, даже если конкретные настройки для онлайна и офлайна разные. -
Написать так называемые «обработчики» для обработки ситуаций, с которыми не справляется СКД или настройка бизнес-процесса.
Не всё можно сделать отбором или настройкой, поэтому в обработке интеграции предусмотрены обработчики, где можно «поправить интеграцию». Как правило, они что-то дозаполняют перед выгрузкой или после загрузки, вызывают механизмы модулей конфигурации.
Порядок действий для подключения терминала сбора данных к 1С
-
Первым делом ознакомимся с продуктом, с которым собираемся делать интеграцию.
-
Скачиваем и устанавливаем «Склад 15». При установке продукта ОБЯЗАТЕЛЬНО выбираем либо вариант «под самостоятельную интеграцию», либо под ту конфигурацию 1С, которая наиболее подходит по метаданным к вашей конфигурации.
-
После установки у вас на ПК появится база «Склад 15», с которой будут работать мобильные устройства и будет происходить обмен данными с 1С.
-
Начнем адаптацию вашей учетной системы с изменения реквизитов интеграционной обработки. Берем за основу наиболее подходящую по метаданным конфигурации 1С интеграционную обработку из поставляемых с продуктом. Копируем её и переименовываем.
Обработки интеграции находятся в папке базы: «\Обработки 1С\Интеграционные обработки». -
Открываем конфигуратором общий модуль скопированной обработки.
-
Изменяем проверяемую конфигурацию и версию в начальных функциях обработки, в области #Область ИнформацияОСовместимости на свои версии и наименования.
Функция ПоддерживаемаяКонфигурация()
Функция ПоддерживаемыеВерсииКонфигурации
(ИмяТекущейКонфигурации)Функция СведенияОВнешнейОбработке() Экспорт Функция Конф_ПрефиксКонфигурации() Экспорт -
Для работы основного функционала интеграции потребуется привести метаданные вашей конфигурации к метаданным нашей обработки КлеверенсТСД. Это происходит в области: #Область МетаданныеКонфигурации.
Указываем имена справочников, к которым будет обращаться (по каким реквизитам) в конфигурацию из нашей интеграции.
-
Необходимо изменить все экспортные функции общего модуля для работы с вашей конфигурацией, за исключением экспортных функций обработчиков событий бизнес-процессов в области.
#Область ОбработчикиВыгрузкиДокументов. -
Список обязательных экспортных функций в модуле интеграционной обработки, необходимых для работы:
- СведенияОВнешнейОбработке.
- ИнформацияСовместимости.
- Конф_ПроверкаСоответствияИспользуемойКонфигурации.
- Конф_ПрефиксКонфигурации.
- Конф_ПолучитьМетаданныеНСИ.
- Конф_ИспользоватьХарактеристикиНоменклатуры.
- Конф_ПолучитьПустуюСсылкуСправочника.
- Конф_ПолучитьСписокИспользуемыхСправочников.
- ПолучитьМакетСКД.
-
Удаляем или комментируем лишние обработчики из интеграционной обработки, так как в них могут использоваться вызовы модулей типовой конфигурации, из-за чего интеграционная обработка не сможет подключиться к основной.
-
Интеграционная обработка готова. Если всё было сделано правильно, то она сможет загрузится в основной обработке КлеверенсТСД.
-
В функции Функция Конф_ПолучитьСписокИспользуемыхСправочников () Экспорт нужно указать список выгружаемых справочников из 1С в соответствующие таблицы базы Mobile SMARTS.
-
Для каждой выгружаемой таблицы из 1С в базу «Склад 15», создаем в обработке макет системы компоновки данных (СКД).
После создания макетов СКД, в функции ПолучитьМакетСКД указываем в каких случаях и какой макет СКД нужно использовать.
-
В режиме 1С предприятия открываем основную обработку КлеверенсТСД, и в открывшемся окне подключаем созданную интеграционную обработку. Если всё сделано правильно, то обработка подцепится и покажет поддерживаемые версии и конфигурации.
-
Интеграционная обработка может быть использована в виде файла внешней обработки, добавлена в справочник с реквизитом типа ХранилищеЗначения для хранения обработки (например справочник «Дополнительные отчеты и обработки» в УТ 11.4) или как обработка, встроенная в конфигурацию.
-
В обработке КлеверенсТСД в окне настройки обмена справочников можно настроить дополнительные отборы справочников и посмотреть предварительный список выгружаемых данных по каждой таблице.
-
Для выгрузки и загрузки документов, в настройках бизнес-процессов добавим новый бизнес-процесс (БП) или копируем из имеющихся если есть (они появляются если выбрали работу с конкретной учетной системой в мастере настроек).
В настройках БП обязательно нужно указать название, тип документа MS, тип исходящего документа 1С (для выгрузки) или тип результирующего документа 1С (для загрузки).
Указываем правила загрузки/ выгрузки реквизитов шапки и табличных частей документов в виде соответствий реквизитов.
-
Для более тонкой настройки операции загрузки и заполнения документа в базу 1С, можно использовать обработчики из интеграционной обработки.
Названия обработчиков событий являются названием экспортных процедур в модуле интеграционной обработки. При возникновения события будет вызвано выполнение данных процедур:
При настройке правил загрузки полей шапки есть возможность указать обработчик события «После открытия формы». Обработчик события «После открытия формы» выполняется в момент окончания заполнения документа и после открытия формы загружаемого документа и вызывает экспортную процедуру из модуля формы интеграционной обработки.
-
Вместо настраиваемой в бизнес-процессе выгрузки документа 1С в базу «Склад 15» полями, есть возможность использовать полностью произвольный алгоритм выгрузки и загрузки.
Название обработчика выгрузки документа должно соответствовать названию экспортной функции в модуле интеграционной обработки отвечающей за выгрузку документа.
-
После создания и настройки бизнес-процесса, добавим настройку отбора документов для интерактивного и онлайн обмена:
Настройка отборов документов нужна для указания диапазона документов, с которыми будут работать пользователи в интерактивном и онлайн режимах. После настройки отбора можно нажать на кнопку «Показать результат отбора», и, если все настроено верно, появится список документов, соответствующий отбору.
-
Интерактивный обмен документами происходит на форме «Обмен документами». Онлайн-отбор происходит при вызове функции «ПолучитьСписокДокументов» с мобильного устройства, для получения результата отбора при работе в онлайне.