历史版本4 :钉钉OA审批 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

用户想要获取 OA 审批相关的数据,,对数据进行分析和处理。

1.2 功能简介

本产品支持获取钉钉 OA 审批数据,通过在开放平台中自建应用,接入相关数据,用户可以更方便的管理和分析数据,提高工作效率。

1.3 数据范围

下表为该数据源下各数据表的取数范围:

数据表
取数范围
获取单个审批实例详情第一次更新可以获取到第一次更新时间往前推近 4 个月数据,再次更新可以获取上次更新到这次更新之间的数据
获取表单schema全量同步,将看到触发同步时间点的所有数据

1.4 注意事项

「钉钉(企业内部应用)」为付费数据源,请管理员开通试用或者购买该数据源。

如何开通试用/购买数据源

超管或管理员,点击「企业设置>版本信息」,即可试用/开通数据源。如下图所示:

Group 144.png

2. 获取授权信息编辑

以下步骤建议由钉钉 主管理员 进行操作,在开放平台中创建应用来获取授权信息。

2.1 获取 AppKey 和 App Secret

1)钉钉主管理员登录 开发者后台,在「应用开放>钉钉应用」下点击「创建应用」。如下图所示:

1.png

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

Group 95.png

3)在权限管理下,在权限管理下,给这个应用申请相关权限。如需获取所有数据,请申请所有权限。

获取单个审批实例详情
工作流实例读权限
获取表单 schema工作流模板读权限

给这个应用申请「工作流实例读权限」、「工作流模板读权限」。如下图所示:

Group 96.png

4)以上条件配置好后,在「版本管理与发布」中,完成企业内部应用的发布。如下图所示:

Group 97.png

5)在「凭证与基础信息」下,就可以获取到 Client ID(AppKey)、Client Secret(AppSecret)。如下图所示:

Group 98.png


2.2 获取 processCode

1)使用有 OA 审批管理权限的账号登录钉钉的「管理后台」。如下图所示:

Group 99.png

2)在应用管理中找到 OA 审批,进入该应用中。如下图所示:

Group 100.png

3)如果您是钉钉新版用户,需要先返回到旧版才能获取 processCode,如下图所示:

Group 101.png

4)进入审批模板的编辑页面,在浏览器 URL 中获取 processCode。如下图所示:

Group 102.png

3. 连接「钉钉 OA 审批」数据源编辑

1)进入数据连接市场,新增「钉钉 OA 审批」数据源。如下图所示:

Group 103.png

2)在页面中添加相关信息,说明如下表所示:

信息
说明
名称自定义数据连接的名称,方便区分
AppKey根据 2.1 节中创建企业内应用后获取的信息
AppSecret
processCode2.2 节中获取的信息

Group 104.png

3)左侧列表中为可以选择添加的数据表,点击「查看」可以查看各表字段信息。勾选需要添加的数据表,点击「>」添加表。如下图所示:

Group 138.png

4)添加好数据表后,点击「确认」。如下图所示:

Group 139.png

5)在左侧就获取到了数据列表。如下图所示:

Group 140.png

4. 同步数据编辑

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

Group 141.png

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

5. 数据源协作编辑

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

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

Group 142.png

6. 使用数据编辑

获取到数据后,需要将数据保存在「分析展示」模块的项目中,进一步地分析。

Group 143.png