Интеграция c Mobile SMARTS через компоненту доступа

Последние изменение: 09.09.2019

 Mobile SMARTS 3.0: Работа с компонентой

 Справочник по объектам Mobile SMARTS и компоненте доступа для платформы

 Справочник по компоненте драйвера терминала сбора данных для 1С:Предприятия (AddIn.Cl.TerminalConnector)

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

Компонента Cleverence.Warehouse.StorageConnector (и другие объекты Mobile SMARTS) могут использоваться при разработке решений на платформе .NET Framework.

В этом случае нет необходимости регистрировать COM-объекты и создавать экземпляр компонеты как COM-объект. Вместо этого следует добавить в ссылки проекта в вашей среде разработки библиотеки Cleverence.MobileSMARTS.ComConnector.dll, Cleverence.Infrastructure.dll, Cleverence.DataCollection.dll, Cleverence.Common.dll (библиотеки находятся в <папка установки Mobile SMARTS>\Connectivity, по умолчанию C:\Program Files (x86)\Cleverence Soft\Mobile SMARTS\Connectivity). В вашем коде объекты Mobile SMARTS создаются с помощью конструкторов по умолчанию (например, new Cleverence.Warehouse.StorageConnector()).

AddIn.Cl.TerminalConnector (файл компоненты Cleverence.Warehouse.TerminalConnector.dll) предназначена специально для работы с «1С:Предприятием» и может быть подключена в 1С как внешняя компонента. Отличие от Cleverence.Warehouse.StorageConnector состоит в том, что функции AddIn.Cl.TerminalConnector «понимают» и принимают объекты 1С (массивы, списки значений, таблицы значений и др.). Благодаря этому написание кода 1С для обмена существенно облегчается.

Файлы, необходимые для работы компонент, находятся после установки по умолчанию в папке C:\Program Files(x86)\Cleverence Soft\Mobile SMARTS\Connectivity.

В этой же папке находится файл «Зарегистрировать COM.bat», запустив который (с правами Администратора) можно зарегистрировать компоненты. Это может потребоваться, если автоматическая регистрация при установке из дистрибутива не выполнилась по каким-то причинам или регистрация стала недействительной (например, из-за повреждения реестра Windows).

После установки компоненты становится возможным создание и операции с объектами компоненты непосредственно в процедурах учетной системы.

Операция создания объектов, описанных в COM, специфична для каждой системы:

Псевдокод:

	 var connector = new Cleverence.Warehouse.StorageConnector();

C# (подключив Cleverence.MobileSMARTS.ComConnector.dll в References):

	 var connector = new Cleverence.Warehouse.StorageConnector();

«1С:Предприятие 7»:

	 connector = СоздатьОбъект("Cleverence.Warehouse.StorageConnector");

«1С:Предприятие 8»:

	 connector = новый COMОбъект("Cleverence.Warehouse.StorageConnector");

Microsoft Dynamics AX (Axapta):

	 var connector = new COM("Cleverence.Warehouse.StorageConnector");

Если при попытке создания COM-объекта в Вашей учетной системе возникает ошибка, запустите (с правами Администратора) файл «Зарегистрировать COM.bat». Если регистрация выполнилась успешно, Вы увидите надпись в окне командной строки: «Типы зарегистрированы успешно». Если и после этого создание компоненты происходит с ошибкой, проверьте есть ли у кода, выполняющегося в учетной системе права на работу с COM-объектами.

Ниже указаны наиболее важные средства взаимодействия с сервером Mobile SMARTS и классы бизнес-сущностей системы.

Обмен с базой данных и инфраструктура

Класс

Описание

StorageConnector [Соединение]

Класс, объекты которого служат для доступа к базе данных Mobile SMARTS.

После создания объекта требуется установить соединение с базой данных Mobile SMARTS

с помощью функции SelectCurrentApp

[УстановитьПодключениеСБазойСМАРТС] после чего будет возможен обмен данными (справочниками, документами).

AppInstance [БазаСМАРТС]

Объект, содержащий описание базы данных Mobile SMARTS.

База данных представляет собой хранилище конфигурации Mobile SMARTS (Environment

[Среда]), текущих данных (справочников, документов, списка пользователей), а также настроек. Данные базы хранятся в папке базы на диске компьютера.

Каждая база данных является экземпляром некоторого приложения Mobile SMARTS (App

[ПриложениеСМАРТС]).

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

App [ПриложениеСМАРТС]

Объект приложения Mobile SMARTS. Содержит описание некоторого приложения (идентификатор, наименование и др.).

Приложение представляет собой определенное прикладное решение.

Примеры приложений: «Магазин 15», «Учет имущества», «Пустая конфигурация Mobile SMARTS» (используется для разработки с нуля своего решения).

Главные бизнес сущности

Класс

Описание

Product [Товар]

Позиция номенклатуры (товар).

Packing [Упаковка]

Упаковка товара. Каждый товар должен содержать как минимум одну упаковку.

Document [Документ]

Документ. Основная единица взаимодействия

 

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

DocumentItem [СтрокаДокумента]

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