飞书在线表-写入表格数据

一、功能描述

实现在飞书在线表格中Sheet页指定位置写入数据，支持写入单元格、行、列、区域

注：当指定位置已经存在数据时，原数据将会被新数据覆盖

 

二、属性说明

组件输入

• 飞书表格对象：字典；飞书表格连接对象，可使用【飞书在线表-连接表格对象】组件进行获取
• 工作表ID:  字符串；飞书在线表Sheet页ID，获取方式可参考本文档的常见问题
• 写入内容：下拉框；写入的方式，支持写入单元格、列、行、区域
• 开始列名：字符串；开始写入单元格的对应列字母，且列字母必须为大写，如：A
• 开始行号：整型；开始写入单元格的对应行号，表格第一行为：1
• 写入内容：字符串/列表；【单元格】写入"标准业务组件"；【行/列】写入一维列表，如：[1,2,3,4]；【区域】写入二维列表，如：[[1,2,3],[4,5,6]]

组件输出

• 执行结果：在此处输出执行结果

高级属性

• 错误继续执行：组件运行异常时，流程是否继续运行
• 执行前延时(秒)：运行组件前的延时时间
• 执行后延时(秒)：运行组件后的延时时间

 

三、使用实例

实例描述：

在飞书在线表的名为‘标准业务组件列表’的Sheet页中，分别写入单元格，行、列、区域，并将执行结果输出至控制台。

前置环境：

a、该流程需要使用"飞书在线表-连接表格对象"组件来获取飞书表格对象。（关于该组件的具体使用详情可参考其使用文档）

b、需要查询到工作表"标准业务组件名称"的工作表ID，查询得知 "标准业务组件列表" Sheet页的工作表ID为 ：72fefe

1、写入单元格

在飞书在线表的名为‘标准业务组件列表’的Sheet页中，向B9单元格写入"添加Sheet页"

流程编辑：

运行结果：

运行前表格展示：

运行后表格展示：

2、写入行

在飞书在线表的名为‘标准业务组件列表’的Sheet页中，向第10行写入添加一行数据，组件类型为："SAP功能操作"，组件名称为："SAP-登录"

流程编辑：

运行结果：

运行前表格展示：

运行后表格展示：

3、写入列

写入列的使用方法同写入行一致，【写入内容】选择"列"即可

3、写入区域

在飞书在线表的名为‘标准业务组件列表’的Sheet页中，批量在最后一行添加行数据，数据为：["SAP功能操作","SAP-获取状态栏"]、["SAP功能操作","SAP-执行命令"]、["SAP功能操作","SAP-表格数据导出"]

流程编辑：

使用"获取第一个可用行和列"组件可获取最后一行。（关于该组件的具体使用详情可参考其使用文档）

运行结果：

运行前表格展示：

运行后表格展示：

 

四、常见问题

1、飞书表格对象过期

组件运行提示：飞书表格对象过期，请重新获取

解决方案：飞书表格对象已失效，请重新运行【飞书在线表-连接表格对象】组件即可

2、获取工作表ID

a、使用【获取所有Sheet页名称】组件进行获取（关于该组件的具体使用详情可参考其使用文档）

b、在浏览器中打开飞书在线表，从网页地址URL中获取Sheet页ID

3、写入其他数据

当需要写入其他数据类型时，比如：邮箱号，@人，可参考以下文档：飞书-支持写入数据类型