读取数据表
组件介绍
读取数据表指定区域的全部内容
属性说明
必填项
属性名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
范围 | 下拉选项 | 单元格 | 读取数据表的范围: ● 单元格 ● 区域 ● 单行 ● 多行 ● 单列 ● 多列 ● 全部 |
单元格 | 字符串 | 空 | 范围选择「单元格」时读取的单元格 |
起始/结束单元格 | 字符串 | 空 | 范围选择「区域」时开始/停止读取的单元格,如 "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
——循环读取列表中的每个内容,相当于是读取每个单元格的内容 - 输出日志:日志
循环项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 都会报错。