SuperAPI AI 工具集

reports

编程与开发

查看项目

更新于 10-16 06:24

技能介绍

用途:在 Frappe 中创建数据分析和汇总报表,支持三种报表类型,按复杂度选择。Report Builder 无需代码,适合简单字段选择、分组和排序;Query Report 只需 SQL,适合直接查询、联表和聚合;Script Report 需要 Python 加 JS,适合复杂逻辑、计算字段和动态筛选。

主要能力:可添加自定义筛选、格式化器和图表,创建可打印报表格式。Query Report 在 SELECT 中用 "Label:Fieldtype/Options:Width" 定义列,筛选变量使用 %(filter_name)s 参数化。Script Report 通过 execute(filters) 返回 columns、data、chart,配合 JSON 元数据和 JS 筛选器定义。报表遵循标准目录结构时自动发现,无需在 hooks.py 注册。

使用方式:Report Builder 在界面新建报表并选择 Report Type;Query Report 写 SQL 并设置 Reference DocType 控制权限;Script Report 按 report 目录放置 .json、.py、.js 文件。可选在报表目录添加 HTML 作为打印格式。

限制与注意事项:需在 SQL 中通过 frappe.db.escape() 或参数化防止注入,检查权限,限制结果集大小,处理空结果和聚合中的 None,按需显式过滤 docstatus。相关调试包括模块路径、bench migrate、SQL 语法和索引性能。官方未提供收费、价格或平台信息。