一、连接器工具介绍

连接器工具主要支持企业内部自有系统实现快速接入，可以根据接口文档实现可视化/代码化的应用接入。企业自有应用接入后可在流程配置中进行授权使用，实现和数环通其他上千个应用互联互通

二、创建连接器

在数环通【工作台】-【连接器开发工具】可以找到应用管理列表

点击【新增应用】，可以创建新的连接器

1. 选择开发方式

数环通支持两种连接器开发方式：

① 源码开发：通过JSON Schema定义进行开发接入

② 可视化开发：通过填写授权设置、触发动作、执行动作等，进行连接器的开发

2. 填写基本信息

填写应用的名称、描述，并上传应用图标

三、开发配置

1. 源码开发

通过JSON Schema定义进行开发接入，主要涉及授权配置，触发器配置、执行器配置，有事件触发的需要进行事件开发接入。

1.1 连接器代码

可根据示例代码配置，具体查看帮助文档https://www.solinkup.com/help/article/1970

2. 可视化开发

通过填写授权设置、触发动作、执行动作等，进行连接器的开发

2.1.应用授权配置

目前授权方式支持 如图所示的5中授权方式

选中授权方式后，进行授权详细信息配置

API Token授权配置需要配置 帮助字段、授权参数、账号测试三块内容

帮助信息主要用于提示和帮助用户进行快速授权和操作提示

此处配置完成后，将会在用户授权该应用的界面进行展示

配置授权参数

授权配置参数主要配置访问字段、返回字段等信息。

在授权输入配置中，添加需要发送的字段，配置的发送字段

- 字段名称：用户输入的字段名称

- 字段key：输入字段的唯一标识

- 字段类型：用户输入的字段类型

- 控件类型：输入框的类型，具体查看帮助文档https://www.solinkup.com/help/article/2222

- 控件配置：有些控件需要其他配置 比如，时间控件设置时间格式、下拉框设置支持多选

启用accessToken配置为常规的请求配置，按照对应的接口参数填写即可

 

返回字段内容和授权完成提示为授权接口请求后返回的参数内容，请注意各类字段的key值对应

2.2 触发动作配置

触发动作支持添加多个动作，主要用于触发流程执行

点击添加动作，即可进行详细的动作配置，配置基础的动作描述信息

点击下一步进入到详细参数配置，配置触发动作的请求参数

使用脚本进行请求参数的解析，目前支持js和java脚本，脚本输入后点击测试可检测脚本是否正确运行

上述内容配置完成后，进行返回参数设置

2.3 执行动作配置

执行动作的配置逻辑和触发动作基本一致，定义请求字段和返回字段

同样进行执行动作的基本信息进行设置，设置完成后，进入到参数配置

四、脚本管理

数环通提供两种示例脚本：加签、数据推送，可直接编辑使用脚本，也可以新建脚本

五、调试

配置完成的应用，可以进行调试后再发布，以确保应用开发无误

六、版本管理与发布

1.版本发布

创建的应用默认版本v1.0.0，发布按钮仅可发布最新的版本到正式环境，发布时将覆盖旧版本。

2.版本复制

如果想要版本迭代，可复制旧版本为最新版本，并进行编辑，点击【发布最新版本】，即可发布新版本到线上。注意：旧的流程仍使用旧版本，新的流程将只能选择新的连接器版本。

3.版本切换

应用开发左上角可切换版本，历史版本仅可查看，可点击顶部【复制】，复制为最新草稿并编辑