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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.1. 创建飞书表格数据集

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

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

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

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

其中需要注意的是：

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

2. 列名不可重复。

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

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

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

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

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

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

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

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