钉钉集成-智能工作流-待办 方案设计

集成

背景

钉钉开放平台升级，废弃了之前的待办中心老接口，需要使用钉钉新推出的“智能工作流”来实现待办中心消息的推送和更新。目前部分线上做了钉钉集成的客户，已经无法在待办中心收到移动审批的待办消息了，影响非常严重，需要最高优先级响应

智能工作流

1个流程模板->N个流程实例
1个流程实例->N个流程待办

交互原理

工作流,移动审批方案

调整点

1、消息推送接口增加两个字段 “process_guid”，“creator”
2、新增更新流程状态接口

消息推送[改造接口]

{
"touser": "mysoft596713fb26afb120144809",
"agentid": "3023",
"msgtype": "oa",
"biz_id": 900000000001,
"extra": {
  "biz_type": 0
  "process_guid":"A88AAFDE-C20A-EA11-80BA-005056A81223",
  "creator":"mysoft596713fb26afb120144000",
  "process_detail_url":"http://xxx/process-detail?kindType=1&node_id=1&proc_id=2",
},
"oa": {
    ................
}
}

更新待办状态[改造接口]
$\color{red}{ 移动审批：流程结束后，最好是区分一下归档，作废，已终止等场景，分别对应的状态为 同意，拒绝 }$
$\color{red}{ 云助手：钉钉流程实例状态默认为0，只有当status == 1 || status == 2 时才更新实例状态 }$

{
"msg": [
    {
        "openid": "openid",            
        "biz_id": "",//业务ID
        "todo": 1//是否已办  0：未办 1：已办，
        "process_guid":"A88AAFDE-C20A-EA11-80BA-005056A81223",
        "status": 1,//审批流程最终处理结果 0：处理中 1:同意 2：拒绝
    }
   ]
}

云助手方案设计

要点

1、租户库新增审批模板，流程实例(钉钉实例信息及流程guid)两张表
2、钉钉待办表新增字段(是否智能工作流，流程guid) --- 兼容智能工作流和非智能工作流的待办
3、企业平台新增智能工作流配置开关，默认为未非智能工作流，开启后会调用钉钉接口创建审批模板

任务项

1、钉钉智能工作流开放接口调试打通(已完成)
2、企业平台钉钉集成配置参数新增"智能工作流“配置开关
3、消息推送接口改造(兼容智能工作流)
4、待办状态更新接口改造(兼容智能工作流)
5、待办状态轮询作业改造
6、钉钉集成-开放平台文档更新，变更点:开启审批流程权限，开启智能工作流开关

移动审批测试环境

时间节点

$\color{red}{目前承诺客户必须是12月04日上线}$
1、云助手和审批要保证各自在11月24日之前完成开发自测
2、11月25日-11月26日做测试环境验收
3、11月27日-11月28日做预发布回归测试
4、11月29上生产