导入导出模板
1. 表简介
business_import_template 表用于维护系统中 导入/导出模板配置。 该表存储了不同业务场景下的导入/导出模板信息,包括模板名称、业务对象、字段配置及样式配置。 通过该表,可以实现灵活的模板管理和样式定制,满足多业务场景下的数据导入导出需求。
2. 表结构说明
| 字段名 | 类型 | 说明 |
|---|---|---|
id | bigint(PK) | 主键 ID,唯一标识模板 |
business_id | bigint | 业务对象 ID,用于绑定具体业务(如客户、订单、库存等) |
name | varchar | 模板名称,便于识别 |
data | json | 模板配置详情(包含字段映射、表头样式、内容样式等信息) |
remark | varchar | 备注信息,记录模板用途说明 |
created_at | datetime | 创建时间 |
updated_at | datetime | 更新时间 |
3. 业务用途
- 统一管理导入导出模板,减少硬编码。
- 支持不同业务(由
business_id区分)使用独立模板。 - 模板支持个性化样式配置,提升导出文件的可读性。
4. 模板配置说明(data 字段 JSON)
4.1 表头配置(header)
表头配置主要用于定义 导出文件表头的样式,提升数据可读性和美观度。
当前设计基于 实体级配置,即每个业务表可定义一套表头样式(统一颜色与风格)。 支持自定义 字体大小、字体颜色、背景颜色 等样式,确保导出效果与 Excel 中保持一致。

4.2表体配置(content)

4.2.1设计理念
本模板的设计基于 所见即所得(WYSIWYG) 原则,用户在配置模板时即可通过预览界面直观感受到最终效果,确保导出的文件在样式上与 Excel 中的呈现保持一致。
4.2.2样式支持清单
| 配置项 | 说明 |
|---|---|
| 是否显示 | 可配置该列是否参与导出,灵活控制导出字段范围。 |
| 是否必填 | 设置为必填后,在导入数据时会自动进行校验,确保数据完整性。 |
| 是否固定列 | 在业务表字段较多时,可将关键字段(如编码、名称等)固定在左侧,提升可读性。 |
| 颜色 / 大小 | 用户可自定义导出内容的字体颜色与字号,实现个性化展示。 |
| 对齐方式 | 支持设置水平对齐(左/居中/右)及垂直对齐方式,保证表格排版美观。 |
导入导出数据
1.表简介
business_import_data 表用于记录系统中 导入/导出文件的执行过程与结果。 该表保存了用户操作导入/导出的文件信息,包括文件路径、状态、查询条件、存储方式等。 通过该表可以追踪文件生成的全流程,便于任务监控、错误排查及历史记录管理。
2.表结构说明
| 字段名 | 类型 | 说明 |
|---|---|---|
id | bigint(PK) | 主键 ID,唯一标识记录 |
user_id | bigint | 操作用户 ID |
file_name | varchar | 文件名称(如:订单导出.xlsx) |
file_path | varchar | 文件路径(支持本地路径或 OSS 地址) |
status | int | 状态: 10 = 待导出 20 = 导出中 30 = 导出成功 99 = 导出失败 |
data | json | 导入/导出时的查询条件,记录执行时的参数 |
business_id | bigint | 业务对象 ID,用于关联具体业务(如客户、订单、库存等) |
type | int | 类型: 10 = 导出 20 = 导入 |
remark | varchar | 备注信息,记录操作说明或异常信息 |
storage_type | int | 存储类型: 10 = 本地存储 20 = OSS 存储 |
created_at | datetime | 创建时间 |
updated_at | datetime | 更新时间 |
3. 业务用途
- 导出:记录用户发起的导出任务,包括查询条件、生成文件、执行状态。
- 导入:记录用户上传的导入文件,包括解析参数、校验结果、存储路径。
- 监控:通过状态字段监控任务进度,支持失败重试与结果追踪。
- 存储:支持 本地存储 与 OSS 存储 两种方式,灵活适配不同部署环境。
