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"), : UiTypeMapper.firstNonBlank(report.attributeValue("title"),
attrOf(report.element("search"), "reporttitle"), "报表"); attrOf(report.element("search"), "reporttitle"), "报表");
String entityId = report.attributeValue("entityid", ""); 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); String reportTable = resolveTableName(entityId, result);
// display → columns(含 ismoney/issummer 合计列) // display → columns(含 ismoney/issummer 合计列)
@@ -3828,17 +3837,59 @@ public class TemplateToAmisConverter {
if ("true".equals(attrOf(search, "ischart"))) { if ("true".equals(attrOf(search, "ischart"))) {
result.degrade("report ischart=true → 图表类报表(B 类),ECharts option 平移单列处置,本批转为表格降级"); 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); noteScripts(report, result);
return page(title, crudSchema); 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(分组容器)—— 子模板跨引用 // group(分组容器)—— 子模板跨引用
// ────────────────────────────────────────────────────────────────────── // ──────────────────────────────────────────────────────────────────────

View File

@@ -2705,14 +2705,70 @@ class TemplateToAmisConverterTest {
} }
@Test @Test
void report_jor套打版式降级() { @SuppressWarnings("unchecked")
void report_含JOR套打版式_改产报表查看器crud() {
// Phase 3:含 <reportfile> JOR 套打版式 → 报表查看器(jatools 引擎渲染保真版式),
// 不再降级成 amis 表格。crud.api 指向 /api/report/frame,单个 html 列把 __url 渲成 iframe。
String xml = "<report title='套打' entityid='e1'>" String xml = "<report title='套打' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>" + "<display><field name='A' text='A'/></display>"
+ "<search selectservice='S'/>" + "<search selectservice='S'/>"
+ "<reportfile><![CDATA[<jatools>非空版式定义内容占位非空版式</jatools>]]></reportfile></report>"; + "<reportfile><![CDATA[<jatools>非空版式定义内容占位非空版式</jatools>]]></reportfile></report>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage); ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
assertEquals(ConversionGrade.PARTIAL, r.getGrade()); Map<String, Object> crud = body(r.getSchema());
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("JOR"))); assertEquals("crud", crud.get("type"));
assertTrue(((String) crud.get("api")).startsWith("/api/report/frame/"), "api=" + crud.get("api"));
List<Map<String, Object>> cols = (List<Map<String, Object>>) crud.get("columns");
assertEquals(1, cols.size(), "报表查看器只有一个 html 列");
assertEquals("html", cols.get(0).get("type"));
String html = (String) cols.get(0).get("html");
assertTrue(html.contains("<iframe"), html);
assertTrue(html.contains("${__url}"), html);
// JOR 现在被引擎渲染,不再作为「不迁移引擎」降级
assertFalse(r.getDegrades().stream().anyMatch(d -> d.contains("不迁移引擎")),
"JOR 应被引擎渲染而非降级: " + r.getDegrades());
}
@Test
@SuppressWarnings("unchecked")
void report_查询条件picker落在crud_filter上下文() {
// 工程(SelectDialog) → picker,且必须落在 crud.filter(实测唯一能让 picker 正常加载选项的上下文)。
// 有查询条件时 initFetch=false:等用户选条件并「查询」后再加载报表(避免必填空参渲染报错)。
String xml = "<report title='收付款' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<search selectservice='S'>"
+ "<field name='PROJECTID' label='工程名称' uitype='SelectDialog' dialogid='d1' required='true'/>"
+ "</search>"
+ "<reportfile><![CDATA[<jatools>版式占位非空版式占位</jatools>]]></reportfile></report>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
Map<String, Object> filter = (Map<String, Object>) crud.get("filter");
assertNotNull(filter, "查询条件应落在 crud.filter");
List<Map<String, Object>> fbody = (List<Map<String, Object>>) filter.get("body");
Map<String, Object> projectField = fbody.stream()
.filter(f -> "PROJECTID".equals(f.get("name"))).findFirst().orElseThrow();
assertEquals("picker", projectField.get("type"), "工程 SelectDialog 应转 picker");
assertEquals(Boolean.FALSE, crud.get("initFetch"), "有查询条件时等用户查询再加载");
}
@Test
void report_templateId入查看器api() {
String xml = "<report title='套打' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<reportfile><![CDATA[<jatools>版式占位非空版式占位</jatools>]]></reportfile></report>";
ConversionResult r = converter.convertGraded(xml, "TID-123", "套打", new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
assertEquals("/api/report/frame/TID-123", crud.get("api"));
}
@Test
void report_无reportfile_保留数据表降级() {
// 9/339 无 JOR 套打版式 → 保留原数据表行为(/api/flow 列实体行),不走查看器
String xml = "<report title='纯数据报表' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<search selectservice='PM_X_SEARCH'/></report>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
assertTrue(((String) crud.get("api")).startsWith("/api/flow/PM_X_SEARCH"), "api=" + crud.get("api"));
} }
@Test @Test