【对接方案】活字格对接钉钉流程
本帖最后由 Joseph.Wang 于 2023-8-4 12:09 编辑钉钉是目前很多企业都在使用的移动办公平台,提供了很多常用的OA审批功能,同时也支持自定义审批流程。有时候流程已经在钉钉中设计好了,可能不想将其再迁移到活字格,因此会希望在活字格中填写完业务数据后能直接发起钉钉的流程,并在流程结束后告知活字格,然后继续自己的业务逻辑。接下来以一个公出申请的场景为例,看下在活字格中的实现思路吧。
1. 在钉钉管理后台中创建流程表单,进行自定义表单设计和流程设计,完成后点击右上角的发布即可 在基础设置页签的最下面,有该模板的唯一编号,这个也是后面发起流程中需要用到的 2. 活字格中设计表以及页面,不需要和钉钉的表单页面一致,只需最终能组装成符合钉钉要求的数据即可 3. 实现业务逻辑,点击提交时,调用钉钉接口,可参考钉钉接口文档
[*]首先要获取accessToken,需要用到Appkey和AppSecret参数,调用发起审批时,需要用到模板的编号,可以将这些参数设置为全局变量,待发布后在管理控制台统一配置,如下图展示,后两个参数会在后面进行介绍
[*]结合活字格的“发送HTTP请求命令”和“Json反序列化命令”,参照钉钉的接口文档,实现接口调用,可参考附件的工程文件服务端命令->钉钉
需要注意formComponentValues参数,需要结合钉钉的表单设计进行构造的,具体的可以看下接口的文档说明
[*]发起成功后,钉钉会返回对应的实例id(instanceId),建议将其保存在业务表上,方便后期根据该字段做更多业务操作
4. 创建钉钉应用,可参考活字格帮助手册与钉钉集成,此时就能获取到对应的AppKey与AppSecret,也是全局变量的前两个配置 5. 发起后,流程就会在钉钉中执行 如果想知道具体的执行情况,就需要钉钉告诉我们,此时就要用到事件订阅的功能
[*]事件订阅的流程以及加解密规则可参考配置事件订阅
[*]对于请求地址,可创建一个任何人都能访问的,post类型的服务端命令。但因为钉钉的请求数据以及响应数据都是加密的,因此可以使用市场上的钉钉事件订阅加解密插件,可参考附件工程文件的服务端命令->事件订阅->eventsubscription
[*]开启需要订阅的事件,不同的事件订阅,请求的数据结构有所不同,可以在事件订阅中进行查看。解密之后可以通过EventType做判断,然后结合实际业务逻辑进行处理
本Demo只是根据操作更新了业务表的状态
以上就是对接钉钉流程的思路,在做的过程中,也参考了小胖老师的对接钉钉的视频(低代码对接钉钉解决方案2.0),也分享给大家作为学习参考。
页:
[1]