操作教程 | DataEase基于插件实现数据源与飞书多维表格的对接

在用户需要通过DataEase开源BI工具对飞书多维表格中的数据进行数据分析与可视化时，有两种方法可以将待分析的飞书多维表格作为数据源接入到DataEase。 一种是将飞书多维表格数据作为普通的API数据源接入DataEase；另一种则是使用DataEase专业版和企业版所提供的飞书多维表格插件，通过该插件提供的“飞书多维表格”数据源选项，让DataEase直接与用户的飞书多维表格进行数据对接。该插件所提供的“飞书多维表格”数据源接入方式相比普通的API数据源接入更加便捷。

本文为您详细介绍DataEase飞书多维表格插件（DataEase专业版和企业版提供）的配置、使用方法，以及在DataEase中接入飞书多维表格数据源的具体步骤。

一、飞书平台与DataEase的对接

要利用插件实现飞书多维表格与DataEase数据源的对接，首先需要进行飞书平台与DataEase的对接设置。具体步骤可以参见官方文档：
https://dataease.io/docs/v2/xpack/platform_abutment/#3。

二、飞书应用的权限设置

将飞书平台与DataEase对接完成后，飞书平台的工作台中会出现一个用于与DataEase对接的应用。其名称是在上一步的对接操作中设置好的，这里我们将这个应用命名为“dataease测试”。我们需要在“dataease测试”应用的“权限管理”设置中进行应用的相关授权，开通“查看、评论、编辑和管理多维表格”和“查看、评论和导出多维表格”这两项权限。

▲图1 飞书平台中“dataease测试”应用的权限开通

三、在DataEase中配置插件，并对接飞书多维表格数据源

1.下载并安装飞书多维表格插件

飞书多维表格插件下载完成后，可以用DataEase系统管理员的账号，将下载好的插件JAR包导入DataEase。具体步骤如下：

① 进入DataEase“系统设置”页面；

▲图2 “系统设置”页面入口

② 进入“系统设置”菜单下的“插件管理”页面，选择通过“本地安装”途径安装飞书多维表格插件；

▲图3 飞书多维表格插件安装路径

③ 选择相应的插件JAR包，点击“打开”按钮将其导入DataEase，提示“安装成功”则代表安装已完成。

▲图4 安装插件JAR包

2.创建飞书多维表格数据源

① 成功安装插件后，返回DataEase的“数据源“页面。点击“数据准备”菜单下的“新建数据源”按钮，进入“创建数据源”页面。在“API数据”分类下，可以看到数据源选项中增加了一个名为“飞书多维表格”的选项；

▲图5 API数据源中新增飞书多维表格数据源

② 点击“飞书多维表格”数据源选项，进入数据源配置信息界面，填写数据源名称后，点击“添加”按钮添加数据源；

▲图6 飞书多维表格数据源的配置信息

③ 进入数据表添加页面后，在“连接API”步骤，填写名称和app_token（app_token获取手册参见：https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview#-752212c）信息。如果前两项信息填写无误，则可以在“数据表”项目中点击“获取数据表”链接选中所需的数据表，在“视图”项目中点击“获取视图”链接选择对应的视图；

▲图7 连接数据表API

④ 输入所有的基础信息后，点击“校验”按钮。如果校验无误，即可点击“下一步”按钮，在得到的返回数据中选择所需数据，并且可以在下拉页面中预览选中的数据；

▲图8 选择所需的数据

▲图9 预览选中数据

⑤ 确认选择的数据无误后，点击“保存”按钮，完成数据表的添加，然后点击“下一步”按钮；

▲图10 数据表添加完成

⑥ 现在我们进行数据更新设置。此处设置数据更新方式为“全量更新”，更新频率为“简单重复”，将更新的“设置规则”调整为“每1分钟更新一次”，并且配置好开始时间与结束时间，然后点击“检验”按钮，如果校验无误即可保存数据源。

▲图11 数据更新设置

▲图12 确认新建数据源

▲图13 数据源创建成功

▲图14 飞书多维表格数据源基础信息页面

通过以上步骤，就可以成功在DataEase中配置好飞书多维表格插件了。通过添加“飞书多维表格”数据源，我们可以通过DataEase对飞书多维表格数据开展可视化分析与数据洞察。