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