在用户需要通过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对飞书多维表格数据开展可视化分析与数据洞察。