1. 概述
1.1 应用场景
用户想要获取 OA 审批相关的数据,对数据进行分析和处理。
1.2 功能简介
本产品支持获取钉钉 OA 审批数据,通过在开放平台中自建应用,接入相关数据,用户可以更方便的管理和分析数据,提高工作效率。
1.3 数据范围
下表为该数据源下各数据表的取数范围:
数据表 | 取数范围 |
---|---|
获取单个审批实例详情 | 第一次更新可以获取到第一次更新时间往前推近 30 天数据,再次更新可以获取上次更新到这次更新之间的数据 |
获取表单schema | 全量同步,将看到触发同步时间点的所有数据 |
2. 获取授权信息
以下步骤建议由钉钉 主管理员 进行操作,在开放平台中创建应用来获取授权信息。
2.1 获取 AppKey 和 App Secret
1)钉钉主管理员登录 开发者后台,在「应用开放>钉钉应用」下点击「创建应用」。如下图所示:
2)用户可以对应用名称、应用描述自定义设置,设置好后点击「保存」。如下图所示:
3)在权限管理下,在权限管理下,给这个应用申请相关权限。如需获取所有数据,请申请所有权限。
获取单个审批实例详情 | 工作流实例读权限 |
获取表单 schema | 工作流模板读权限 |
给这个应用申请「工作流实例读权限」、「工作流模板读权限」。如下图所示:
4)以上条件配置好后,在「版本管理与发布」中,完成企业内部应用的发布。如下图所示:
5)在「凭证与基础信息」下,就可以获取到 Client ID(AppKey)、Client Secret(AppSecret)。如下图所示:
2.2 获取 processCode
1)使用有 OA 审批管理权限的账号登录钉钉的「管理后台」。如下图所示:
2)在应用管理中找到 OA 审批,进入该应用中。如下图所示:
3)进入审批模板的编辑页面,在页面底部可获取 processCode 信息。如下图所示:
3. 连接「钉钉 OA 审批」数据源
1)进入数据连接市场,新增「钉钉 OA 审批」数据源。如下图所示:
2)在页面中添加相关信息,说明如下表所示:
信息 | 说明 |
---|---|
名称 | 自定义数据连接的名称,方便区分 |
AppKey | 根据 2.1 节中创建企业内应用后获取的信息 |
AppSecret | |
processCode | 2.2 节中获取的信息 |
3)左侧列表为可以选择添加的数据表,点击「查看」可以查看各表字段信息。勾选需要添加的数据表,点击「>」添加表。如下图所示:
4)添加好数据表后,点击「确认」。如下图所示:
5)在左侧就获取到了数据列表。如下图所示:
4. 同步数据
1)完成授权后,在左侧就获取了数据列表。此时还没有数据,点击「同步数据源」将全部数据同步一次,先获取数据。如下图所示:
2)之后可以根据自己的实际需求,对单表或者多表进行同步。建议减少同步整个数据源次数,以避免不必要的等待时间。详情参见文档:同步数据
5. 数据源协作
6. 使用数据
获取到数据后,需要将数据保存在「分析展示」模块的项目中,进一步地分析。