这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

预制集成应用

针对高频集成场景，提供预制集成应用，达到开箱即用的基础数据集成能力。

1、概述

针对高频集成场景，提供预制集成应用，达到开箱即用的基础数据集成能力。

2、预制应用清单

1 - 致远V5

1、概述

实现V8与V5之间接口鉴权、单点登录、组织同步、事项同步、消息同步集成。

2、集成场景

2.1、V8作为门户，V5发布应用

  1. V8配置菜单，单点登录打开V5应用
  2. V8主动调用V5组织写入OpenAPI，完成组织同步
  3. V5推送待办事项，V8呈现V5待办事项并免登陆打开详情页
  4. V5推送消息到V8，V8呈现V5消息并免登陆打开详情页
  5. M5作为移动门户，单点登录打开V5菜单、事项、消息

2.2、V8发布应用，V5作为门户

  1. V5配置菜单，单点登录打开V8应用
  2. V8主动调用V5组织查询OpenAPI，完成组织同步
  3. V8推送待办事项到V5，V5呈现V8待办事项并免登陆打开详情页
  4. V8推送消息到V5，V5呈现V8消息并免登陆打开详情页
  5. M3作为移动门户，单点登录打开V8菜单、事项、消息

3、V5版本场景区隔表

1721891532837

4、集成配置步骤

1.1 - V8作为门户，V5发布应用

1、V8作为门户，V5发布应用

1.1、V8配置菜单，单点登录打开V5应用

1.1.1、V5集成页面配置

1.1.1.1、产品登记【V5】

1721891567861

1721891573690

1.1.1.2、应用注册【V5】

1721891614673

1721891622709

1.1.1.3、应用接入设置

1721891662595

1.1.1.4、用户绑定设置

1721891868364

1.1.1.5、切换系统管理员角色

1721891689905

1.1.1.6、进入REST用户管理

1721891771980

1.1.1.7、新建REST账号

1721891782630

1721891788675

1.1.2、V5配置文件修改

1.1.2.1、配置spring-v8-sso文件

【V5安装路径】

\ApacheJetspeed\webapps\seeyon\WEB-INF\cfgHome\plugin\cip\spring\spring-v8-sso.xml

1721891972347

  • url参数：【V8服务域名】+"/service/cip-manager/plug/sso/callback"
  • 说明：V8拉取待办事项并列表呈现，点击待办打开待办详情页时，会在URL后拼接ticket参数，V5拦截ticket参数后，调用V8登录认证地址接口，换取手机号码/人员编号，模拟登陆，完成免登陆打开事项详情页。*
  • key参数(加密因子)：与V8连接器单点登录配置的加密因子保持一致即可。

1.1.3、V8集成配置

1.1.3.1、导入预制集成应用

说明：由于版本差异，请联系集成平台获取

1721892093148

1721892098193

1721892103440

1721892108235

1.1.3.2、免登配置

1721892253781

1.1.3.3、菜单配置

1721892263179

1721892269896

1.1.3.4、发布并启用三方集成应用

1721352435158

1.1.3.5、菜单角色授权

1721892312744

1721892316871

1721892321109

1721892325632

1.1.3.6、菜单效果查看

1721892344903

1.2、V8主动调用V5组织写入OpenAPI，完成组织同步

需要时联系集成平台获取预制集成应用

1.3、V5推送待办事项，V8呈现V5待办事项并免登陆打开详情页

1.3.1、V5集成配置

1.3.1.1、产品登记【V5】

1721891567861

1721891573690

1.3.1.2、应用注册【V5】

1721891614673

1721891622709

1.3.1.3、应用接入设置

1721891662595

1.3.1.4、用户绑定设置

1721891868364

1.3.1.5、切换系统管理员角色

1721891689905

1.3.1.6、进入REST用户管理

1721891771980

1.3.1.7、新建REST账号

1721891782630

1721891788675

1.3.2、V8集成配置

1.3.2.1、启用API

1721892826294

1.3.2.2、新建接入应用

1721892831149

