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

返回本页常规视图.

集成应用(连接器)

封装三方异构系统能力,使其符合COP自建应用规范,COP平台内应用可以直接调用三方应用。

1、概述

封装三方异构系统服务,使其符合COP自建应用规范,COP平台内应用可以直接调用三方应用。

2、能力位置

能力路径:管理后台–>集成平台–>三方应用集成–>集成应用管理

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

3、能力导图

1719368559739

4、角色权限定义

集成应用

5、能力特征清单

1 - 应用管理

提供应用新建、复制、导出、导入、删除、发布等应用管理能力。

1、概述

提供应用新建、复制、导出、导入、删除、发布等应用管理能力。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持用户自助新建集成应用
列表展示 支持卡片列表展示、分页查询、模糊搜索
编辑/设计 支持用户编辑集成应用
删除 支持用户删除集成应用
分类检索 支持用户自定义应用分类,支持按照分类检索应用
导出/导入 支持应用跨环境导出、导入
不支持大版本导出导入
自定义应用图标 支持自定义应用图标,包含图标上传和图标库选择
能力开放 支持将三方应用接口发布到COP开放平台,使其可以复用COP接口签名规则、
COP接口授权管理。
扩展导入 支持swagger文件、postman文件自动创建集成应用
多类型支持 支持Rest接口、SOAP接口、数据库直连
高级设置 支持复用微流程编排能力扩展集成应用能力
复制 支持一键复制集成应用
发布 支持应用发布至应用中心,是三方集成应用与自建应用遵循相同的内容管理规范

2.2、核心界面示例

2.2.1、导出(原样导入、复制导入)

1720077589262

2.2.2、应用管理(新建、设计、发布、复制、导出、删除)

1720077533053

2.2.3、异构接口登记后,开放至开放平台

1720077556611

3、使用场景

3.1、跨环境导出导入

集成应用导出后,在新建页面支持原样导入和复制导入两种导入模式

原样导入:AppId不变、标识不变、名称不变、低代码定制应用依赖关系不变,BPM表单应用依赖关系不变;

复制导入:AppId重新生成、标识可修改、名称不变可修改、低代码定制应用依赖关系丢失,BPM表单应用依赖丢失;

1720078100063

1720078115168

3.2、复制备份

复制时,原集成应用不变,会重新生成一个新的集成应用,效果类似复制导入。用于备份配置、三方异构系统差异小时使用;

3.3、API登记后发布至COP开放平台

三方异构系统接口注册封装到集成应用后,开启能力开放,则会把三方异构系统接口发布至开放平台,遵循平台统一的权限管理、请求域名、安全签名,做到轻量级ESB总线能力。

1720077994311

1720077976513

2 - 接口登记

封装三方系统接口,使其符合COP平台规范,平台内应用可以直接使用【自定义服务】形式调用。

1、概述

封装三方系统接口,使其符合COP平台规范,平台内应用可以直接使用【自定义服务】形式调用。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持按需新建接口
编辑 支持按需编辑接口
删除 支持按需删除接口
复制 支持按需复制接口,复制的接口名称会自动拼接“_副本",接口标识自动拼接”copy“
公共入参 支持应用内所有接口共享的公共默认入参,配置公共入参后
公共回参 支持应用内所有接口共享的公共默认回参
返回码 支持按需维护返回码和成功标识,当返回码未被标记成功时,接口会被标识失败
安全认证 根据三方系统的提供接口签名、安全认证,提供可视化配置,保证接口安全性
SPI扩展 当标准的安全认证无法满足接口需求时,实施团队可以通过SPI扩展个性化安全认证规则
自定义接口分组 支持自定义接口分组,便于接口搜索和管理
关键字搜索 支持按照接口名称模糊查询接口
一键展开/一键折叠 接口分组支持折叠和展开,提供一键展开所有分组和一键合并所有分组
启用/停用 支持接口启用/停用,COP应用将无法使用停用且发布的的接口
多数据类型 支持自定义请求数据类型和返回数据类型
多请求方式 支持POSTGETOPTIONS
请求地址自动拼接 支持完成请求地址路径
支持相对路径,自动拼接应用菜单下的请求地址
JSON参数一键导入 支持通过接口请求示例和返回示例,一键导入,自动生成结构化参数定义
高级函数 支持请求参数和参会参数默认值,默认值支持高级函数配置
枚举转义 支持自定义枚举
参数转义 支持内部实体**/枚举IDCode**自动设置
支持内部实体**/枚举Code与外部Code**转义设置
应用参数 支持跨应用参数共享
导出时自动携带应用参数
分页配置 支持抽象分页参数,支持UDC应用PageRequest和三方API分页参数自动映射
在线调试 支持三方API在线调试
WSDL接口自动生成 针对SOAP接口,支持通过WSDL链接一键生成接口
熔断保护 同一应用下的同一接口,如果连续错误10次,系统会判定为接口服务异常,
会自动停止当前接口的调用连接,等待10分钟后接口连接重新启用;
支持在nacos中关闭当前熔断保护;

