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

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

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

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

Cleverence.Warehouse.StorageConnector (файл компоненты Cleverence.MobileSMARTS.ComConnector.dll) содержит методы для работы с Mobile SMARTS из любой программы или информационной системы, которая способна использовать COM.

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 [СтрокаДокумента]

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