# 三方批量操作接口(ESB动作流)配置示例

来源快照：`result_data_new_260518.json`

- 来源 ID：`1181492683748106241`
- 模块：集成中心
- 目录：统一待办中心 - 配置示例
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、需求背景

配置使用三方批量操作接口，在流程列表页面上可以对三方统一待办数据做批量操作。

# 二、操作步骤

## 1.配置连接器

### 1.1.点击新建连接器

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492743970693122&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 1.2.填写对应的连接器信息

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492761019891715&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

 

### 1.3.新建连接信息

要根据第三方提供的批量接口进行确定，【协议】、【域名/IP地址】、【编码】需要第三方提供，其他配置项可以根据需要自行确定。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492739625394178&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 1.4新建接口信息

#### 1.4.1.基础

【接口地址】、【请求方式】需要第三方提供，其他配置按需填写

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492748160409603&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

#### 1.4.2.请求

根据第三方提供的接口信息进行配置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492756761747462&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

打开“明细数据”开关后，推送给第三方的数据是数组的格式

示例：

[    {        "sysCode": "dntest1",        "receiver": "15166752550",        "operateType": "SUBMIT",        "flowId": "ewdn55555555555555",        "taskId": "ewdn55555555555555_2227495622798760670"    },    {        "sysCode": "dntest1",        "receiver": "15166752550",        "operateType": "SUBMIT",        "flowId": "ewdn5555555555555",        "taskId": "ewdn5555555555555_2227495622798760670"    }]  
---  
  
 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492761137586179&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 1.4.3.响应

根据第三方提供的接口信息进行配置。如果返回的值包含数组的格式，“参数类型”需要选中“JSON”数组开关打开。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492752584220673&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 1.4.4.成功失败

根据第三方提供的接口信息进行配置。需要第三方提供一个字段，用户确定接口整体调用情况（成功/失败）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492765411975168&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.动作流配置

整体运行：获取批量操作数据（内置MQ监听）→调用上游批量接口→批量接口调用失败回写流程数据中间态

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492756788486147&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492748230533122&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 2.1新建动作流

#### 2.1.1.选择“自定义事件触发”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492756775510020&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 2.1.2.选择“内置MQ监听”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492756761747458&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

#### 2.1.3.填写“队列名称”

该名称可以自定义要保证全局唯一性。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492765357056001&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：此处的队列名称与异构系统中的配置相同

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492752379879426&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 2.2内置MQ监听（批量操作源数据）

配置“接收参数”，此配置为固定配置参数名称不可变更。参数名称见下表

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492765411975171&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

参数名称| 显示名称| 参数类型| 备注  
---|---|---|---  
operateType| 操作类型| 文本|    
sysCode| 异构系统标识| 文本|    
receiver| 接收人| 文本|    
userId| 接收人id| 文本|    
requestIds| 流程ID| 文本|    
batchId| 批次id| 文本|    
todoData| 流程数据列表| JSON| 数组类型 开启  
  
 

 

todoData：流程数据列表  
---  
参数名称| 显示名称| 参数类型| 备注  
sysCode| 异构系统标识| 文本|    
flowId| 第三方流程ID| 文本| 第三方调用统一待办接口推送过来的流程id  
requestName| 流程标题| 文本|    
workFlowName| 流程类型名称| 文本|    
receiverNodeName| 接收人节点名称| 文本|    
nodeName| 流程节点名称| 文本|    
pcUrl| Pc端跳转地址| 文本|    
appUrl| APP端跳转地址| 文本|    
creator| 创建人| 文本|    
createDateTime| 创建时间| 文本|    
receiver| 接收人| 文本| 与人员转换规则匹配  
receiveDateTime| 接收时间| 文本|    
isRemark| 流程处理状态| 文本| 0：待办 2：已办 4：办结 8：抄送（待阅） 10：待领取 -1：删除  
viewType| 流程查看状态| 文本| 0：未读； 1：已读;  
receivets| 时间戳| 文本| 示例：1602817491990（毫秒级时间戳）  
workFlowCode| 流程类型码| 文本|    
tenantKey| 住户信息| 文本|    
requestLevel| 紧急程度| 文本|    
operateType| 批量操作类型| 文本| 操作类型，枚举值：SUBMIT（批量提交）RETURNED(批量退回)ACQUIRE（批量领取）DELETE(批量删除)  
taskId| 审批任务ID| 文本|    
  
 

### 2.3连接器（上游接口）

#### 2.3.1.选择连接器

选择刚才配置的接连器，以及对应的接口

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492765242630144&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 2.3.2.输入参数配置

点击“输入参数配置”，“依据值”中选择内置MQ监听“todoData”固定值

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492739519889415&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

#### 2.3.3.匹配接口入参字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492752429957123&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 2.3.4.配置异常处理

配置“异常处理”，选择“跳过当前节点”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492761019891713&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492743756390403&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D) 

### 2.4配置分支（接口执行判断）

#### 2.4.1.选择“分支”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492756724924420&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

#### （2）【执行方式】选择“排它分支”。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492748164997121&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

添加配置条件，第三方接口返回报文中需要提供一个字段，可以根据该字段的值进行判断接口是否调用成功。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492735333974016&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 2.5接口响应（数据回写）

#### 2.5.1.两个分支中均需要选择“内置MQ发送”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492735244967937&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

