功能概述
调用飞书开放平台电子表格 API,支持向工作表指定单元格 / 区域写入表格计算公式,提供【单列写入】与【区域写入】两种模式;支持开启云端公式自动填充,适配批量设置求和、查找、匹配等公式自动化场景。
适用场景:自动化批量设置报表计算公式、自动新增行后填充运算公式、定时更新表格运算逻辑、报表自动化生成。
二、输入参数配置清单
| 参数名称 | 控件类型 | 参数说明 | 获取方式 | 是否必填 |
|---|---|---|---|---|
| 飞书访问凭证 | 变量选择器 | 飞书开放接口鉴权 Token(tenant_access_token/user_access_token) | 通过【获取飞书开放平台凭证】指令生成 | ✅ 必填 |
| 飞书表格 URL | 输入框 | 飞书在线电子表格完整链接,指令内部自动解析提取spreadsheet_token | 直接复制浏览器表格地址填入 | ✅ 必填 |
| Sheet_id | 输入框 | 工作表唯一标识(区分文档内不同 sheet 页面) | 通过【获取 sheet 页的 id】指令,根据 sheet 名称查询得到 | ✅ 必填 |
| 写入方式 | 单选框 | 可选:列 / 区域列:单列批量写入;区域:自定义矩形单元格范围写入 | 手动下拉选择 | ✅ 必填 |
| 写入区域 | 输入框 | 单元格位置标识,格式示例:单列模式:D1;区域模式:C1:C10 | 手动填写单元格地址 | ✅ 必填 |
| 写入列内容 | 输入框 | 单列模式生效,填写单条公式文本,示例:=A1+B1 | 手动录入公式 | 条件必填(写入方式 = 列) |
| 写入区域内容 | 输入框 | 区域模式生效,任意值列表,多条公式数组,按顺序填充单元格 | 传入数组变量 | 条件必填(写入方式 = 区域) |
| 是否开启云端公式自动填充 | 开关 | 开启后,以起始单元格公式向下自动填充至表格有效数据行 | 手动开关选择 | ☐ 选填,默认关闭 |
三、配置填写示例
示例 1:单列模式
飞书访问凭证:t-g12345xxxxxx
飞书表格 URL:https://xxx.feishu.cn/sheets/abcdefgHIJKLMN
Sheet_id:shtxxxxxx
写入方式:列
写入区域:E2
写入列内容:=B2+C2-D2
是否开启云端公式自动填充:开启
效果:E2 单元格写入公式,自动向下填充至表格最后有效行
示例 2:区域模式
写入方式:区域
写入区域:F2:F5
写入区域内容:["=A210","=A310","=A410","=A510"]
效果:F2~F5 单元格依次填入对应公式