版本：8.1.0

在线文档

概述

观远 BI 支持与飞书电子表格、飞书多维表格及钉钉 AI 表格进行深度集成，使用户能够无缝地将上述表格工具中的数据导入与同步，快速形成在线文档数据集。同时支持在观远 BI 中对这些数据进行完整的 ETL 处理、多维度可视化分析及智能洞察，打通「数据存储 - 同步 - 分析 - 决策」全链路，为企业提供更深入、全面的数据支撑，助力精准决策。

飞书与钉钉表格工具的详细特性及区别，可参考官方文档：飞书表格官方文档、钉钉表格官方文档。

应用场景

观远 BI 支持飞书/钉钉表格接入后，可充分利用企业习惯使用的已有工具，低成本的实现企业内多种业务场景下的数据统一整合和管理分析。帮助企业在销售、财务等方面做出高效率的业务决策。减少重复工作，快速方便的对接飞书表格，让更多的业务数据进入 BI，让业务用起来。

飞书电子表格：部分企业的业务人员在日常业务使用飞书电子表格作为载体进行协同，协作填写、收集手工数据。需要协同的表格字段多、参与的角色多、且业务修改单元格数据的频率较高。例如销售需求、供应链库存、销售目标等核心且高频使用数据，对于此部分数据也需要上传到 BI 中进行数据分析和消费。
飞书多维表格：部分业务人员选择使用飞书多维表格实现数据填报、补录场景，期望将相关数据接入 BI，满足与其他业务数据共同分析的场景。
钉钉 AI 表格：适配电商、制造、餐饮、物流等多行业，核心靠 AI 赋能提效。可自动处理评价、巡检等数据，接入观远 BI 后，能与订单、设备故障等数据融合分析，还支持通用数据填报与跨系统整合，放大数据价值。

飞书电子/多维表格

前提条件

确保已完成飞书与 BI 的集成，并已开通表格相关权限。

飞书与 BI 平台的认证集成

在接入飞书多维/电子表格之前，首先要建立观远 BI 与飞书平台的认证关系，获取相关权限，详情请参阅「飞书开放平台-开发者后台」创建观远BI应用和「观远管理后台」填写飞书企业自建应用相关信息。

说明
需通过飞书自建应用并完成相关配置，并按需开通在线文档的权限。
为飞书应用分配权限

进入飞书的「开发配置 > 权限管理」界面，为飞书云文档开启相关接口权限。

若图中的权限等级为「需审核权限」，则发布版本需要等待审核，审核通过后版本发布成功，权限配置方可生效。
- 飞书多维表格
  
  至少需为应用开启如下图「查看、评论、编辑和管理多维表格」的权限，其他飞书在线表格相关权限根据实际使用需求开通。
- 飞书电子表格
  
  至少需为应用开启如下图「查看、评论、导出电子表格」的权限，其他飞书在线表格相关权限根据实际使用需求开通。
如果文档存为知识库下（文档链接为「域名/wiki/...」），则需再开通 wiki 权限，详见：

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

飞书表格的链接权限配置

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

在本环节则是对飞书表格的分享链接权限进行预配置，链接分享有 4 种方式，请按需选择：
- 组织内获得链接的人可阅读（推荐选择，与 BI 平台对接时会进行组织权限校验）；
- 组织内获得链接的人可编辑（推荐选择，与 BI 平台对接时会进行组织权限校验）；
- 互联网上获得链接的人可阅读（公开可见，可能存在数据泄露的合规风险，请谨慎选择）；
- 互联网上获得链接的人可编辑（公开可见，可能存在数据泄露且被篡改的合规风险，请谨慎选择）。
说明
为表格分配权限，至少需分配组织内获得链接的人可阅读这项权限。
获取表格链接

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

选择连接器

功能入口：数据准备 > 数据集 > 新建数据集 > 在线文档 > 飞书电子/多维表格。

飞书多维表格连接器升级说明

新接口连接器（建议优先选择）：7.1 及以上版本支持对接飞书多维表格新接口，目前仅支持数据表及收集表两种类型的接入。为保障数据连接查询服务稳定，建议在新建数据集时优先选择此连接器。
旧接口连接器：原「飞书多维表格」更名为「（旧）飞书多维表格」，此连接器在连接查询数据时使用飞书旧接口。飞书后续将不再对该旧接口进行维护，为保障数据连接查询服务稳定，建议在新建数据集时优先选择「飞书多维表格」连接器。

选择数据表

填写表格地址

