第三方集成用友待办

一、对接流程

undefined

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

提交工单给指定租户开通接收待办事件; 工单说明如下:

需要开通接收待办事件
租户id: ******
租户名称:******

三、订阅待办事件

请点击链接操作: 订阅

  • 最终添加以下两个事件

undefined

四、编写待办代码

  • 建议第三方存储这些数据,这样第三方就可以查看已办数据

undefined

创建代办接收数据格式


{
    "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,建议【客开方】发布一个接口作为地址信息,使用者点击后, 请求【客开方】服务然后重定向到单点地址。

可参考如下格式:

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

示例截图

undefined

5.2、 单点实现

请点击链接操作: 三方单点YS(单租户)

5.3、测试

  • 提交采购订单单据

undefined

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

undefined

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

undefined

undefined

Copyright © 用友 -【生态技术部】 2021 all right reserved,powered by Gitbook修订时间: 2022-08-31 15:49:05

results matching ""

    No results matching ""