跳到主要内容
版本：6.0.0

飞书表格数据接入

观远数据支持与飞书电子表格进行集成，使用户能够无缝地将飞书电子表格中的数据导入与同步，形成在线文档数据集。并支持在观远BI中进行ETL处理与可视化分析等，实现更深入的数据洞察和决策支持。

  • 注意：目前版本仅支持从云文档入口创建的电子表格，不支持从知识库入口创建的电子表格及多维表格。

1.飞书与BI平台的认证集成​

说明：需通过飞书自建应用并完成相关配置，并按需开通文档（这里指电子表格）的权限。

  1. 飞书应用创建：登陆飞书开放平台，进行应用创建（若已完成创建，可忽略此步骤）。

1(3).png

  1.  将飞书与BI系统认证绑定：在基础凭证页面，获取应用凭证中的"App ID"和"App Secret，并将其填入系统集成-飞书-配置信息中，且需测试连接通过。

pic2.png

  1. 进入开发配置—权限管理界面，为飞书云文档开启相关接口权限。

    * 注意：必须需要开启"查看、评论、编辑和管理云空间中所有文件"的权限（其余云文档权限可按需开通）。

    可前往飞书官方文档进行更详细的了解：接入飞书应用说明

画布 4-页面 9.png

2. 飞书表格的链接权限配置​

BI平台若要接入飞书表格，需要填写表格的链接地址后才能进行数据集接入，完成对数据的读取或写入。

在本环节则是对飞书表格的分享链接权限进行预配置，链接分享有4种方式，请按需选择：

  1. 组织内获得链接的人可阅读（推荐选择，与BI平台对接时会进行组织权限校验）

  2. 组织内获得链接的人可编辑（推荐选择，与BI平台对接时会进行组织权限校验）

  3. 互联网上获得链接的人可阅读（公开可见，可能存在数据泄露的合规风险，请谨慎选择）

  4. 互联网上获得链接的人可编辑（公开可见，可能存在数据泄露且被篡改的合规风险，请谨慎选择）

pic4.png

3. 飞书表格数据集的接入​

上述两个步骤【飞书集成认证】和【飞书表格链接权限配置】完成后，可进行飞书表格的数据接入。

3.1. 创建飞书表格数据集​

进入数据中心-数据及页面，点击"新建数据集"选择"在线文档"后接入飞书电子表格。

pic5.png

3.2. 选择数据表并配置读取范围​

填写数据表的表格链接后点击"获取表格"，并设置需读取的sheet工作表以及目标行列范围。

链接获取方式如下图所示：

pic6.png

其中需要注意的是：

  1. 飞书表格数据集的数据读取范围不能超于行列范围的配置项（当配置项为默认时，将读取至当前工作表下的最后有数列，中间空列以Null值进行标记）。

  2. 列名不可重复。

  3. 尽量输入行数据范围，否则可能会出现空数据（飞书会将电子表格空行计入行数统计，BI平台接入时会认为行存在且正常读取数据，但实际行数据为空）。

  4. 通过配置公式生成的数据，BI平台接入时仅保留其当前数据，不支持继承公式；

  5. 选择多个sheet工作表时，飞书表格数据集将默认把第一个sheet作为表头，其余sheet仅保留于第一个sheet有对应字段的数据。

pic7(1).png

输入表格链接且点击"获取表格"后，可能会出现的异常提示：

异常提示项处理思路
获取失败，地址无效检查是否飞书表格是否与应用处于同一组织
获取失败，地址无效：飞书api接口请求失败检查飞书表格是否开启分享链接
获取失败，地址无效：没有权限获取工作表信息，请开通"获取工作表"API的接口权限检查飞书开放平台中应用是否分配正确的云文档权限
获取失败，地址无效：飞书未启用检查观远BI中-系统集成中的飞书是否开启
获取失败，地址无效：部分飞书授权配置项缺失检查观远BI中-系统集成中的飞书App ID，App Secret是否正确，测试连通性

3.3. 指定数据连接方式及更新周期​

飞书电子表格为Guan-index类型的数据集，数据更新周期支持手动更新、定期更新（每天/每周/每月），后续也可以在数据集详情页开启"URL触发更新"。

pic8(1).png

3.4. 确认数据表信息并指定存储位置​

通过自定义飞书表格数据集名称，并给指定路径进行保存，完成对Guan-index类型的飞书表格数据集创建。

pic9.png