#### 2.5.2.“队列名称”填写“esb-iL3Ei”或“esb-juUxA”“模式”选择“广播模式”

#### esb-iL3Ei：支持场景：e-builder搭建页面时，数据源使用“统一待办中心异构系统流程表”的组件

esb-juUxA：支持场景：（1）流程中心-待办流程（2）e-builder搭建页面时，数据源使用“统一待办中心异构系统流程表”的组件

注：此队列不支持批量提交异常提醒

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492752451575808&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

#### 2.5.3.接口调用成功数据回写

此处配置的“参数名称”为固定值不可更改。参数名称见下表

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492739629195265&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

发送参数设置：

batchId：获取内置MQ监听响应数据batchId（注：接收参数下batchId非todoData下数据）

operateType：获取内置MQ监听响应数据operateType

requestIds：获取内置MQ监听响应数据requestIds

sysCode：获取内置MQ监听响应数据sysCode

receiver：获取内置MQ监听响应数据receiver

userId：获取内置MQ监听响应数据userId

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492739519889409&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

status：获取连接器（上游接口）responsebody数据status

code：获取连接器（上游接口）responsebody数据code

msg：获取连接器（上游接口）responsebody数据msg

data：获取连接器（上游接口）responsebody数据data

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492743756390401&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

sysCode：依据值：获取连接器（上游接口）responsebody数据data下sysCode

flowId：依据值：获取连接器（上游接口）responsebody数据data下flowId

receiver：依据值：获取连接器（上游接口）responsebody数据data下receiver

taskId：依据值：获取连接器（上游接口）responsebody数据data下taskId

status：依据值：获取连接器（上游接口）responsebody数据data下status

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492748164997123&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

tenantKey：固定值：当前租户识别码（以具体租户确定）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492739519889411&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

参数名称| 显示名称| 参数类型| 备注  
---|---|---|---  
batchId| 批次id| 文本|    
operateType| 操作类型| 文本|    
requestIds| 流程ID| 文本|    
sysCode| 异构系统标识| 文本|    
receiver| 接收人| 文本|    
userId| 接收人id| 文本|    
code| 接口响应码| 文本| 200 表示调用成功，其他均表示失败  
msg| 响应信息| 文本|    
status| 接口状态标识| 文本| 枚举值true：成功；false：失败；  
tenantKey| 租户信息| 文本| 固定值：取当前租户识别码  
data| 流程数据列表| JSON| 数组类型开启  
  
 

 

data：动态赋值，数组类型，从“第三方接口，responsebody”data中获取  
---  
参数名称| 显示名称| 参数类型| 备注  
sysCode| 异构系统标识| 文本| 依据值  
flowId| 第三方流程ID| 文本| 依据值  
receiver| 接收人| 文本| 依据值  
taskId| 审批任务ID| 文本| 依据值  
status| 操作状态| 文本| 依据值  
  
 

#### 2.5.4.接口调用失败数据回写

此处配置的“参数名称”为固定值不可更改。参数名称见下表

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492735244967939&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

发送参数设置：

batchId：获取内置MQ监听响应数据batchId（注：接收参数下batchId非todoData下数据）

operateType：获取内置MQ监听响应数据operateType

requestIds：获取内置MQ监听响应数据requestIds

sysCode：获取内置MQ监听响应数据sysCode

receiver：获取内置MQ监听响应数据receiver

userId：获取内置MQ监听响应数据userId

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492739519889409&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

status：固定值false

code：固定值400

msg：固定值：调用第三方接口失败

data：获取内置MQ监听响应数据data

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492760949235712&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

sysCode：依据值：获取内置MQ监听响应数据data下sysCode

flowId：依据值：获取内置MQ监听响应数据data下flowId

receiver：依据值：获取内置MQ监听响应数据data下receiver

taskId：依据值：获取内置MQ监听响应数据data下taskId

status：固定值false

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492761031548931&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

tenantKey：固定值：当前租户识别码（以具体租户确定）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492752584220676&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

参数名称| 显示名称| 参数类型| 备注  
---|---|---|---  
batchId| 批次id| 文本|    
operateType| 操作类型| 文本|    
requestIds| 流程ID| 文本|    
sysCode| 异构系统标识| 文本|    
receiver| 接收人| 文本|    
userId| 接收人id| 文本|    
code| 接口响应码| 文本| 固定值：400  
msg| 响应信息| 文本| 固定值：调用第三方接口失败  
status| 接口状态标识| 文本| 固定值：false  
tenantKey| 租户信息| 文本| 固定值：取当前租户识别码  
data| 流程数据列表| JSON| 数组类型 开启  
  
 

 

data：动态赋值，数组类型，从“内置MQ监听”事件中获取  
---  
参数名称| 显示名称| 参数类型| 备注  
sysCode| 异构系统标识| 文本| 依据值  
flowId| 第三方流程ID| 文本| 依据值  
receiver| 接收人| 文本| 依据值  
taskId| 审批任务ID| 文本| 依据值  
status| 操作状态| 文本| 固定值：false  
  
 

## 3.应用系统配置

开启：支持批量操作

指定批量操作ESB队列名称 “队列名称“

![](https://weapp.eteams.cn/papi/file/preview?fileId=1181492756724924417&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
