钉钉多维表

1.1 应用场景

用户想要获取钉钉 AI 表格（多维表格）中的数据，对数据进行处理和分析。

1.2 功能简介

本产品支持对接钉钉 AI 表格（多维表格），用户只需获取相关授权信息，即可将钉钉 AI 表格数据获取到本产品中。

1.3 注意事项

1）此数据源 支持获取「AI 表格」的数据，其他类型的文件数据暂不支持获取。

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

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

2.1 创建应用获取 AppKey 和 App Secret

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

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

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

• 通讯录个人信息读权限（Contact.User.Read）

• 通讯录部门信息读权限（qyapi_get_department_list）

• 通讯录部门成员读权限（qyapi_get_department_member）

• 知识库节点读权限（Wiki.Node.Read）

• AI 表格应用读权限（Notable.Base.Read.All）

• 企业员工手机号信息（fieldMobile）：要使用手机号字段

• 邮箱等个人信息（fieldEmail）：要使用邮箱或其他个人信息字段

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

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

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

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

2.2 获取链接

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

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

3.1 新增「钉钉多维表」数据源

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

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

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

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

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

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

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

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

3.2 添加多个在线表格数据

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

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

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

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

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

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

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

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

7.1 连通性测试失败

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

7.2 获取的字段&字段值

在获取钉钉 AI 表格数据时，部分字段存在异常情况，相关说明见下表：