钉钉文档

1.1 应用场景

用户想要获取钉钉文档中的在线表格数据，对数据进行处理和分析。

1.2 功能简介

本产品支持对接钉钉文档，用户只需获取相关授权信息，即可将钉钉在线表格数据获取到本产品中。

1.3 授权流程

• 此数据源 支持获取「在线表格」的数据，其他类型的文件数据暂不支持获取。

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

2.1 创建自建应用获取 AppKey 和 App Secret

1）钉钉主管理员登录 开发者后台，在「应用开放>钉钉应用」下点击「创建应用」。如下图所示：

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

3）在权限管理下，请根据图片示例依次搜索权限并勾选，下方所有权限都需要勾选。全部勾选完成后，点击「批量申请」。如下图所示：

• 知识库文档读权限

• 知识库读权限

• 知识库节点读权限

• 钉钉表格读权限

• 知识库搜索权限

• 通讯录个人信息读权限

4）请勾选「通讯录管理」tab 下所有权限，点击「批量申请」。如下图所示：

5）进入「分享设置」页面，在接入登录回调域名处添加：https://dm.shukuajing.com/sync/datasource/auth。如下图所示：

6）完成上述所有操作者，在「版本管理与发布」中，完成企业内部应用的线上发布。如下图所示：

注：非企业管理员创建应用并申请上线，需要企业管理员在管理后台中进行应用审核，详情参见文档：审核自建应用

7）在「凭证与基础信息」下，就可以获取到 App ID 和 App Secret 。如下图所示：

2.2 获取链接

进入在线表格中，点击「分享」按钮，即可复制链接，链接形式为：https://alidocs.dingtalk.com/i/nodes/xxxxxxxxxxx

注：在连接「钉钉文档」数据源时，需要进行授权。请确保授权账号拥有文档的查看及以上权限，否则会授权失败。

3.1 新增「钉钉文档」数据源

1）进入数据连接市场，新增「钉钉文档」数据源。如下图所示：

2）在页面中填写第 2 节中获取的信息，「点击授权」进入授权页。如下图所示：

3）登录钉钉账号，同意授权协议。如下图所示：

4）看到「已完成」提示，表示授权成功。点击「下一步」，如下图所示：

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

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

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

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

3.2 添加多个在线表格数据

如果需要获取多个在线表格，请重复 2.4 节获取对应文件链接。

• 如果需要将所有在线表格放置在一个数据连接下进行管理，点击节点右侧的「新增」按钮，再填写相关信息。这样可以把多个表格的数据放在同一个数据连接下，方便查看和管理。如下图所示：

• 如果需要对数据分别管理，可以点击「新增数据连接」，再填写相关信息。这样可以添加两个数据连接，对其分开管理。如下图所示：

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

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

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

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

在数据连接市场添加好数据源并同步数据后，下一步，需要将数据保存在「分析展示」模块的项目中，进一步地分析。

若在授权时出现：连通性测试失败。请检查授权账号是否拥有文档的查看及以上权限，若该账号无权限，则授权失败。