技术文档

#三方系统提供写入OpenAPI（推荐） description: 三方异构系统提供写入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不一致，需要配置参数映射、层级转换等