集成平台

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

1、推送 1.1 地址：

REST认证地址：/seeyon/rest/token/{username}/{password}
单条消息：/seeyon/rest/thirdpartyMessage/receive/singleMessage
多条消息：/seeyon/rest/thirdpartyMessage/receive/messageList

1.2 /receive/singleMessage 的json格式如下

{
    "thirdpartyRegisterCode": "注册系统编码",
    "thirdpartyMessageId": "第三方系统消息主键",
    "messageContent": "消息内容",
    "thirdpartySenderId": "第三方系统发送者主键（点对点绑定使用）",
    "thirdpartyReceiverId": "第三方系统接收人主键（点对点绑定使用）",
    "creation_date": "消息创建日期，格式yyyy-MM-dd HH:mm",
    "downloadUrl": "原生app的下载地址",
    "messageH5URL": "H5穿透地址",
    "messageURL": "PC穿透地址",
    "noneBindingSender": "登录名称/人员编码/手机号/电子邮件（免绑定使用）",
    "noneBindingReceiver": "登录名称/人员编码/手机号/电子邮件（免绑定使用）"
}

1.3 /receive/messageList 的json格式如下：

{
    "messages": [
        {
            "thirdpartyRegisterCode": "注册系统编码",
            "thirdpartyMessageId": "第三方系统消息主键",
            "messageContent": "消息内容",
            "thirdpartySenderId": "第三方系统发送者主键（点对点绑定使用）",
            "thirdpartyReceiverId": "第三方系统接收人主键（点对点绑定使用）",
            "creation_date": "消息创建日期，格式yyyy-MM-dd HH:mm",
            "downloadUrl": "原生app的下载地址",
            "messageH5URL": "H5穿透地址",
            "messageURL": "PC穿透地址",
            "noneBindingSender": "登录名称/人员编码/手机号/电子邮件（免绑定使用）",
            "noneBindingReceiver": "登录名称/人员编码/手机号/电子邮件（免绑定使用）"
        }
    ]
}

注：穿透地址需要完整的http/https格式

2、主动取消息 实现ThirdpartyMessagePullProvider类，会依据定时任务取外部系统消息，和注册应用一一对应

	/**
	 *
	 * @ClassName: ThirdpartyMessagePullProvider
	 * @Description: 第三方消息拉取模式接口，实现后CIP会定时抓取此第三方系统做过绑定映射人的待办 *
	 */
	public abstract class ThirdpartyMessagePullProvider { /**
	  * 需要和系统注册中编码一致
	  *
	  * @return 注册系统编码
	  */
	 String registerCode();
	 /**
	  * 自行实现，系统指定第三方系统人员主键列表
	  *
	  * @return 返回 MessageReceiveVo 集合 
	  */
	 abstract protected List<MessageReceiveVo> pull(List<String> thirdAccountList, String registerCode,String... serviceURL);

3、取消息触发URL和接口

4、消息数据字段列表

1720174487292.png

5、 消息穿透单点登录

【穿透认证】无认证、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
修改人：suyongjun

快速跳转

    ← 04 待办集成 →