1. 概述

1.1. 功能说明

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

1.2. 前提准备

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

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

2. 获取 App ID 和 App Secret：

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

4. 为飞书应用分配权限

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

2. 使用指导

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

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

2.2. 配置表格权限

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

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

2.3. 复制表格链接

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

2.4. 创建飞书表格数据集

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

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

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

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

• 没有权限获取表格信息，请开通对应 API 的接口权限：飞书应用的 API 权限没开；

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

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

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

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

3. 选择 sheet（支持多 sheet ），可自定义选择列、选择行数据的开始和终止，预览并进入下一步。

注意：

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

• 列名不可重复；

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

• 不支持公式的处理；

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

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

相关链接：

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

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

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