创建钉钉AI表格数据源

步骤一：获取应用授权

您需要在钉钉开放平台中创建企业内部应用，并获取相关授权信息，用于后续在Quick BI中创建数据源时认证使用。具体操作说明如下。

1. 登录钉钉开发者后台，为当前账号申请开通开发者权限。

2. 点击创建应用，在创建弹窗中维护应用的相关信息，完成后点击保存。

3. Quick BI是通过API接口读取钉钉AI表格数据，因此您需要为当前应用申请钉钉API接口的调用权限。在应用的开发者后台，选择左侧导航栏权限管理，在右侧页面中为当前创建的应用配置所需权限。

   说明

   由于钉钉侧限制，钉钉标准版接口累计可调用次数为5000次/月。若该调用量无法满足需求，您可升级至钉钉专业版、钉钉专属版扩容调用次数。具体请参见钉钉PaaS能力调整公告。

   您需要勾选以下API权限并点击批量开通。

   • AI表格应用读权限

   • 成员信息读权限

   • 企业存储应用读权限

4. 右侧导航栏选择应用发布 > 版本管理与发布，点击右侧页面中的创建版本。

5. 在跳转的版本详情页面中，维护版本信息，完成后点击保存触发应用发布审批流，审批完成后应用将自动发布。

6. 应用发布完成后，在凭证与基础信息页面，复制并保存当前应用的Client ID与Client Secret。

步骤二：获取钉钉AI表格链接

登录钉钉文档，找到需要接入Quick BI的目标钉钉AI表格，复制并保存分享链接。具体操作说明如下。

1. 在钉钉云文档的文档列表中，找到需要接入Quick BI的目标钉钉表格，点击其操作列中的分享（）图标。

   说明

   对于接入Quick BI的AI表格，目前存在以下限制，请您提前确认表格是否符合限制。

   • 单个表格页列数不超过100列，行数不能超过10000行。

   • 暂不支持导入以下字段类型：部分常用字段（包括：文档、货币、图片、附件、进度、公式、单向关联、双向关联）、高级字段（人员、部门除外）、AI Agent字段及实用工具字段。

   • 表格Sheet页中的内容不能为空，且Sheet页数量需控制在5个以内。

2. 在分享弹窗中设置链接的分享范围。

3. 点击复制链接按钮，复制并保存当前表格的分享链接。

步骤三：创建数据源

获取钉钉应用授权信息及AI表格分享链接后，您需要将其添加至Quick BI数据源新建页面中，以接入钉钉中的AI表格。具体操作说明如下。

1. 登录Quick BI工作台 > 数据源，点击数据源页面右上角的新建数据源。

2. 在新建数据源页面选择应用服务 > 钉钉AI表格。

   说明

   请确保当前账号所在的组织，已在组织管理 > 办公软件接入处完成了钉钉应用授权，否则将无法进行钉钉数据源连接。您可以联系组织管理员进行授权，具体操作步骤请参见钉钉集成。

3. 在跳转配置页面中，填入通过步骤一、步骤二获取的钉钉端相关授权信息。

   配置内容	配置说明
   AppKey	填入钉钉应用的唯一标识，对应钉钉开发者后台凭证与基础信息页面中的Client ID 。
   AppSecret	填入钉钉应用的密钥，在创建当前应用时由钉钉平台自动生成。对应钉钉开发者后台凭证与基础信息页面中的Client Secret。
   钉钉AI表格链接	填入钉钉AI表格分享链接，对应钉钉文档分享页面中复制的链接。 说明 请确保您有该链接对应AI表格的查看权限，具体设置方法可参见获取钉钉AI表格链接中的说明。

4. 点击连接测试，测试通过后页面上即会显示授权应用的信息。

