10 KiB
10 KiB
普通列表报表示例
场景说明
一个标准的普通列表报表，数据集编码为 aa，SQL为 select * from demo，展示6个字段：id、name、key_word、punch_time、salary_money、bonus_money。
- 表头行（第1行）：蓝底白字，行高34px
- 数据行（第2行）：居中+垂直居中，通过
#{aa.字段名}绑定数据
完整 jsonStr
{
"loopBlockList": [],
"querySetting": {
"izOpenQueryBar": false,
"izDefaultQuery": true
},
"recordSubTableOrCollection": {
"group": [],
"record": [],
"range": []
},
"printConfig": {
"paper": "A4",
"width": 210,
"height": 297,
"definition": 1,
"isBackend": false,
"marginX": 10,
"marginY": 10,
"layout": "portrait",
"printCallBackUrl": ""
},
"hidden": {
"rows": [],
"cols": [],
"conditions": {
"rows": {},
"cols": {}
}
},
"queryFormSetting": {
"useQueryForm": false,
"dbKey": "",
"idField": ""
},
"dbexps": [],
"dicts": [],
"fillFormToolbar": {
"show": true,
"btnList": ["save", "subTable_add", "verify", "subTable_del", "print", "close", "first", "prev", "next", "paging", "total", "last", "exportPDF", "exportExcel", "exportWord"]
},
"freeze": "A1",
"dataRectWidth": 700,
"isViewContentHorizontalCenter": false,
"autofilter": {},
"validations": [],
"cols": {
"len": 100
},
"area": {
"sri": 12,
"sci": 3,
"eri": 12,
"eci": 3,
"width": 100,
"height": 25
},
"pyGroupEngine": false,
"submitHandlers": [],
"excel_config_id": "1193766682428530688",
"hiddenCells": [],
"zonedEditionList": [],
"rows": {
"1": {
"cells": {
"1": { "text": "id", "style": 4 },
"2": { "text": "name", "style": 4 },
"3": { "text": "key_word", "style": 4 },
"4": { "text": "punch_time", "style": 4 },
"5": { "text": "salary_money", "style": 4 },
"6": { "text": "bonus_money", "style": 4 }
},
"height": 34
},
"2": {
"cells": {
"1": { "text": "#{aa.id}", "style": 2 },
"2": { "text": "#{aa.name}", "style": 2 },
"3": { "text": "#{aa.key_word}", "style": 2 },
"4": { "text": "#{aa.punch_time}", "style": 2 },
"5": { "text": "#{aa.salary_money}", "style": 2 },
"6": { "text": "#{aa.bonus_money}", "style": 2 }
}
},
"len": 200
},
"rpbar": {
"show": true,
"pageSize": "",
"btnList": []
},
"fixedPrintHeadRows": [],
"fixedPrintTailRows": [],
"displayConfig": {},
"fillFormInfo": {
"layout": {
"direction": "horizontal",
"width": 200,
"height": 45
}
},
"background": false,
"name": "sheet1",
"styles": [
{
"border": {
"bottom": ["thin", "#000"],
"top": ["thin", "#000"],
"left": ["thin", "#000"],
"right": ["thin", "#000"]
}
},
{
"border": {
"bottom": ["thin", "#000"],
"top": ["thin", "#000"],
"left": ["thin", "#000"],
"right": ["thin", "#000"]
},
"align": "center"
},
{
"border": {
"bottom": ["thin", "#000"],
"top": ["thin", "#000"],
"left": ["thin", "#000"],
"right": ["thin", "#000"]
},
"align": "center",
"valign": "middle"
},
{
"border": {
"bottom": ["thin", "#000"],
"top": ["thin", "#000"],
"left": ["thin", "#000"],
"right": ["thin", "#000"]
},
"align": "center",
"valign": "middle",
"bgcolor": "#01b0f1"
},
{
"border": {
"bottom": ["thin", "#000"],
"top": ["thin", "#000"],
"left": ["thin", "#000"],
"right": ["thin", "#000"]
},
"align": "center",
"valign": "middle",
"bgcolor": "#01b0f1",
"color": "#ffffff"
}
],
"fillFormStyle": "default",
"freezeLineColor": "rgb(185, 185, 185)",
"merges": []
}
结构要点
rows 布局
| 行号 | 用途 | style | 说明 |
|---|---|---|---|
| 1 | 表头行 | 4（蓝底白字） | height: 34，text为字段显示名 |
| 2 | 数据行 | 2（居中+垂直居中） | text为 #{数据集编码.字段名} |
styles 索引对照
| 索引 | 边框 | 水平对齐 | 垂直对齐 | 背景色 | 字体色 | 典型用途 |
|---|---|---|---|---|---|---|
| 0 | thin #000 | — | — | — | — | 基础单元格 |
| 1 | thin #000 | center | — | — | — | 居中文本 |
| 2 | thin #000 | center | middle | — | — | 数据行 |
| 3 | thin #000 | center | middle | #01b0f1 | — | 蓝底表头(无白字) |
| 4 | thin #000 | center | middle | #01b0f1 | #ffffff | 表头行(推荐) |
数据绑定规则
- 数据集编码
aa对应 saveDb 时的dbCode: "aa" - 绑定语法:
#{aa.字段名}— 字段名来自 fieldList 中的fieldName - 列号从 1 开始（0列通常留空）
对应的数据集配置
{
"jimuReportId": "1193766682428530688",
"dbCode": "aa",
"dbChName": "aa",
"dbType": "0",
"dbSource": "",
"isList": "1",
"isPage": "1",
"dbDynSql": "select * from demo",
"fieldList": [
{ "fieldName": "id", "fieldText": "id", "widgetType": "String", "orderNum": 0 },
{ "fieldName": "name", "fieldText": "name", "widgetType": "String", "orderNum": 1 },
{ "fieldName": "key_word", "fieldText": "key_word", "widgetType": "String", "orderNum": 2 },
{ "fieldName": "punch_time", "fieldText": "punch_time", "widgetType": "String", "orderNum": 3 },
{ "fieldName": "salary_money", "fieldText": "salary_money", "widgetType": "String", "orderNum": 4 },
{ "fieldName": "bonus_money", "fieldText": "bonus_money", "widgetType": "String", "orderNum": 5 }
],
"paramList": []
}
正确的 /jmreport/save 请求格式
关键：jsonStr 内容（rows、cols、styles 等）必须放在请求体顶层，和
designerObj同级。禁止嵌套在designerObj.jsonStr中，否则后端会清空 rows 数据。后端
saveReport逻辑：json.remove("designerObj")后，剩余的顶层 JSON 直接作为 jsonStr 存入数据库。
{
"designerObj": {
"id": "1193766682428530688",
"name": "普通列表示例",
"type": "0",
"template": 0,
"delFlag": 0,
"viewCount": 0,
"updateCount": 0,
"submitForm": 0,
"reportName": "普通列表示例"
},
"loopBlockList": [],
"querySetting": { "izOpenQueryBar": false, "izDefaultQuery": true },
"recordSubTableOrCollection": { "group": [], "record": [], "range": [] },
"printConfig": { "paper": "A4", "width": 210, "height": 297, "definition": 1, "isBackend": false, "marginX": 10, "marginY": 10, "layout": "portrait", "printCallBackUrl": "" },
"hidden": { "rows": [], "cols": [], "conditions": { "rows": {}, "cols": {} } },
"queryFormSetting": { "useQueryForm": false, "dbKey": "", "idField": "" },
"dbexps": [], "dicts": [],
"fillFormToolbar": { "show": true, "btnList": ["save", "subTable_add", "verify", "subTable_del", "print", "close", "first", "prev", "next", "paging", "total", "last", "exportPDF", "exportExcel", "exportWord"] },
"freeze": "A1",
"dataRectWidth": 700,
"isViewContentHorizontalCenter": false,
"autofilter": {},
"validations": [],
"cols": { "len": 100 },
"area": { "sri": 12, "sci": 3, "eri": 12, "eci": 3, "width": 100, "height": 25 },
"pyGroupEngine": false,
"submitHandlers": [],
"excel_config_id": "1193766682428530688",
"hiddenCells": [],
"zonedEditionList": [],
"rows": {
"1": {
"cells": {
"1": { "text": "id", "style": 4 },
"2": { "text": "name", "style": 4 },
"3": { "text": "key_word", "style": 4 },
"4": { "text": "punch_time", "style": 4 },
"5": { "text": "salary_money", "style": 4 },
"6": { "text": "bonus_money", "style": 4 }
},
"height": 34
},
"2": {
"cells": {
"1": { "text": "#{aa.id}", "style": 2 },
"2": { "text": "#{aa.name}", "style": 2 },
"3": { "text": "#{aa.key_word}", "style": 2 },
"4": { "text": "#{aa.punch_time}", "style": 2 },
"5": { "text": "#{aa.salary_money}", "style": 2 },
"6": { "text": "#{aa.bonus_money}", "style": 2 }
}
},
"len": 200
},
"rpbar": { "show": true, "pageSize": "", "btnList": [] },
"fixedPrintHeadRows": [],
"fixedPrintTailRows": [],
"displayConfig": {},
"fillFormInfo": { "layout": { "direction": "horizontal", "width": 200, "height": 45 } },
"background": false,
"name": "sheet1",
"styles": [
{ "border": { "bottom": ["thin", "#000"], "top": ["thin", "#000"], "left": ["thin", "#000"], "right": ["thin", "#000"] } },
{ "border": { "bottom": ["thin", "#000"], "top": ["thin", "#000"], "left": ["thin", "#000"], "right": ["thin", "#000"] }, "align": "center" },
{ "border": { "bottom": ["thin", "#000"], "top": ["thin", "#000"], "left": ["thin", "#000"], "right": ["thin", "#000"] }, "align": "center", "valign": "middle" },
{ "border": { "bottom": ["thin", "#000"], "top": ["thin", "#000"], "left": ["thin", "#000"], "right": ["thin", "#000"] }, "align": "center", "valign": "middle", "bgcolor": "#01b0f1" },
{ "border": { "bottom": ["thin", "#000"], "top": ["thin", "#000"], "left": ["thin", "#000"], "right": ["thin", "#000"] }, "align": "center", "valign": "middle", "bgcolor": "#01b0f1", "color": "#ffffff" }
],
"fillFormStyle": "default",
"freezeLineColor": "rgb(185, 185, 185)",
"merges": []
}