ThingsKit物聯網平台産品管理之物模型

概述

物模型是ThingsKit物聯網平台為産品定義的資料模型，用于描述産品的功能。本文介紹物模型相關概念和使用限制。

功能說明

物模型是實體空間中的實體（如傳感器、車載裝置、樓宇、工廠等）在雲端的數字化表示，從屬性、服務和事件三個次元，分别描述了該實體是什麼、能做什麼、可以對外提供哪些資訊。定義了物模型的這三個次元，即完成了産品功能的定義。

功能類型	描述
屬性	用于描述裝置運作時具體資訊和狀态。 例如，環境監測裝置所讀取的目前環境溫度、智能燈開關狀态、電風扇風力等級等。 屬性可分為讀寫和隻讀兩種類型。讀寫類型支援讀取和設定屬性值，隻讀類型僅支援讀取屬性值。
服務	指裝置可供外部調用的指令或方法。服務調用中可設定輸入和輸出參數。輸入參數是服務執行時的參數，輸出參數是服務執行後的結果。 相比于屬性，服務可通過一條指令實作更複雜的業務邏輯，例如執行某項特定的任務。 服務分為異步和同步兩種調用方式。
事件	裝置運作時，主動上報給雲端的資訊，一般包含需要被外部感覺和處理的資訊、告警和故障。事件中可包含多個輸出參數。 例如，某項任務完成後的通知資訊；裝置發生故障時的溫度、時間資訊；裝置告警時的運作狀态等。 事件可以被訂閱和推送。

物模型資料格式說明

産品裡面新增物模型時，選擇不同的功能（屬性、服務、事件），屬性對應不同的資料格式。

屬性資料格式	資料格式說明
int32（整數型）	物模型屬性顯示為整數類型（可定義範圍）
double（雙精度浮點型）	物模型屬性顯示為double 如：12.16（可定義範圍）
bool（布爾型）	适用于開關，定義為0和1
text（字元串）	字元串資料格式（可定義範圍）
struct（結構體）	結構體裡面還有json對象 資料格式如：{"jiegou":{"json":126}}

物模型導出

點選物模型TSL，選擇屬性、服務、事件，進行單獨導出，也可選擇導出全部（屬性、服務、事件）物模型。

提示

導出為Json格式檔案，可以檔案編輯器打開自行修改資料。

物模型檢視

進入物模型管理，對物模型資料進行檢視具體資料和功能。

物模型搜尋

根據物模型功能類型：屬性、服務、事件，功能名稱/辨別符進行搜尋。

編輯物模型

新增屬性

進入産品物模型管理，點選編輯物模型，點選新增物模型，新增屬性功能。

提示

物模型新增後必須點選釋出上線才能生效。

屬性物模型功能是顯示裝置接收的資料。

新增屬性選擇讀寫時，可以在裝置物模型資料點選屬性下發。

屬性資料格式	資料格式說明
int32（整數型）	物模型屬性顯示為整數類型（可定義範圍）
double（雙精度浮點型）	物模型屬性顯示為double 如：12.16（可定義範圍）
bool（布爾型）	适用于開關，定義為0和1
text（字元串）	字元串資料格式（可定義範圍）
struct（結構體）	結構體裡面還有json對象 資料格式如：{"jiegou":{"json":126}}

新增服務

進入産品物模型管理，點選編輯物模型，點選新增物模型，新增服務功能。

提示

物模型新增後必須點選釋出上線才能生效。

調用方式異步為單向下發指令，同步為雙向下發指令。

服務功能适用于看闆管理（僅TCP類型裝置），場景關聯執行動作中裝置輸出選擇服務下發到裝置。

新增事件

進入産品物模型管理，點選編輯物模型，點選新增物模型，新增事件功能。

提示

物模型新增後必須點選釋出上線才能生效。

事件需要Topic來publish推送json資料格式進行下發事件https://yunteng.yuque.com/avshoi/v1xdocs/rb4u89wbsltriwen。

删除模型

點選編輯物模型，資料右側的删除按鈕點選删除備援資料。