1.3.2.3、API授权

1721892835361

1.3.2.4、启用接入应用

1721892840432

1.3.2.5、获取AppKey和AppSecret

1721892844323

1.3.2.6、查看接口域名

1721892849581

1721892854408

1.3.2.7、导入预制集成应用

说明：联系集成平台获取

1721892860876

1721892881078

1721892885585

1721892890600

1.3.2.8、新建事项同步

1721892898675

1.3.2.9、查看事项同步-同步能力编码

1721892904176

1.3.2.10、发布并启用三方集成应用

1721352435158

1.3.3、V5修改配置文件
1.3.3.1、配置spring-v8-sso文件

【V5安装路径】

\ApacheJetspeed\webapps\seeyon\WEB-INF\cfgHome\plugin\cip\spring\spring-v8-sso.xml

1721893052756

  • url参数(V8登录认证地址)：【V8服务域名】+"/service/cip-manager/plug/sso/callback"

说明：V8拉取待办事项并列表呈现，点击待办打开待办详情页时，会在URL后拼接ticket参数，V5拦截ticket参数后，调用V8登录认证地址接口，换取手机号码/人员编号，模拟登陆，完成免登陆打开事项详情页。

  • key参数(加密因子)：与V8连接器单点登录配置的加密因子保持一致
1.3.3.2、配置spring-v8-cip文件

【V5安装路径】

\ApacheJetspeed\webapps\seeyon\WEB-INF\cfgHome\plugin\cip\spring\spring-v8-cip.xml

1721893115496

  • openApiUrl(V8开放平台OpenAPI域名前缀)：“https://openapi-"+【V8前台域名】；

说明：值来源请参考步骤【查看接口域名】

  • capabilityId(V8同步能力编码)：V8基础集成-事项同步-编辑态-同步能力编码；

说明：值来源请参考步骤【查看事项同步-同步能力编码】

  • appKey:V8接入应用分配的AppKey

说明：¡值来源请参考步骤【查看AppKey和AppSecret】

  • secretKey:V8接入应用分配的AppSecret

说明：值来源请参考步骤【查看AppKey和AppSecret】

1.3.4、V5发布补丁包

由于版本差异，请联系集成平台获取；

打上补丁包后，修改配置文件。然后重启V5系统。

1.4、V5推送消息到V8，V8呈现V5消息并免登陆打开详情页

说明：参照事项同步配置

1.5、M5作为移动门户，单点登录打开V5菜单、事项、消息

说明：由于以上配置包含移动端配置，所以M5可以直接使用以上功能项

1.2 - V8发布应用，V5作为门户

1、V8发布应用，V5作为门户

1.1、V5配置菜单，单点登录打开V8应用

1.1.1、V5集成配置步骤

1.1.1.1. 产品登记【V5】

1721891567861

1721891573690

1.1.1.2. 应用注册【V5】

1721891614673

1721891622709

1.1.1.3. 应用接入设置

1721891662595

1.1.1.4. 用户绑定设置

1721891868364

1.1.1.5. 单点登录设置

1721895441615

1.1.1..6. 门户配置

1721895446745

1721895451573

1721895456983

1721895464060

1721895468929
1721895473021
1721895477215

1.1.2. V5单点登录地址说明

https://【COP-V8平台域名+端口】/oauth/home # 固定值前缀
?mobile=urlencode(【COP移动端待跳转目标相对地址】)  # url encode 后的 手机端跳转目标地址，相对路径
&web=urlencode(【COP PC端待跳转目标相对地址】)   # url encode 后的 web 跳转目标地址，相对路径
&businessType=outsider  # 固定值
&type=【defaultAvoid】    # 双方约定好的业务类型。 这里假设是 defaultAvoid
&dynamicField=【v5ticket】  # 默认 v5ticket， 如果定制化的参数，则 value= 参数 key。 eg: 三方追加的值不叫 code，而是叫 ticket，则在这里写 ticket
&ticket=【三方系统生成临时授权码】   #  与 dynamicField 的 value 一致并赋值

