1. 概述
1.1 应用场景
用户想要获取飞书考勤数据,对数据进行处理和分析。
1.2 功能简介
本产品支持对接飞书考勤,用户只需获取相关授权信息,即可将飞书考勤数据获取到本产品中。
1.3 注意事项
1)此数据源需调用「考勤查询接口」,会消耗飞书企业自建应用的 API 调用次数,企业管理员可登录管理后台,在「费用中心 > 权益数据」页面查看 API 调用次数。详情请参见飞书官方文档:自建应用 API 调用量上线调整说明
2)「飞书考勤」为付费数据源,请管理员开通试用/购买该数据源。如下图所示:
| 如何开通试用/购买数据源 |
管理员点击「高级设置>版本信息」,即可试用/购买数据源。如下图所示:
|
2. 获取授权信息
2.1 获取 App ID 和 App Secret
1)飞书管理员 登录开发者后台,点击「创建企业自建应用」,填写应用基本信息,并点击「创建」。如下图所示:

2)在权限管理下,请依次搜索并勾选以下权限,确认开通权限。如下图所示:
导出打卡数据(attendance:task:readonly)
获取通讯录基本信息(contact:contact.base:readonly)
获取用户 user ID(contact:user.employee_id:readonly)
注:如您在发布应用后再次勾选其他权限,请再次发布应用,配置才可生效。

3)在「版本管理与发布」中,完成企业内部应用的线上发布。如下图所示:
注:非企业管理员创建应用并申请上线,需要企业管理员在管理后台中进行应用审核,详情参见文档:审核自建应用

4)在「凭证与基础信息」下,就可以获取到 App ID 和 App Secret 。如下图所示:

2.2 获取管理员用户 ID
登录 飞书管理后台 ,请选择一位能查看飞书考勤数据的管理员,查看用户 ID。如下图所示:

3. 连接「飞书考勤」数据源
3.1 新增「飞书考勤」数据源
1)进入数据连接市场,新增「飞书考勤」数据源。如下图所示:

2)在弹窗中添加相关配置,相关配置说明如下表所示:
| 信息 | 说明 |
|---|---|
| 名称 | 自定义新增数据的名称,方便区分 |
| AppId | 2.1 节中配置应用后获取的信息 |
| AppSecret | |
| 管理员用户ID | 2.4 节获取的用户ID |

3)左侧列表为可以选择添加的数据表,点击「查看」可以查看各表字段信息。勾选需要添加的数据表,点击「>」添加表。
若用户希望自动获取新增的表,可在选表界面开启「新增表自动勾选」。

4)添加好数据表后,点击「确认」。如下图所示:

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

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

2)之后可以根据自己的实际需求,对单表或者多表进行同步。建议减少同步整个数据源次数,以避免不必要的等待时间。详情参见文档:同步数据
5. 数据源协作
6. 使用数据
在数据连接市场添加好数据源并同步数据后,下一步,需要将数据保存在「分析展示」模块的项目中,进一步地分析。

