1. 概述
1.1 应用场景
钉钉企业用户想要将钉钉数据同步至九数云，在九数云中进行数据的分析和处理，如何将数据同步至九数云呢？
1.2 功能简介
数据资产平台作为钉钉上的数据整合平台，可以将钉钉用户使用的数据汇总，作为数据的中转岛，ISV 连入数据资产平台后可以通过资产平台的一个数据接口获取整合后的用户授权数据。
使用钉钉的企业可以将 OA 审批数据同步至九数云，使用九数云来帮助企业进行业务上的分析。
1.3 授权流程
第一步：先确认钉钉工作台中是否开通「OA审批」应用，没有开通是获取不到数据的。
第二步：钉钉企业管理员登录开发者后台，在数据资产平台中进行授权。
第三步：在九数云中添加钉钉 OA 审批数据，并同步数据。
第四步：管理员给成员分配权限，有权限的成员才可使用 OA 审批数据。
1.4 注意事项
1）钉钉企业才可使用钉钉数据源，非钉钉企业不展示钉钉数据源入口。
2）由于钉钉平台的限制，在九数云中获取 OA 数据后，修改 OA 审批的表单结构，例如修改字段名、增加/删除字段等，再次同步会清空历史数据，仅能同步修改后新增的数据。如您需要获取历史数据：
从钉钉后台中导出数据后上传到九数云中，再与现在的钉钉数据表上下合并；
在修改表单结构之前，在九数云中对现有 数据存档 一下，同步后再与新数据上下合并。
2. 获取钉钉数据
在九数云中添加钉钉数据之前，需要在数据资产平台中先将数据授权给九数云应用。
如果操作者是钉钉的主管理员，拥有企业的全部权限，可直接进入 2.2 节授权数据资产平台；
非管理员进入数据资产平台，需要让主管理员按照 2.1 节分配「开发者权限」，才可进入数据资产平台。
2.1 使用准备
登录开发者后台需要有组织的开发者权限，主管理员在钉钉管理后台中给其他成员添加开发者权限。
1）主管理员进入钉钉「管理后台」。如下图所示：
2）设置其他成员为子管理员，并给他添加「开发者权限」。如下图所示：
2.2 数据资产平台中授权九数云
1）登录 开发者后台，选择对应的企业，进入进入「开放能力>数据资产平台」，如下图所示：
2）点击左侧功能栏的「创建数据服务」，进入「授权数据使用」页面，如下图所示：
3）在页面中展示了九数云应用，找到「钉钉OA数据服务」，点击「去授权」。这样就对九数云授权了 OA 审批数据，下一步在九数云中添加这些数据。如下图所示：
2.3 添加 OA 审批数据
1）九数云管理员进入数据连接市场，点击进入「钉钉数据源」。如下所示：
2）点击左上角「新增数据链接」按钮获取钉钉数据，在弹窗展示了当前可添加的数据目录，如下图所示：
3）可以点击选择想要的数据，在右侧修改表的名称以及取数的范围。如下图所示：
若需添加多张数据表，重复「新增数据连接」步骤即可。
2.4 数据说明
1）以「个人客户」数据为例，数据说明如下：
最近一年：支持拉取最近一年的明细数据；
最近一月：支持拉取最近一月的明细数据；
年度：按照年分组获取「个人客户」的所有数据；
月度、季度、周：同年度数据一样，按照时间分组获取「个人客户」的所有数据。
2）「审批单明细」、「审批单审批人效率明细」这两张数据表，首次同步可以获取当前时间往前半年的数据。且因接口限制，不返回当天的数据，仅能同步到前一天的数据。例如，2023-08-01 首次同步，2024-05-02 再次同步数据，只能获取到 2023-08-01 至2024-05-01 的数据。
2.5 同步数据
2.4 节只获取了数据列表，可以点击右上角的「同步表单」按钮同步数据。同步状态显示成功，数据就获取成功了。如下图所示：
3. 权限设置
点击「权限设置」按钮，管理者可对数据源进行设置，分配给其他成员或者团队使用。
详情参见文档：数据源权限设置
注1：钉钉数据源的权限默认分配给「企业数据管理团队」，管理员可进行更改；
注2：只有管理员或者是有权限的成员才可以查看到钉钉数据表，没有权限的成员请向管理员申请。
4. 使用数据
获取到数据后，就可以将数据添加到项目中，进一步地分析。如下图所示：
5. 删除数据
如果某个数据不小心重复添加了，可点击数据右侧的「删除」按钮，删除这张表。
在删除之前可以先点击「查询使用情况」查询这张数据表是否被使用。
