Flow ServerStarter
数据读写

按模板写 Excel

type excelTemplate

在设计器中打开 ↗

保留模板样式,替换 ${key} 占位符并按列表克隆模板块

使用说明

要点:按模板输出:保留样式,替换 ${key} 占位符;body 为 List<Map> 时按模板块克隆,为 Map 时替换整份工作簿的标量。示例先把 JSON 转成 Map。
可选依赖该节点需要宿主额外引入 poi-ooxml,否则部署相关流程会在 Camel 启动路由阶段失败并回滚。

属性

字段类型必填默认值说明
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 入口。

Flow JSON
{
  "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>(明细行);模板中整格占位符会按值类型写入数字 / 布尔 / 日期。

相关节点