📊 报表引擎

吾码报表不只是只读查询：它能查询并编辑虚拟表格数据，再由接口引擎按业务规则新增、修改或删除多张表，也能编排多个已配置数据库。ECharts 图表与仪表盘使用界面引擎。

组成

Rpt_Report：报表定义；
报表字段：虚拟 diy_table/diy_field 设计，支持查询、排序、格式和表内编辑；
接口引擎类型化数据能力：用 V8、SQL 或 JSON 提供查询结果；
接口引擎写操作：查询替换及新增、修改、删除，可编排多表与多数据库；
模块引擎：菜单、列、筛选、按钮和权限。

报表字段是虚拟字段，不应假设存在同名物理列。

建模流程

明确指标口径、时间范围、时区、维度、精度、数据权限和导出上限。
创建类型化接口查询并使用稳定 ApiEngineKey。
创建报表、绑定接口引擎查询并配置字段。
通过模块引擎配置查询列、可编辑列、搜索列、排序和按钮。
写操作分别绑定专用接口引擎。
用真实普通角色、无权限角色和另一租户验收。

查询安全

禁止把 V8.Param._Where、字段名、排序或用户输入直接拼接 SQL。动态值使用 .AddInParameter，可选维度和排序由白名单映射：

var tenantId = V8.CurrentUser.TenantId;
var keyword = String(V8.Param.Keyword || '');
var pageSize = Math.min(Math.max(Number(V8.Param._PageSize || 20), 1), 100);

var rows = V8.Db.FromSql(`
SELECT ShebeiMC, ShebeiXH, SUM(Shuliang) AS Shuliang
FROM diy_huanxinlb
WHERE OsClient = @osClient
  AND TenantId = @tenantId
  AND ShebeiMC LIKE @keyword
GROUP BY ShebeiMC, ShebeiXH
ORDER BY ShebeiMC ASC
LIMIT @pageSize`)
  .AddInParameter('@osClient', V8.OsClient)
  .AddInParameter('@tenantId', tenantId)
  .AddInParameter('@keyword', '%' + keyword + '%')
  .AddInParameter('@pageSize', pageSize)
  .ToArray();
return { Code: 1, Data: rows };

不同数据库的分页语法不同；正式接口按当前数据库适配。菜单数据范围不会自动保护任意聚合 SQL，数据源/接口必须在真实查询中应用当前用户范围。聚合结果也可能泄露敏感信息，必要时设置最小样本或脱敏。

可增删改查的写入型报表

报表查询返回的每一行都可以按字段配置进入编辑状态。保存、新增或删除时，报表不直接把前端行数据写回某一张物理表，而是分别调用配置的 ApiReplace.Select / Insert / Update / Delete 或菜单查询接口，让接口引擎重算并执行真正的业务动作。

text

报表查询 / SelectApi
        ↓
虚拟字段表格 → 新增 / 编辑 / 删除
        ↓
InsertApi / UpdateApi / DeleteApi
        ↓
权限与状态重算 → 多张业务表 → 当前库或多个已配置数据库

因此，一次“编辑报表行”可以在同一业务事务中同步主表、明细、库存、审计等多张表；也可以通过 V8.Dbs.<已配置数据库Key> 编排 ERP、MES 或其它数据库。当前数据库内的多表写入应共享事务；跨数据库无法天然形成同一个本地事务时，必须使用幂等键、状态机、outbox/inbox 或补偿机制，不能宣称前端保存成功就等于所有外部库已一致。

多表新增、修改、删除必须由接口引擎在执行前重新校验：

当前用户和记录范围；
当前业务状态与并发版本；
金额、数量、状态迁移；
幂等键与唯一约束。

前端隐藏按钮、只读字段或当前行数据不能作为授权。资产、库存、审批和批量副作用不得由前端直接调用通用 FormEngine 修改。

性能与导出

默认分页并限制最大每页、聚合桶和导出行数。
大聚合使用索引、预聚合表或专用统计接口。
缓存 Key 包含 OsClient + ReportId + 授权版本/用户 + 参数哈希。
大导出使用后台任务；文件放私有桶并按菜单、记录、字段签发访问。

老版本升级

旧库缺少 ReportName/ReportId/DataSourceId 或报表字段关联时，使用当前版本 Upgrade/表单设计补齐并回读；不要直接复制其它租户的报表、数据源或连接配置。升级后重新选择字段数据源和菜单权限，并做真实 UI 验收。

完整规范见 microi.skills/report-engine/SKILL.md、接口引擎类型化数据能力与平台安全与兼容基线。

📊 报表引擎 ​

组成 ​

建模流程 ​

查询安全 ​

可增删改查的写入型报表 ​

性能与导出 ​

老版本升级 ​