【对接方案】活字格对接企业微信流程

收藏

本帖最后由 Joseph.Wang 于 2023-8-15 10:06 编辑

在之前的一篇帖子中，有介绍到活字格对接钉钉流程，这篇帖子就来介绍一下如果流程是在企微中设计的，活字格该如何对接，并在流程结束后告知活字格，本次同样也是以一个公出申请的场景为例。

1. 活字格中创建公出申请页面
image.png382518920.png

2. 在企业微信中创建审批模板
image.png37765196.png

3. 设置模板，该公出模板创建了3个字段，时长类型(文本)、公出时间(文本)、理由(多行文本)
image.png181364745.png

4. 对模板进行审批流程、可见范围等其它设置
image.png121242064.png

5. 在企微中创建一个应用，用于将活字格开发的页面嵌入到该应用中，具体步骤可以参考这个帖子：企业微信集成-活字格应用嵌入企业微信
image.png421130370.png

至此，活字格的页面、企微应用和流程已经设置完成，接下来要做的就是对接的部分。
1. 在录入完数据点击提交时，不仅要保存到业务表，同时也要调用企微接口进行提交。
a. 调用获取access_token接口，需要用到corpid和corpsecret，可参考获取access_token文档
image.png538082580.png

b. 调用提交审批申请接口，可参考提交审批申请文档，其中需要注意几点
i. 需要知道提交的模板的template_id，可打开之前设计的模板，在url地址上获取
image.png837517700.png

      ii. 在接口的apply_data(审批数据)参数中，需要知道每个控件的类型和ID。可参考以下方法：
         在模板设置页面点击F12，选择对应的控件，即可在element(元素)选项卡中看到对应信息
         image.png530287780.png

上述内容可以参考工程文件中的"发送公出申请流程"的服务端命令，具体要传哪些参数可参考文档并结合实际业务场景
image.png81905516.png

c. 接口会返回审批编号(sp_no)，将其更新到业务表，方便后面的操作，同时也可根据接口文档的描述创建一张状态字典表
image.png593552550.png

2. 发起流程后，流程会在企业微信中执行，如果想知道流程的情况，需要配置"接收事件服务器"
Token和EncodingAESKey是接收消息时需要用到的，并且开启需要通知回调的模板
image.png36284789.png

3. 配置消息服务器的URL地址，按照企微的接收消息与事件文档，使用服务端命令暴露一个WebApi即可，因为企微对于消息进行了加密，可以使用"企业微信事件订阅"插件
i. 验证URL有效性，创建一个服务端命令，方法为Post/Get，且任何人都能访问
选择"验证URL"操作，传入需要的参数，并将结果返回即可
image.png974349670.png

ii. 发布活字格应用，并配置对应的URL地址，点击保存(一定要先保存成功之后再做后面的操作)
image.png334904174.png

iii. 至此完成了验证URL，接收消息就是使用该URL，但是具体的使用方法和验证URL是有区别的
因此该服务端命令的名称不要修改，可将前两步的命令禁用，再做如下配置
image.png622163695.png

企微发送的是XML格式的数据，插件进行了处理并返回了Json格式，可先反序列化再进行后续的操作

以上就是活字格对接企微流程的思路，附件为工程文件和反序列化的Json示例，大家可以进行参考，也欢迎大家讨论沟通

		自动登录	找回密码
密码			立即注册

[解决方案] 【对接方案】活字格对接企业微信流程

0 个回复