1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.2.8.5 | - |
1.2 功能说明
FineDataLink 支持连接飞书表格数据源，支持：定时管道任务读取。
1.3 使用限制
1）仅当用户注册了「应用系统（云端）」功能点，且「应用系统（云端）-类型数」大于 0 时，才支持使用此数据源。详情参见文档：注册简介
2）工程所在服务器需具备访问外网权限，或者可以配置白名单：
域名白名单：dm.shukuajing.com
IP白名单：47.110.75.116
1.4 注意事项
此数据源不支持飞书表格中存在使用公式「从其他表格引用数据」，若存在，配置数据连接后，会存在字段或数据的丢失。
2. 收集连接信息
2.1 创建自建应用获取 App ID 和 App Secret
1）飞书管理员 登录开发者后台，点击「创建企业自建应用」，填写应用基本信息，并点击「创建」。如下图所示：
2）在权限管理下，先搜索「云空间」，勾选上云空间相关的权限。如下图所示：
3）还需要选择以下权限，请依次搜索并勾选以下权限，确认开通权限。如下图所示：
查看、评论、编辑和管理多维表格
查看、评论和导出多维表格
查看、评论、编辑和管理电子表格
查看、评论和导出电子表格
查看、编辑和管理知识库
查看知识库
导出云文档（docs:document:export）
导出云文档（drive:export:readonly）
注：如您在发布应用后再次勾选其他权限，请再次发布应用，配置才可生效。
4）在「版本管理与发布」中，完成企业内部应用的线上发布。如下图所示：
注：非企业管理员创建应用并申请上线，需要企业管理员在管理后台中进行应用审核，详情参见文档：审核自建应用
5）在「凭证与基础信息」下，就可以获取到 App ID 和 App Secret 。如下图所示：
2.2 飞书文件的配置要求
在需要获取数据的文件中，添加前面的自建应用。
1）非本人创建的自建应用，需要 管理员登录飞书管理后台 ，在管理后台中分配 2.1 节自建应用的使用权限后，该成员才可在文件中添加应用。如下图所示：
2）点击进入电子表格/多维表格，点击「添加文档应用」。如下图所示：
3）在搜索栏中搜索 2.2 节中的自建应用，并给与「可管理」权限，点击「添加」按钮。如下图所示：
注：此处请授予「可管理」权限，否则数据无法同步。
2.3 自动获取文件夹中的文件
2.3.1 注意事项
1）若只需获取单个电子表格/多维表格中的数据，可直接跳转到 2.4 节；
2）若只需一次性获取文件夹中的数据，之后文件夹的数据不需要自动同步，可直接跳转到 2.4 节；
3）若希望获取某一个文件夹中的所有文件，且想要实现文件夹内新增的文件自动同步到产品中，可以通过添加机器人来自动获取飞书文件夹内的所有文件；
4）仅自动获取「直接」放在绑定文件夹中的表，子文件节内的表不会自动获取，如需使用请单独绑定子文件夹。
2.3.2 配置机器人
1）登录开发者后台，进入 2.1 节的自建应用中，在该应用中添加「机器人」。如下图所示：
2）当前的配置发生了变化，点击「创建版本」，填写相关信息后，申请线上发布新版本，使当前的修改生效。如下图所示：
3）在飞书中创建一个新的群组，可以自定义群组的相关信息，填写好后点击「创建」。如下图所示：
4）进入刚才创建的群聊中，对当前群聊进行设置。如下图所示：
5）在群机器人中添加上面自建应用的机器人。如下图所示：
6）将要获取的文件夹分享给该群聊，如下图所示：
7）给文件的协作者增加群聊，配置完成。如下图所示：
2.4 获取链接
授权信息还需要电子表格/多维表格/文件夹的链接。
1）如果需要获取整个文件夹中的数据，打开文件夹，复制浏览器中的地址，即文件夹链接。
链接格式为：https://sample.feishu.cn /drive/folder/ cSJe2JgtFFBwRuTKAJK6baNGUn0
2）如果只需要获取单个电子表格的数据，进入电子表格，复制浏览器中的地址，即电子表格链接。
链接格式为：https://sample.feishu.cn /sheets/ MRLOWBf6J47ZUjmwYRsN8utLEoY
3）如果只需要获取单个多维表格的数据，进入多维表格，复制浏览器中的地址，即多维表格链接。
链接格式为：https://sample.feishu.cn /base/ Pc9OpwAV4nLdU7lTy71t6Kmmkoz
4）如果需要获取知识库中的在线表格/多维表格，打开知识库，复制浏览器中的地址，即链接。
链接格式为：https://sample.feishu.cn /drive/folder/ cSJe2JgtFFBwRuTKAJK6baNGUn0
3. 配置连接
3.1 前提条件
详情请参见：前提条件
3.2 驱动准备
下载驱动：
若 FineDataLink 为独立部署的工程，将驱动文件放置到 %FineDataLink%/webroot/web-inf/lib 下；放置后，需要重启 FDL 工程。
若 FineDataLink 为 OPS 部署的工程，将驱动文件上传至 FineDataLink 工程外挂目录的 customlib 文件夹下
如忘记工程外挂目录位置，请参考文档查询：导出项目部署信息；放置后，需要重启 FDL 工程。
注：如需获取驱动文件，请联系技术支持。
3.3 具体连接步骤
1）创建数据连接步骤请参见：创建并管理数据
2）在页面中填写相关信息，说明如下表所示：
| 信息 | 说明 |
|---|---|
| 名称 | 自定义新增数据的名称，方便区分 |
| AppId | 2.1 节中配置应用后获取的信息 |
| AppSecret | |
| 链接 | 2.4 节相关文件的 url |
| 表头行序号（选填） | 填写后所有表单以制定行号作为表头，如不填则按默认逻辑 |
上一篇：配置美团管家智能版数据源
