审批附件的操作流程

更新于 2024-01-11本教程介绍了如何通过官方OA审批API实现发起带附件的审批流，及下载附件。

说明

预期效果

本文档展示了，创建一个企业内部应用，实现使用官方OA审批发起带附件的审批、下载审批附件等流程：

步骤一：登录开发者后台，点击应用开发-企业内部开发，创建企业内部应用。

步骤二：单击基础信息 > 应用信息，获取应用AppKey和AppSecret。

步骤三：添加接口调用权限。单击“OA审批”，申请OA审批对应的权限。

步骤四：获取应用访问凭证获取企业内部应用的access_token。调用接口时，通过accessToken鉴权调用者身份。

步骤五：调用OA审批相关API和客户端JSAPI：

调用服务端API-获取审批钉盘空间信息接口，获取审批钉盘空间space_id。
调用客户端JSAPI-上传附件到钉盘/从钉盘选择文件接口，获取文件基本信息。
获取模板的唯一编码process_code。
- 通过钉钉管理后台-OA审批-打开对应审批模版获取。
- 调用服务端API-创建或更新审批模板接口，创建审批模板获取process_code。
调用服务端API-发起审批实例接口发起审批，获取审批实例process_instance_id。
根据审批实例process_instance_id，调用服务端API-获取单个审批实例详情接口获取审批实例详情中的file_id。
调用服务端API-下载审批附件接口，获取文件的链接download_uri实现下载。目前不支持第三方企业应用调用。

说明

如果已有企业内部应用，可直接使用已有应用，可忽略此步骤。

获取应用AppKey和AppSecret信息。

添加接口调用权限。单击“OA审批”，申请OA审批对应的权限。

重要

以下接口均使用服务端API接口，SDK下载详情参见服务端SDK。

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的access_token。

调用OA审批相关API和客户端JSAPI：

调用服务端API-获取审批钉盘空间信息接口，获取审批钉盘空间space_id。
Loading...
调用客户端JSAPI-上传附件到钉盘/从钉盘选择文件接口，获取文件基本信息，本流程示例使用JSAPI Explorer实现。
重要
调用该方法前，需要调用获取审批钉盘空间信息进行授权操作。
获取模板的唯一编码process_code。有2种方式可以获取processCode，可以选择以下任一种：
- 方式一，通过钉钉管理后台-OA审批-打开对应审批模版获取。
  说明
  钉钉管理后台版本不同，获取processCode的方式不同。登录钉钉管理后台，在首页查看版本。如下图所示，页面展示回到旧版和新版反馈，说明当前是新版。
  新版钉钉管理后台：在审批模板编辑页-基础设置-页面底部查看。
  旧版钉钉管理后台：在审批模板编辑页的URL中查看。
- 方式二：调用服务端API-创建或更新审批模板接口，创建审批模板获取process_code。
  Loading...
调用服务端API-发起审批实例接口发起审批，获取审批实例process_instance_id。
Loading...
根据审批实例process_instance_id，调用服务端API-获取单个审批实例详情接口获取审批实例详情中的file_id。
Loading...
调用服务端API-下载审批附件接口，获取文件的链接download_uri实现下载。目前不支持第三方企业应用调用。
Loading...