飞书项目

1.1 应用场景

用户想要获取飞书项目的相关数据，对数据进行处理和分析。

1.2 功能简介

本产品支持对接飞书项目，用户只需获取相关授权信息，即可将飞书项目数据获取到本产品中。

1.3 注意事项

1）Beta 版本的数据源正处于公测阶段，如在使用中有任何问题或者需求，可联系技术支持进行反馈。Beta 版本在完成测试周期后会成为正式版，该信息将通过产品公告通知用户。

2）「飞书项目」为付费数据源，请管理员开通使用或者购买该数据源。

2.1 创建插件

1）在飞书项目中，点击进入「开发者后台」。如下图所示： 

2）点击创建一个插件。如下图所示：

3）在基本信息中，填写插件的相关信息。如下图所示：

4）在「权限管理」中，批量获取所有的权限。如下图所示：

5）进入「插件发布」，发布插件新版本，使当前配置生效。如下图所示：

2.2 获取 Plugin ID、Plugin Secret

1）在基本信息中，获取 Plugin ID、Plugin Secret，复制这两个信息填写在授权配置页。如下图所示：

2.3 获取 User Key

点击头像，在更多信息中获取用户 ID，即 User Key。如下图所示：

2.4 使用插件

1）创建一个团队，团队成员为飞书通讯录的所有成员。并设置可使用本团队的空间，例如空间名为「测试空间」。

2）进入「测试空间」中，在「空间配置>插件管理」中安装前面已发布的插件，这样才可获取所有用户信息。如下图所示：

1）进入数据连接市场，新增「飞书项目」数据源。如下图所示：

2）在页面中填写第 2 节中获取的信息，如下图所示：

3）左侧列表为可以选择添加的数据表，点击「查看」可以查看各表字段信息。勾选需要添加的数据表，点击「>」添加表。

若用户希望自动获取新增的表，可在选表界面开启「新增表自动勾选」。

4）添加好数据表后，点击「确认」。如下图所示：

5）在左侧就获取到了数据列表。如下图所示：

1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：

2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据

数据源的创建者默认拥有数据源的管理权限，管理者可将此数据源分配给其他成员使用。

点击「权限设置」按钮，在弹窗中即可自定义配置数据源权限，详情参见文档：数据源权限设置

获取到数据后，需要将数据添加至「分析空间」模块的项目中，进一步地分析。详情参见：将数据添加进项目中