Вводная в объекты 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 | Этикетка | Задает значения полей при печати конкретной этикетки. |