创建钉钉表格数据源

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

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

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

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

• 钉钉表格读权限

• 成员信息读权限

• 企业存储应用读权限

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

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

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

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

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

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

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

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

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

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

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

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

  展示内容	配置内容	配置操作
  区域 ① 表格在Quick BI系统中的展示名称	重命名展示名称	您可以根据实际需求自定义修改。 说明 展示名称不允许使用特殊字符，且前后不能包含空格。
  区域② 表格的分享链接	跳转查看源文档	点击表格链接旁的图标，即可在跳转新窗口中查看当前表格在钉钉端的源文档。
  区域 ③ 表格的表格页数量及标题	切换表格页	单击页签切换表格页以预览不同表格页中的数据内容，数据内容（即区域④）会随着页签的切换而相应调整。
  	重命名表格页	双击名称以根据实际业务意义重命名当前表格页，默认读取钉钉端表格中的表格页名称。 说明 表格页名称不允许使用特殊字符，且前后不能包含空格。
  区域 ④ 表格的数据内容	数据预览	在数据预览页签下预览数据内容，并进行以下操作。 修改字段名称：单击字段名称输入框，修改字段名。 修改字段类型：点击字段类型图标，在下拉列表中选择合适的字段类型。支持的类型包括文本、数值、日期。 说明 不支持继承钉钉源文档中的计算公式，导入后仅保留数值。
  	字段详情	表格接入后，会以数据库表的形式存储，数据库字段名称和字段类型为生成数据库表的字段名和类型，而字段名称对应钉钉表格中数据表的字段名称。 您可以在此根据实际情况重命名字段名称、修改字段类型。当不需要使用某一个字段时，点击图标即可将其删除。 说明 不支持继承钉钉文档中的计算公式，导入后仅保留数值。
  	设置定时同步	当您需要每天向Quick BI钉钉表格数据源中定时同步最新业务数据时，您可以将定时同步开关置于开启状态，并在数据定时同步弹窗中设置每天需要同步数据的时间点。 设定完成后，也可以通过点击图标修改已有的定时同步设置。 说明 每次同步都会全量覆盖原有数据，单个表格页的同步上限为10000行和100列。 该项设置仅对当前Sheet页生效，如果您有多个Sheet页需要同步，请逐一切换至相应Sheet页页签设置定时同步时间。
  	设置标题行	系统默认将表格的首行识别为表头行，第二行开始识别为要同步的数据。您也可以根据实际情况，在此修改当前Sheet的标题行，点击刷新按钮即可生效。 说明 输入的数字需为大于0的整数。 请确保标题行中没有空字段，否则将触发报错。
  区域⑤ 表格同步设置	连接后立即同步所有Sheet页	选中后，后续连接钉钉表格时Quick BI系统即会自动同步当前表格中所有Sheet的内容，无需再手动同步。

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

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

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

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

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

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

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

  说明

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

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

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

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

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

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

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