全部產品
Search
文件中心

IoT Platform:添加屬性設定任務

更新時間:Jun 30, 2024

如果您需要同時設定多個裝置的屬性值,可以使用物聯網平台的裝置批量屬性設定任務。本文介紹該任務的建立方法、運行中Topic及其資料格式的說明,查看狀態的具體操作。

前提條件

  • 裝置所屬產品下已添加物模型屬性,且多個裝置中包含相同屬性標識符。具體操作,請參見添加物模型
  • 已在裝置端完成物模型屬性設定能力開發。具體操作,請參見物模型的設定屬性

任務管理流程

  1. 建立裝置批量屬性設定任務。
    1. 物聯網平台控制台對應執行個體下的監控營運 > 任務管理頁面,單擊建立任務
    2. 建立任務頁面,單擊以下參數名稱右側的協助表徵圖協助,根據頁面提示,配置任務和作業。
      • 任務配置
        參數說明
        任務名稱輸入符合規則的任務名稱。可自訂。
        任務類型選擇類型:裝置批量屬性設定任務
        任務描述輸入該任務的用途等資訊,便於您區分不同的任務。
        目標裝置、產品或分組
        從裝置、產品或分組維度選擇可執行任務的裝置。
        重要 從分組維度選擇裝置時,不支援選擇動態分組。
        下發給裝置的任務執行規則上傳規則檔案。僅支援.json格式檔案,檔案大小不能超過64 KB。

        您可單擊下載模板,擷取規則檔案模板。

        例如裝置所屬產品下的物模型屬性溫度標識符temperature),資料類型double,程式碼範例如下:

        {
            "params": {
                "temperature": 30.5
            }
        }
        • params:屬性設定參數。其下可包含多個屬性。
        • temperature30.5:屬性標識符及對應值。可在物聯網平台控制台,裝置所屬產品的功能定義中查看屬性標識符。

          如果是自訂(非預設)模組testFb下屬性temperature,則參數為"testFb:temperature":30.5

      • 作業配置
        參數說明
        作業執行速率配置根據您的業務需要,設定每分鐘作業推送數量。必選配置。
        作業執行的逾時配置僅對自訂任務生效。此處無需配置。
        作業開始調度時間可選配置。

        從當前設定作業的時間,開始計算時間。

        裝置任務建立成功後,先初始化,直至到達調度時間,才會開始調度執行。

    3. 單擊完成
  2. 任務建立完成後,物聯網平台通過調用SetDevicePropertySetDevicesProperty介面,下發設定屬性指令到裝置,然後裝置向物聯網平台返迴響應結果。

    資料格式(下行)

    請求和響應Topic

    透傳/自訂

    • 請求Topic:/sys/${productKey}/${deviceName}/thing/model/down_raw

    • 響應Topic:/sys/${productKey}/${deviceName}/thing/model/down_raw_reply

    Alink JSON

    • 請求Topic:/sys/${productKey}/${deviceName}/thing/service/property/set

    • 響應Topic:/sys/${productKey}/${deviceName}/thing/service/property/set_reply

    訊息格式如下:

    {
        "id": "123",
        "version": "1.0",
        "params": {
            "temperature": "30.5"
        },
        "method": "thing.service.property.set"
    }

    其中,params資料是任務規則檔案的params資料。

    設定裝置屬性的Alink協議,請參見設定裝置屬性

  3. 在物聯網平台對應執行個體下的監控營運 > 任務管理頁面,查看已建立任務及目前狀態。
    重要 狀態為已逾時的任務,不可再被調度執行。

    從任務建立完成開始計時,如果任務下作業未在7天內全部執行完成,任務狀態顯示為已逾時

    您可根據實際情境需要,執行以下操作:

    • 在工作清單中,取消執行中狀態的任務。
    • 單擊目標任務對應的查看,在任務詳情頁面,查看任務資訊和作業執行統計。
      功能頁簽說明
      任務資訊您可以查看任務資訊,修改任務描述和作業配置,下載裝置任務檔案。
      作業概覽您可以查看任務下各狀態的作業統計。
      • 您可以單擊目標裝置的查看,在裝置詳情頁面:
        • 單擊任務頁簽,查看該裝置下的所有工作清單。
        • 單擊Log Service前往查看,在雲端作業記錄頁簽的搜尋欄,選擇業務類型雲到裝置訊息,查看裝置任務相關日誌。
      • 如果作業未執行成功,單擊執行詳情,可查看失敗原因。
      • 如果作業執行已逾時或失敗,單擊已逾時失敗的狀態按鈕,可查看對應狀態的作業列表。

        您可以單擊列表上方的重新執行,重新執行當前任務下所有已逾時和失敗的作業。

    • 單擊目標任務對應的刪除,然後單擊確認
      警告 刪除裝置任務後,與該任務相關的資料被清除,如果有依賴該任務的業務,可能導致服務不可用或影響使用者的業務。請謹慎操作。