飞书多维表格数据接入
1. 概述
1.1. 功能说明
在线文档支持接入“飞书多维表格”。
1.2. 前提准备
在接入飞书多维表格前,首先要通过以下步骤建立观远 BI 与飞书表格的认证关系,获取相关权限:
- 在飞书开放平台创建飞书应用,https://open.feishu.cn/app/
- 获取 App ID 和 App Secret:
- 将 App ID 和 App Secret 填入观远平台 > 系统集成 > 飞书,测试连接通过。回调信息为非必填项。
- 为飞书应用分配权限
至少需为应用开启如下图“查看、评论、编辑和管理多维表格”的权限,其他多维表格相关权限根据实际使用需求开通,详见:
如果文档存为知识库下(文档链接为“域名/wiki/...”),则需再开通wiki权限,详见:
2. 使用指导
2.1. 创建/找到飞书电子表格
目前观远 BI 仅支持接入飞书云文档-电子表格,如下图所示:
2.2. 配置表格权限
为表格分配权限,至少需分配组织内获得链接的人可阅读这项权限。
若选择了组织内获得链接的人可阅读/可编辑,则在BI中获取链接的飞书表格中数据时,会进行组织权限校验;若选择了互联网上获得链接的人可阅读/可编辑,则该链接对应的飞书表格数据可以直接获取。(请关注企业数据安全性,分配合适的权限,保管好链接信息)。
2.3. 复制表格链接
可以在这三处复制飞书表格链接。
2.4. 创建飞书表格数据集
- 功能入口:新建数据集 > 在线文档 > 飞书多维表格
- 将 2.3 中获取的表格地址填入。
可能存在的异常提示及处理方案:
-
请检查 BI 系统管理 > 飞书集成配置连通性:BI 的 系统集成 > 飞书 未启用,或者配置信息不全;
-
没有权限获取表格信息,请开通对应 API 的接口权限:飞书应用的 API 权限没开;
-
请提供有效的飞书多维表格链接:检查提供的链接是否有误;
-
请求飞书接口失败:数据太大,服务器计算超时 或 上次提交的修改还没有处理完可以适当进行重试;
-
请检查表格链接的权限配置:电子表格、多维表格的链接分享范围需要调整;
-
飞书api接口请求失败:BI未捕获异常,一般可以从飞书官方报错文档里找到对应报错原因;
- 选择 sheet(支持多 sheet ),可自定义选择列、选择行数据的开始和终止,预览并进入下一步。
注意:
默认读取至表格最后的有数据列或根据自定义列数读取,中间空列以 null 填充;
列名不可重复;
不输入具体行号情况下,因空行会被飞书电子表格计入到sheet的行数里,可能会出现空数据;
不支持公式的处理;
选择多个数据表,将会以选择的第一个数据表作为表头,其余数据表仅保留与第一个数据表有对应字段的数据。
- 设置更新方式,完成创建,生成 Guan-index 类型数据集,详情页功能项与抽取数据集相同。
相关链接:
飞书开放平台地址:https://open.feishu.cn/app/
飞书表格地址:https://login.feishu.cn/accounts/page/
飞书应用接入说明:接入飞书应用