可视化元件手册

  1. 首页
  2. 全部文档
  3. 可视化元件手册
  4. 集成功能元件(54个)
  5. Load Excel Table导入Excel数据

Load Excel Table导入Excel数据

名称:

Load Excel Table | 导入Excel数据

图标:

功能:

  • 上传Excel文件数据转为数据结构
  • 此元件后台是采用POI-HSSF(Apache的jakarta项目)包进行处理的,某些其他软件生成的Excel文件有可能处理较慢
  • 处理是按标题行进行查找定位数据,如果有空白行则自动停止认为处理完成
  • 只能处理简单表格(多行多列、行列、标题数据对应一致),不能处理有合并单元格等表格数据

使用方式:

获取Excel文件的内容

输入

  • <File>:二进制类型的输入,单数,必须项;输入Excel文件的二进制内容,上传文件中内容就是二进制,如果是读取其他文件,需要进行类型转换,先处理为二进制内容再输入
  • <Sheet Name>:字符类型的输入,单数,非必须项;要处理的数据内容是文件中哪个名称的表中的,如果无此输入项,则默认是第一个表
  • <Skip Unmatching Rows>:布尔类型的输入,单数,非必须项;输入布尔值,来确定是否将空白行等进行忽略跳过,默认是No值不跳过,发现空白行即停止处理

输出:

  • <Rows>:数据结构类型的输出,复数,必须项;输出为一个数据结构带每行值的实例对象
    · 如果将复数形式改为单数(选中输出元件英文输入法时快捷键小写“m”),则输出第一行信息
  • 根据表格的列头名称和每列中内容类型来设计输出的数据结构:
    · 数据结构需要命名(用默认的Data Structure名称),上传的表格默认是Excel第一个表,但如果数据结构是其他名称,则是对应名称的Excel文件中的表名数据上传,下部案例中就是对应“Row”和“gysdata”名称的表,Excel文件中必须有此名称表才行
    · 只能设计一个数据结构带多个不同类型变量的结构,不能有多级子数据结构
    · 数据结构中代表列的变量的名称必须在Excel文件的某一行中,实际处理时先按数据结构变量名称查找,名称所在下一行认为是第一行数据内容,名称行之前的行忽略不处理
    · 各行数据转入数据结构时,自动按数据结构中变量的类型转换数据存入变量中形成一个个的数据结构实例对象,如数字或日期自动转换存入数字变量和日期变量中
    · 注意如果上传数据中有一行在转换时类型错误,此时<Skip Unmatching Rows>输入元件如果传入Yes则跳过此行处理后面的内容,比如输出的变量类型为数字,但是文件中某一行此列是字符文字值,则跳过此行;如果<Skip Unmatching Rows>输入元件传入No值则全部退回初始状态不再处理,同时生成弹窗提示信息说明哪一行数据有问题
    · 若一行中对有单元格为空,则停止此行后的数据导入
    · 若对应的列有些有值有些无值,则转为一个数据对象时,有值的变量中传入值,无值的为空值
    · 表格中可以多出一些列,这些列名称可以不设计数据结构中对应的变量,不进行转换处理,但是如果在数据结构中设计了某个名称的变量,则表格中必须有对应的列名
    · 上传表格中的内容是值,不能是引用其他表的引用数据,否则不能识别值内容

示例:

案例一:获取Excel文件的内容

任意项目的目录“Common/Templates/Miscellaneous/Load Excel Table”中:
此目录下有多个示例可以参考导入Excel数据的用法

案例二:教程申请审批系统中供应商信息导入

任意项目的目录“Common/Templates/Miscellaneous/Load Excel Table”中:
此目录下有多个示例可以参考导入Excel数据的用法