跳到主要内容
版本:6.5.0

飞书多维表格数据接入

1. 概述

1.1. 功能说明

在线文档支持接入“飞书多维表格”。

1.2. 前提准备

在接入飞书多维表格前,首先要通过以下步骤建立观远 BI 与飞书表格的认证关系,获取相关权限:

  1. 在飞书开放平台创建飞书应用,https://open.feishu.cn/app/

image.png

  1. 获取 App ID 和 App Secret:

image.png

  1. 将 App ID 和 App Secret 填入观远平台 > 系统集成 > 飞书,测试连接通过。回调信息为非必填项。

image.png

  1. 为飞书应用分配权限

至少需为应用开启如下图“查看、评论、编辑和管理多维表格”的权限,其他多维表格相关权限根据实际使用需求开通,详见:

image.png

如果文档存为知识库下(文档链接为“域名/wiki/...”),则需再开通wiki权限,详见:

image.png

2. 使用指导

2.1. 创建/找到飞书电子表格

目前观远 BI 仅支持接入飞书云文档-电子表格,如下图所示:

image.png

2.2. 配置表格权限

为表格分配权限,至少需分配组织内获得链接的人可阅读这项权限。

若选择了组织内获得链接的人可阅读/可编辑,则在BI中获取链接的飞书表格中数据时,会进行组织权限校验;若选择了互联网上获得链接的人可阅读/可编辑,则该链接对应的飞书表格数据可以直接获取。(请关注企业数据安全性,分配合适的权限,保管好链接信息)。

image.png

2.3. 复制表格链接

可以在这三处复制飞书表格链接。

image.png

image.png

2.4. 创建飞书表格数据集

  1. 功能入口新建数据集 > 在线文档 > 飞书多维表格

image.png

image.png

  1. 将 2.3 中获取的表格地址填入。

image.png

可能存在的异常提示及处理方案:

  • 请检查 BI 系统管理 > 飞书集成配置连通性:BI 的 系统集成 > 飞书 未启用,或者配置信息不全;

  • 没有权限获取表格信息,请开通对应 API 的接口权限:飞书应用的 API 权限没开;

  • 请提供有效的飞书多维表格链接:检查提供的链接是否有误;

  • 请求飞书接口失败:数据太大,服务器计算超时 或 上次提交的修改还没有处理完可以适当进行重试;

  • 请检查表格链接的权限配置:电子表格、多维表格的链接分享范围需要调整;

  • 飞书api接口请求失败:BI未捕获异常,一般可以从飞书官方报错文档里找到对应报错原因;

  1. 选择 sheet(支持多 sheet ),可自定义选择列、选择行数据的开始和终止,预览并进入下一步。

image.png

注意:

  • 默认读取至表格最后的有数据列或根据自定义列数读取,中间空列以 null 填充;

  • 列名不可重复;

  • 不输入具体行号情况下,因空行会被飞书电子表格计入到sheet的行数里,可能会出现空数据;

  • 不支持公式的处理;

  • 选择多个数据表,将会以选择的第一个数据表作为表头,其余数据表仅保留与第一个数据表有对应字段的数据。

  1. 设置更新方式,完成创建,生成 Guan-index 类型数据集,详情页功能项与抽取数据集相同。

image.png

image.png

相关链接:

飞书开放平台地址:https://open.feishu.cn/app/

飞书表格地址:https://login.feishu.cn/accounts/page/

飞书应用接入说明:接入飞书应用