...

新建：
- 入口一：“Excel数据导入”模块在定制管理，选择定制管理> 数据管理> Excel导入模板
- 入口二：“Excel数据导入”模块资源定制，选择资源定制右键新建分析> Excel导入模板。
编辑：点击Excel导入模板，右键编辑，进入模板编辑界面。
执行导入：双击Excel导入模板（或者右键 - 打开）进入导入excel数据界面。
删除：点击Excel导入模板，右键删除。

...

下面以新建一个"演示带参数的导入模板"为例，详细说明每一项的配置。该示例实现为每个学校导入、更新行政单位及其负责人。Excel数据： Image Removed

Image Added
目标表结构：

其中学校代码，需要根据用户选择的值导入，实现如下：

点击新建Excel导入模板
- 入口一：在"Excel数据导入"模块左侧资源目录区"导入模板"目录或子目录右键菜单选择 新建 > Excel导入模板
- 入口二：在"Excel数据导入"模块右侧主界面，单击 新建Excel导入模板。入口一：“Excel数据导入”模块在定制管理，选择定制管理> 数据管理> Excel导入模板
- 入口二：“Excel数据导入”模块资源定制，选择资源定制右键新建分析> Excel导入模板
进入Excel导入模板编辑界面，点击"添加导入规则"

Image Removed Image Added

- 区域一："添加导入规则"点击可在左侧添加导入规则
- 区域一："上传Excel补录模板"，是指上传满足"导入规则列表区"规则的excel文件，用于用户下载补录模板或异常数据日志管理中异常数据下载。选择模板文件之后，必须点击"上传"才能保存补录模板，这里选择"表1-3学校相关行政单位补录模板.xls"上传
- 区域二：导入规则列表区，可重命名规则名（双击）、切换编辑规则、删除规则
- 区域三：导入规则编辑区域

进入规则编辑界面
- 基本设置

Image Removed Image Added

- - 数据源：系统管理中定义的关系数据源，要导入的目标库。
  - 回写表：要导入的目标表
  - Sheet名：对应Excel文件中要导入Sheet名称。
  - 起始行：设置开始执行导入的行，包含设置的值，不设缺省从1开始
    - 行号：通过设置行号的形式设置起始行
    - 出现字符：通过设置Excel中指定列开始出现指定字符设置起始行
  - 结束行：设置结束导入的行，设置的结束行也会执行导入，缺省直到Excel结束
    - 行号：通过设置行号的形式设置结束行
    - 出现字符：通过设置Excel中指定列开始出现指定字符设置结束行
    - 直到空行：遇到空行终止导入
  - 异常处理规则：设置出现校验异常时（如长度超长，类型不匹配、超值域范围、主键冲突等），是回滚整个sheet的导入还是继续执行下一条数据，将这条异常数据写入异常日志表。这里的异常是指不满足用户设置的校验规则导致的异常，并非数据库sql执行过程中产生的未知异常，后者是直接回滚抛出错误原因给用户的。
    - 回滚：设置为出现校验异常时，回滚整个sheet中数据的导入，并抛出碰到的第一个校验异常原因。选择了回滚，异常日志中并不会记录所有的异常数据及原因，因为回滚意味着遇到第一个校验异常时，直接回滚，跳出导入该sheet。
    - 继续执行：设置为出现校验异常时，继续执行导入下一条数据，并将这条数据写入到异常日志，供后面下载查看异常原因。
  - 数据处理模式：导入数据的时候是采取增量更新还是全量更新。
    - 全量：把数据库中的表中原有的数据删除，重新导入数据。
    - 增量：在数据库中的表原有的数据基础下继续导入数据。
  - 主键冲突处理规则：设置主键冲突时（是指Excel中数据出现和数据库表中的数据主键值一样时），是执行更新还是抛出主键冲突的校验异常，这里的"主键"是"列设置"中用户指定的主键，并不一定是数据库表的主键，但设置的主键也是需要数据满足唯一性。
    - 更新：主键重复时，执行更新
    - 异常处理：主键重复时，抛出主键冲突的检验异常，由"异常处理规则"去处理这个异常
    异常处理规则：设置出现校验异常时（如长度超长，类型不匹配、超值域范围、主键冲突等），是回滚整个sheet的导入还是继续执行下一条数据，将这条异常数据写入异常日志表。这里的异常是指不满足用户设置的校验规则导致的异常，并非数据库sql执行过程中产生的未知异常，后者是直接回滚抛出错误原因给用户的。
    - 回滚：设置为出现校验异常时，回滚整个sheet中数据的导入，并抛出碰到的第一个校验异常原因。选择了回滚，异常日志中并不会记录所有的异常数据及原因，因为回滚意味着遇到第一个校验异常时，直接回滚，跳出导入该sheet。
    - 继续执行：设置为出现校验异常时，继续执行导入下一条数据，并将这条数据写入到异常日志，供后面下载查看异常原因。
- 列设置

Image Removed Image Added

