一、指令概述
该指令用于向网页端在线表格内指定区域、整行、整列批量写入数据。
二、核心参数配置
表格
| 参数名称 | 说明 | 输入格式 / 规则 |
| 网页对象 | 打开目标在线表格的浏览器网页对象 | 必填 |
| Sheet 页名称 | 表格内目标工作表名称 | 选填;留空默认写入当前页面激活的 Sheet 工作表;填写则精准写入对应名称的工作表(名称需完全匹配) |
| 写入方式 | 数据写入维度 | 单选可选:区域、行、列 |
| 写入区域 | 对应维度的表格坐标 | 严格遵循 Excel 坐标格式,示例如下:1. 单元格:(A1)2. 连续区域:(A1:B2)3. 整行:(1)(代表第 1 行)4. 整列:(A)(代表 A 列) |
| 开始行号 | 数据写入的起始行 | 选填;默认从表格第 1 行开始写入;自定义填写数字行号后,数据将从指定行开始,逐行依次填入对应单元格 |
| 写入内容 | 需要写入表格的源数据 | 根据写入方式匹配格式:1. 行 / 列写入:传入一维列表2. 区域写入:传入二维列表(列表内子项为单行完整数据) |
三、写入方式详细说明
1. 区域写入
向指定起止坐标的整片单元格批量写入多行多列数据,适配整段数据回填。
· 格式示例:写入区域A1:C5,传入二维列表[[数据1,数据2,数据3],[数据4,数据5,数据6]],自动逐行填充区域单元格。
2. 行写入
向指定整行批量写入内容,数据横向填充该行所有单元格。
· 格式示例:写入行(1),传入一维列表[订单号,商品名,金额],自动从起始列开始填充整行。
3. 列写入
向指定整列批量写入内容,数据纵向填充该列所有单元格;如果受「开始行号」控制,它会从指定行开始向下写入。
· 格式示例:写入列(A),开始行号2,传入一维列表[数据1,数据2,数据3],自动从 A2 单元格开始向下依次填入。
四、典型操作示例
示例 1:整列从第 2 行开始批量写入
· 网页对象:在线表格网页
· Sheet 页名称:留空(默认当前页)
· 写入方式:列
· 写入区域:A
· 开始行号:2
· 写入内容:["订单001","订单002","订单003"]
· 执行效果:从 A2 单元格开始,向下依次填入 3 条订单数据。
示例 2:整行写入表头数据
· 网页对象:在线表格网页
· Sheet 页名称:订单台账
· 写入方式:行
· 写入区域:1
· 开始行号:留空(默认第 1 行)
· 写入内容:["订单编号","商品名称","成交金额","下单时间"]
· 执行效果:表格第 1 行完整写入表头字段。
示例 3:多区域批量写入多行数据
· 网页对象:在线表格网页
· Sheet 页名称:留空
· 写入方式:区域
· 写入区域:A1:D3
· 写入内容:[["001","上衣",29.9,"2025-04-01"],["002","裤子",59.9,"2025-04-01"]]
· 执行效果:从 A1 单元格开始,批量填充 2 行完整订单数据