第三方集成用友待办

一、对接流程

二、指定租户开通接收待办

需要开通接收待办事件
租户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、应用场景

• 点击下载测试Demo

背景

一般情况，【客开方】收到用友待办信息后，需要再调用三方消息接口，将该待办信息发送给三方系统。 这种情况存在一个问题：生成的单点登录地址只能使用一次，发送待办信息给三方系统时一般就会直接带上该地址。 这就造成使用者如果打开后未审批，或者想再次查看都会报错。

解决方案

【客开方】发送待办信息给三方系统时不要直接发送用友待办的mUrl或者webUrl,建议三方系统发布一个接口作为地址信息，使用者点击后， 请求【客开方】服务然后重定向到单点地址。

可参考如下格式：

http://localhost:8080/yonsuite/sso?userId=sdfsdfssss1&targetUrl=https%3A%2F%2Fezone.diwork.com%2Fmeeting%2Fweb%2F%23%2Fquery%3Fneed_login%3Dtrue

示例截图

5.2、 单点实现

请点击链接操作: 三方单点YS（单租户）

5.3、测试

• 提交采购订单单据

• 代码接收到待办事件，示例中解析出了webUrl

• 将webUrl复制到单点测试类（这里仅仅是用于测试，生成的单点地址只能使用一次，如果需要多次使用，查看5.1方案）