# 统一待办推送套件：推送蓝凌(REST-Basic认证)配置示例

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、需求背景

10.0.2503.01：通过现有开发业务完成对接，随着客户场景的扩充发现，蓝凌的接口存在迭代升级，考虑到对接蓝凌业务的完整性。统一待办推送对接蓝凌接口相关业务同步升级。

# 二、操作步骤

## 1.蓝凌(REST-Basic认证)

支持通过Basic认证方式调用蓝凌Rest接口推送本系统的流程审批数据

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203337200876445698&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=1203337248213360642&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)

参数设置根据实际情况填写，其中appName、username、password、sendTodoURL、setTodoDoneURL、deleteTodoURL需要咨询蓝凌技术人员获取；ekpUserKey参数需要根据实际情况配置对应关系

 

 

## 4.EKP系统组织架构对接字段介绍

蓝凌接口中创建人、接收人数据需支持多维度数据，具体对接时使用什么的是蓝凌组织架构中人员的那个字段是需要指明清楚的。

 

 

数据格式| 单值格式为: {类型: 值}， 如{"PersonNo":"001"}。  
多值格式为: [{类型1:值1}，{类型2:值2}...]，如: [{"PersonNo":"001"}，{"KeyWord":"2EDF6"}]。  
---|---  
说明|   对于"格式"中的类型，以下是对应的类型说明表:类型名描述IdEKP系统组织架构唯一标识PersonNoEKP系统组织架构个人编号LoginNameEKP系统组织架构个人登录名KeywordEKP系统组织架构关键字LdapDN和LDAP集成时LDAP中DN值  
  
 

蓝凌接口中创建人、接收人数据需支持多维度数据，具体对接时使用什么的是蓝凌组织架构中人员的那个字段是需要指明清楚的。

在对接配置中添加参数设置 ，EKP组织架构对接字段：

组件样式：

参数名| ekpUserKey  
---|---  
描述| EKP组织架构对接字段  
组件样式| 下拉框  
参数值| 个人登录名、唯一标识、个人编号、关键字、LdapDN  
默认值| 个人登录名  
  
 

# 三、蓝凌接口介绍

## 1.发送待办接口(sendTodo)

### 1.1.请求数据

待办发送上下文（NotifyTodoSendContext），详细说明如下:

程序名| 描述| 类型| 可否为空| 备注说明  
---|---|---|---|---  
appName| 待办来源| 字符串(String)| 可为空| 标识待办来源的系统  
注：未设置该参数的情况下，无法识别待办的来源，待办来源将默认为当前提供服务的系统  
建议第三方系统调用接口时设置该参数，以便当前提供服务的系统能够区分待办的来源  
modelName| 模块名| 字符串(String)| 不允许为空| 标识待办来源的模块  
modelId| 待办唯一标识| 字符串(String)| 不允许为空| 标识待办在原系统唯一标识修改对接方案，历史对接是requestId，新对接改为requestId_userId  
subject| 标题| 字符串(String)| 不允许为空| 待办标题  
link| 链接| 字符串(String)| 不允许为空| 对应待办的链接地址(全路径)  
mobileLink| 移动端链接| 字符串(String)| 不允许为空| 对应待办的链接地址(全路径) 新增字段  
padLink| pad端链接| 字符串(String)| 不允许为空| 对应待办的链接地址(全路径) 新增字段  
type| 待办类型| 数字(int)| 不允许为空| 1:表示审批类待办 固定值 1  
2:表示为通知类待办  
key| 关键字| 字符串(String)| 可为空| 待办关键字，用于区分同一文档下不同类型待办， 如:会议文档的抄送待办和与会人参加待办属于同一文档的不同类型的待办。  
param1| 参数1| 字符串(String)| 可为空| 待办附加标识。功能同"关键字"，辅助区分不同类型的待办  
param2| 参数2| 字符串(String)| 可为空| 待办附加标识。功能同"关键字"，辅助区分不同类型的待办  
targets| 待办所属对象| 字符串(JSON)| 不允许为空| 待办对应接收人，数据格式为JSON，格式描述请查看"《推送蓝凌—支持EKP系统组织架构对接字段》"历史接口只支持{“LoginName”:””}即对接明源登录账号，这里需要扩展支持多样性  
createTime| 创建时间| 字符串(String)| 不允许为空| 格式为:yyyy-MM-dd HH:mm:ss  
docCreator| 待办创建者| 字符串(JSON)| 可为空| 待办创建人，数据格式为JSON，格式描述请查看"《推送蓝凌—支持EKP系统组织架构对接字段》"历史接口只支持{“LoginName”:””}即对接明源登录账号，这里需要扩展支持多样性  
level| 待办优先级| 数字(Integer)| 可为空| 待办优先级。如：按紧急（1）、急（2）、一般（3）。  
extendContent| 消息内容扩展| 字符串(JSON)| 可为空| 数据格式为JSON，格式描述请查看"《2.3 extendContent的格式说明》"。  
others| 扩展参数| 字符串(JSON)| 可为空| 备用参数，方便以后参数的扩展。数据格式为JSON，格式如：{key1:value1,key2:value2}。  
  
