读取 Excel
组件介绍
读取工作表指定区域的全部内容
截图
属性说明
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 范围 | 下拉选项 | 单元格 | 读取内容的范围： ● 单元格 ● 区域 ● 多行 ● 单行 ● 多列 ● 单列 ● 全部 |
| 单元格 | 字符串 | 空 | 范围选择【单元格】时生效 读取的单元格，如 "A1" |
| 起始/结束单元格 | 字符串 | 空 | 范围选择【区域】时生效 开始/停止读取的单元格，如 "A1" |
| 起始/结束行 | 数字 | 空 | 范围选择【多行】时生效 开始/停止读取的行号，如 1 |
| 行号 | 数字 | 空 | 范围选择【单行】时生效 读取的单行行号，如 1 |
| 起始/结束列 | 数字/字符串 | 空 | 范围选择【多列】时生效 开始/停止读取的列号/列名，具体介绍详见下方名词解析 |
| 列 | 数字/字符串 | 空 | 范围选择单列时生效 读取的列号/列名，具体介绍详见下方名词解析 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 表名 | 字符串 | 空 | 需要操作的工作表名称，为空默认为当前打开的工作表 |
| Excel 对象 | 对象 | 空 | 需要切换的 Excel 文件 【打开 Excel】组件返回值对应的 Excel 文件 空默认为上一个【打开 Excel】组件打开的 Excel 文件 |
返回值
| 名称 | 类型 | 说明 |
|---|---|---|
| 读取内容 | 字符串/数据表/列表 | 读取到指定范围内全部内容 范围选择【单元格】，返回值类型：字符串 范围选择【区域】及【全部】，返回值类型：数据表 使用【遍历数据表行】组件可以读取数据表每行内容 范围选择【多行】、【单行】、【多列】及【单列】，返回值类型：列表 使用【for each 循环】组件可以循环获取列表中的每个数据 |
组件示例
- 打开 Excel：文件 "./res/测试.xlsx"，其他选填项默认 — "./res/测试.xlsx" 表示流程的 res 文件夹下的 测试.xlsx 文件，具体介绍详见【打开 Excel】组件
- 写入 Excel：写入内容 "测试写入"，范围单元格，单元格 "A1"，其他选项默认
- 读取 Excel：范围单元格，单元格 A1"，返回值读取内容读取内容
- 输出日志：日志读取内容——点击 fx 选择变量
- 关闭 Excel
- 运行结果：打开 测试.xlsx 文件，在 A1 单元格写入文字：测试写入，读取并在日志面板输出 A1 单元格的内容
名词解析
列号、列名：数字列号从数字 1 开始，数据类型为数字；字母列名从字母 A 开始，数据类型为字符串；列号 1、2、3 对应列名 "A"、"B"、"C"，为第 1 列、第 2 列及第 3 列，可使用【数字列号转字母列名】及【字母列名转数字列号】组件将列名及列号进行相互转换。
列表：由多个文本组成，每个文本之间以逗号分隔，两端以方括号括起来。例如 ["1","2","3","4","5","6","7"] 就是一个列表，其中包含 7 个文本项。
数据表：为多个列表的集合，可以理解为存储大量信息并包含行和列的简单电子表格的数据。
注意事项
此组件可以不添加到【打开 Excel】或者【指定 Excel 对象】组件（仅支持 v1.3.6 及以上版本编辑器及模拟器），当此组件【Excel 对象】为非空时，操作对象为 Excel 对象对应的 Excel 文件；【Excel 对象】为空默认为上方最近的一个 Excel 对象。
必须安装 2016 及其以上版本 Microsoft Office 软件或者 WPS 软件。
选填项输入的表名不存在会报错，不写默认为当前打开的工作表，可以使用【所有工作表名】组件获取工作表名称。
如果出现出现未打开对应 Excel 文件或者此组件报错：RPC 服务器不可用或者报错：组件执行失败的问题，请点击右上角蓝色头像，点击【设置】，点击【关于我们】中 SDK 版本后方的【重置运行环境】按钮后重新运行流程试下。