feat(converter): convertReport 对含 JOR 套打的 type=200 产报表查看器

EIP3 真报表(jatools JOR 套打)此前被转换器降级成 amis 表格。现 convertReport 分流:
含 <reportfile>(JOR 套打版式,328/339)→ convertReportViewer 产 page→crud:
- api=/api/report/frame/{templateId}(currentTemplateId,缺则回落 entityId);
- filter=buildSearchFilter(查询条件,F3-1 过滤主键列)——picker 落 crud.filter 工作上下文;
- 单 html 列把 ${__url} 渲成 <iframe>(JOR HTML 独立加载、CSS 隔离保真);
- 有查询条件时 initFetch:false(等用户「查询」再加载,避免必填工程为空时空参渲染报错);
- header/footer toolbar 置空(报表查看器无新增/批量/分页)。
无 reportfile(9/339,纯数据报表)→ 保留原数据表降级行为不变。

测试:替换旧 JOR 降级用例为 4 个查看器用例(api/单 html iframe 列/picker 落 crud.filter+initFetch/
templateId 入 api/无 reportfile 保留表格);全 platform-converter 186 测试绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-25 22:19:18 +08:00
parent 3090906f9e
commit 8e5e2410d1
2 changed files with 116 additions and 9 deletions

View File

@@ -3769,6 +3769,15 @@ public class TemplateToAmisConverter {
: UiTypeMapper.firstNonBlank(report.attributeValue("title"),
attrOf(report.element("search"), "reporttitle"), "报表");
String entityId = report.attributeValue("entityid", "");
// Phase 3:含 <reportfile> JOR 套打版式(328/339)→ 报表查看器(jatools 引擎渲染保真版式),
// 不再降级成 amis 表格。无 reportfile(9/339)→ 落到下方数据表降级(原行为)。
Element reportfile = report.element("reportfile");
if (reportfile != null && !reportfile.getTextTrim().isBlank()) {
return convertReportViewer(report.element("search"), entityId, title,
reportfile.getTextTrim().length(), report, result);
}
String reportTable = resolveTableName(entityId, result);
// display → columns(含 ismoney/issummer 合计列)
@@ -3828,17 +3837,59 @@ public class TemplateToAmisConverter {
if ("true".equals(attrOf(search, "ischart"))) {
result.degrade("report ischart=true → 图表类报表(B 类),ECharts option 平移单列处置,本批转为表格降级");
}
// JOR 套打版式(reportfile CDATA 非空)→ 不迁移引擎(报表迁移方案 C 类)
Element reportfile = report.element("reportfile");
if (reportfile != null && !reportfile.getTextTrim().isBlank()) {
result.degrade("report 含 reportfile(JOR 套打版式 " + reportfile.getTextTrim().length()
+ " 字符) → C 类不迁移引擎,仅转表格视图(套打另案 univer/Web 打印)");
}
noteScripts(report, result);
return page(title, crudSchema);
}
/**
* 报表查看器(Phase 3):含 JOR 套打版式的 type=200 报表 → amis {@code crud}。
*
* <p><b>为何是 crud 而非独立 form</b>:报表查询条件里常有「工程」等 SelectDialog→picker;实测
* picker 只有落在 {@code crud.filter}(amis CRUD store 托管的过滤区)才能正常加载弹窗选项,放在
* 页面级独立 {@code form} 里弹窗恒「暂无数据」(同一 picker 配置,仅容器不同)。故查询条件落
* {@code crud.filter}。
*
* <p><b>报表如何渲染</b>:crud 的 {@code api} = {@code /api/report/frame/{id}},回显单行
* {@code {__url}}(指向 {@code /api/report/render/{id}?format=html&<查询参数>});唯一的 html 列把
* {@code __url} 渲成 {@code <iframe>}。用户「选条件→查询」时 crud 携 filter 参数请求 frame → 拿到带新
* 参数的 {@code __url} → iframe 重载 → JOR 引擎按工程过滤刷新。iframe 隔离 JOR 自带 CSS,版式保真。
*
* <p><b>initFetch</b>:有查询条件时设 {@code false},等用户「查询」再加载(避免必填工程为空时空参渲染报错)。
*/
private Map<String, Object> convertReportViewer(Element search, String entityId, String title,
int jorLen, Element report, ConversionResult result) {
// 查询条件落 crud.filter(picker 唯一可用上下文,F3-1 过滤主键列)
Map<String, Object> filter = buildSearchFilter(search, result, true, entityId);
String tid = (currentTemplateId != null && !currentTemplateId.isBlank()) ? currentTemplateId : entityId;
Map<String, Object> crud = new LinkedHashMap<>();
crud.put("type", "crud");
crud.put("api", "/api/report/frame/" + tid);
crud.put("syncLocation", false);
crud.put("headerToolbar", new ArrayList<>()); // 报表查看器无新增/批量按钮
crud.put("footerToolbar", new ArrayList<>()); // 单行信封,无分页条
crud.put("affixHeader", false);
if (filter != null) {
crud.put("filter", filter);
crud.put("initFetch", false); // 有查询条件 → 等用户「查询」再加载
}
// 唯一的 html 列:把回显的 __url 渲成 iframe(JOR HTML 文档独立加载,CSS 隔离保真)
Map<String, Object> col = new LinkedHashMap<>();
col.put("name", "__url");
col.put("label", "");
col.put("type", "html");
col.put("html", "<iframe src=\"${__url}\" style=\"width:100%;min-height:680px;border:0;\" frameborder=\"0\"></iframe>");
List<Map<String, Object>> cols = new ArrayList<>();
cols.add(col);
crud.put("columns", cols);
result.note("report 含 JOR 套打版式(" + jorLen + " 字符) → 报表查看器:crud.filter 查询条件 + html 列 iframe 加载 "
+ "/api/report/render/" + tid + "(jatools 引擎渲染保真版式;图表 ischart 亦由引擎 jfreechart 出图)");
noteScripts(report, result);
return page(title, crud);
}
// ──────────────────────────────────────────────────────────────────────
// group(分组容器)—— 子模板跨引用
// ──────────────────────────────────────────────────────────────────────