1. 概述
1.1 应用场景
插件可以在普通导入、自定义导入、批量导入场景下，修改默认的导入逻辑。
支持以下导入场景：
| 场景 | 图示 | |
|---|---|---|
| 1 | 单行表头，表头部分无横向扩展 |  |
| 2 | 单行表头，表头部分存在一个横向扩展 | |
| 3 | 导入区域上方有标题或其它不扩展的固定内容 | |
| 4 | 导入区域下方有不扩展的固定内容 注：如果Excel中不存在这些内容，则可以直接导入。如果Excel中也存在这些内容，则需要使用自定义导入的选择导入行功能才可以正常导入数据。 | |
| 5 | 自由报表，不存在扩展单元格 | |
不支持以下场景（不支持的场景可以替换Excel标记导入）：
注：如果模板预览时的样式和Excel完全一致，则会触发位置匹配，此时支持所有格式。以下不支持场景的前提是触发不了位置匹配。
| 序号 | 场景 | 图示 |
|---|---|---|
| 1 | 多层表头 | |
| 2 | 表头部分多个横向扩展 | |
| 3 | 导入区域有多行扩展行 | |
| 4 | 导入区域里一个父格对应多个子格 | |
| 5 | 导入区域由多个数据集组成 | |
1.2 功能逻辑
1）插件的配置为全局配置，意味着会对所有模板的导入功能生效。当前不支持针对单个模板来设置导入逻辑。
2）除了「标记导入」以外的导入方式都会受到此插件配置的影响。
3）插件不支持移动端使用。
2. 插件介绍
2.1 安装插件
点击下载插件：Excel导入逻辑设置
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照：服务器插件管理
2.2 设置导入逻辑
安装好插件后，设计器菜单栏点击「模板 > Excel 导入配置」，弹出 Excel 导入配置对话框，即可设置导入逻辑。
2.3 导入逻辑说明
| 导入逻辑 | 说明 |
|---|---|
| 根据位置匹配 | 程序内置逻辑，无法通过设置修改。当Excel和模板预览时的样式完全一致时触发，会1:1导入Excel的数据。 |
| 根据标题匹配 | 默认逻辑。对Excel和模板中的标题进行比较，标题一致的则导入该列数据。需要至少匹配2列及以上标题时才会触发该逻辑。 |
| 根据单元格位置匹配 | 识别到需要导入数据的区域后，按照Excel中的列顺序进行导入，不再判断标题是否一致。 |
| 显示值转换 | 默认不开启，在提交入库时会将Excel导入的值作为实际值提交入库。开启后，可以根据单元格的数据字典设置，将Excel导入的值转化为对应的实际值入库。 |
| 双向扩展格导入 | 默认不开启，当模板中的导入区域同时包含横向和纵向扩展单元格时，或者存在多个不同数据集时，需要勾选双向扩展格导入。 |
2.4 导入逻辑存储位置
安装「Excel导入逻辑设置」插件并设置后，会将相关配置信息存储到finedb中，具体位置如下：
「fine_conf_entity」表
| 字段名 | 描述 |
|---|---|
| CustomConfig.excelImportAttr.importDouble | 双向扩展格导入
|
| CustomConfig.excelImportAttr.importMatchTitle | 单元格匹配逻辑
|
| CustomConfig.excelImportAttr.showValue | 显示值转换
|
注1：如果表中无相关字段，可以手动添加。
注2: 已有字段会始终保留在finedb中，即使禁用或者卸载插件，程序依然会读取相关配置。