第三方集成用友待办
一、对接流程
二、指定租户开通接收待办
提交工单给指定租户开通接收待办事件; 工单说明如下:
需要开通接收待办事件
租户id: ******
租户名称:******
三、订阅待办事件
请点击链接操作: 订阅
- 最终添加以下两个事件
四、编写待办代码
- 建议第三方存储这些数据,这样第三方就可以查看已办数据
创建代办接收数据格式
{
"msgTsLong": 1635583234094,
"resendable": true,
"omitNotify": false,
"todoType": "approve",
"srcMsgId": "20211030202110307d0f6df7-d4d6-4f0e-ad11-76f26aa8819d:ubpm20200520",
"typeName": "待办消息",
"approveSource": "PU",
"richText": "来自倪帅臣于10-30 15:48提交的采购订单CGDD0000211030000002,请处理。 ",
"title": "待办提醒",
"content": "来自倪帅臣于10-30 15:48提交的采购订单CGDD0000211030000002,请处理。 ",
"mUrl": "https://mdf-node-yonsuite.diwork.com/meta/voucher/st_purchaseorder/2496594306814208?domainKey=upu&apptype=mdf&taskFlag=todo&typecode=approve&tenantId=aen06kxy&qzId=278401&code=${esncode}&isReturnNative=true&source=PU,u8c,UIT&yssource=PU,u8c,UIT",
"yyUserIds": ["0f059088-9c92-4769-a3e7-8f1a341cc3df"],
"webUrl": "https://mdf-node-yonsuite.diwork.com/meta/voucher/st_purchaseorder/2496594306814208?domainKey=upu&bipCasTag&taskFlag=todo&typecode=approve&tenantId=aen06kxy&qzId=278401&source=PU,u8c,UIT&code=${esncode}&uSpaceOpenType=_blank",
"appId": "59bcd8c644594106bf0",
"businessKey": "0c2a4042-395d-11ec-b69a-a2be2d4436a4",
"tenantId": "aen06kxy",
"srcAppId": "msgplatform",
"labelCode": "bizProcessGeneralDomain"
}
结束代办接收数据格式
{
"msgTsLong": 1635583194664,
"yyUserId": "0f059088-9c92-4769-a3e7-8f1a341cc3df",
"businessKey": "51938770-395c-11ec-80f7-3e3f15ddd04c",
"srcMsgId": "20211030202110306c3f383b-7f73-469a-9eb3-6c5d2b95d222:ubpm20200520",
"tenantId": "aen06kxy",
"srcAppId": "msgplatform",
"validApp": false
}
五、三方系统单点YonBIP
5.1、应用场景
背景
一般情况,【客开方】收到用友待办信息后,需要再调用三方消息接口,将该待办信息发送给三方系统。 这种情况存在一个问题:生成的单点登录地址只能使用一次,发送待办信息给三方系统时一般就会直接带上该地址。 这就造成使用者如果打开后未审批,或者想再次查看都会报错。
解决方案
【客开方】发送待办信息给三方系统时不要直接发送用友待办的mUrl或者webUrl,建议三方系统发布一个接口作为地址信息,使用者点击后, 请求【客开方】服务然后重定向到单点地址。
可参考如下格式:
示例截图
5.2、 单点实现
请点击链接操作: 三方单点YS(单租户)
5.3、测试
- 提交采购订单单据
- 代码接收到待办事件,示例中解析出了webUrl
- 将webUrl复制到单点测试类(这里仅仅是用于测试,生成的单点地址只能使用一次,如果需要多次使用,查看5.1方案)