Mobile SMARTS 3.0: Работа с компонентой
Справочник по объектам Mobile SMARTS и компоненте доступа для платформы
Для организации обмена данными между учетной системой пользователя и 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 и классы бизнес-сущностей системы.
Обмен с базой данных и инфраструктура
|
Класс |
Описание |
|
Класс, объекты которого служат для доступа к базе данных Mobile SMARTS. После создания объекта требуется установить соединение с базой данных Mobile SMARTS с помощью функции SelectCurrentApp [УстановитьПодключениеСБазойСМАРТС] после чего будет возможен обмен данными (справочниками, документами). |
|
|
Объект, содержащий описание базы данных Mobile SMARTS. База данных представляет собой хранилище конфигурации Mobile SMARTS (Environment [Среда]), текущих данных (справочников, документов, списка пользователей), а также настроек. Данные базы хранятся в папке базы на диске компьютера. Каждая база данных является экземпляром некоторого приложения Mobile SMARTS (App Данный объект содержит описание базы данных (идентификатор, наименование, способ подключения), позволяет получить доступ к пользовательским настройкам, но не содержит данные базы (конфигурацию, справочники, документы). Для доступа к данным базы используется StorageConnector [Соединение]. |
|
|
Объект приложения Mobile SMARTS. Содержит описание некоторого приложения (идентификатор, наименование и др.). Приложение представляет собой определенное прикладное решение. Примеры приложений: «Магазин 15», «Учет имущества», «Пустая конфигурация Mobile SMARTS» (используется для разработки с нуля своего решения). |
Главные бизнес сущности
|
Класс |
Описание |
|
Позиция номенклатуры (товар). |
|
|
Упаковка товара. Каждый товар должен содержать как минимум одну упаковку. |
|
|
Документ. Основная единица взаимодействия между учетной системой и пользователем. Содержит описание задания, назначенного к выполнению, и сам результат выполнения задания. |
|
|
Строка в документе, заявленная или фактическая. Содержит информацию о товаре, его количестве и дополнительных полях (сроки годности, серийные номера, дополнительные характеристики и т.п.) |
