自定义连接类型

自定义连接类型

变更记录

1 简介

1.1 功能介绍

除了预置连接器外，支持两种方式自定义开发第三方系统连接器。

一、通过WebAPI连接器方式

通过脚本实现会话登陆、刷新、API调用等服务，可以快速实现一个全新的连接器，例如钉钉、企业微信等。只要接口类型是WebAPI或WebService，就可以通过自定义连接类型的方式，实现针对某一类系统的连接。

二、通过自定义连接器工厂类方式

可以支持各类协议的接口，如SAP的RFC接口、邮件服务STMP等，都可以通过此方式实现。同时集成云提供了可供参考的SDK，帮助用户实现一个高度自定义的连接器。

在集成云中定义一个第三方系统连接器，即通过自定义连接类型，用于配置连接。

【集成管理】→【连接配置】→【连接类型】→【新增】

字段说明

字段名称	详细解释
编码	自定义连接类型的编码
名称	自定义连接类型的名称
描述	描述该连接类型的主要用途、使用场景等
连接器工厂类	工厂类必须实现接口：kd.isc.iscb.platform.core.connector.ConnectionFactory，并部署在集成云的应用中。
配置表单	配置表单必填，请参考资料自定义连接器类型登记与连接配置
会话登录脚本	实现WebAPI连接时编写，负责在业务API调用前建立会话，获得被调用系统的用户认证信息，通常是为了获取业务API调用所需的会话token。该脚本的执行结果会被缓存，以避免频繁登录的开销。
会话刷新脚本	实现WebAPI连接时编写，会话刷新脚本负责定时刷新缓存的会话信息，避免第三方系统的会话失效。该脚本的执行结果会被缓存，以避免频繁登录的开销。
API调用脚本	实现WebAPI连接时编写，负责构造WebAPI调用所需的URL和请求数据，并对响应结果进行解析，返回简单值组成的Map或List供该系统集成对象的结果转换脚本做进一步处理。
服务器状态测试脚本	负责检查第三方系统是否在线。
脚本扩展	提供注入Java对象的机制，以扩展脚本引擎能力；多个类名之间用分号（;）分隔，换行符不是必要，但能改善配置信息的可读性。
顺序号	显示在连接类型列表的顺序

按钮说明

按钮名称	详细解释
新增	新增连接类型
修改	修改连接类型
删除	删除连接类型
启用	启用连接类型；启用后，可配置相应连接配置
禁用	禁用连接类型；禁用后，禁止新增连接配置，已配置的连接不受影响
导出类型	导出连接类型
导入类型	导入连接类型
刷新环境	清除会话信息缓存

2 主要操作

前提条件

1、工厂类必须实现接口：kd.isc.iscb.platform.