9.12 Excel 导入导出组件

概述

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 组件不替代后端导入（后端校验才是边界），只做轻量场景补充

相关

• 7.4 数据导入导出