读取数据表
组件介绍
读取数据表指定区域的全部内容
属性说明
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 范围 | 下拉选项 | 单元格 | 读取数据表的范围： ● 单元格 ● 区域 ● 单行 ● 多行 ● 单列 ● 多列 ● 全部 |
| 单元格 | 字符串 | 空 | 范围选择【单元格】时读取的单元格 |
| 起始/结束单元格 | 字符串 | 空 | 范围选择【区域】时开始/停止读取的单元格，如 "A1"、"B2" |
| 行号 | 数字 | 空 | 范围选择【单行】时读取的行号，如 2 表示第 2 行 |
| 起始/结束行 | 数字 | 空 | 范围选择【多行】时开始/停止读取的行号 |
| 列 | 数字/字符串 | 空 | 范围选择【单列】时读取的列号或者列名 列名/列号介绍详见名词解析 |
| 起始/结束列 | 数字/字符串 | 空 | 范围选择【多列】时开始/结束读取的列号或者列名 列名/列号介绍详见名词解析 |
选填项
| 属性名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| 数据表对象 | 对象 | 空 | 需要操作的数据表 空默认为上方最近的一个对象 非空为选择的数据表对象 点击右侧 fx 可以选择数据表对象 |
返回值
| 名称 | 类型 | 说明 |
|---|---|---|
| 内容 | 字符串/列表/数据表 | 读取到指定区域的全部内容 范围选择【单元格】，返回值类型：字符串 范围选择【单行】及【单列】，返回值类型：列表 范围选择【区域】、【多行】及【多列】，返回值类型：数据表 |
组件示例
- 赋值：变量名数据表，变量值 [["第一行","111"],["第二行","222"],["第三行","333"]]——表示有 3 行数据，每个 [] 表示一行，以逗号分隔
- 筛选数据：筛选条件列 "B"，筛选条件文字包含，值 2，筛选结果正选，数据表对象数据表，返回值数据表数据表3——筛选出第 2 列中包含 2 数据所在行对应内容，"B" 表示第 2 列，返回数据表
- 输出日志：日志数据表3——筛选出第 2 行的数据，此时数据表只有 1 行
- 读取数据表：范围单行，行号 "1"，数据表对象数据表3，返回值内容内容——数据表对象选择变量数据表3说明操作对象为筛选后的数据表，读取筛选后数据表第 1 行的内容，返回值列表，将数据表转换成了列表
- 输出日志：日志内容
- for each 循环：列表内容，返回值循环项循环项6——循环读取列表中的每个内容，相当于是读取第 2 行每个单元格的内容
- 输出日志：日志循环项6——点击右侧 fx 选择变量
- 运行结果：筛选出第 2 列中包含数字 2 数据所在行对应内容，日志面板依次输出筛选到的数据、筛选后第一行的的据及对应的每个数据
名词解析
数据表：为多个列表的集合，可以理解为存储大量信息并包含行和列的简单电子表格的数据如，使用方括号把多个用逗号分隔的列表括起来，例如 [[列表1],[列表2],[列表3]]，其中 [[]] 表示空数据表。
列号、列名：数字列号从数字 1 开始，数据类型为数字；字母列名从字母 A 开始，数据类型为字符串；列号 1、2、3 对应列名 "A"、"B"、"C"，为第 1 列、第 2 列及第 3 列，可使用【数字列号转字母列名】及【字母列名转数字列号】组件将列名及列号进行相互转换。
注意事项
当此组件添加添加到【指定数据表对象】组件中并且对应属性【数据表对象】为空时，操作数据表默认为【指定数据表对象】组件属性【数据表】选择对象对应数据表，具体详见【指定数据表对象】组件。
当此组件的属性【数据表对象】为非空时，操作数据表为选择数据表对象变量对应数据表，如下图【数据表行数】组件的【数据表对象】选择变量 c，则对应操作数据表则为变量 c 对应的数据表，需要保证变量 c 为数据表变量否则会报错。
在网页上抓取数据目前支持谷歌、IE、Edge、360 及 Firefox（火狐） 浏览器，除 IE 浏览器外其他浏览器都需要安装插件，具体操作详见浏览器插件安装说明。
必填项的单元格、行号、列号及列名不能超出当前数据表内容的操作范围（范围为 A1 至最后一个数据所在单元格），否则会报错，如上图操作范围为 A1 至 B7，行号超过 7、列号超过 2 或者单元格超过 B7 都会报错。