一、指令概述
该指令用于读取网页端在线表格（Excel 类网页表格）内指定范围的数据，支持指定工作表、读取方式自定义、单元格 / 整行 / 整列 / 区域精准读取，将表格内容提取并存储至变量，供后续流程调用、数据判断、循环遍历等自动化场景使用。
二、核心参数配置
| 参数名称 | 说明 | 输入格式 / 规则 |
|---|---|---|
| 网页对象 | 打开目标在线表格的浏览器网页对象 | 必填 |
| Sheet 页名称 | 表格内目标工作表名称 | 选填；留空默认读取当前页面激活的 Sheet 工作表；填写则精准读取对应名称的工作表 |
| 读取方式 | 数据读取维度 | 单选可选：区域、行、列 |
| 读取区域 | 对应维度的表格坐标 | 严格遵循 Excel 坐标格式，示例如下：1. 单元格：(A1)2. 连续区域：(A1:B2)3. 整行：(1)（代表第 1 行）4. 整列：(A)（代表 A 列） |
| 生成变量【数据】 | 存储读取结果的变量 | 必填；指令提取的全部表格数据将存入该变量，用于下游流程调用 |
三、读取方式详细说明
1. 区域读取
读取指定起止坐标内的整片单元格数据，适用于批量读取多行多列内容。
- 格式示例：
A1:C5，读取 A1 单元格至 C5 单元格的全部区域数据。
2. 行读取
读取表格内指定整行的全部单元格内容。
- 格式示例：
1，读取表格第 1 行的所有列数据。
3. 列读取
读取表格内指定整列的全部单元格内容。
- 格式示例：
A，读取表格 A 列的所有行数据。
四、典型操作示例
示例 1：读取第 3 行全部数据
- 网页对象：在线表格网页
- Sheet 页名称：
商品台账 - 读取方式：行
- 读取区域：
3 - 输出：变量内存储表格第 3 行所有列的完整数据
示例 2：读取 A 列全部数据
- 网页对象：在线表格网页
- Sheet 页名称：留空
- 读取方式：列
- 读取区域：
A - 输出：变量内存储 A 列所有行的完整数据
示例3：批量读取多单元格区域
- 网页对象：在线表格网页
- Sheet 页名称：
订单数据 - 读取方式：区域
- 读取区域：
A1:D10 - 输出：变量内存储 A1 至 D10 整片区域的表格数据