大家好！我是sum墨，一个一线的底层码农，平时喜欢研究和思考一些技术相关的问题并整理成文，限于本人水平，如果文章和代码有表述不当之处，还请不吝赐教。

钉钉作为一款办公软件，审批功能是它的核心功能之一，最常见的审批场景就是请假和报销了。虽然钉钉也内置了一些审批流，但是审批场景层出不穷，光靠钉钉内置的那些是不够用的。尤其一些公司自己也有技术团队，则更希望可以二次开发一下，做一套更适合自己公司的审批流。那么本文我们就钉钉的审批能力来讲一下：钉钉OA自定义审批流的创建和使用。

这个还是要说下，否则很多人都找不到！

登录链接如下：https://oa.dingtalk.com/

进去之后是这样的，我们也可以在这里创建新表单，不过这里创建的表单是不支持代码调用的。

那么，接下来正文开始！

如果你的组织的类型是认证服务商，那么可以选择创建第三方企业应用，否则就创建企业内部应用。

这两种应用的主要区别就是获取AccessToken的方式不同，如何不同可以看我的这篇文章：钉钉小程序生态1—区分企业内部应用、第三方企业应用、第三方个人应用

那么如何判断自己是不是服务商组织呢？登录开放平台—>首页—>有认证服务商标签的就是啦

这里我为了方便文章撰写，我就创建一个企业内部应用来说明接下来的流程。如果大家使用的是第三方企业应用，那么还需要配置一下钉钉事件回调，详细可见我这篇文章： 钉钉小程序生态4—钉钉应用事件与回调

这里H5微应用、小程序两种类型都可以，我们主要是为了获取创建钉钉OA自定义审批流的权限。

权限一共5个全都点申请，将对应权限权限申请好之后，我们就可以调用接口创建OA审批模板和发起审批实例了。

如何接入可以看钉钉的官方文档：配置Stream推送，非常的简单，这里我就不贴代码了。 配置回调的作用是为了后续审批状态发生变化的时候可以及时通知到我们。

到目前为止，创建和配置相关的工作我们已经完成了，接下来就是开发了。

模板的创建是一次性的，也就是说只需要调用一下创建接口就行，这里复杂的东西是它的控件很多，比如：文本框、数字框、日期选择器等等，如下图：

用可视化界面创建固然是容易，但是要用代码来创建就有点麻烦了，我开始也错了好几次，从简单的控件开始尝试就好了，多试几次就行。 官方链接如下：创建或更新审批表单模板 这里我自己创建的代码如下：

maven依赖代码如下：

创建好之后可以在OA里面找到刚才创建的审批流模板

审批表单模板创建结束后，钉钉会返回一个processCode给我们，这个processCode很重要需要保存下来。整体来说，审批表单模板的创建不难理解，毕竟在这里不需要设置各个环节的审批人，真正复杂的是发起审批实例这个接口，下面我们来讲一下如何发起审批实例。

官方文档：发起审批实例 这里我自己发起实例的代码如下：

把参数都准备好之后，实现起来还是比较简单的，调用代码创建的审批实例，钉钉会返回一个实例ID:instanceId，这个instanceId和processCode一样也需要保存下来，发送成功后钉钉APP上就会自动出现一条OA审批啦。

所谓审批实例状态监控，就是当前审批流程是被同意啦还是被拒绝了。这里有两种方案：

而作为一个成年人，这两个肯定是全都要啦，一个用来实时更新，一个用来做兜底。 这里查询的审批实例的接口文档链接如下：获取单个审批实例详情。 如果前面创建审批模板、发起审批实例都能跑通，那么这个接口也肯定不在话下，所以这里我就不贴代码了。

最后我把事件订阅推送的数据格式贴一下：

写在最后：其实这些东西大部分都是钉钉官方文档上面的，除了那个agentId... 但是钉钉文档的东西实在是太多，作为一个开发者，我们不可能去从头到尾看一遍的，一般都是用到了就去找。但是这样一来又会很混乱，所以我这篇文章主要是从开发者角度来梳理一下这个流程，不仅利己也能帮助其他人。

本文来自博客园，作者：sum墨，转载请注明原文链接：https://www.cnblogs.com/wlovet/p/17785671.html