1.1 版本

1.2 应用场景

Excel标记导入整合了所有原有的Excel导入逻辑和导入方式，通过标记标题&内容区域+智能识别的方式，实现Excel数据导入。

1.3 名词解释

• 标题区域：表格中的表头部分

• 内容区域：表格中的数据部分

• 内容区域外部分：表格中不规则的内容部分

1.4 功能描述

具体功能清单如下：

• 支持清空、覆盖、增量三种导入方式

• 支持纵向、横向两种导入方向

• 支持将导入值转换为实际值入库

• 支持按照位置导入内容区域以外的内容

• 支持自由选择Excel的某个sheet导入

• 支持自由选择导入模板任一sheet位置

• 支持更改多sheet导入时的匹配逻辑
  

• 支持导入时记住本次导入配置

• 支持自由设置导入excel中的实际值或者显示值

• 支持智能识别Excel的标题和内容区域

• 支持默认导入智能识别结果（不需要业务前端操作）
  

• 支持前端调整导入的标题/内容区域

不支持的场景如下：

• 不支持新填报预览

• 不支持移动端

• 不支持断开的导入区域

• 不支持导入图片

• 存在斜线的单元格无法识别

• 不支持导入内容区域的合并单元格，会自动拆成列表

• 尽可能使用Microsoft Excel 2007及以上版本，对于WPS Excel和Microsoft Excel低版本不保证兼容。

2.1 插件安装

点击下载插件：Excel标记导入

设计器插件安装方法请参见：设计器插件管理

服务器安装插件方法请参见：服务器插件管理

2.2 基础使用方法

1）找到设置入口：「设计器>模板>Excel导入标记」

注：若模板有多个sheet需要导入，则每个sheet页都需要单独设置导入标记，否则前端导入时选不到该sheet。

2）导入标记设置：选择标题&内容区域

格式说明：【A1:D2】指A1为起点，D2为终点的4×2单元格区域

3）添加标记导入按钮，完成配置

打开「模板>模板web属性>填报页面设置」，选择「为该模板单独设置」，双击「标记导入」添加到工具栏。

4）预览模板，测试业务导入的效果

2.3 进阶使用方法（可选项）

2.3.1 导入标记设置区域

说明：sheet表设置内的配置项，只针对当前sheet生效；模板设置内的配置项，对整个模板所有sheet生效

设置名称	说明	适用场景
导入方向	默认选择纵向。 根据数据扩展方向选择，分为纵向和横向，大部分导入Excel场景都适用「纵向」。	纵向(预览时标题为横向，而数据需要纵向导入) shu 横向(预览时标题为纵向，而数据需要横向导入)
智能识别Excel标题区域和内容区域	默认开启智能识别 “Excel标题区域”用于提升识别效率——标记的范围越精准，识别越快。可以不填写，或不精准填写。	适用于大部分场景，能有效降低业务用户操作成本
导入方式	默认清空导入。 共有三种导入方式：清空、增量和覆盖，支持多选，若未勾选任何一项会等同于全选。	当导入方式唯一时，业务用户默认按照此方式导入，适合业务用户不了解导入方式的情况 当导入方式设置多个时，需要业务用户在导入时进行选择，适合业务用户掌握导入方式的情况
支持导入内容区域外的部分	默认不勾选。 勾选后，会将Excel中内容区域以外的内容进行导入，且这部分在导入时执行按照位置匹配	适用于Excel除了标题和内容行列外，有固定内容的场景，希望直接按照位置导入，比如落款或日期等。
将数据转换为实际值提交	默认不勾选。 勾选后，显示值转换可以将Excel导入的值，根据自定义的数据字典转换为想要的实际值来入库。比如导入的是男、女，入库的是1、2。具体效果可参考：Excel导入显示值转换	导入后，想保持当前显示值（导入值）不变，想通过形态改变入库实际值，需要勾选“将数据转换为实际值提交”，就可以将形态中的实际值入库，不勾选的话。 该功能勾选后，形态转换对提交校验同样生效

2.3.2 单元格设置区域

4.1  JS接口

FR.MarkExcelImport.markImportExcel()

使用场景：自定义按钮进行导入

4.2  导入配置存储位置

在导入时勾选保存设置后，会将相关信息存储到finedb中，具体位置如下图所示：

fine_excel_mark_conf 表

fine_excel_mark_sheet_conf 表

模板设计建议：

• 模板中需要导入数据的列（行），需要和Excel中对应数据列标题保持一致

• 模板中内容区域的单元格，需要设置成可扩展

• 模板中内容区域需要展示数据时，尽量设置成列表展示

其他常见问题：

• Excel导入常见问题与解决方案