1 - 三方系统提供写入OpenAPI(推荐)
三方异构系统提供写入OpenAPI,由COP定时调用接口主动推送,完成事项同步。
1、概述
三方异构系统提供写入OpenAPI,由COP定时调用接口主动推送,完成事项同步。
三方系统提供事项写入OpenAPI,COP平台封装接口,定时主动推送待办事项,配置字段映射,完成事项同步。
2、优缺点
* 优点
a. 三方系统工作量少,三方无需关注字段映射、同步日志等集成步骤,针对有标准接口的saas产品集成效率更高;
b. 整个集成步骤都是在图形化操作界面中完成,可以大量节约集成工期和研发投入;
c. 主动写入,数据时效性高;
* 缺点
a. 三方系统数据库结构字段要求高,必须满足COP系统事项呈现要求,否则会造成部分功能缺失;
b. 致远实施工作量大,需要了解三方系统数据库字段要求;
3、操作步骤
序号 | 步骤名称 | 责任方 | 使用场景 |
---|---|---|---|
1 | 提供单点登录接口规范和文档 | 三方系统 | 非必须,如果COP和三方系统未接入统一身份认证系统,则需要通过单点登录方式免登陆打开事项详情页 |
2 | 提供事项写入接口规范和文档 | 三方系统 | 必须, |
3 | 注册并配置鉴权AppID和秘钥 | 三方系统 | 非必须,如果三方系统接口调用时涉及到安全鉴权,则需要提供 |
4 | 提供接口调用示例 | 三方系统 | 必须,为了集成效率,强烈建议三方系统提供可直接使用的postman接口调用示例, |
5 | 新建三方集成应用 | 致远 | 必须,集成应用负责封装三方系统接口和配置单点登录 |
6 | 发布三方集成应用 | 致远 | 必须,集成应用只有发布后才能正常使用 |
7 | 封装安全认证 | 致远 | 非必须,如果三方系统接口调用时涉及到安全鉴权,则需要配置安全认证 |
8 | 封装签名 | 致远 | 非必须,如果三方系统接口调用时涉及到签名参数,则需要配置签名 |
9 | 接口封装 | 致远 | 必须,三方系统提供的接口只有正常封装后才能供给COP使用 |
10 | 在线调试验证 | 致远 | 必须,三方系统接口封装完成后,需要在线调试,验证网络通信、接口返回结果是否正确等 |
11 | 单点登录 | 三方系统 | 必须,参照【三方系统单点登录打开COP】单点登录模式配置 |
12 | 新建事项同步 | 致远 | 必须, |
13 | 选择同步模式 | 致远 | 必须, |
14 | 配置同步周期 | 致远 | 必须,根据数据量和服务器消费能力,合理配置同步周期 |
15 | 配置字段映射 | 致远 | 必须:三方系统接口文档中的字段名,字段释义与COP不一致,需要配置参数映射、层级转换等 |
4、集成配置说明
4.1. 新建三方集成应用
4.2. 封装安全认证
4.3. 枚举定义
4.4. 接口封装
4.5.在线调试验证
4.6. 新建事项同步【致远】
4.7. 选择同步模式【致远】
4.8. 配置字段映射【致远】
4.9. 发布三方集成应用
5、注意事项
无