如果您需要同時調用多個設備的異步服務，可使用物聯網平臺的設備批量服務調用任務。本文介紹該任務的創建方法、運行中Topic及其數據格式的說明，查看狀態的具體操作。

前提條件

  • 設備所屬產品下已添加物模型服務（異步調用），且多個設備中包含相同服務標識符。具體操作，請參見添加物模型。
  • 已在設備端完成物模型服務調用能力開發。具體操作，請參見物模型的調用服務。

任務管理流程

  1. 創建設備批量服務調用任務。
    1. 在物聯網平臺控制臺對應實例下的監控運維 > 任務管理頁面，單擊創建任務。
    2. 在創建任務頁面，單擊以下參數名稱右側的幫助圖標幫助，根據頁面提示，配置任務和作業，單擊完成。
      • 任務配置
        參數說明
        任務名稱輸入符合規則的任務名稱。可自定義。
        任務類型選擇類型：設備批量服務調用任務。
        任務描述輸入該任務的用途等信息，便于您區分不同的任務。
        目標設備、產品或分組
        從設備、產品或分組維度選擇可執行任務的設備。
        重要 從分組維度選擇設備時，不支持選擇動態分組。
        下發給設備的任務執行規則上傳規則文件。僅支持.json格式文件，文件大小不能超過64 KB。

        您可單擊下載模板，獲取規則文件模板。

        例如設備所屬產品下物模型服務數據計算，標識符為Operation_Service，調用方式為異步，輸入參數為數值A（NumberA）和數值B（NumberB），參數數據類型均為int32，代碼示例如下：

        {
    "serviceIdentifier": "Operation_Service",
    "params": {
        "NumberA": 32,
        "NumberB": 56
    }
}
        • serviceIdentifier：服務唯一標識符。可在物聯網平臺控制臺中，設備所屬產品的功能定義中查看。

          如果是自定義（非默認）模塊testFb下服務Operation_Service，則參數為"serviceIdentifier": "testFb:Operation_Service",。

        • params：服務的入參，可包含多個入參。
      • 作業配置作業配置
        參數說明
        作業執行速率配置根據您的業務需要，設置每分鐘作業推送數量。必選配置。
        作業執行的超時配置僅對自定義任務生效。此處無需配置。
        作業開始調度時間可選配置。

        從當前設置操作的時間，開始計算時間。

        設備任務創建成功后，先初始化，直至到達調度時間，才會開始調度執行。

  2. 任務創建完成后，物聯網平臺通過InvokeThingService或InvokeThingsService接口調用服務，采用異步方式下行推送請求，然后設備也采用異步方式向物聯網平臺返回響應結果。

    消息格式如下：

    {
    "id": "123",
    "version": "1.0",
    "params": {
        "Power": "on",
        "WF": "2"
    },
    "method": "thing.service.${tsl.service.identifier}"
}

    其中，params數據是任務規則文件中params數據；{tsl.service.identifier}是任務規則文件中serviceIdentifier的值。上文規則文件對應消息格式如下：

    {
  "id": "123",
  "version": "1.0",
  "params": {
    "NumberA": 32,
    "NumberB": 56
  },
  "method": "thing.service.Operation_Service"
}

    設備服務異步調用的Alink協議，請參見設備服務調用（異步調用）。

  3. 在物聯網平臺對應實例下的監控運維 > 任務管理頁面，查看已創建任務及當前狀態。
    重要 狀態為已超時的任務，不可再被調度執行。

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

    您可根據實際場景需要，執行以下操作：

    • 在任務列表中，取消執行中狀態的任務。
    • 單擊目標任務對應的查看，在任務詳情頁面，查看任務信息和作業執行統計。
      功能頁簽說明
      任務信息您可以查看任務信息，修改任務描述和作業配置，下載設備任務文件。
      作業概覽您可以查看任務下各狀態的作業統計。
      • 您可以單擊目標設備的查看，在設備詳情頁面：
        • 單擊任務頁簽，查看該設備下的所有任務列表。
        • 單擊日志服務的前往查看，在云端運行日志頁簽的搜索欄，選擇業務類型為云到設備消息，查看設備任務相關日志。
      • 如果作業未執行成功，單擊執行詳情，可查看失敗原因。
      • 如果作業執行已超時或失敗，單擊已超時或失敗的狀態按鈕，可查看對應狀態的作業列表。

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

    • 單擊目標任務對應的刪除，然后單擊確認。
      警告 刪除設備任務后，與該任務相關的數據被清除，如果有依賴該任務的業務，可能導致服務不可用或影響用戶的業務。請謹慎操作。