数据读写
按模板写 Excel
type excelTemplate
保留模板样式,替换 ${key} 占位符并按列表克隆模板块
使用说明
要点:按模板输出:保留样式,替换 ${key} 占位符;body 为 List<Map> 时按模板块克隆,为 Map 时替换整份工作簿的标量。示例先把 JSON 转成 Map。
属性
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
path模板路径 |
文本 | 必填 | — | /data/template.xlsx |
output输出路径 |
文本 | 必填 | — | /data/out.xlsx 或 /data/ |
fileName文件名 |
文本 | 可选 | — | order-${header.id}.xlsx |
sheet工作表 |
文本 | 可选 | — | Sheet1 或 0 |
templateRow模板起始行 |
数字 | 可选 | 1 |
0 基;该行 ${key} 作为列占位符 |
templateRows模板块行数 |
数字 | 可选 | 1 |
多行表头或明细块 |
shiftRows移动表尾 |
布尔 | 可选 | true |
数据行数变化时上下移动表尾 |
autoSize自动列宽 |
布尔 | 可选 | false |
|
values标量数据 |
表达式 | 可选 | — | 缺省取消息体 Map |
rows列表数据 |
表达式 | 可选 | — | 缺省取消息体 List<Map> |
示例流程
可直接保存为 demo-excelTemplate.json 并部署;非入口节点默认套了一个 REST 入口。
{
"id": "demo-excelTemplate",
"desc": "按模板写 Excel 示例",
"group": "示例/数据读写",
"schemaVersion": 1,
"nodes": [
{
"id": "n1",
"type": "rest",
"props": {
"method": "POST",
"path": "/demo/excelTemplate",
"desc": "示例入口"
}
},
{
"type": "unmarshal",
"props": {
"format": "json",
"type": "java.util.Map"
},
"id": "n1"
},
{
"type": "excelTemplate",
"props": {
"path": "./data/templates/report.xlsx",
"output": "./data/out",
"fileName": "report-${header.id}.xlsx",
"templateRow": 1,
"templateRows": 1,
"shiftRows": true
},
"id": "n2"
}
]
}
curl -X POST 'http://localhost:8086/flow' \
-H 'Content-Type: application/json' \
-H 'X-Flow-Token: change-me' \
--data-binary @demo-excelTemplate.json
调用方式
如何触发:消息体传 Map(标量)或 List<Map>(明细行);模板中整格占位符会按值类型写入数字 / 布尔 / 日期。