2.2、核心界面示例

2.2.1、接口登记

1720140936874

2.2.2、分页配置

1720141414594

2.2.3、安全认证、接口签名鉴权

1720141078576

2.2.4、公共参数和返回码

1720141297361

3、使用场景

3 - 读写数据库

直连三方系统数据库库,实现数据库表数据查询、写入、更新、删除等操作,使平台内应用可以直接通过【自定义服务】操作三方数据库。

1、概述

直连三方系统数据库库,实现数据库表数据查询、写入、更新、删除等操作,使平台内应用可以直接通过【自定义服务】操作三方数据库。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持新建表数据库读写配置
编辑 支持编辑表数据库读写配置
删除 支持删除表数据库读写配置
复制 支持复制表数据库读写配置
启用**/**停用 支持启用**/**停用表数据库读写配置
自定义条件 支持数据库表查询场景中,可视化配置查询条件
自定义结果集 支持数据库表查询场景中,可视化配置查询结果集
高级函数 支持默认值配置,默认值支持高级函数配置
共享数据源 支持跨应用共享数据源
导出时自动携带数据源配置
去重 支持数据库表查询场景中,结果集自动去重
自定义分组 支持数据库表查询场景中,结果集分组展示
一键展开**/**一键折叠 支持一键展开所有分组**/**一键折叠所有分组
结果过滤 支持查询结果过滤筛选
排序 支持结果集排序
分页 支持分页查询
一键生成SQL 支持一键生成SQL语句
SQL一键复制 支持SQL语句一键复制
在线调试 支持在线调试
可视化表结构 支持可视化字段表格

2.2、核心界面示例

2.2.1、选择数据源、接口登记转为数据库直连配置

1720141723776

2.2.2、数据直连配置

1720141888887

3、使用场景

4 - 事件订阅

监听三方系统事件,并写入到COP平台内部事件中,COP应用可以通过事件监听直接获取三方系统事件内容。

1、概述

监听三方系统事件,并写入到COP平台内部事件中,COP应用可以通过事件监听直接获取三方系统事件内容。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持新建事件订阅
编辑 支持编辑事件订阅
删除 支持删除事件订阅
复制 支持一键复制事件订阅
自定义分组 支持自定义分组名称
一键展开/一键折叠 支持一键展开所有分组/一键折叠所有分组
自动订阅接口 支持回调事件订阅接口
关键字搜索 支持通过关键字搜索事件订阅
启用/停用 支持单条时间订阅启用/停用
列表轮询 支持事件列表轮询
多数据类型 支持多种数据类型application/x-www-form-urlencodedmultipart/form-dataapplication/jsontext/plain
请求地址自动拼接 支持事件回调地址自动拼接事件标识
JSON参数一键导入 支持JSON格式请示示例一键导入,自动解析成结构化参数
高级函数 支持通过高级函数配置默认值
应用参数 支持选择应用参数作为参数默认值

2.2、核心界面示例

2.2.1、事件定义

1720142220815

3、使用场景

3.1.1、三方系统投递事件

1720142538836

3.1.2、低代码应用监听事件

1720142579131

1720142665394

5 - 消息队列

支持三方消息队列数据投入和数据消费能力。

1、概述

支持三方消息队列数据投入和数据消费能力。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持新建消息队列
编辑 支持编辑消息队列
删除 支持删除消息队列
复制 支持复制消息队列
自定义分组 支持自定义分组名称
一键展开/一键折叠 支持一键展开所有分组一键展开/一键折叠所有分组
关键字搜索 支持通过关键字搜索事件订阅
启用/停用 支持单条时间订阅启用/停用
JSON参数一键导入 支持JSON格式请示示例一键导入,自动解析成结构化消息体参数
高级函数 支持通过高级函数配置默认值
应用参数 支持选择应用参数作为参数默认值
独立数据源 支持应用外数据源配置,支持队列独立数据源替换
多消息体 支持kafka标签化消息体

2.2、核心界面示例

1720144582343

3、使用场景

