物聯網平臺自動報表通用配置核心邏輯：先確定數據源→建報表模板→配置聚合統計→添加定時調度→設置推送(郵件/本地存儲)→測試

一、前置準備(必須先完成)

1. 設備已接入平臺，遙測變量/物模型屬性正常上報，時序歷史數據開啟存儲;

2. 確認需要統計的測點：溫度、流量、電能、開關狀態等;

3. 確定聚合方式：平均值、最大值、最小值、累計值、總時長;

4. 報表周期：小時報 / 日報 / 周報 / 月報;輸出格式：CSV/Excel/PDF;

5. 確認接收方式：平臺存檔下載、郵件自動推送、API回調。

二、通用5步配置

1. 選擇數據源與數據聚合

- 原始數據：直接導出原始上報記錄;

- 聚合數據(推薦用于日報月報)：平臺預計算，按時間窗口自動統計(均值、累計、極值)

> 聚英云/EMCP/有人云：先把測點添加為匯總變量，設置采樣周期，平臺定時預計算并存入匯總表，報表直接讀取聚合結果，減輕查詢壓力。

> 阿里云IoT：在「分析洞察」新建SQL離線任務，寫SQL做聚合，配置調度，結果存入自定義存儲表。

> ThingsBoard：報表模板內通過Entity Alias篩選設備，設置時間窗口+聚合函數。

2. 新建報表模板(定義報表內容、列、布局)

1. 進入【報表管理 / 智能報表 / Reporting模板】→新建報表

2. 填寫報表名稱;選擇設備分組/單個設備，勾選需要展示的變量

3. 配置報表字段：時間戳、設備名稱、測點值、聚合結果、備注、報警標記

4. 選擇文件格式：Excel/CSV(原始數據)，PDF(帶圖表正式報告)

5. 預覽報表，檢查字段順序、小數位數、單位，保存模板

3. 開啟周期自動生成(定時調度核心)

找到定時任務/調度計劃/Scheduled report

- 任務名稱

- 執行周期：每日凌晨0點生成昨日日報;每月1號生成上月月報(注意時區!)

- 統計時間窗口：`上一日 00:00 ~ 24:00`

- 選擇剛才建好的報表模板

- 啟用定時任務

> 有人云：報表里勾選【周期循環下載】，設置天/周/月周期

> ThingsBoard PE：Reporting → Scheduling → +Scheduled report，綁定模板、時區、執行賬號(報表權限跟隨該賬號)

4. 自動推送配置(可選)

- 本地存檔：報表生成后保存在平臺報表列表，隨時下載;

- 郵件推送：填入收件郵箱，支持多收件人，報表作為附件自動發送;

- API推送：平臺生成報表后，調用業務系統Webhook，把文件鏈接傳給MES/ERP;

- 部分平臺支持短信、企業微信推送報表鏈接。

5. 測試與排錯

1. 手動觸發一次【測試生成報表】，檢查數據是否完整、有無缺數;

2. 等待定時任務跑一次，驗證自動生成+推送;

3. 常見問題排查：

- 報表為空：設備歷史存儲未開啟、測點key寫錯、時間窗口跨時區錯誤;

- 數據不全：采樣周期太短，數據量大查詢超時，改用預聚合匯總表;

- 定時任務不執行：定時任務未啟用、賬號權限不足、平臺郵件服務未開通。

三、各平臺簡要差異

? 聚英云(輕量化物聯網云平臺)

1. 設備歷史數據開啟存儲;

2. 在【數據匯總/歷史報表】添加匯總變量，配置聚合(平均/累計);

3. 進入報表模塊新建報表，綁定匯總變量;

4. 設置周期存儲(日報/月報)，數據云端自動記錄保存1年，支持后臺自動存儲，支持報表Excel格式下載;

5. 公有云版本原生郵件定時推送功能有限，兩種方案：

- 方案A：定時生成報表存在平臺，業務系統通過REST API定時拉取文件;

- 方案B：私有化部署版本支持配置郵件自動推送。

? ThingsBoard(企業版PE才有自動報表，社區版無原生定時報表)

1. Reporting → Templates 創建報表模板，拖拽組件，綁定設備遙測、圖表;

2. Scheduling新建定時任務，選擇模板、執行周期、接收人;

3. 支持PDF/CSV，郵件推送;社區版需要用規則引擎+外部腳本自己實現導出。

? 阿里云IoT平臺

1. 物模型+時序存儲;

2. 數據服務→分析洞察，新建SQL離線分析任務，配置調度(日/小時)，計算結果寫入存儲表;

3. 報表讀取分析結果表，搭配API/Quick BI定時導出。

? 有人云

報表管理→新建報表，選擇【周期循環下載】，選擇設備變量，設置周期，自動生成并支持郵件推送CSV/Excel。

四、推薦架構選型建議

- 簡單項目(幾十臺設備，日報導出Excel存檔)：直接使用平臺自帶匯總報表，API拉取;

- 需要自動郵件發給客戶、帶圖表PDF報告：優先ThingsBoard PE或私有化聚英云;

- 海量設備、復雜統計(能耗、環保合規報表)：平臺時序庫+離線SQL預聚合，再輸出報表。

五、落地注意事項

1. 時區：報表統計窗口務必統一北京時間，跨時區很容易出現日期錯位;

2. 數據存儲時長：平臺時序數據有保留期限，月報要確保整月數據沒有過期清理;

3. 權限：定時任務執行賬號必須擁有所有目標設備的讀權限，否則報表為空;

4. 補報表：大部分平臺支持手動回溯生成歷史周期報表，用于補錄。