填写数据表的表格链接（链接获取方式参见上文）后点击「获取表格」，

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

异常提示项	处理思路
获取失败，地址无效	检查是否飞书表格是否与应用处于同一组织
获取失败，地址无效：飞书 api 接口请求失败	检查飞书表格是否开启分享链接。数据太大，服务器计算超时或上次提交的修改还没有处理完可以适当进行重试若 BI 未捕获异常，一般可以从飞书官方报错文档里找到对应报错原因；
获取失败，地址无效：没有权限获取工作表信息，请开通「获取工作表」API 的接口权限	检查飞书开放平台中应用是否分配正确的云文档权限；检查新建的多维表格没有添加相应的应用；
获取失败，地址无效：飞书未启用	检查观远 BI 中系统集成中的飞书是否开启
获取失败，地址无效：部分飞书授权配置项缺失	检查观远 BI 中系统集成中的飞书 App ID，App Secret 是否正确，测试连通性
请提供有效的飞书多维表格链接	检查提供的链接是否有误
请检查表格链接的权限配置	电子表格、多维表格的链接分享范围需要调整

相关链接：

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

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

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

选择表信息 - 电子表格

对于飞书电子表格，获取表格后需设置待接入的 sheet 工作表以及目标行列范围。

若需配置多张数据表，且这些表的配置需求保持一致时，建议先对其中一张数据表进行详细配置。随后，利用「配置同步」功能，可一键将已配置的数据范围及参数同步应用于其他选定数据表，以提升操作效率与准确性。

说明

飞书表格数据集的数据读取范围不能超于行列范围的配置项（当配置项为默认时，将读取至当前工作表下的最后有数列，中间空列以 Null 值进行标记）；
列名不可重复；
尽量输入行数据范围，否则可能会出现空数据（飞书会将电子表格空行计入行数统计，BI 平台接入时会认为行存在且正常读取数据，但实际行数据为空）；
通过配置公式生成的数据，BI 平台接入时仅保留其当前数据，不支持继承公式；
选择多个 sheet 工作表时，飞书表格数据集将默认把第一个 sheet 作为表头，其余 sheet 仅保留于第一个 sheet 有对应字段的数据。

选择表信息 - 多维表格

说明

飞书多维表格数据结构详情可参考多维表格记录数据结构。

对于飞书多维表格，获取表格后需参照以下步骤完成配置，以便更高效地管理和使用表格内容。

选择数据表：支持同时选择多个数据表进行处理。
配置数据表格式：需设置数据的行与列范围。
- 列数据：对应字段名称，用于识别不同数据属性。
- 行数据：用于界定具体数据内容的起始和结束位置，确保仅处理目标数据。
设置附件字段解析规则：在获取有附件字段的多维表格时，配置其解析规则。根据实际业务需求，自定义该字段在表格中希望展示和引用的核心内容。

可选内容类型包括：附件名称、访问地址（URL）或名称 +URL 组合形式。
完成上述配置后，点击右下角「预览」按钮以检查配置结果，进入后续操作环节。

说明

飞书表格数据集的数据读取范围不能超于行列范围的配置项（当配置项为默认时，将读取至当前工作表下的最后有数列，中间空列以 Null 值进行标记）；
列名不可重复；
尽量输入行数据范围，否则可能会出现空数据（飞书会将电子表格空行计入行数统计，BI 平台接入时会认为行存在且正常读取数据，但实际行数据为空）；
通过配置公式生成的数据，BI 平台接入时仅保留其当前数据，不支持继承公式；
选择多个 sheet 工作表时，飞书表格数据集将默认把第一个 sheet 作为表头，其余 sheet 仅保留于第一个 sheet 有对应字段的数据。

设置更新方式

飞书电子/多维表格的数据更新方式为抽取。

：开启调度状态时，将根据数据更新周期配置自动触发数据集更新；关闭调度后，系统将停止自动更新；手动及 URL 触发等不受调度状态影响。
按每天、每周、每月的周期配置触发数据集更新任务，可精确到时分。

说明
单个数据集一天内不能更新超过 4 次。
：可设置数据集抽取的任务优先级，保证同一时间调度起来的业务高关注度任务可以优先执行。分为最高、高、中等、低、最低五种，默认为中等。当触发数据集更新任务后，会按照当前配置的优先级插入到任务队列中。

确认数据表信息

通过自定义飞书电子/多维表格的数据集名称，并给指定路径进行保存，完成对抽取类型的飞书表格数据集创建。

钉钉AI表格