一、目的

由于在多个项目中都有需要给OA等外系统推送待办的需求，且业务相对一致，所以计划在产品中增加对外系统推送待办的功能，用于统一管理外发待办且支持各项目扩展的需求。

二、要求

1．异步性，不能影响单据流程的正常流转

2．统一性，产品提供默认流转逻辑统一管理，项目默认实现对外接口即可完成最基本要求

3．可扩展性，支持项目上自定义对接不同的OA平台和自定义扩展流转逻辑

三、流转时序图

四、消息发送场景-以华大基因为例，作为产品默认场景实现主要流程

操作	本节点	下一节点	待办消息推送接口	待办消息删除接口	待办转已办接口
提交	开始	业务	是
提交	开始	共享财务
审批通过	业务	共享财务			是
	业务	业务	是		是
	共享财务	业务	是
驳回	业务	开始	可选		是
	业务	业务	是		是
	业务	共享财务			是
	共享财务	开始	可选
	共享财务	业务	是
	共享财务	共享财务
起草人撤回				是
加签-在我之前	业务	业务	是	是
加签-在我之后	业务	业务	是		是
转交	业务	业务	是	是
调度-完成	业务	共享财务			是
调度-完成	业务	业务	是		是
调度-完成	共享财务	业务	是
调度-转交	业务	业务	是	是
调度-跳转	业务	开始		是
调度-跳转	业务	业务	是	是
调度-跳转	业务	共享财务		是
调度-跳转	共享财务	开始
调度-跳转	共享财务	业务	是
调度-跳转	共享财务	共享财务

五、报账平台改造

1．修改cn.ztessc.service.base.AbstractBoeFormCoreServiceImpl#fmcAfterOperation和cn.ztessc.service.base.AbstractBoeFormCoreServiceImpl#doInBackground，在末尾调用MQ消息，将单据信息，流程返回结果信息等参数，打包发送给接口平台，约定bus_id：empId_taskId

2．组装参数：包括单据ID，单据状态，操作类型，本节点信息，下一个节点信息。如项目扩展需要其他参数的话就根据单据ID去数据库查，避免MQ占用过多资源

3．新建数据字典THIRD_SYS_TASK_SWITCH,用于是否启用第三方待办开关，如果项目不需要发送第三方待办则关闭开关，避免资源消耗

六、接口平台改造

1.建立一张记录表，报错待办的每一步操作，用于记录和补偿

新建一张记录表	包含字段--（一般待办都可能会有）
THIRD_SYS_TASK_LOG	title	标题
	subject	正文
	bus_id	单据ID或其他ID
	bus_type	待办业务类型：0单据 1、2、3其他自定义
	task_id	唯一标识（一般用流程任务ID+员工编号拼接保证唯一）
	last_task_id	上一步Id，用来判断若上一步未处理完成，就走了下一步，是否需要补偿
	pc_link	PC端审批/查看链接
	mobile_link	移动端审批/查看链接
	process_status	处理状态 0未发送 1已发送 2发送失败
	task_type	0待办 1已办 2待阅
	urgent_message	是否催办:0/是,其它/否
	target	待办接收人
	extend_sxxxx	其他扩展用字段

2．建立第三方待办统一处理类ThirdSysMessageService，包括以下方法：

（1）pushTaskToThirdSys:主流程，根据获得的参数（操作类型、本节点、下一节点）和预设场景判断此次推送哪些接口

（2）validateTaskPushData:校验参数合法性，主流程调用

（3）processResult:处理返回结果，记录日志到THIRD_SYS_TASK_LOG等，主流程调用

（4）compensateTaskToThirdSys:补偿方法，从THIRD_SYS_TASK_LOG捞取推送失败的数据再次走主流程进行补偿（MQ已存在补偿机制，这个可选）

3．新建ZfsInternalCoreDaoPrjPluginClient 和方法pushTaskToThirdSysExtend，统一调用外挂方法

4．建立ThirdSysMessageController用于接收MQ消息，包括以下方法：

（1）pushTaskToThirdSys:对接PushTaskToThirdSysService的消息发送主流程

七、外挂平台改造

1．建立PushTaskToThirdSysPluginController用于承接接口平台 ZfsInternalCoreDaoPrjPluginClient 里设置的埋点，包括：

（1）pushTaskToThirdSysExtend 统一调用AbstractPushTaskToThirdSysPluginService的主方法

2．建立AbstractPushTaskToThirdSysPluginService，预设对外接口处理流程和抽象方法供实现类实现外部接口

3．建立PushTaskToThirdSysPluginService用于各项目实现具体接口推送方法

（1）sendTask:实现发送待办接口

（2）finishTask:实现待办转已办接口

（3）cancelTask:实现待办撤销接口

（4）extendOpr:实现自定义扩展

（5）fillDto:补充数据

（6）buildPcLink：拼待办链接

（7）buildMobileLink：拼移动端待办链接

（8）buildSubject：拼接正文

（9）buildTitle：拼接标题

（10）根据待办中的是否催办标识(urgent_message:是否催办:0/是,其它/否)传入第三方系统是否催办

待办推送半封装开发设计文档

待办推送半封装开发设计文档

关于作者

目录