一、指令概述
该 RPA 指令用于向飞书表格的指定区域写入数据，同时返回包含操作结果（如更新范围、行数等）的 JSON 信息，便于后续流程校验写入是否成功，支撑飞书表格的自动化数据录入与结果反馈场景。
二、调用参数配置示意
| 参数名称 | 示例 / 默认值 | 说明 |
| 指令 | 写入表格内容 | 固定选择 “写入表格内容”，表示执行飞书表格数据写入操作。 |
| 飞书访问凭证 | 飞书访问凭证 | 配置飞书 API 访问所需的凭证（需具备目标表格操作权限），支持变量（界面显示 “{x}” 标识）。 |
| 飞书表格 Url | 飞书表格URL | 输入目标飞书表格的网页链接（需确保 URL 有效且表格存在），支持变量。 |
| Sheet 页名称 | 表格1 | 输入要写入数据的 Sheet 页名称；若不填，需依赖表格默认 Sheet 页，支持变量。 |
| 区域 | A1:C4 | 输入要写入的单元格区域（如 “A1:C4” 对应 A1 到 C4 的矩形范围），需与 “写入内容” 的二维列表尺寸匹配，支持变量。 |
| 写入内容 | 二维列表 | 输入要写入的二维列表数据（如 [[1,2,3],[4,5,6]]），支持变量。 |
三、返回结果说明
指令执行后，会生成包含操作结果的 JSON 数据（关键敏感参数已掩码），示例：
| { "code": 0, "data": { "revision": 83, "spreadsheetToken": "********************", // 飞书表格唯一标识（已掩码） "updatedCells": 7, "updatedColumns": 3, "updatedRange": "1XYmgo!A1:C3", "updatedRows": 3 }, "msg": "success" } |
各字段含义：
• code：状态码，0 代表执行成功（非 0 通常为失败，需结合 msg 排查）。
• data：详细操作结果：
◦ revision：表格版本号（每次修改递增，可用于版本追踪）。
◦ spreadsheetToken：飞书表格唯一标识（敏感信息，实际为加密字符串）。
◦ updatedCells：本次写入更新的单元格总数。
◦ updatedColumns：本次写入涉及的列数。
◦ updatedRange：实际写入的单元格范围（格式为 “Sheet 页标识！起始单元格：结束单元格”）。
◦ updatedRows：本次写入涉及的行数。
• msg：提示信息，success 表示操作成功。
四、使用示例（员工信息表写入 + 结果校验）
场景：向飞书表格 “员工信息统计表” 的 “表格 1” Sheet 页，写入 3 行 3 列员工数据（区域 A1:C3），并校验写入是否成功。
参数配置：
• 指令：写入表格内容
• 飞书访问凭证：feishuAuthToken（提前配置的飞书访问凭证变量）
• 飞书表格 Url：https://example.feishu.cn/sheets/xxx（目标表格实际 URL）
• Sheet 页名称：表格1
• 区域：A1:C3
• 写入内容：employeeData（二维列表变量，内容如 [["姓名","部门","工号"],["张三","技术部","001"],["李四","市场部","002"]]）
• 返回结果：writeResult（自定义变量，存储返回的 JSON 结果）
执行流程：
1. 调用指令，RPA 通过飞书 API 认证，定位 “表格 1” Sheet 页，将 employeeData 写入 A1:C3 区域。
2. 指令执行后，writeResult 变量被赋值为返回的 JSON 数据。
3. 后续通过 “判断 writeResult.code === 0 && writeResult.msg === 'success'”，校验写入是否成功。
五、注意事项
1. 权限与有效性：“飞书访问凭证” 需有目标表格编辑权限且有效；“飞书表格 Url” 和 “Sheet 页名称” 需对应真实存在的表格 / Sheet，否则指令报错。
2. 区域与数据匹配：“区域” 的行列范围需与 “写入内容” 的二维列表行数、列数完全匹配（如区域 A1:C3 对应 3 行 3 列，二维列表也需 3 行 3 列），否则可能数据错位或返回异常结果。
3. 结果校验必要性：实际流程需校验返回结果的 code 和 msg，确保写入成功；若失败，可根据 msg 排查（如权限不足、数据格式错误等）。
六、延伸应用
可结合 RPA 的「条件判断」「日志记录」指令，实现 “写入后自动校验结果 → 成功则记日志 / 执行后续操作，失败则告警 / 重试” 的闭环；也可结合「数据读取」指令，从 ERP、本地文件等来源获取数据生成二维列表，再通过本指令写入飞书表格，实现跨系统数据同步自动化。