配置钉钉文档数据源

1.1 版本

1.2 功能简介

FineDataLink 支持连接钉钉文档数据源，支持：定时管道任务读取。

1.3 使用限制

1）「钉钉文档」数据连接支持获取的表及字段信息见：平台/表/字段

2）仅当用户注册了「应用系统（云端）」功能点，且「应用系统（云端）-类型数」大于 0 时，才支持使用此数据源。详情参见文档：注册简介

3）工程所在服务器需具备访问外网权限，或者可以配置白名单：

• 域名白名单：dm.shukuajing.com

• IP 白名单：47.110.75.116

• 端口白名单：443

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.1 前提条件

详情请参见：前提条件

3.2 具体连接步骤

1）创建数据连接步骤请参见：创建并管理数据

2）在页面中填写相关信息，说明如下表所示：

3）登录钉钉账号，该授权成员需在知识库成员中，且需拥有表格的查看及以上权限。看到「已完成」提示表示授权成功。如下图所示：

4.1 定时管道任务读取

定时管道任务的数据来源支持：钉钉文档，详情参见文档：定时管道概述