交互配置
物聯網應用開發配置組件時,可設置事件和動作實現組件的動作交互。事件觸發時,按照交互動作配置的先后順序依次執行相應的動作。
支持的事件和動作
事件:包括單擊、雙擊、鼠標移入、鼠標移出、值改變、聚焦、失焦等。
動作執行模式:包括同時執行(默認)和按順序執行。
動作:包括設置設備屬性、調用設備服務、打開鏈接、刷新組件、賦值給頁面變量、展示或隱藏組件、調用其他服務和打開彈窗容器。動作具體配置,請參見下文介紹。
使用限制
支持多個交互動作使用同一個觸發事件,多個動作的執行模式支持為同時執行(默認)和按順序執行。
動作執行模式為按順序執行時,如果子動作為當前頁面打開鏈接或子動作執行失敗,則后續子動作不會再執行。
一個組件最多支持20個交互動作,一個觸發事件支持最多20個交互子動作。
設置設備屬性
觸發事件時,設置組件關聯設備的屬性。
選擇觸發事件,選擇動作為設置設備屬性。
單擊配置設備。
在設置設備屬性頁面,配置設備信息,單擊保存。
說明保存設置前,可單擊驗證對相關配置進行驗證。
參數
描述
選擇產品
選擇該組件對應的設備所屬產品。
選擇設備
選擇該組件對應的設備。
指定設備:如果已有真實設備連接到物聯網平臺,則選擇真實設備。如果真實設備未連接到物聯網平臺,沒有上報數據,則需使用設備模擬器功能,在線模擬上報數據進行數據格式驗證。具體操作,請參見設備模擬器。
動態設備:可選頁面變量、組件值、URL參數和來自交互動作四種類型的動態設備。
空設備:若選擇為空,可在設備模擬數據框中,輸入模擬數據,進行數據格式驗證。
選擇屬性
選擇該組件對應的屬性。
設置值
需根據所選設備屬性的取值范圍,設置模擬值。
支持配置動態數據源,單擊參數來源,可選:
說明IoT Studio目前僅支持調用強校驗類型的物模型數據。參數來源的數據必須滿足屬性或服務的物模型定義配置。有關物模型數據校驗的詳細說明,請參見校驗物模型數據。
組件值:選擇當前應用中,已配置的表單組件作為參數值來源。
URL參數:將當前組件所屬頁面最終發布的URL地址中的某個URL參數的key值配置為此處的URL參數。頁面運行時,會自動獲取頁面中對應URL參數的value值。
頁面變量:選擇在當前應用中,已創建的頁面變量作為參數值來源。創建頁面變量具體操作,請參見頁面變量管理。
屬性取值范圍,請在產品詳情頁的功能定義中查看。
調用設備服務
觸發事件時,調用來自產品功能定義的服務。
選擇觸發事件,選擇動作為調用設備服務。
單擊配置服務。
在調用設備服務頁面,配置設備服務,單擊保存。
說明保存設置前,可單擊驗證對相關配置進行驗證。
參數
描述
選擇產品
選擇該組件對應的設備所屬產品。
選擇設備
選擇該組件對應的設備。詳細說明,請參見上文“設置設備屬性”中的參數描述。
選擇服務
選擇該組件對應的服務,然后設置相關參數。服務來自產品的功能定義。
打開鏈接
觸發事件時,打開配置的鏈接。
選擇觸發事件,選擇動作為打開鏈接。
單擊選擇鏈接。
在彈出的對話框中,配置鏈接,單擊確定。
參數
說明
鏈接打開方式
可選:
當前頁面:在當前應用頁面打開鏈接。
新開頁面:在新開頁面打開鏈接。
目標鏈接
可選:
當前應用頁面:設置當前應用中的某個頁面為鏈接目標頁。
指定鏈接:設置外部鏈接為鏈接目標頁。輸入鏈接需以http://或https://開頭。
URL參數
鼠標指針移動到URL參數右側的幫助圖標,可查看URL鍵值對配置說明。
單擊+URL參數,配置鍵和值。
值支持配置動態參數,單擊參數來源,選擇來源類型進行配置。
其中組件值、URL參數、頁面變量的詳細說明,請參見上文“設置設備屬性”中的參數描述。
登錄賬號:在開啟應用賬號鑒權的情況下。配置數據分析服務、自定義接口和業務邏輯開發時,可以選擇登錄的賬號信息作為請求參數,以完成一些界面或功能的定制需求。詳細使用說明,請參見賬號數據。
刷新組件
觸發事件時,會刷新組件數據源。
對于控制組件和表單組件的展示內容或狀態,如果用戶手動更新的組件內容或狀態與組件數據源返回結果不一致,則組件展示內容或狀態以組件數據源結果為準。
選擇觸發事件,選擇動作為刷新組件。
設置需要刷新的組件,可多選。
賦值給頁面變量
觸發事件時,為頁面變量賦值。
選擇觸發事件,選擇動作為賦值給頁面變量。
(可選)若還沒有創建對應頁面變量,單擊管理頁面變量,單擊新增頁面變量,輸入頁面變量信息,單擊確認,返回交互頁簽。
單擊配置。
在彈出對話框中,單擊賦值,選擇組件的頁面變量值。
可選擇為組件的對應值,或輸入自定義的固定值。
選擇要賦值的頁面變量,單擊確定。
展示隱藏
觸發事件時,控制其他組件的展示和隱藏。
選擇觸發事件,選擇動作為展示隱藏。
設置點擊出現的組件和點擊隱藏的組件。均可多選。
調用其他服務
觸發事件時,調用自定義接口、本項目內業務邏輯開發或產品與物的管理接口。
選擇觸發事件,選擇動作為調用其他服務。
單擊選擇服務。
在服務配置對話框中,配置要調用的接口。
參數
說明
接口來源
選擇要調用的服務。
自定義接口:調用開發者自己開發的開放接口或第三方接口。
重要自定義接口必須滿足以下要求:
如果設置了請求參數,該參數必須使用JSON格式數據。
接口返回的數據必須是JSON格式的。
調用自定義接口,最大超時時間為10秒。若10秒內未收到接口返回的數據,則返回超時錯誤。
支持的JSON的數據格式有:
對象(Object):
{}
數組(Array):
[]
字符串(string):
"test"
數字(number):
123
布爾值(bool):
true
、false
業務邏輯開發:調用在當前項目中,通過業務邏輯開發的HTTP接口。
產品與物的管理:調用查詢產品信息列表接口、查詢產品屬性接口、查詢物的詳情列表接口或查詢物的數量接口。
請求方法
選擇自定義接口的請求方法,可選:get、post。
當接口來源選擇為自定義接口時出現的參數。
請求地址
輸入您的自定義接口的請求地址。
當接口來源選擇為自定義接口時出現的參數。
選擇接口
選擇要調用的接口。
當接口來源選擇為業務邏輯開發或產品與物的管理時出現的參數。
請求參數
可選:
靜態參數:需在下方輸入框中,填入鍵值對組成的請求參數,格式需為標準的JSON格式。
動態參數:需在下方添加請求參數,設置鍵和值。
值支持配置動態參數,單擊參數來源,可選組件值、URL參數、頁面變量或登錄賬號。詳細說明請參見上文“打開鏈接”中的參數描述。
打開彈窗容器
觸發事件時,打開彈窗組件。
選擇觸發事件,選擇動作為打開彈窗容器。
設置需要打開的彈窗組件。
如果彈窗組件配置了數據源,單擊配置彈窗數據源。在對話框數據源配置面板,您可以再次修改彈窗組件已配置的數據源,然后單擊確定。