基础设置

• 1: 组织映射
• 2: 应用参数
• 3: 参数转义
• 4: 数据源配置

1 - 组织映射

1、概述

提供公共的、跨应用共享的平台内外组织、人员映射管理，解决COP与三方应用间组织、人员标识字段不一致，但需要实现组织、人员信息交换的场景。

2、能力位置

能力路径：管理后台–>集成平台–>基础设置–>组织映射

URL相对路径：/main/backstageManage/cip-connector/mapping-config/app

3、能力特征

3.1、特征清单

功能特征	描述
新建	支持用户自助新建组织映射支持新建移动插件时，自动新建组织映射（组织、人员）
列表展示	支持列表展示、分页查询、模糊搜索
编辑/配置	支持用户编辑组织映射支持用户自定义外部参数列支持用户编辑参数映射内容
导出/导入	支持用户自助导出、导出映射内容
内容校验	支持用户自助刷新映射数据，过滤失效数据
删除	支持用户删除组织映射
清空	支持用户清空映射内容
引用记录	支持可视化展示当前组织映射被引用记录
自助更新三方用户标识	配置授权后，用户可以自助更新自己与三方系统间的账号映射

3.2、核心界面示例

4、使用场景

4.1、单点登录

当COP与三方系统间需要单点登录，且用户标识字段不统一时，使用用户映射建立用户一对一的绑定关系，登录终端包含PC端单点登录和移动端单点登录；

4.2、事项同步

当三方系统提供事项写入接口，COP负责将事项数据同步到三方系统时，可以根据用户映射，将COP用户转为三方系统可识别的用户标识。

4.3、消息同步

当三方系统提供消息接收接口，COP负责将消息数据同步到三方系统时，可以根据用户映射，将COP用户转为三方系统可识别的用户标识。

4.4、移动插件免登用户映射

移动插件新建时，自动生成用户映射和部门映射配置，数据自动写入；

4.5、组织同步自动写入用户映射数据

组织同步时，通过开启用户映射配置，用户映射数据会自动写入当前【集成应用-免登】关联的用户映射中；

4.6、用户自助更新三方用户标识

用户在前台-个人设置中，维护具体三方异构系统与COP平台用户关系，只能维护当前登录账号的用户映射。

2 - 应用参数

1、概述

提供一套公共的、跨应用共享的参数配置，包含参数启停、引用跟踪、请求地址校验等功能。

2、能力位置

能力路径：管理后台–>集成平台–>基础设置–>应用参数

URL相对路径：/main/backstageManage/cip-connector/app-register/app

3、能力特征

3.1、特征清单

功能特征	描述
新建	支持用户自助新建应用参数
列表展示	支持列表展示、分页查询、模糊搜索
编辑/配置	支持用户编辑应用参数
删除	支持用户删除未引用/已经取消引用的应用参数
启用/停用	支持用户启用、停用应用参数
请求地址校验	支持请求地址域名校验
参数配置	支持自定义参数、自定义数据类型、默认值，
引用记录	支持可视化展示当前应用参数被引用记录，存在引用记录时禁止删除

3.2、核心界面示例

4、使用场景

4.1、跨应用参数共享：

当目标系统为大型ERP系统，一个系统包含多个应用时,由于各应用体量大而拆分成多个集成应用时，就需要一套在应用间共享的应用参数，减少用户实施压力。

4.2、跨环境参数统一维护：

当跨环境导出、导入应用时，用户无需逐个进入应用，即可维护请求地址、三方应用ID、三方应用秘钥等共享参数。

4.3、应用关系在线跟踪：

当用户需要根据应用核心参数梳理应用间关系时，可以参考引用记录直接确定三方应用关系。

3 - 参数转义

1、概述

提供COP平台内部实体编码或枚举与第三方系统实体编码或枚举的转换机制。主要用于COP平台与第三方系统相互调用时的实体编码或枚举转换。

2、能力位置

能力路径：管理后台–>集成平台–>基础设置–>参数转义

URL相对路径：/main/backstageManage/cip-manager/escape-setting/app

3、能力特征

3.1、特征清单

功能特征	描述
新建	支持用户自助新建参数转义
列表展示	支持列表展示、分页查询、模糊搜索
编辑/配置	支持用户编辑参数转义内容
删除	支持用户删除组织映射

3.2、核心界面示例

4、使用场景

4.1、外部编码自动转义为内部实体编码

UDC定制应用通过三方集成应用调用三方接口时，且参数类型为实体/枚举时，可以将入参由内部ID转义为外部编码或者内部ID转义为内部编码，出参由外部编码转义为内部编码或者外部编码转义为内部ID；

配置规则如下：

参数转义：厂商标识==集成应用：厂商标识

参数转义：产品标识==集成应用：标识

参数转义：版本号==集成应用：版本号

参数转义：应用==集成应用-接口-参数：转义应用（对应后台代码需要添加注解）

参数转义：实体/枚举==集成应用-接口-参数：转义实体（对应后台代码需要添加注解）

4.2、OpenAPI自动将外部编码转义为内部实体ID

三方系统调用开放平台OpenAPI时，可以将请求参数外部编码自动转义为内容实体ID，返回参数由内部实体/枚举ID转为外部编码；

配置规则如下：

参数转义：厂商标识==接入应用：厂商标识

参数转义：产品标识==接入应用：产品标识

参数转义：版本号==接入应用：版本号

参数转义：应用==接入应用-参数：转义应用（对应后台代码需要添加注解）

参数转义：实体/枚举==接入应用-参数：转义实体（对应后台代码需要添加注解）

4 - 数据源配置

1、概述

提供公共的、跨应用的、可视化的数据源配置配置，将数据库配置、MQ连接信息抽象到数据源配置。并提供在线测试连接功能，以便多个连接器可以公用一个数据源，同时在跨环境推送时，可以直接修改数据源，而不需要进入到各个连接器中逐一修改数据源。

2、能力位置

能力路径：管理后台–>集成平台–>基础设置–>数据源配置

URL相对路径：/main/backstageManage/cip-connector/database-config/app

3、能力特征

3.1、数据源配置

功能特征	描述
新建	支持用户自助新建数据源配置
列表展示	支持列表展示、分页查询、模糊搜索
编辑/配置	支持用户编辑数据源配置
删除	支持用户删除数据源
启用/停用	支持用户按需启用/停用数据源
连接测试	支持用户在新和编辑状态时，测试数据源连接

3.2、数据库类型、版本支持

功能特征	描述
MySQL	5.7版本SQL规范
PostgreSQL	13.x版本SQL规范
Oracle	12c版本SQL规范
SqlServer	2022版本SQL规范

3.3、消息队列类型、版本支持

功能特征	描述
Kafka	2.2.0版本连接规范
Rocket	4.x版本连接规范

3.4、核心界面示例

4、使用场景

4.1、读写数据库

配合集成应用，提供异构数据库读写能力；

4.2、消费消息

配合集成应用，提供Kafka、Rocket消息订阅和消费能力；适用于组织同步、事项同步、消息同步

4.3、投递消息

配合集成应用，提供Kafka、Rocket消息投递能力；