- - 字段名和字段类型：根据基本设置中设置的表自动读取
  - 是否主键：缺省会自动从数据库读取，但用户可以更改，例如选择学校代码、单位号作为主键
  - 是否允许为空：缺省会自动从数据库读取，但用户可以更改
  - 绑定输入：设置数据库表列的数据来源
    - 不绑定：执行导入时，该列不插入值
    - 绑定excel列：绑定excel中指定列数据
    - 绑定excel单元格：绑定excel中指定单元格数据
    - 绑定参数：绑定参数，该参数为公共设置中定义的参数，选择绑定参数后，执行导入时，导入界面会显示该参数，用户导入前需要先选择参数的值再执行导入，这样这列导入的值就是用户所选的参数值，这里学校代码选择参数"学校名称"，其中的学校名称参数是下拉框参数，数据源是northwind,备选值是："select t_code as code, t_name as name from dim_xxmc"，默认值是"select t_code as code, t_name as name from dim_xxmc limit 1"
    - 使用固定值：绑定固定值，用户输入一个固定值
    - 使用JAVA类：绑定java类，系统内置了唯一id和系统时间两个常用的类，用户可通过扩展包，实现接口smartbi.daq.excelimport. ICellDataGenerator，并注册java类，详细请见"演示绑定自定义java类的导入模板"
      - 唯一id：32位长的唯一id
      - 系统时间：执行导入时的系统时间
  - 按文件绑定

Image Removed Image Added

- - - Excel配置文件：excel文件，该文件中必须有一行是数据库列名或列的别名，系统通过将这个名称和数据库表的列名、或列的别名匹配达到自动映射的目的
    - 作为补录模板：勾选这一项后，系统会将上传的配置文件作为补录模板，相当于功能"上传Excel补录模板"功能
    - Sheet名：用于匹配的Sheet页名称，如果勾选了"作为补录模板"，该名称必须和Excel导入模板中配置的Sheet名相同
    - 名称所在行号：列名/列别名所在行号
  - 校验设置

Image Removed Image Added
支持的验证规则：字符长度限制、值域范围验证、数字范围验证、正则表达式验证（譬如某一列必须满足邮件的规则，就可以使用正则表达式验证）

- 扩展设置

Image Removed Image Added

- - 规则验证类：如果通过"校验设置"，不能满足用户验证需求，用户通过该入口，可以自定义该类，实现自定义验证每一行数据规则的目的，该类必须实现smartbi.daq.excelimport.IRuleValidator接口，设置了该项，系统缺省的"校验设置"是不生效的，用户可以通过继承smartbi.daq.excelimport.DefaultRuleValidator保留缺省的校验设置
  - 数据处理类：缺省情况下，系统使用smartbi.daq.excelimport.DefaultRowDataImporter处理每一行数据，如果用户需要实现自己的导入数据的逻辑，可设置该类，并必须实现smartbi.daq.excelimport.IRowDataImporter接口

...

点击"保存"，弹出"保存Excel导入模板"对话框，输入名称及描述，点"确认"保存模板。
Image Removed Image Added

执行导入Excel数据

双击Excel导入模板（或者右键 - 打开）进入导入excel数据界面，如"演示带参数的导入模板"，进入导入界面：
Image Removed Image Added

- 下载补录模板：下载模板编辑界面上传的补录模板
- 学校名称：选择Excel数据所属学校，这是在Excel导入模板列设置中绑定的参数
- 选择Excel文件：要导入的Excel数据文件
- 导入：点击该按钮执行导入，显示导入等待界面，导入完成后再下方显示导入结果：

Image Removed Image Added
这个模板执行

锚

	_GoBack
	_GoBack

界面可以通过openresource的方式集成到其他系统，
如:http://localhost:8080/smartbi/vision/openresource.jsp?resid=I402881e7422f475c0146c3e43ec8035e&user=admin&password=manager

...

- 值域名称：值域的真实名称，保存后不可修改
- 值域别名：值域的别名
- 描述：值域的描述信息
- 值域类型：支持sql和静态列表，和参数的备选值设置、默认值的设置相同
  - SQL：通过SQL的方式设置值域的可选值列表

Image Removed Image Added

- - 静态列表：通过手动设置值列表，本例选择这种方式

Image Removed Image Added

- - 批量导入：选择静态列表后激活，可导入UTF-8编码的文本格式文件，每一行代表一个值，如：

Image Removed Image Added

- - 值：根据值域类型设置的不同，设置方式就不同，其中通过SQL方式设置值，请参见下拉框参数的备选值设置
  - 值字段：值域类型选择SQL后，显示，设置定义的sql中哪一列作为值域值。

...

查看导入异常日志，并可以导出导入异常的数据、及异常原因。
入口：在"Excel数据导入"模块右侧主界面，单击 系统运维，单击 异常数据日志管理。
出现在异常数据日志中的前置条件：Excel导入模板中需要设置"异常处理规则"为"继续执行"。
Image Removed Image Added