3.1、低代码应用投递消息

1720148055566

3.2、低代码应用消费消息

1720148018200

6 - 应用菜单

支持三方系统菜单、功能页面封装能力。配合单点登录能力,可以在授权后免登进入三方系统。

1、概述

支持三方系统菜单、功能页面封装能力。配合单点登录能力,可以在授权后免登进入三方系统。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持新建三方菜单
编辑 支持编辑三方菜单
删除 支持删除三方菜单
多级菜单 支持菜单层级接口
自定义图标 支持自定义图标
免登开关 支持启用**/**不启用单点登录菜单

2.2、核心界面示例

2.2.1、新建/编辑菜单

1720148299110

2.2.2、角标

1720148358453

3、使用场景

3.1、发布应用时,菜单自动发布至应用中心

1720148636510
1720148676746

7 - 单点登录

实现COP平台单点登录跳转到三方系统。

1、概述

实现COP平台单点登录跳转到三方系统。

2、能力特征

2.1、特征清单

功能特征 描述
标准认证**-**身份认证 支持JIRA账号密码单点登录认证经典模式
用友认证**-YonBIP** 支持用友系YonBIP单点登录认证经典模式
协同认证**-V5** 支持致远系V5单点登录认证经典模式
标准认证**-CAS** 支持CAS单点登录认证经典模式
标准认证**-OAuth2.0** 支持OAuth2.0单点登录认证经典模式
关爱通认证 支持关爱通单点登录认证经典模式
263邮箱认证 支持263邮箱单点登录认证经典模式
腾讯认证**-DingKalk** 支持腾讯系DingTalk单点登录认证经典模式
用友认证**-NC65** 支持支持用友系NC65单点登录认证经典模式
协同认证**-V8** 支持致远系V8单点登录认证经典模式
薪事力认证 支持薪事力单点登录认证经典模式
金蝶认证**-**我家云 支持金蝶系我家云单点登录认证经典模式
SPI扩展 经典模式不满足时,支持通过SPI扩展单点登录模式
用户映射 支持内部用户和三方用户映射配置

2.2、核心界面示例

2.2.1、配置单点登录

1720148924769

2.2.2、选择并配置用户映射

1720148968414

1720149025021

1720149057540

3、使用场景

3.1、单点登录效果查看

1720149154197

1720149275852

3.2、COP单点登录三方异构系统(菜单、事项详情页、消息详情页)

1720149378199

8 - 组织同步

支持COP平台与三方系统间的组织、人员数据同步能力。

1、概述

支持COP平台与三方系统间的组织、人员数据同步能力。

2、能力特征

2.1、特征清单

2.1.1、同步配置

功能特征 描述
自定义模式 支持外部系统接口、事件订阅、消息队列、LDAP/AD四种同步类型
支持主动拉取和主动推送两种同步方向
组织平移**/**挂靠 支持跟组织挂靠模式和跟组织平移两种模式
自定义同步维度 支持自选同步维度,机构、部门、岗位、职务、职级、人员、人员**&**任职
默认值 字段映射支持好几函数配置默认值
自定义业务数据路径 支持多层级数据结构自动解析
参数赋值 支持三方系统参数与COP平台需求参数一对一映射
参数映射 支持三方系统参数与COP平台需求参数组合映射
枚举映射 支持枚举类参数一对一映射,例如性别、员工状态等
动态扩展参数 组织模型扩展参数后,支持扩展参数间的字段映射
清空配置 支持一键凭空单维度字段映射配置
自定义更新字段 数据更新场景中,支持自定义更新字段
自定义任职更新策略 一人多岗更新数据场景中,支持自定义更新策略
数据过滤 支持数据筛选过滤
启用**/**停用 支持同步配置启用**/**停用
自定义同步方式 支持自选自动同步和手动同步方式
自定义同步频率 支持自定义同步频率
配置自动校验 保存提交时,自动校验配置

2.1.2、同步补偿

功能特征 描述
新建 支持新建消息同步
编辑 支持编辑消息同步
启用/停用 支持消息同步启用/停用
删除 支持删除消息同步
多规则配置 支持多种同步规则同时生效
自定义时效 支持自定义补偿时效,全部数据、7天、15天、30天、60天、120
自定义补偿方式 支持自定义补偿和手动补偿
自定义补偿频率 当补偿方式选择定时补偿时,支持自定义补偿频率
机构补偿 针对组织同步中的机构同步,进行补偿
部门补偿 针对组织同步中的部门同步,进行补偿
岗位补偿 针对组织同步中的岗位同步,进行补偿
职务补偿 针对组织同步中的职务同步,进行补偿
职级补偿 针对组织同步中的职级同步,进行补偿
人员补偿 针对组织同步中的人员同步,不包含人员任职,进行补偿

