动态表格的 Excel 导入导出

最低支持版本

动态表格在 20220302 版本之后才支持 Excel 导入导出功能

<dependency>
  <groupId>com.epichust</groupId>
  <artifactId>above-patch-5.1.3-ehdynagrid</artifactId>
  <version>20220302</version>
</dependency>

导出功能

开启导出功能

在配置页面是否可导出 Excel 选项,选择是,表格顶部区域就会出现导出按钮
image.png
image.png

配置可导出的字段

在配置页的 Excel 导入导出配置标签页中,通过开启关闭是否导出开关来控制该字段是否可以导出
image.png
关闭了是否导出的字段,不会出现在导出的可选字段中
image.png

导入功能

开启导入功能

在配置页的自定义按钮配置标签页中,将导入按钮和下载模板按钮的隐藏关掉
如果没有这两个按钮,请点击添加初始按钮
image.png

配置 Excel 模板

导入的 Excel 模板是通过配置生成的
在配置页的 Excel 导入导出配置标签页中,通过开启关闭是否导入开关来控制该字段是否出现在 Excel 模板中,导入备注对应的是该字段在 Excel 中的批注和顶部注释栏
image.png
如下是通过配置生成的 Excel 模板
image.png

导入方式

导入分为只插入、只更新、插入并更新三种
image.png

主键

在配置页的 Excel 导入导出配置标签页中,通过开启关闭是否主键设定该字段是否为主键
主键在导入时,会和 Excel 内数据和数据库数据做唯一校验
只更新和插入更新情况下必须设置主键
主键可以有一个或者多个,如果存在多个主键会联合进行校验
image.png

外键

导入时会自动查询外键并进行关联
例如,工单中的工艺路线编码和工艺路线名称
image.png
在字段配置中,这两个字段是关联的另一实体中的属性,那么在导入时会根据 Excel 中的工艺路线编码和工艺路线名称去查询出唯一的工艺路线实体,并关联至工单中
image.png

导入规则

导入规则是在导入之前,将当前字段数据执行自定义的规则脚本转换后导入
规则中value代表当前字段值,可以做简单运算或者执行函数
例如,将物料名称加上后缀 ex:value + "ex",或者下图中返回当前时间
这里的函数可以在产品的方法注册中自定义
image.png
image.png

导入失败

数据之间互不影响,部分失败不会导致其他数据导入
image.png
部分数据导入失败后,可以下载失败数据进行修改,如下图,失败的数据最后一列会列出失败原因
修改后再次导入即可
image.png