飞书表格

1. 概述

1.1 功能简介

支持连接飞书表格数据源,用户可通过新建同步表配置,将飞书表格数据同步至指定应用中使用。

1.2 注意事项

  • 请确保表格中至少有一行数据,否则会导致字段获取异常。
  • 不支持飞书表格中存在使用公式「从其他表格引用数据」,若存在,配置数据连接后,会存在字段或数据的丢失。
  • 此数据连接会消耗飞书企业自建应用的 API 调用次数,飞书企业管理员可登录管理后台,在「费用中心 > 权益数据」页面查看 API 调用次数。详情请参见飞书官方文档:自建应用 API 调用量上线调整说明

2. 获取授权信息

2.1 创建自建应用获取 App ID 和 App Secret

1)飞书管理员 登录开发者后台,点击「创建企业自建应用」,填写应用基本信息,并点击「创建」。如下图所示:

Group 26.png

2)在权限管理下,先搜索「云空间」,勾选上云空间相关的权限。如下图所示:

Group 42.png

3)还需要选择以下权限,请依次搜索并勾选以下权限,确认开通权限。如下图所示:

  • 查看、评论、编辑和管理多维表格
  • 查看、评论和导出多维表格
  • 查看、评论、编辑和管理电子表格
  • 查看、评论和导出电子表格
  • 查看、编辑和管理知识库
  • 查看知识库
  • 导出云文档(docs:document:export)
  • 导出云文档(drive:export:readonly)

注:如您在发布应用后再次勾选其他权限,请再次发布应用,配置才可生效。

Group 39.png

4)在「版本管理与发布」中,完成企业内部应用的线上发布。如下图所示:

注:非企业管理员创建应用并申请上线,需要企业管理员在管理后台中进行应用审核,详情参见文档:审核自建应用

Group 1229.png

5)在「凭证与基础信息」下,就可以获取到 App ID 和 App Secret 。如下图所示:

Group 1230.png

2.2 飞书文件的配置要求

在需要获取数据的文件中,添加前面的自建应用。

1)非本人创建的自建应用,需要 管理员登录飞书管理后台 ,在管理后台中分配 2.1 节自建应用的使用权限后,该成员才可在文件中添加应用。如下图所示:

Group 1232.png

2)点击进入电子表格/多维表格,点击「添加文档应用」。如下图所示:

Group 1233.png

3)在搜索栏中搜索 2.2 节中的自建应用,并给与「可管理」权限,点击「添加」按钮。如下图所示:

注:此处请授予「可管理」权限,否则数据无法同步。

Group 34.png

2.3 自动获取文件夹中的文件

2.3.1 注意事项

1)若只需获取单个电子表格/多维表格中的数据,可直接跳转到 2.4 节;

2)若希望获取某一个文件夹中的所有文件,且想要实现文件夹内新增的文件自动同步到产品中,可以通过添加机器人来自动获取飞书文件夹内的所有文件;

3)仅自动获取「直接」放在绑定文件夹中的表,子文件节内的表不会自动获取,如需使用请单独绑定子文件夹。

2.3.2 配置机器人

1)登录开发者后台,进入 2.1 节的自建应用中,在该应用中添加「机器人」。如下图所示:

Group 1234.png

2)当前的配置发生了变化,点击「创建版本」,填写相关信息后,申请线上发布新版本,使当前的修改生效。如下图所示:

Group 1235.png

3)在飞书中创建一个新的群组,可以自定义群组的相关信息,填写好后点击「创建」。如下图所示:

Group 1236.png

4)进入刚才创建的群聊中,对当前群聊进行设置。如下图所示:

Group 1237.png

5)在群机器人中添加上面自建应用的机器人。如下图所示:

Group 1238.png

6)将要获取的文件夹分享给该群聊,如下图所示:

16.png

7)给文件的协作者增加群聊,配置完成。如下图所示:

Group 1239.png

2.4 获取链接

授权信息还需要电子表格/多维表格/文件夹的链接。

1)如果需要获取整个文件夹中的数据,打开文件夹,复制浏览器中的地址,即文件夹链接。

链接格式为:https://sample.feishu.cn /drive/folder/ cSJe2JgtFFBwRuTKAJK6baNGUn0

Group 43.png

2)如果只需要获取单个电子表格的数据,进入电子表格,复制浏览器中的地址,即电子表格链接。

链接格式为:https://sample.feishu.cn /sheets/ MRLOWBf6J47ZUjmwYRsN8utLEoY

Group 1241.png

3)如果只需要获取单个多维表格的数据,进入多维表格,复制浏览器中的地址,即多维表格链接。

链接格式为:https://sample.feishu.cn /base/ Pc9OpwAV4nLdU7lTy71t6Kmmkoz

Group 45.png

4)如果需要获取知识库中的在线表格/多维表格,打开知识库,复制浏览器中的地址,即链接。

链接格式为:https://sample.feishu.cn /drive/folder/ cSJe2JgtFFBwRuTKAJK6baNGUn0

Group 44.png

3.新建数据连接

进入「数据连接管理」,新增「飞书表格」数据连接。说明如下表所示:

配置项

说明

名称

自定义新增数据的名称,方便区分

AppId

2.1 节中配置应用后获取的信息

AppSecret

链接

2.4 节相关文件的url

4. 新建同步表

新建数据连接后,在「同步表管理」中新建同步表,可以将数据同步至应用中使用。

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验