2.2、核心界面示例

2.2.1、参数配置

1720149469472

2.2.2、同步内容配置

1720149708907

1720149719405

2.2.3、自定义同步维度

1720149785360

2.2.4、数据过滤和绑定扩展字段

1720149894797

2.2.5、字段映射配置

1720150006750

1720150169684

2.2.6、运行配置

1720150309422

3、使用场景

9 - 事项同步

支持COP平台与三方系统间的事项同步能力。

1、概述

支持COP平台与三方系统间的事项同步能力。

2、能力特征

2.1、特征清单

2.1.1、同步配置

功能特征 描述
新建 支持新建事项同步
编辑 支持编辑事项同步
启用**/**停用 支持事项同步启用**/**停用
删除 支持删除事项同步
多规则配置 支持多种同步规则同时生效
自定义同步类型 支持外部系统接口、事件订阅、消息队列、关联开放API多种同步类型
自定义同步方向 支持主动推送和主动拉取两种方向
同步创建消息 支持自定义同步行为,是否同步创建消息
自定义业务数据路径 支持多层级数据结构自动解析
数据过滤 支持数据筛选过滤
参数赋值 支持三方系统参数与COP平台需求参数一对一映射
默认值 支持通过高级函数配置默认值
详情页单点穿透 支持复用应用单点登录能力,事项详情页免登打开

2.1.2、同步补偿

功能特征 描述
新建 支持新建消息同步
编辑 支持编辑消息同步
启用/停用 支持消息同步启用/停用
删除 支持删除消息同步
多规则配置 支持多种同步规则同时生效
自定义时效 支持自定义补偿时效,全部数据、7天、15天、30天、60天、120
自定义补偿方式 支持自定义补偿和手动补偿
自定义补偿频率 当补偿方式选择定时补偿时,支持自定义补偿频率
事项补偿 针对事项同步,进行补偿

2.2、核心界面示例

2.2.1、选择同步模式

1720171598173

2.2.2、配置信息(选择接口、执行频率、是否同步生成消息)

1720171685542

2.2.3、字段映射

1720171874683

3、使用场景

10 - 消息同步

支持COP平台与三方系统间的消息数据同步能力。

1、概述

支持COP平台与三方系统间的消息数据同步能力。

2、能力特征

2.1、特征清单

功能特征 描述
新建 支持新建消息同步
编辑 支持编辑消息同步
启用**/**停用 支持消息同步启用**/**停用
删除 支持删除消息同步
多规则配置 支持多种同步规则同时生效
自定义同步类型 支持外部系统接口、事件订阅、消息队列、关联开放API多种同步类型
自定义同步方向 支持主动推送和主动拉取两种方向
自定义业务数据路径 支持多层级数据结构自动解析
数据过滤 支持数据筛选过滤
参数赋值 支持三方系统参数与COP平台需求参数一对一映射
默认值 支持通过高级函数配置默认值
详情页单点穿透 支持复用应用单点登录能力,事项详情页免登打开

2.2、核心界面示例

2.2.1、选择同步模式

1720486779172

2.2.2、配置信息(选择接口、执行频率)

1720486915641

2.2.3、字段映射

1720171874683

3、使用场景

11 - 监控日志

支持应用内使用日志可视化展示能力。

1、概述

支持应用内使用日志可视化展示能力。

2、能力特征

2.1、特征清单

功能特征 描述
接口调用日志 接口调用、调试日志
事件回调日志 事件回调日志
免登日志 终端单点登录日志
队列日志 消息队列投递和消费日志
组织同步明细日志 组织同步明细行日志,精确到每一条数据
事项同步日志 事项同步日志,记录单次同步成功数量
消息同步日志 消息同步日志,记录单次同步成功数量
同步补偿日志 同步补偿日志

2.2、核心界面示例

2.2.1、接口调用日志

1720487126698

2.2.2、事件监听日志

1720487356737

2.2.3、消息队列日志

1720487385085

2.2.4、单点登录日志

1720487443540

2.2.5、组织同步日志

1720487533359

2.2.6、事项同步日志

1720487561695

2.2.7、消息同步日志

1720487589971

2.2.8、同步补偿日志

1720487614560

3、注意事项

3.1、由于日志采用异步计入,所以会有延迟展示,最多延迟5分钟;