5. 点击确定连接，系统将自动解析读取当前URL下的所有Sheet页内容：

   说明

   最多仅支持解析前5个Sheet页。

   • 当所有Sheet页解析成功时，将跳转至数据预览页面。您可以在此预览以下信息并进行相关操作。

     展示内容	配置内容	配置操作
     区域 ① 表格在Quick BI系统中的展示名称	重命名展示名称	您可以根据实际需求自定义修改当前表格数据源的展示名称。 说明 展示名称不允许使用特殊字符，且前后不能包含空格。
     区域② 表格的分享链接	跳转查看源文档	点击表格链接旁的图标，即可在跳转新窗口中查看当前表格在钉钉端的源文档。
     区域 ③ 表格的表格页数量及标题	切换表格页	单击页签切换表格页以预览不同表格页中的数据内容，数据内容（即区域④）会随着页签的切换而相应调整。
     	重命名表格页	双击名称即可根据实际业务意义重命名当前表格页，默认读取钉钉端表格中的表格页名称。 说明 表格页名称不允许使用特殊字符，且前后不能包含空格。
     区域 ④ 表格的数据内容	数据预览	在数据预览页签下预览数据内容，并进行以下操作。 修改字段名称：单击字段名称输入框，修改字段名。 修改字段类型：点击字段类型图标，在下拉列表中选择合适的字段类型。支持的类型包括文本、数值、日期。
     	字段详情	表格接入后，会以数据库表的形式存储，数据库字段名称和字段类型为生成数据库表的字段名和类型，而字段名称对应AI表格中数据表的字段名称。 您可以在此根据实际情况重命名字段名称、修改字段类型。当不需要使用某一个字段时，点击图标即可将其删除。 说明 暂不支持导入附件、单向关联、双向关联、公式类型的字段，因此Quick BI会做过滤处理。
     	自动解析	在AI表格中，一个单元格内的数据内容可能不仅仅是简单的文本或数字，它可能携带卡片、标签列表等样式以展示多维信息。当Quick BI通过API从表格中提取数据时，为保留完整的数据层次和语义信息，包含复杂信息的字段通常以JSON格式来传输。Quick BI接收到这些JSON格式的数据后，需要进一步解析成可用于数据分析的普通字段。 此时，您可以通过开启自动解析功能，采用Quick BI侧提供的钉钉AI表格解析规则，自动将JSON数据解析成对应的字段类型；也可以按需通过新建计算字段来自定义解析规则。 默认为当前表格数据源开启自动解析状态，支持通过点击开关图标（）调整。 说明 使用钉钉AI表格数据源创建的数据集，在新建计算字段时，仅支持使用系统内置函数。
     	设置定时同步	当您需要每天向Quick BI钉钉AI表格数据源中定时同步最新业务数据时，您可以将定时同步开关置于开启状态，并在数据定时同步弹窗中设置每天需要同步数据的时间点。 设定完成后，也可以通过点击图标修改已有的定时同步设置。 说明 每次同步都会全量覆盖原有数据，单个表格页的同步上限为10000行和100列。 该项设置仅对当前Sheet页生效，如果您有多个Sheet页需要同步，请逐一切换至相应Sheet页页签设置定时同步时间。
     区域⑤ 表格同步设置	连接后立即同步Sheet页内容	选中后，后续连接钉钉AI表格时Quick BI系统即会自动同步当前AI表格中前5个Sheet的内容，无需再手动同步。

   • 当存在解析失败的Sheet页时，您可以在数据预览页面查看该Sheet页解析失败的原因，并在根据提示调整内容后，通过点击右上角刷新按钮完成更正；如果该Sheet页无实际业务意义，您也可以不对该Sheet页进行内容更正，后续完成其他Sheet页信息确认后，连接钉钉表格时，该解析失败的Sheet页将会被自动过滤。

6. 完成配置后点击确认并连接，完成钉钉AI表格数据源创建。

7. 回到数据源页面，在数据源列表中找到刚才接入的钉钉AI表格数据源，点击各表格页操作列的图标以同步数据。

   说明

   如果您在接入表格时已勾选连接后立即同步所有Sheet页，则系统已为您自动同步内容，您不用操作该步骤。

   

8. （可选）您可以在数据源页面中，查看并管理已创建的钉钉表格数据源及其下的表格页，支持进行以下操作。

   • 预览数据表：在名称列找到需要预览的数据表，点击其名称，即可在预览数据页面查看当前数据表的内容。

   • 设置定时同步：点击定时同步开关，修改定时同步功能的开启状态；也可以在定时同步开启的前提下，点击图标修改定时同步的时间点。

   • 创建数据集：点击图标，即可跳转至数据集创建页面，在当前表格页的基础上创建数据集。关于创建数据集的详细操作说明，请参见创建数据集。

     说明

     请确保当前表格页的同步状态为成功，否则无法基于此表格页创建数据集。

   • 同步数据：点击图标以手动触发同步任务。

   • 查看同步记录：点击图标，在查看日志弹窗中查看当前表格页的历史更新记录，展示的内容包括：更新的时间、状态、耗时、日志信息，且支持根据特定的时间范围查询相关日志。

步骤四：编辑数据源

将钉钉AI表格接入Quick BI平台后，支持编辑该数据源的授权信息、表格分享链接、数据源展示名称等信息，具体操作如下。

1. 钉钉AI表格列表中，找到目标数据源并点击编辑按钮。

2. 在钉钉AI表格的选择数据界面，修改钉钉自建应用的授权信息。

   配置内容	配置说明
   已授权应用	点击已授权应用右侧的图标，页面中即会显示AppKey和AppSecret的输入框，在此维护新应用的AppKey和AppSecret。
   钉钉表格链接	填入新表格的分享链接。

3. 点击连通测试，校验通过后点击确定连接，即可跳转至预览数据界面。您可以在此根据实际需求编辑钉钉表格的展示名称、定时同步设置、字段名称、数据类型等信息，具体操作说明同步骤三：创建数据源中的第5步。

4. 完成编辑后点击确认并连接。

点击后即可重新获取当前Sheet页的信息，包括Sheet页名称、字段名称、数据类型等。