MyEMS 开箱即用了 20 多种标准报表：计量表能耗、空间能耗分类、能流图、碳排放……但真实场景永远比标准模板复杂——

这些需求，MyEMS 的标准报表都不直接覆盖。但好消息是——MyEMS 基于 MIT 协议，代码全开放，报表模块的扩展是系统中最容易上手的二次开发入口。

在动手之前，你需要理解 MyEMS 报表模块的三个关键设计模式。

2.1 一个报表 = 一个 Falcon Resource 类

 框架（轻量级 Python REST 框架），每个报表对应 

 目录下的一个 Python 文件，核心结构高度统一：

myems-api/reports/
├── meterenergy.py          # 计量表能耗报表
├── metercarbon.py          # 计量表碳排放报表
├── spaceenergycategory.py  # 空间能耗分类报表
├── energyflowdiagram.py    # 能流图报表
├── ...                     # 更多标准报表
└── youreport.py            # ← 你要新增的自定义报表

class Reporting:
    def __init__(self):
        pass

    def on_options(self, req, resp):
        resp.status = falcon.HTTP_200

    def on_get(self, req, resp):
        # 1. 验证 API Key
        # 2. 解析请求参数
        # 3. 查数据库
        # 4. 组装结果
        # 5. 返回 JSON（可选导出 Excel）

MyEMS 的 Web UI 基于 React，报表页面对应路由在 

 下注册。标准报表的页面组件位于 

理解了这三点，下面的代码你就能看懂每一行"为什么这么写"。

实战：自定义"班次能耗对比报表"

我们来实现一个真实场景的报表——按早班（06:00-14:00）、中班（14:00-22:00）、夜班（22:00-06:00）分别统计各计量表的用电量，支持日/周/月周期选择，可导出 Excel。

解析 spaceid / periodtype / reportingperiodstart / reportingperiodend 参数

按班次时间段从 tbl_meter_hourly 查能耗，夜班跨日用 OR 拆分

组装 JSON 返回，quickmode=false 时调用 Excel 导出器

"""shift energy report api"""
import falcon
import mysql.connector
import simplejson as json
from datetime import datetime
import config
import excelexporters.shiftenergy

