Добавление дополнительных свойств

У каждого Device есть ряд стандартных свойств, которые осуществляют контроль за подключением к аппаратному оборудованию и обработкой данных на сервере, например, за Периодом синхронизации (Synchronization Period) или Использованием расширенного статуса (Use Extended Status). Однако может быть необходимым ассоциировать некоторую нестандартную информацию с Device. Например, задачи по управлению IT-инфраструктурой требуют легкого обнаружения текущего месторасположения Device, т.е. здания, этажа и номера офиса. SberMobile разрешает добавлять любые пользовательские данные в учетную запись устройства или системные ресурсы, используя свойство общих данных. В этом уроке показано, как добавить информацию о Месторасположении устройства в каждое устройство при помощи SberMobile IIoT Platform Client.

Во-первых, нам необходимо создать общую таблицу, которая будет описывать формат наших пользовательских свойств. Копия данной таблицы позднее будет добавлена в каждую учетную запись устройства.

Дважды кликните по узлу Глобальные общие данные (), чтобы запустить создание таблицы. Введите свойства таблицы следующим образом:

• Имя таблицы: location
• Описание таблицы: Device Location
• Минимальное количество записей: 1 (поскольку мы добавляем не табличное свойство)
• Максимальное количество записей: 1

Кликните OK, чтобы добавить новую общую таблицу. Она появится в системном дереве:

Если диалоговое окно конфигурации таблицы не всплывает автоматически после создания таблицы, кликните правой кнопкой мыши по только что созданной таблице и выберите Настроить общую таблицу (). Переключитесь во вкладку Поля, чтобы приступить к добавлению полей таблицы.

Кликните по Добавить ряд () и введите свойства поля:

• Имя: building
• Тип: String
• Описание: Building
• Значения расширенного выбора: Yes

Кликните по Значения выбора и введите несколько зданий. Ниже следует пример:

Оставьте другие значения по умолчанию и добавьте два других поля:

• Имя: floor
• Тип: String
• Описание: Floor

и

• Имя: room
• Тип: String
• Описание: Room

Таблица Поля должна выглядеть следующим образом:

А теперь пора сообщить SberMobile Server, что наша новая таблица - дополнительное свойство устройства. Переключитесь во вкладку Дополнительные свойства и выберите Использовать общую таблицу как дополнительное свойство.

На этом этапе поле Выражение пригодности станет доступным для редактирования. Оно определяет, какие контексты следует ассоциировать с нашей таблицей. Кликните по кнопке [...] внутри поля Выражения пригодности, чтобы открыть редактор выражений.

В нашем случае выражение пригодности следует назначить как верное (TRUE) для любого контекста устройства и неверное (FALSE) для всех остальных контекстов. Раздел контекст устройства в ссылке контекста указывает, что тип контекста для контекстов устройства имеет следующую форму:

device.DEVICE_TYPE

Это означает, что любой тип контекста, начинающийся со слова "устройство",  соответствует контексту устройства. Выберите функцию startsWith из раскрывающегося списка Функций, чтобы вставить ее в выражение:

Согласно описанию данной функции у нее есть два параметра строки; она возвращает TRUE, если первая строка  начинается со второй строки ("префикса"). Кликните параметры внутри функции и дважды кликните по Типу контекста в области Относительных ссылок, чтобы добавить тип контекста как первый параметр. Затем вручную добавьте буквенную строку "device" аналогично второму параметру:

Кликните OK дважды, чтобы применить изменения в настройке Выражения пригодности и Общей таблицы. Теперь каждое устройство в системе имеет свое собственное свойство Месторасположения.

Чтобы получить доступ к свойству Месторасположение устройства определенного устройства, щелкните по нему правой кнопкой мыши и выберите Редактировать дополнительные свойства.

Теперь можно заполнить вкладку Местоположение устройства: