Интеграция Mobile SMARTS с учетной системой

Вводная в объекты Mobile SMARTS

В работе с Mobile SMARTS используется множество различных объектов, которые можно условно разделить на две большие группы: бизнес-сущности и вспомогательные объекты. Бизнес-сущности системы, такие как товар, упаковка, склад, пользователь, шаблон этикетки и т.д., представляют собой данные, хоть как-то отражающие бизнес и объекты учета учетной системы. Вспомогательные сущности, такие как StorageConnector, состояние терминала и т.д., имеют отношение только непосредственно к работе Mobile SMARTS.

Все объекты системы обладают определенным набором свойств и методов. Все доступные объекты, а также их свойства и методы, перечислены в файле справки «Mobile SMARTS 2008 Компонента доступа.chm».

Бизнес-сущности

Почти у всех бизнес-сущностей есть свойство (чаще всего, Id), значение которого должно быть уникально, что требуется для поддержания связей между объектами. Например, каждый товар ссылается на свой базовый тип упаковки посредством свойства Product.BasePackingId, а каждый пользователь системы (Cleverence.Warehouse.User) имеет три уникальных поля: код (User.Id), имя (User.Name) и штрихкод (User.Barcode). Первое используется для указания на конкретного пользователя (например, исполнитель в объекте документа), а второе для однозначной авторизации пользователя при входе в клиентское приложение Mobile SMARTS.

Для большинства сущностей системы предусмотрены соответствующие коллекции объектов (т.е. пополняемые списки). Например, для сущности товара (Cleverence.Warehouse.Product) существует коллекция товаров — Cleverence.Warehouse.ProductCollection. Коллекции – это не справочники, а типы данных, наподобие массивов.

Коллекции имеют функции для добавления (Add) и удаления (Remove) объектов, получения конкретного объекта по его индексу в коллекции (Item) и получения текущего количества объектов в коллекции (Count). Кроме того, коллекция позволяет искать и фильтровать содержащиеся в ней объекты. Для этих целей каждому свойству бизнес-сущности в коллекции соответствует функция вида FindBy…(…). Например, для свойства User.Name в UserCollection существует функция FindByName(string name). Если, как в данном примере, значение свойства уникально, то функция возвращает единичный объект (в данном случае User), либо пустое значение (null, т.е. объект не найден). Если же свойство не подразумевает уникальности, как например свойство артикула для товара (Product.Marking), то результатом вызова ProductCollection.FindByMarking(string marking) буде тновая коллекция товаров, артикул которых соответствует параметру marking.

В таблице ниже приведен полный список всех бизнес-сущностей Mobile SMARTS:

НаименованиеПереводОписание
ProductТовар (ТМЦ, Номенклатура)Задает позицию справочника товаров.
PackingУпаковка

Задает вариант упаковки товара с собственным

штрихкодом, весом и т.д.

UnitЕдиница измерения«шт.», «кг», «м» и т.д.
WarehouseСкладОдин из существующих складов Компании.
CellЯчейкаОписание конкретной ячейки, шаблона большой
группы ячеек или зоны хранения на конкретном
складе.
PalletПаллетаОписание конкретной паллеты либо шаблона
большой группы паллет.
DocumentДокументЭлектронный документ, связанный с
определенной складской операцией.
DocumentTypeТип документаЗадает тип операции на мобильном терминале и
соответствующий ей тип электронного документа
с описанием алгоритма выполнения документов
такого типа на мобильном терминале.
ClassifierПризнакЗадает признак, который может быть назначен
объекту системы. Позволяет расширить данные о
каком-то объекте, не добавляя новых полей во все
объекты бизнес-сущности.
ClassifierTypeТип признакаЗадает тип используемых признаков, уточняя их
применение к различным бизнес-сущностям.
QuantityPolicyПолитика количества товара

Задает вариант ввода и отображения количества

определенных товаров.

UserПользовательПользователь Mobile SMARTS со стороны
мобильных терминалов со своим именем,
паролем, рабочими складами и т.д.
UserGroupГруппа пользователейГруппа пользователей Mobile SMARTS со стороны
мобильных терминалов, по которой назначаются
доступные операции.
PrinterПринтерИмя и сетевой путь к принтеру.
PrinterMappingПривязка принтераЗадает правило выбора принтера в зависимости от
сочетания пользователя, склада, где он находятся,
и типа документа, из обработки которого
производится печать.
LabelTemplateШаблон этикеткиДизайн-макет этикетки для печати на принтерах
этикеток (и, вообще говоря, любых windows-
принтерах) с шаблонами полей для вставки
данных.

 

Вспомогательные объекты

Вспомогательные объекты используются в основном для обмена данными с сервером Mobile SMARTS при получении данных о терминалах, печати этикеток, вызове окон настроек и просмотра метаданных Mobile SMARTS и т.д.

В таблице ниже даны некоторые примеры вспомогательных объектов Mobile SMARTS:

НаименованиеПереводОписание
StorageConnectorКоннекторСодержит все методы для обмена данными с
сервером Mobile SMARTS.
LabelЭтикеткаЗадает значения полей при печати конкретной
этикетки.