class Reporting:
    def __init__(self):
        pass

    @staticmethod
    def on_options(req, resp):
        resp.status = falcon.HTTP_200

    @staticmethod
    def on_get(req, resp):
        # 第一步：验证 API 密钥
        if 'API-KEY' not in req.headers or \
                req.headers['API-KEY'] != config.myems_api['api_key']:
            raise falcon.HTTPError(status=falcon.HTTP_400,
                title='API.BAD_REQUEST',
                description='API.INVALID_API_KEY')

        # 第二步：解析请求参数
        space_id = req.params.get('spaceid')
        period_type = req.params.get('periodtype')
        reporting_period_start = req.params.get('reportingperiodstart')
        reporting_period_end = req.params.get('reportingperiodend')

        if not space_id or period_type not in ('hourly','daily','monthly'):
            raise falcon.HTTPError(status=falcon.HTTP_400,
                title='API.BAD_REQUEST',
                description='API.INVALID_PARAMETERS')

        start_utc = datetime.strptime(reporting_period_start, '%Y-%m-%dT%H:%M:%S')
        end_utc   = datetime.strptime(reporting_period_end,   '%Y-%m-%dT%H:%M:%S')

        # 第三步：连接数据库
        cnx_system = mysql.connector.connect(**config.myems_system_db)
        cnx_energy = mysql.connector.connect(**config.myems_energy_db)
        try:
            cursor_system = cnx_system.cursor()
            cursor_energy = cnx_energy.cursor()

            # 第四步：查询空间下的所有计量表
            cursor_system.execute(
                "SELECT m.id, m.name, ec.name, ec.unit "
                "FROM tbl_meters m "
                "INNER JOIN tbl_spaces_meters sm ON m.id=sm.meter_id "
                "INNER JOIN tbl_energy_categories ec ON m.energy_category_id=ec.id "
                "WHERE sm.space_id=%s ORDER BY m.id", (space_id,))
            rows_meters = cursor_system.fetchall()

            # 第五步：按班次查询能耗数据
            shifts = {
                'morning':   {'start': 6,  'end': 14},
                'afternoon': {'start': 14, 'end': 22},
                'night':     {'start': 22, 'end': 6},
            }
            result_data = []
            for meter_id, meter_name, ec_name, ec_unit in rows_meters:
                meter_result = {'meter_id': meter_id, 'meter_name': meter_name,
                                'energy_category': ec_name, 'unit': ec_unit, 'shifts': {}}
                for shift_name, sr in shifts.items():
                    # 夜班跨日 → 用 OR 拆分 SQL
                    if sr['start'] > sr['end']:
                        query = ("SELECT SUM(actual_value) FROM tbl_meter_hourly "
                                 "WHERE meter_id=%s AND ((start_datetime>=%s AND start_datetime<%s "
                                 "AND HOUR(start_datetime)>=%s) OR (start_datetime>=%s "
                                 "AND start_datetime<%s AND HOUR(start_datetime)<%s))")
                        cursor_energy.execute(query,
                            (meter_id, start_utc, end_utc, sr['start'],
                             start_utc, end_utc, sr['end']))
                    else:
                        query = ("SELECT SUM(actual_value) FROM tbl_meter_hourly "
                                 "WHERE meter_id=%s AND start_datetime>=%s AND start_datetime<%s "
                                 "AND HOUR(start_datetime)>=%s AND HOUR(start_datetime)<%s")
                        cursor_energy.execute(query,
                            (meter_id, start_utc, end_utc, sr['start'], sr['end']))

                    row = cursor_energy.fetchone()
                    meter_result['shifts'][shift_name] = round(float(row[0] or 0), 3)

                total = sum(meter_result['shifts'].values())
                meter_result['shifts']['total'] = round(total, 3)
                result_data.append(meter_result)

            # 第六步：组装返回结果
            result = {'space': {'id': space_id},
                      'reporting_period': {
                          'start_datetime': start_utc.strftime('%Y-%m-%dT%H:%M:%S'),
                          'end_datetime': end_utc.strftime('%Y-%m-%dT%H:%M:%S')},
                      'shifts_definition': shifts,
                      'meters': result_data}
        except Exception as e:
            raise falcon.HTTPError(status=falcon.HTTP_500,
                title='API.INTERNAL_ERROR', description=str(e))
        finally:
            cursor_system.close(); cursor_energy.close()
            cnx_system.close();     cnx_energy.close()

        # 第七步：可选 Excel 导出
        if req.params.get('quickmode') != 'true':
            result['excel_bytes'] = excelexporters.shiftenergy.export(
                result, space_id, reporting_period_start,
                reporting_period_end, period_type)

        resp.text = json.dumps(result)
        resp.status = falcon.HTTP_200

 夜班 22:00-06:00 必须用 OR 拆成两段 SQL

 MyEMS 标准模式，确保数据库连接不泄漏

 传 quickmode=true 跳过 Excel 生成，加速前端渲染

"""shift energy report excel exporter"""
import base64
from io import BytesIO
import openpyxl
from openpyxl.styles import Font, Alignment, Border, Side, PatternFill

def export(report, space_id, start, end, period_type):
    wb = openpyxl.Workbook()
    ws = wb.active
    ws.title = "班次能耗对比"

    header_font = Font(name='Arial', bold=True, size=12, color='FFFFFF')
    header_fill = PatternFill(start_color='4472C4', end_color='4472C4', fill_type='solid')
    thin_border = Border(left=Side(style='thin'), right=Side(style='thin'),
                         top=Side(style='thin'), bottom=Side(style='thin'))

    titles = ['计量表名称','能源类别','单位',
              '早班(06-14)','中班(14-22)','夜班(22-06)','合计']
    for col, title in enumerate(titles, 1):
        c = ws.cell(row=1, column=col, value=title)
        c.font = header_font; c.fill = header_fill
        c.alignment = Alignment(horizontal='center')
        c.border = thin_border

    for row_idx, meter in enumerate(report.get('meters',[]), 2):
        s = meter.get('shifts',{})
        row_data = [meter.get('meter_name',''), meter.get('energy_category',''),
                    meter.get('unit',''), s.get('morning',0),
                    s.get('afternoon',0), s.get('night',0), s.get('total',0)]
        for col, val in enumerate(row_data, 1):
            c = ws.cell(row=row_idx, column=col, value=val)
            c.border = thin_border
            if col >= 4: c.number_format = '#,##0.000'

    buffer = BytesIO()
    wb.save(buffer); buffer.seek(0)
    return base64.b64encode(buffer.read()).decode('utf-8')

from reports.shiftenergy import Reporting as ShiftEnergyReporting
api.add_route('/reports/shiftenergy', ShiftEnergyReporting())

