钉钉文档

1. 概述

1.1 功能简介

本产品支持对接钉钉文档获取数据，对取到的数据进行处理和分析。

1.2 注意事项

1）此数据源支持获取知识库中的「在线表格」的数据，其他类型的文件数据暂不支持获取。

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

3）此数据源会消耗钉钉企业内部应用 API 调用量，请用户自行购买。详情请参见钉钉官方文档：调用量和调用频次说明

2. 获取授权信息

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/ZQYprEoWonELE2xkU6lBOGDA81waOeDk?utm_scene=team_space

注1：仅支持获取知识库中的「在线表格」的数据，其他类型的文件数据暂不支持获取，知识库中的在线文档 URL 结尾为：?utm_scene=team_space。

注2：在连接「钉钉文档」数据源时，需要进行授权，授权成员需在知识库成员中，且授权成员需拥有表格的查看及以上权限，否则会授权失败。

3. 新增数据连接

3.1 新增「钉钉文档」数据连接

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

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

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

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

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

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

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

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

3.2 添加多个在线表格数据

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

点击「新增数据连接」，再填写相关信息。如下图所示：

4. 同步数据源

完成授权后，在左侧就获取了数据列表。此时还没有数据，请勾选需要同步的数据表，批量同步数据。如下图所示：

详情参见文档：同步数据

5. 数据源协作

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

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

6. 使用数据

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