### 泛微统一待办中心接口详解
#### 1. 统一待办接口时序图及说明
本文档旨在详细介绍泛微统一待办中心的相关接口及其使用方法，包括接收异构系统流程接口和删除异构系统指定人员待办流程接口。
**1.1 时序图**
该部分提供了统一待办接口的时序图，用于说明接口在不同系统间的交互顺序。时序图是理解整个通信过程的关键，有助于开发者更好地集成接口。
#### 2. 统一待办接口说明
##### 2.1 接收异构系统流程接口
**2.1.1 功能说明**
该接口用于接收来自异构系统的待办事项。这些待办事项通常以 JSON 格式传输，并由统一待办中心进行处理。
**2.1.2 参数说明**
- **接口地址**: `/rest/ofs/ReceiveRequestInfoByJson`
- **功能说明**: 接收异构系统流程(json 格式)
- **参数说明**:
- **syscode**: 异构系统标识，类型为 String。
- **flowid**: 流程实例 ID，类型为 String。
- **requestname**: 待办标题，类型为 String。
- **workflowname**: 流程类型名称，类型为 String。
- **nodename**: 步骤名称或节点名称，类型为 String。
- **pcurl**: PC 地址，类型为 String。
- **appurl**: APP 地址，类型为 String。
- **isremark**: 流程处理状态，0 表示待办，2 表示已办，4 表示办结，8 表示抄送（待阅），类型为 String。
- **viewtype**: 流程查看状态，0 表示未读，1 表示已读，类型为 String。
- **creator**: 创建人（原值），类型为 String。
- **createdatetime**: 创建日期时间，格式为 YYYY-MM-DD HH:mm:ss，类型为 String。
- **receiver**: 接收人（原值），类型为 String。
- **receivedatetime**: 接收日期时间，格式为 YYYY-MM-DD HH:mm:ss，类型为 String。
- **receivets**: 时间戳字段，客户端使用线程调用接口时，根据此字段判断是否需要更新数据，防止后发的请求数据被之前的覆盖，例如 "1602817491990"（毫秒级时间戳），类型为 String。
**2.1.3 返回值说明**
- **syscode**: 异构系统标识。
- **dateType**: 数据类型，包含以下几种：
- **IsUse**: 统一待办中心
- **OtherSys**: 异构系统
- **WfType**: 流程类型
- **WfData**: 流程数据
- **SetParam**: 参数设置
- **operType**: 操作类型，包括：
- **AutoNew**: 自动创建
- **New**: 新建
- **AutoEdit**: 自动更新
- **Edit**: 编辑
- **Del**: 删除
- **Check**: 检测
- **Set**: 设置
- **operResult**: 操作结果，1 表示成功，0 表示失败。
- **message**: 错误信息。
**2.1.4 参数示例**
```json
{
"syscode": "NC",
"flowid": "001",
"requestname": "测试流程 001",
"workflowname": "测试流程名称 001",
"nodename": "测试节点 001",
"pcurl": "http://www.baidu.com",
"appurl": "http://mobile.baidu.com",
"creator": "wld",
"createdatetime": "2018-12-04 17:56:00",
"receiver": "wld",
"receivedatetime": "2018-12-04 17:56:00",
"isremark": "0",
"viewtype": "1",
"receivets": "1602817491990"
}
```
**2.1.5 POSTMAN 调用示例**
- **请求路径**: `/rest/ofs/ReceiveRequestInfoByJson`
- **请求头设置**: `accept:*/*`, `connection:Keep-Alive`, `Content-Type:application/json`
- **请求参数设置**: 如上所示的 JSON 示例。
##### 2.2 删除异构系统指定人员待办流程
**2.2.1 功能说明**
该接口用于删除异构系统中指定接收人的待办流程。
**2.2.2 参数说明**
- **接口地址**: `/rest/ofs/deleteUserRequestInfoByJson`
- **功能说明**: 删除异构系统指定接收人待办流程(json 格式)
- **参数说明**:
- **syscode**: 异构系统标识，类型为 String。
- **flowid**: 流程实例 ID，类型为 String。
- **userid**: 接收人（原值），类型为 String。
**2.2.3 返回值说明**
- **syscode**: 异构系统标识。
- **dateType**: 数据类型，同接收异构系统流程接口。
- **operType**: 操作类型，同接收异构系统流程接口。
- **operResult**: 操作结果，1 表示成功，0 表示失败。
- **message**: 错误信息。
**2.2.4 参数示例**
```json
{
"syscode": "NC",
"flowid": "001",
"userid": "111"
}
```
#### 3. 统一认证方案说明
##### 3.1 中转页面方案
**3.1.1 执行逻辑**
中转页面方案主要通过一个中转页面与第三方系统对接，按照第三方系统的验证方式进行开发。具体执行过程如下：
1. 用户登录统一待办中心。
2. 统一待办中心根据用户权限显示待办事项列表。
3. 当用户点击某个待办事项时，系统会根据该待办事项所属的第三方系统信息跳转到相应的中转页面。
4. 在中转页面中，用户完成第三方系统的身份验证。
5. 验证通过后，用户可以在第三方系统中继续处理待办事项。
**3.1.2 优缺点**
- **优点**:
- 可以灵活地对接各个系统，无需修改第三方系统的源代码。
- 对于统一待办中心来说，只需要维护一个中转页面即可。
- **缺点**:
- 如果有多个第三方系统，则需要开发多个不同的中转页面，增加了开发和维护成本。
**3.1.3 推荐实现方案**
为了减少中转页面的数量和提高系统的灵活性，建议与各个第三方协商使用统一的单点登录方式。例如，可以采用 SHA 加密数据的方式生成 Token 来实现：
```java
String token = SHA1Utils.getToken(Prop.getPropValue("QC699764", "secrect") + loginid + timestamp);
```
通过这种方式，可以简化中转页面的开发，并确保数据的安全性。
