Интеграция 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 Этикетка Задает значения полей при печати конкретной
этикетки.