全部產品
Search
文件中心

IoT Platform:添加待流轉的資料來源

更新時間:Jun 30, 2024

通過規則引擎的雲產品流轉功能,物聯網平台可將指定Topic的資料,流轉至其他Topic和其他阿里雲產品中。本文介紹添加訊息Topic作為資料來源的具體操作。

背景資訊

配置資料流轉解析器時,需關聯已添加的訊息Topic,作為待流轉的資料。每個資料來源中最多添加1,000個訊息Topic。

解析器指令碼中可使用擷取訊息內容相關的函數topic(n),擷取訊息來源的Topic。更多資訊,請參見資料流轉支援的函數

建立資料來源

  1. 登入物聯網平台控制台

  2. 執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。

  3. 在左側導覽列,選擇訊息轉寄 > 雲產品流轉

  4. 雲產品流轉頁面,單擊右上方體驗新版,進入新版功能頁面。

    說明

    如果您已執行過此操作,再次進入雲產品流轉頁面,會直接進入新版功能頁面。

  5. 單擊資料來源頁簽,然後單擊建立資料來源

  6. 輸入資料來源名稱和描述,單擊確定

    資料來源名稱支援中文、英文字母、日文、數字、底線(_)和短劃線(-),長度為1~30個字元,一個中文及日文佔2個字元。

    根據頁面提示,可直接進入資料來源詳情頁面。您可單擊右上方編輯,修改資料來源名稱和描述。資料來源詳情

  7. 資料來源詳情頁面,單擊添加Topic,在彈出對話方塊中,根據頁面提示,選擇需要處理的訊息Topic,然後單擊確定

    支援的Topic如下:

    重要

    對於雲網關產品和裝置,僅支援選擇自訂裝置狀態變化通知裝置生命週期變更。訊息轉寄Topic和資料格式的詳情說明,請參見開源MQTT協議的訊息通訊說明JT/T 808協議的訊息轉寄說明GB/T 32960協議的訊息轉寄說明

    表 1. Topic說明

    Topic

    說明

    相關文檔

    自訂

    流轉自訂資料格式訊息的Topic,與自訂Topic的格式相同。格式為:/${productKey}/${deviceName}/user/${TopicShortName}

    其中${TopicShortName}為自訂的Topic類,即自訂Topic的尾碼。

    支援使用萬用字元(+)和(#):

    • 全部裝置(+):指定產品下所有裝置。

    • /user/#:指定裝置的所有自訂Topic。

    使用自訂Topic通訊

    裝置狀態變化通知

    流轉裝置上下線狀態變更訊息的Topic:/as/mqtt/status/${productKey}/${deviceName}

    裝置上下線狀態

    物模型資料上報

    包含:

    • 流轉裝置上報屬性資料的Topic:/${productKey}/${deviceName}/thing/event/property/post

    • 流轉裝置上報事件數目據的Topic:/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post

    • 流轉裝置批量上報屬性資料的Topic:/${productKey}/${deviceName}/thing/property/batch/post

    • 流轉裝置批量上報事件數目據的Topic:/${productKey}/${deviceName}/thing/event/batch/post

    • 流轉裝置響應雲端命令返回訊息的Topic:/${productKey}/${deviceName}/thing/downlink/reply/message

    對應裝置上報未經處理資料的Topic如下:

    • 裝置上報屬性的Topic:/sys/${productKey}/${deviceName}/thing/event/property/post

    • 裝置上報事件的Topic:/sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post/sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:{tsl.event.identifier}/post

    • 裝置批量上報屬性、事件數目據的Topic:/sys/${productKey}/${deviceName}/thing/event/property/batch/post

    裝置生命週期變更

    流轉裝置建立、刪除、禁用、啟用等訊息的Topic:/${productKey}/${deviceName}/thing/lifecycle

    裝置生命週期變更

    網關發現子裝置上報

    網關裝置特有的Topic:/${productKey}/${deviceName}/thing/list/found,將發現的子裝置資訊上報給物聯網平台,然後進行流轉。

    網關發現子裝置

    裝置拓撲關係變更

    網關裝置特有Topic:/${productKey}/${deviceName}/thing/topo/lifecycle,流轉子裝置和網關之間的拓撲關係建立和解除訊息的Topic。

    裝置拓撲關係變更

    對應裝置上報未經處理資料的Topic:/sys/${productKey}/${deviceName}/thing/topo/change

    通知網關拓撲關係變化

    裝置標籤變更

    流轉裝置標籤資訊變更的Topic:/${productKey}/${deviceName}/thing/deviceinfo/update

    裝置標籤變更

    對應裝置上報未經處理資料的Topic:/sys/${productKey}/${deviceName}/thing/deviceinfo/update

    上報標籤資訊

    物模型歷史資料上報

    包含:

    • 流轉裝置上報歷史屬性資料的Topic:/${productKey}/${deviceName}/thing/event/property/history/post

    • 流轉裝置上報歷史事件數目據的Topic:/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/history/post

    對應裝置上報物模型歷史資料的Topic:/sys/${productKey}/${deviceName}/thing/event/property/history/post

    物模型歷史資料上報

    OTA升級裝置狀態通知

    包含:

    • 流轉裝置上報OTA升級結果的Topic:/${productKey}/${deviceName}/ota/upgrade

    • 流轉裝置上報OTA升級進度的Topic:/${productKey}/${deviceName}/ota/progress/post

    對應裝置上報升級進度的Topic:/ota/device/progress/${productKey}/${deviceName}

    裝置上報升級進度

    OTA模組版本號碼上報

    流轉裝置上報OTA模組版本號碼變更的Topic:/${productKey}/${deviceName}/ota/version/post

    OTA模組版本號碼變更通知

    對應裝置上報OTA模組版本的Topic:/ota/device/inform/${productKey}/${deviceName}

    裝置上報OTA模組版本

    OTA升級批次狀態通知

    物聯網平台通知OTA升級批次狀態變化的Topic:/${productKey}/${packageId}/${jobId}/ota/job/status

    OTA升級批次狀態通知

    任務事件

    包含:

    • 流轉裝置任務狀態通知的Topic:/sys/uid/${uid}/job/${jobId}/lifecycle

    • 流轉執行個體遷移任務狀態通知的Topic:/sys/uid/${uid}/distribution/${jobId}/lifecycle

      說明

      遷移產品的名稱為執行個體遷移的任務名稱。

  8. 可選:重複上一步操作,可在當前資料來源下,添加多個訊息Topic。

    添加Topic後,若有業務需求,您也可在資料來源詳情頁面,刪除已添加的訊息Topic。Topic列表

  9. 可選:重複步驟5~8,添加多個資料來源。

後續步驟

添加轉寄到的資料目的