天宫EXCEL介绍
# Excel组件-介绍
# Excel组件是什么?
Excel组件是一款用于提取Excel表格内容存储到临时表,并且通过用户设置的入正式库的API,将数据存储到正式库的工具组件。省去了开发人员用于文件上传,读取,数据验证,数据入临时库的过程。开发人员只需要设置数据源,模版信息,以及Excel表格中的列与数据库中表的对应关系,即可。在实际使用过程中,运维人员可以修改模版中的单元格描述等达到适用于不同公司使用不同的模版,实现快速复用。客户在导入功能时,只需选择相应的模版文件,上传系统,即可完成整个导入流程。
# Excel组件有哪些优势?
Excel组件提供了3种文件类型:列表模版,自定义模版-单值模版,自定义模版-多值模版。当用户选择好临时表以后,字段对应关系的设置非常便捷,有横向匹配和纵向匹配模式,最快只需要3步即可完成模版创建。
Excel组件提供了批注的方式实现数据验证,客户也能很容易了解需要输入的数据要求。
Excel组件提供了友好的导入结果展示,客户可以很清楚的查看导入成功与失败的记录,并且下载错误数据修改再重新上传。
# Excel组件模块名称与模版名称的含义?
模块是指一个大类,里面包含很多模版,业务系统可以指定模块名称跳转过来就立即显示当前模块内的模版列表。
模版名称是指每一个模版的名称。
# Excel事务导入是什么含义?
保存模版的时候,选择是否事务导入。选择“是”则表示整个Excel验证全部通过了开始导入临时表,如果临时表全部入库成功,则调用入正式库的API。选择“否”则表示单个sheet如果成功则调用正式库API,如果失败则不调用,表头表体的sheet需要头和体全部正确了才认为正确。
# Excel组件模版类型是什么意思?
列表模版:列表文件。
自定义模版-单值模版:字段名称和字段值在两个不同的单元格中。
自定义模版-多值模版:字段名称和字段值(可能还有code)在同一个单元格中。 通过分号(支持中文和英文)及回车分隔。code 填写在中文括号内。
# Excel组件支持哪些批注类型?
可以输入“请输入”,“请填写”这样的建议词。如果没有匹配到以下内容,会跳过。
基础验证:整数,正整数,身份证,中文,英文,大写英文,小写英文,英文和数字,邮箱,金额,必填。
长度验证:10位,18位社会信用代码或10位海关代码。
小数点后保留验证:小数点后保留5位 (注意:目前最大支持99位)。
日期格式验证:日期,日期格式:(YYYY-MM-dd HH:mm:ss)。
字段映射:币制名称(匹配币制的中文),币制(不包含‘名称’就匹配代码)。
# Excel组件上传模式是什么含义?
极速模式:根据单元格批注验证内容,一旦验证失败,换下一行验证。如果是表头,就结束验证。
全文模式:根据单元格批注验证内容,遇到验证失败会继续验证,会把所有不满足批注要求的内容都校验出来。
# Excel组件流程图
# Excel组件横向匹配,纵向匹配是什么含义?
匹配的含义是单元格中的内容与表内字段的备注如果完全一致,可以自动选择字段。
横向匹配:列名都在同一行,选中列名与值所在的行,横向匹配生成右侧名词列表。如果是列表的场景下,只需要选择列头,读取内容会自动去匹配下面的所有行,直到结束或结束标记才停止。
纵向匹配:列名都在同一列,选中列名与值所在的列,纵向匹配生成右侧名词列表。
# Excel组件结束标记是什么含义?
结束标记是指设置自定义模版内表体的情况下,如果表体下面还有其他表体或者其他信息,获取内容时不需要使用到的情况下,设置结束标记,根据内容匹配到行以后,就停止读取。如果不设置结束标记,就会读取直至文件结束。