表单流程回调

YonBIP/YonSuite协同表单流程结束后回写第三方

一、了解开放平台订阅

如果以前没有使用过订阅，请先查看此文档

事件订阅

二、添加表单流程结束后订阅

注意添加的回调地址必须外网可访问

三、校验环境是否准备完毕

必须完成一、二的操作， 在代码中配置完成了解密校验且配置了外网可访问地址。 点击校验，提示【回调地址正确】，如果有问题请仔细看一二步操作（特别注意）

四、获取回调JSON

可以填写一个表单并审批直至流程结束，可在自己的代码中收到以下格式回调信息。

流程结束后回调的JSON信息如下：

{
    "processActionType": null,
    "processEnd": true,
    "listenerType": "DefaultExecutionListener",
    "eventCenterEventType": "end",
    "canBeArchived": false,
    "language": "zh_CN",
    "source": "ESN",
    "tenantCode": "approve_babqz7zj",
    "userId": "0f059088-********-a3e7-8f1a341cc3df",
    "deleteReason": null,
    "eventCenterEventSource": "bpm_process_approve",
    "processDefinitionKey": "iform_53502cf244",
    "mainTenantId": "babqz7zj",
    "businessKey": "223b3b1fc68b45229d0774464c5ce09f:825f06db9d4946c19485e9dada24ba5b",
    "tenantId": "babq***zj_approve",
    "processInstId": "1723726b-fabb-11ec-b05d-169ae28c18c5",
    "yht_access_token": "bttQ0JRQ3M2WGFHUXhqcmJaNEo4WFhaYUpGN1RQbkVSdWtMQ28wZ2xlZDZlb29hZHovQ0xobmtCckhpTVlOV0J5MmdFbWNBbWFJVHRYRDZDNS9hbEhYTmlieWJVWDJvT0JZc2lBcHhaV2VGNytMenFFTGZBTStvajlVWHJkbG1hdldfX2V1Yy55b255b3VjbG91ZC5jb20.__c07f1d9b845391dbd9fd70a7e4829b3c_1656844205519",
    "appSource": "approve",
    "category": "a366af29-364d-11ec-83d3-06dbeb73508a",
    "superProcessInstanceId": null
}

五、业务逻辑处理

获取表单的pkbo,此pkbo是表单的标识，不会改变。代码中固定写死即可

从回调JSON中取出businessKey，如下：pkBoins:pkBo

223b3b1fc68b45229d0774464c5ce09f:825f06db9d4946c19485e9dada24ba5b

截断businessKey的值，用：号隔开，分别取出：pkBoins和pkBo； 由于所有的表单流程结束都会触发该回调，所以需要需要判断businessKey中的pkbo是否等于上述表单中取出的pkbo。 如果相同则执行后续逻辑，否则抛弃该消息

六、根据表单模型id和实例id查询表单数据

调用开放平台接口,接口名称【根据表单模型id和实例id查询表单数据】

• 根据以上接口名称，按照以下文档查找接口文档信息

开发必读

其值从五获取。

七、如何解析获取到的数据