数据中心

一、报表管理

1、概述

通过配置时间周期和报表规则，数据维度可以选择设备或场景，并选择相应的变量，最后会根据配置生成相应的报表Excel文件，并可以下载查看。

2、配置规则

2.1、时间周期

• 周期计算：根据时间周期计算报表数据，数据会根据设置的周期自动循环生成报表，适用于制作周期性报表，如日报、周报、月报等。

  执行时间节点：根据选择的时间，每日几时、每周几几时、每月几日几时运算。

• 固定时间：选择开始和结束时间，则报表数据为该时间段的数据。

  执行时间节点：根据结束时间来执行

2.2、数据维度

• 设备：选择设备，选择该设备下的变量，则报表数据为所选变量的历史数据。

• 场景：选择场景，选择该场景下的变量，则报表数据为所选变量的历史数据。

2.3、数据类型

2.3.1、历史数据

直接查询所选变量在时间周期内的所有历史数据，并按时间升序排序。

2.3.2、聚合数据

报表规则需要选择聚合单位，变量需要选择统计方式。

• 聚合单位：可选分钟、小时、天、月，根据时间周期按单位分割时间段，例如分钟：则该时间周期内每分钟为一个时间段。

• 统计方式：可选平均值、最大值、最小值、累计值、差值、极差值，根据分割出的时间段，每个变量该时间段内的历史数据按统计方式计算出一个最终值。

3、生成报表

根据配置的报表规则，在执行时间节点会生成一个报表Excel文件，并保存到指定位置。

4、报表下载

在报表下载列表，直接点击下载按钮，即可下载报表Excel文件。

5、消息通知

5.1、QQ邮箱通知

• 先去创建通知模板，模板内容如下图所示；

提示

注意：需要把下载地址里面的地址改为自己服务器的IP或域名。QQ邮箱报表通知模板目前支持的变量如图所示，可参考消息通知文档自行调整。

• 配置报表时可选通知用户配置，报表生成后会发送到用户的QQ邮箱；

提示

注意：用户个人信息必须配置有效的QQ邮箱，否则无法发送通知。

6、后续优化

• 报表生成后可以通过邮箱发送报表文件
• 根据报表数据生成相应的图表展示

二、历史记录

选择设备或场景下的变量，可单选或多选，并选择时间段，即可查询出变量该时间段内的历史数据，按时间升序排序，并通过曲线图和表格展示。

二、数据分析

选择设备和时间，并展示设备相关的数据，依次展示设备变量历史数据折线图、告警处理情况、变量下发次数统计、变量实时数值表、实时告警记录，可根据数据分析设备的运行情况。

三、报表验收

验收项	正常表现
报表规则	时间周期、数据维度、变量和统计方式保存成功
周期生成	到达执行时间后生成报表记录
Excel 下载	下载文件可打开，数据列完整
历史数据	设备或场景变量可按时间查询
聚合数据	平均值、最大值、最小值、累计值等计算正确
邮件通知	配置通知用户后可收到报表下载链接
租户隔离	不同机构只能查看权限范围内报表

四、常见问题

报表没有生成

检查规则状态、执行时间、服务器时间、定时任务是否启用，变量是否有历史数据。

报表为空

检查时间范围内设备是否上报、变量是否开启历史存储、统计方式是否适合当前数据。

下载链接打不开

检查服务器域名、Nginx 转发、文件存储路径、通知模板中的下载地址。

邮件没有收到

检查通知模板、用户邮箱、通知渠道、发送日志和邮件服务商限制。

五、二次开发入口

类型	路径或接口	说明
前端页面	vue3/src/views/dataCenter/report	报表管理、下载、编辑
后端接口	报表相关接口	报表规则、记录、数据生成
数据表	report、report_records、report_rule、report_rule_data	报表核心表
通知模块	springboot/fastbee-notify	报表邮件通知
数据模块	springboot/fastbee-iot-data	历史数据和聚合数据来源