1.1.3. V8_nocas配置

微服务：ctp-user

文件修改内容

seeyon:
  avoid:
    defaultAvoidSso:
      【defaultAvoid】: { authType: default, callbackUrl: 【获取用户信息的 GET 请求 URL】 }

替换内容说明：

1、defaultAvoid替换为拼接地址中的type参数值；

2、 【获取用户信息的** GET 请求 URL】替换成【根据code获取用户信息】的接口请求地址**

3、 default参数是固定值，不需要修改；

1.1.4. 注意事项

  • V5点击菜单后，无法成功跳转到V8目标菜单，URL地址栏限制【callbackUrl】，这是因为V5和V8之间的网络问题，请联系运维处理。
  • V5根据版本不同，菜单默认的dynamicField也不同，8.1以及之前是dynamicField=ticket，8.2中dynamicField=v5ticket，如果不确定，就两个都试试

1.2、V8主动调用V5组织查询OpenAPI，完成组织同步

1.2.1、V5集成配置步骤

1.2.1.1. 切换系统管理员角色

1721891689905

1.2.1.2. 进入REST用户管理

1721891771980

1.2.1.3. 新建REST账号

1721891782630

1721891788675

1.2.2、V8集成配置步骤

1.2.2.1. 导入三方集成应用

说明：联系集成平台获取

1721892860876

1721892881078

1721892885585

1721892890600

1.2.2.2. 配置安全认证

1721895648613

1.2.2.3. 测试接口

1721895653542
1721895656917

1.2.2.4. 启用组织同步

1721895662287

1.2.2.5. 运行配置

1721895666183

1.2.2.6. 数据校验

1721895671064
1721895674295

1.2.2.7. 发布并启用三方集成应用

1721352435158

由于版本差异，请联系集成平台获取

1.2.3、V8预制应用获取

有项目实施经理提供，或者联系集成平台获取

1.3、V8推送待办事项到V5，V5呈现V8待办事项并免登陆打开详情页

1.3.1. V5集成配置步骤

1.3.1.1. 产品登记【V5】

1721891567861

1721891573690

1.3.1.2. 应用注册【V5】

1721891614673

1721891622709

1.3.1.3. 应用接入设置

1721891662595

1.3.1.4. 用户绑定设置

1721891868364

1.3.1.5. 单点登录设置

1721895441615

1.3.1.6. 切换系统管理员角色

1721891689905

1.3.1.7. 进入REST用户管理

1721891771980

1.3.1.8. 新建REST账号

1721891782630

1721891788675

1.3.2. V8集成配置步骤

1.3.2.1. 导入预制集成应用

说明：联系集成平台获取

1721892860876

1721892881078

1721892885585

1721892890600

1.3.2.2. 配置安全认证

1721895648613

1.3.2.3. 测试接口

1721895653542
1721895656917

1.3.2.4. 修改事项同步配置

1721895855513
1721895860100
1721895864668
1721895868720

1.3.2.5. 启用事项推送

1721895875940

1.3.2.6. 发布并启用三方集成应用

1721352435158

1.4. V8推送消息到V5，V5呈现V8消息并免登陆打开详情页

1.4.1、V5集成配置步骤

参考事项集成配置

1.4.2. V8集成配置步骤

1.4.2.1. 导入预制集成应用

说明：联系集成平台获取

1721892860876

1721892881078

1721892885585

1721892890600

1.4.2.2. 配置安全认证

1721895648613

1.4.2.3. 测试接口

1721895653542
1721895656917

1.4.2.4. 修改消息同步配置

1721895982342
1721895985752
1721895990348
1721895994102

1.4.2.5. 启用消息推送

1721895999249

1.4.2.6. 发布并启用三方集成应用

1721352435158

1.5、M3作为移动门户，单点登录打开V8菜单、事项、消息

由于以上配置步骤包含M3移动端配置，所以使用M3可以直接使用以上功能

1.6、V8预制应用导入和发布

1.6.1、下载致远_V5预置集成应用

致远_V5_1728373780330.json