飞书数据回填

1.1 版本

1.2 应用场景

支持将 FineBI 仪表板中的数据结果回填至飞书表格中，以便飞书内部的成员进行查看和使用。这样的集成方案，可以推动团队的数据分析效率。

1.3 前置条件

• 安装并完成飞书集成：飞书集成

• 安装插件：飞书集成插件（bi7）

如何创建完整应用，实现飞书用户同步和消息通知。详情可参考文档：飞书集成

2.1 创建应用

1）登录开发者后台，「创建企业自建应用」，填写应用基本信息。

2.2 开通权限

在权限管理下，必须开通以下权限才可实现数据回填：

• 查看、评论、编辑和管理多维表格

• 查看、评论、编辑和管理电子表格

• 查看、编辑和管理知识库

• 查看知识库

注：如果发布应用后再次勾选其他权限，请再次发布应用，配置才可生效。

2.3 发布应用 

在「版本管理与发布」中，完成企业内部应用的线上发布。

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

在「凭证与基础信息」下，就可以获取到 App ID 和 App Secret ；

管理员在飞书「管理后台」获取「企业编号」。

在 FineBI 「飞书管理」中成功集成上该应用。（租户ID对应企业编号）

将下方数据回填到飞书中。

4.1 飞书表格绑定应用

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

支持的文件类型有：电子表格、多维表格

点击进入「电子表格/多维表格」，点击「添加文档应用」，在搜索栏中自建应用名称，并给与「可管理」权限。

示例演示，将 FineBI 仪表板中的「合同信息」内容回填到飞书的下方电子表格中。  多维表格与电子表格步骤相同。

注：非本人创建的自建应用，需要 管理员登录飞书管理后台 ，在管理后台中分配自建应用的使用权限后，该成员才可在文件中添加应用。

4.2 定时调度

在 FineBI 的「管理系统>定时调度>飞书数据回填」中 ，进行回填操作配置。

1）创建定时调度任务，并添加 FineBI 中「合同信息」组件所在仪表板作为调度内容，并配置相关信息。

2）文件管理选择「飞书数据回填」，选择回填应用和回填目标表链接。点击「获取表头字段」即可在「字段映射」中匹配飞书目标表和组件的字段。点击「保存」完成数据回填。

• 追加数据：直接将当前表所有数据插入到目标表中，不会修改已有数据。

• 替换数据：将删除回填的飞书表单中的全部数据，替换为本表数据。删除后数据无法恢复!

4.3 效果预览

电子表格下方新增数据内容。如下图所示：