集成平台

说明

  1. 选择已经注册的第三方应用
  2. 选择消息获取模式：第三方推送和第三方读取
  3. 如果选择了第三方读取则可以设置时间间隔，启用后会定时读取消息，可以选择URL、接口模式，如果都不选择为默认内置接口模式
  4. 第三方应用读取如果要灵活的实现，不使用URL和接口则可以自己实现代码
  5. 当选择读取模式后如果按致远默认路径URI提供了接口，需要提供服务地址

个人设置->空间栏目->扩展栏目配置第三方待办的栏目

1 推送 1.1 地址

REST认证地址：/seeyon/rest/token/{username}/{password}

单条待办：/seeyon/rest/thirdpartyPending/receive

多条待办：/seeyon/rest/thirdpartyPending/receive/pendings

更新待办状态：/seeyon/rest/thirdpartyPending/updatePendingState

1.2 receive/pendings的json格式：

{
	"pendingList": [
		{
			"registerCode": "注册系统编码",
			"taskId": "第三方系统待办主键",
			"title": "待办标题",
			"senderName": "待办发起人姓名",
			"classify": "类别",
			"contentType": "内容类型",
			"state": "状态0待办，1已办",
			"thirdSenderId": "第三方系统发送者主键",
			"thirdReceiverId": "第三方系统接收人主键",
			"creationDate": "待办发起日期，格式yyyy-MM-dd HH:mm",
			"content": "原生app的下载地址",
			"h5url": "H5穿透地址",
			"url": "PC穿透地址",
			"noneBindingSender":"登录名称/人员编码/手机号/电子邮件",
			"noneBindingReceiver":"登录名称/人员编码/手机号/电子邮件"
		}
	]
}

1.3 receive的json格式：

{
			"registerCode": "注册系统编码",
			"taskId": "第三方系统待办主键",
			"title": "待办标题",
			"senderName": "待办发起人姓名",
			"classify": "类别",
			"contentType": "内容类型",
			"state": "状态0待办，1已办",
			"thirdSenderId": "第三方系统发送者主键",
			"thirdReceiverId": "第三方系统接收人主键",
			"creationDate": "待办发起日期，格式yyyy-MM-dd HH:mm",
			"content": "原生app的下载地址",
			"h5url": "H5穿透地址",
			"url": "PC穿透地址",
			"noneBindingSender":"登录名称/人员编码/手机号/电子邮件",
			"noneBindingReceiver":"登录名称/人员编码/手机号/电子邮件"
		}

2 主动取待办 实现ThirdpartyPendingPullProvider类，会依据定时任务取外部系统待办，和注册应用一一对应

/**
 * 第三方待办拉取模式接口，实现后CIP会定时抓取此第三方系统做过绑定映射人的待办
 * @author zhangyong 
 */

public abstract class ThirdpartyPendingPullProvider {
 /**
  * 需要和系统注册中编码一致
  * 
  * @return 注册系统编码
  */
 String registerCode();

 /**
  * 自行实现，系统指定第三方系统人员主键列表
  * 
  * @param 第三方用户账号列表
  * @return 返回ThirdPendingVO 集合
  */
 abstract protected List<ThirdPendingVO> pull(List<String> thirdAccountList,String registerCode,String... serviceURL);

3 取待办触发URL和接口

4 待办数据字段列表

5 更新待办状态

补充：state 支持传递 2:撤销/删除

6 待办穿透单点登录 【穿透认证】无认证、V5认证、第三方认证。

【V5认证】

  1. OA在PC和移动端穿透时获取到第三方系统的URL，会在地址后拼接上v5ticket，格式如【第三方系统的URL?v5ticket=XXX】，由浏览器请求。
  2. 第三方系统获取到v5ticket后调此地址认证：【http://XXXX:XX/seeyon/thirdpartyController.do?ticket=v5ticket】，v5ticket替换为OA传过去的真实v5ticket，OA验证后返回LoginName(OA用户登录名称)。
  3. 第三方系统验证此用户成功后，则直接放行OA请求重定向到指定三方页面即可。 注：V70SP2之前，请使用：【http://XXXX:XX/seeyon/login/sso?from=m3token&token=v5ticket】进行认证。

【无认证】完全依据第三方链接穿透，无单点登录认证过程。

【第三方认证】需要配置认证接口(接口应用类型为认证接口)，自定义认证参数名称。

创建人：chuhc
修改人：lichaoj、suyongjun、het

快速跳转

    ← 01 操作 →