curl -X GET \
  "http://localhost:8000/reports/shiftenergy?spaceid=1&periodtype=hourly&reportingperiodstart=2025-06-01T00:00:00&reportingperiodend=2025-06-30T23:59:59" \
  -H "API-KEY: your-api-key-here"

import React, { useState, useEffect, useCallback } from 'react';
import { APIBaseURL } from '../../config';
import { useTranslation } from 'react-i18next';
import ShiftEnergyTable from './ShiftEnergyTable';

const ShiftEnergyReport = () => {
  const { t } = useTranslation();
  const [spaceId, setSpaceId] = useState('');
  const [periodType, setPeriodType] = useState('hourly');
  const [reportData, setReportData] = useState(null);
  const [loading, setLoading] = useState(false);

  // 查询报表
  const handleSubmit = useCallback(() => {
    if (!spaceId) return;
    setLoading(true);
    const params = new URLSearchParams({
      spaceid: spaceId, periodtype: periodType,
      reportingperiodstart: start.toISOString().slice(0,19),
      reportingperiodend:   end.toISOString().slice(0,19),
      quickmode: 'true',
    });
    fetch(`${APIBaseURL}/reports/shiftenergy?${params}`, {
      headers: { 'API-KEY': localStorage.getItem('api_key') },
    }).then(r => r.json()).then(json => {
      setReportData(json); setLoading(false);
    });
  }, [spaceId, periodType]);

  // 下载 Excel (省略 base64 解码逻辑，见完整文章)

  return (
    <div>
      {/* 筛选条件栏 */}
      <select value={spaceId} onChange={e=>setSpaceId(e.target.value)}>...</select>
      <select value={periodType} onChange={e=>setPeriodType(e.target.value)}>...</select>
      <button onClick={handleSubmit}>{loading ? '...' : t('Query')}</button>
      <button onClick={handleExport}>{t('Export Excel')}</button>
      {reportData && <ShiftEnergyTable data={reportData} />}
    </div>
  );
};

import ShiftEnergyReport from '../pages/ShiftEnergyReport';

// 路由配置
{ path: '/reports/shiftenergy', name: 'reports.shiftenergy', component: ShiftEnergyReport }

// 侧边栏菜单
{ id: 'reports.shiftenergy', name: 'reports.shiftenergy', url: '/reports/shiftenergy' }

。高并发下连接池会瞬间耗尽，千万不能只 open 不 close。

 是两个独立时间段，不能写在一个 AND 里。必须用 

标准报表都做了 API Key 验证。跳过此步骤意味着未登录也能访问——生产环境的安全隐患。务必保留 

MyEMS Web UI 支持中/英/德多语言。所有用户可见文案应通过 

 函数输出，不要硬编码中文字符串。

在 myems-aggregation/ 下新增自定义聚合逻辑，按班次维度预聚合能耗值，避免每次查报表都实时计算

结合 tbl_virtual_meters 和 tbl_command 表，当夜班能耗超过阈值时自动触发告警通知

引入 Prophet 或 ARIMA 模型，在报表中增加"预测值 vs 实际值"对比列

参考 meter_carbon.py 的模式，将班次能耗乘以碳排放因子，生成班次碳排报表

MyEMS 的报表模块二次开发，本质上是

这三个文件各司其职，通过 REST API 串起来。理解了 

 中的标准模式，任何自定义报表都是同一套骨架的变体——改 SQL 查询逻辑、改数据组装结构、改前端展示样式。

开源的真正力量不是免费，而是你能看懂每一行代码在做什么，然后改掉它。

MyEMS 二次开发入门：自定义能耗报表模块完整代码示例

一套开源能源管理系统，真正的价值不在于"开箱即用"，而在于你能不能把它变成自己的。
本文带你从零写出一个完整的自定义能耗报表模块——后端 API、数据查询、Excel 导出、前端页面，全部可运行的代码，一行不少。

编程语言

MyEMS报表二次开发指南：针对工厂班次能耗、园区费用明细等个性化需求，通过Falcon框架+MySQL双库模式快速扩展。提供完整代码示例，包括后端API开发、Excel导出器实现及前端页面集成，解决跨日查询、数据库连接管理等常见问题，实现企业级能耗分析报表定制。

预测分析

数据库

路由

Python

MySQL

React

JSON

腾讯云BI特惠9.9元起！


腾讯云大数据特惠0.2折起


oceanus

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

MyEMS 二次开发入门：自定义能耗报表模块完整代码示例

MyEMS 二次开发入门：自定义能耗报表模块完整代码示例

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