1. 概述
1.1 功能简介
本产品支持对接钉钉项目获取数据,为取到的数据进行处理和分析。
1.2 注意事项
1)「钉钉项目」数据源为 Alpha版本,可能存在一些不稳定因素。诚邀您 参与共创,帮助数据源团队改进和完善功能。如您愿意参与共创,可填写 表单 ,数据源团队将主动和您联系并协助配置。
2)「钉钉项目」为付费数据源,请管理员开通试用或者购买该数据源。详情请参见:第三方平台管理
3)此数据源会消耗钉钉企业内部应用 API 调用量,请用户自行购买。详情请参见钉钉官方文档:调用量和调用频次说明
2. 获取授权信息
以下步骤建议由钉钉 主管理员 进行操作,在开放平台中创建应用来获取授权信息。
1)钉钉主管理员登录 开发者后台,在「应用开放>钉钉应用」下点击「创建应用」。如下图所示:

2)用户可以对应用名称、应用描述自定义设置,设置好后点击「保存」。如下图所示:

3)在权限管理下,给这个应用申请相关权限。请根据图片示例依次搜索权限并勾选,下方所有权限都需要勾选。全部勾选完成后,点击「批量申请」。
通讯录部门信息读权限(qyapi_get_department list)
通讯录部门成员读权限(gyapi get_department_member)
成员信息读权限(qyapi_get_member)
项目应用任务读权限(Project.Task.Read.All)
项目应用项目读权限(Project.Project.Read.All)
通讯录接口权限范围选择「全部员工」。如下图所示:

4)以上条件配置好后,在「版本管理与发布」中,完成企业内部应用的发布。如下图所示:
注:若发布后再修改应用的相关信息,请再次发布。

5)在「凭证与基础信息」下,就可以获取到 Client ID(AppKey)、Client Secret(AppSecret)。如下图所示:

3. 新增数据连接
1)进入数据连接市场,新增「钉钉项目」数据源。如下图所示:

2)在页面中添加相关信息,说明如下表所示:
| 信息 | 说明 |
|---|---|
| 名称 | 自定义数据连接的名称,方便区分 |
| ClientId | 第 2 节获取的信息:
|
| Client Secret |

3)左侧列表为可以选择添加的数据表,点击「查看」可以查看各表字段信息。勾选需要添加的数据表,点击「>」添加表。添加好数据表后,点击「确认」。如下图所示:

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

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

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