1.6 KiB
1.6 KiB
9.12 Excel 导入导出组件
:::tip 概述 Excel 能力分前后端两半：后端 excelize 读写（7.4 数据导入导出），前端 Excel/importFile 组件承担交互与浏览器侧解析，downloadFile 工具负责落盘。 :::
前端组件
| 组件/工具 | 职责 |
|---|---|
| Excel | 基于 xlsx 库的前端解析/生成（纯前端表格处理场景） |
| importFile | 导入交互：选文件 → 上传到模块导入接口 → 展示结果汇总 |
| utils/downloadFile | 拿到导出 URL 后触发浏览器下载 |
导入流（对接后端 Import 契约）
点击导入 → importFile 选择 xls/xlsx
→ FormData 提交 POST /{模块}/import（UnmarshalBody 契约）
→ 后端逐行校验写入
→ 前端展示 ResMsg 提示语 + 失败原因列表（ Reasons 含行号）
导出流（对接后端 Export 契约）
点击导出 → 带当前查询条件 GET /{模块}/export
→ 后端过滤写出 xlsx，返回文件 URL
→ downloadFile 触发下载
导出条件与列表分页同参数——"所见即所导"。
导入模板
模板经文件模板管理（6.21）下载（ByCode 接口），列头与后端解析顺序一致——改模板要同步改解析代码。
约定
- 大文件导入无事务逐行写，失败行不影响成功行（结果汇总呈现）
- 前端 Excel 组件不替代后端导入（后端校验才是边界），只做轻量场景补充