观远 BI

飞书电子表格数据接入

创建于 2022-12-08 / 最近更新于 2024-02-22 / 7281
字体: [默认] [大] [更大]

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

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


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

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

  1. 飞书应用创建:登陆飞书开放平台,进行应用创建(若已完成创建,可忽略此步骤)。

1(3).png

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

pic2.png

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

 * 注意:必须需要开启"查看、评论、编辑和管理电子表格"的权限(其余云文档权限可按需开通)。

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

lQLPJxItu4hbYe_NBLjNC0CwdILJCUxKcfwFxGKUmAJCAQ_2880_1208.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


34 人点赞过