** **

###  1.2.响应数据

待办发送后返回信息（NotifyTodoAppResult），详细说明如下:

程序名| 描述| 类型| 可否为空| 备注说明  
---|---|---|---|---  
returnState| 返回状态| 数字(int)| 不允许为空| 0:表示未操作  
1:表示操作失败  
2:表示操作成功  
message| 返回信息| 字符串(String)| 可为空| 返回状态值为0时，该值返回空。  
返回状态值为1时，该值错误信息。  
返回状态值为2时， 该值返回空。  
  
** **

##  2.设为已办接口(setTodoDone)

### 2.1.请求数据

待办上下文（NotifyTodoRemoveContext），详细说明如下:

程序名| 描述| 类型| 可否为空| 备注说明  
---|---|---|---|---  
appName| 待办来源| 字符串(String)| 可为空| 标识待办来源的系统  
注：未设置该参数的情况下，无法识别待办的来源，待办来源将默认为当前提供服务的系统  
建议第三方系统调用接口时设置该参数，以便当前提供服务的系统能够区分待办的来源（是否设置该参数需与“发送待办接口”保持一致性）  
modelName| 模块名| 字符串(String)| 不允许为空| 标识待办来源的模块  
modelId| 待办唯一标识| 字符串(String)| 不允许为空| 标识待办在原系统唯一标识修改对接方案，历史对接是requestId，新对接改为requestId_userId  
optType| 操作类型| 数字(int)| 不允许为空| 1:表示设待办为已办操作  固定值1  
2:表示设置目标待办所属人为已办操作  
key| 关键字| 字符串(String)| 可为空| 待办关键字，用于区分同一文档下不同类型待办， 如:会议文档的抄送待办和与会人参加待办属于同一文档的不同类型的待办。  
param1| 参数1| 字符串(String)| 可为空| 待办附加标识。功能同"关键字"，辅助区分不同类型的待办  
param2| 参数2| 字符串(String)| 可为空| 待办附加标识。功能同"关键字"，辅助区分不同类型的待办  
type| 待办类型| 数字(Integer)| 可为空| 待办类型，1 待审 2 待阅 3暂挂由int类型更改为Integer类型，区别在于之前接口默认给0，新接口如果给0则会报错，因为接口校验只运行写入 1、2、3  
targets| 待办所属对象| 字符串(JSON)| 当操作类型为2时,生效,且不能为空| 待办对应接收人，数据格式为JSON，格式描述请查看"《推送蓝凌—支持EKP系统组织架构对接字段》"历史接口只支持{“LoginName”:””}即对接明源登录账号，这里需要扩展支持多样性  
  
 

### 2.2.响应数据

待办删除后返回信息（NotifyTodoAppResult），详细说明如下:

程序名| 描述| 类型| 可否为空| 备注说明  
---|---|---|---|---  
returnState| 返回状态| 数字(int)| 不允许为空| 0:表示未操作  
1:表示操作失败  
2:表示操作成功  
message| 返回信息| 字符串(String)| 可为空| 返回状态值为0时，该值返回空。  
返回状态值为1时，该值错误信息。  
返回状态值为2时， 该值返回空。  
  
 

 

## 3.删除待办接口(deleteTodo)

### 3.1.请求数据

待办上下文（NotifyTodoRemoveContext），详细说明如下:

程序名| 描述| 类型| 可否为空| 备注说明  
---|---|---|---|---  
appName| 待办来源| 字符串(String)| 可为空| 标识待办来源的系统  
注：未设置该参数的情况下，无法识别待办的来源，待办来源将默认为当前提供服务的系统  
建议第三方系统调用接口时设置该参数，以便当前提供服务的系统能够区分待办的来源（是否设置该参数需与“发送待办接口”保持一致性）  
modelName| 模块名| 字符串(String)| 不允许为空| 标识待办来源的模块  
modelId| 待办唯一标识| 字符串(String)| 不允许为空| 标识待办在原系统唯一标识修改对接方案，历史对接是requestId，新对接改为requestId_userId  
optType| 操作类型| 数字(int)| 不允许为空| 1:表示删除待办操作  固定值1  
2:表示删除指定待办所属人操作 (不会真正删除待办，对待办所属人做已办处理)  
key| 关键字| 字符串(String)| 可为空| 待办关键字，用于区分同一文档下不同类型待办， 如:会议文档的抄送待办和与会人参加待办属于同一文档的不同类型的待办。  
param1| 参数1| 字符串(String)| 可为空| 待办附加标识。功能同"关键字"，辅助区分不同类型的待办  
param2| 参数2| 字符串(String)| 可为空| 待办附加标识。功能同"关键字"，辅助区分不同类型的待办  
type| 待办类型| 数字(Integer)| 可为空| 待办类型，1 待审 2 待阅 3暂挂由int类型更改为Integer类型，区别在于之前接口默认给0，新接口如果给0则会报错，因为接口校验只运行写入 1、2、3  
targets| 待办所属对象| 字符串(JSON)| 当操作类型为2时,生效,且不能为空| 待办对应接收人，数据格式为JSON，格式描述请查看"《推送蓝凌—支持EKP系统组织架构对接字段》"历史接口只支持{“LoginName”:””}即对接明源登录账号，这里需要扩展支持多样性  
  
 

### 3.2.响应数据

待办发送后返回信息（NotifyTodoAppResult），详细说明如下:

程序名| 描述| 类型| 可否为空| 备注说明  
---|---|---|---|---  
returnState| 返回状态| 数字(int)| 不允许为空| 0:表示未操作  
1:表示操作失败  
2:表示操作成功  
message| 返回信息| 字符串(String)| 可为空| 返回状态值为0时，该值返回空。  
返回状态值为1时，该值错误信息。  
返回状态值为2时， 该值返回空。  
  
 

 

# 四、问题处理

## 1.针对10.0.2402.01配置下推送历史数据的清理：

### 1.1.蓝凌(REST-Basic认证)推送清理历史requestId维度数据

实现类| com.weaver.intunifytodo.client.engine.push.request.interfaces.WPushRemoveLanLingToBasic  
---|---  
参数设置  
参数名| 描述| 组件| 约束  
appName| 待办来源标识| 输入框| 必输，第三方系统标识  
username| 账号| 输入框| 非必输，第三方提供接口验证账号  
password| 密码| 输入框| 非必输，第三方提供接口验证密码  
deleteTodoURL| 删除待办地址| 输入框| 非必输  
  
![](https://weapp.eteams.cn/papi/file/preview?fileId=1203337514532519944&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=1181495840486277127&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)
