## 一、連接器工具介紹

連接器工具主要支持企業(yè)內(nèi)部自有系統(tǒng)實現(xiàn)快速接入，可以根據(jù)接口文檔實現(xiàn)可視化/代碼化的應(yīng)用接入。企業(yè)自有應(yīng)用接入后可在流程配置中進行授權(quán)使用，實現(xiàn)和數(shù)環(huán)通其他上千個應(yīng)用互聯(lián)互通

## 二、創(chuàng)建連接器

在數(shù)環(huán)通【工作臺】-【連接器開發(fā)工具】可以找到應(yīng)用管理列表

![](/media/202406/2024-06-12_191643_5739230.9774343727649059.png)

點擊【新增應(yīng)用】，可以創(chuàng)建新的連接器

![](/media/202406/2024-06-12_191735_4292690.5420280452881109.png)

### 1. 選擇開發(fā)方式

數(shù)環(huán)通支持兩種連接器開發(fā)方式：

① 源碼開發(fā)：通過 JSON Schema 定義進行開發(fā)接入

② 可視化開發(fā)：通過填寫授權(quán)設(shè)置、觸發(fā)動作、執(zhí)行動作等，進行連接器的開發(fā)

![](/media/202406/2024-06-12_192004_5805520.8564108838281885.png)

### 2. 填寫基本信息

填寫應(yīng)用的名稱、描述，并選擇或上傳應(yīng)用圖標(biāo)

![](/media/202406/2024-06-12_192045_4307600.42662323757669063.png)

## 三、開發(fā)配置

### 1. 源碼開發(fā)

通過 JSON Schema 定義進行開發(fā)接入，主要涉及授權(quán)配置，觸發(fā)器配置、執(zhí)行器配置，有事件觸發(fā)的需要進行事件開發(fā)接入。

![](/media/202406/2024-06-12_192756_4784050.8361339037746075.png)

**1.1 連接器代碼**

可根據(jù)示例代碼配置，具體查看幫助文檔http://www.bus6a.cn/doc/126/
內(nèi)置函數(shù)參考：http://www.bus6a.cn/doc/132/

![](/media/202406/2024-06-12_192847_4654520.6187657853951624.png)

### 2. 可視化開發(fā)

通過填寫授權(quán)設(shè)置、觸發(fā)動作、執(zhí)行動作等，進行連接器的開發(fā)

![](/media/202406/2024-06-12_193149_7227240.006688835736411103.png)

**2.1.授權(quán)配置**

![](/media/202406/2024-06-12_193228_0466360.865324806761172.png)

目前授權(quán)方式支持 如圖所示的 2 種授權(quán)方式以及不需要授權(quán)

選中授權(quán)方式后，進行授權(quán)詳細信息配置

![](/media/202406/2024-06-12_193345_6163230.8116828710544916.png)

**配置授權(quán)參數(shù)**

授權(quán)配置參數(shù)主要配置訪問字段、返回字段等信息。

在授權(quán)輸入配置中，添加需要發(fā)送的字段，配置的返回字段；

![](/media/202310/2023-10-19_134209_4675060.6788923840326203.png)

- 字段名稱：用戶輸入的字段名稱
- 字段 key：輸入字段的唯一標(biāo)識
- 字段類型：用戶輸入的字段類型
- 控件類型：輸入框的類型，具體查看幫助文檔http://www.bus6a.cn/doc/127/
- 控件配置：有些控件需要其他配置 比如，時間控件設(shè)置時間格式、下拉框設(shè)置支持多選

啟用 accessToken 配置為常規(guī)的請求配置，按照對應(yīng)的接口參數(shù)填寫即可；${client_id} 會自動引用授權(quán)時輸入的參數(shù)數(shù)據(jù)；

![](/media/202310/2023-10-19_134128_0758130.3148772876363529.png)

若header 中需要 使用隨機數(shù)、時間戳等，可通過函數(shù)獲取：
${date:nowUnixTimestamp()} 返回時間戳 秒${date:nowUnixTimestampMillisLong()} 返回時間戳 毫秒
${random:generate(6)} 返回6位隨機數(shù)，參考內(nèi)置函數(shù)：http://www.bus6a.cn/doc/132/
![](/media/202310/2023-10-19_135137_1674030.3606410910176683.png)
返回字段內(nèi)容和授權(quán)完成提示為授權(quán)接口請求后返回的參數(shù)內(nèi)容，請注意各類字段的 key 值對應(yīng)

![](/media/202406/2024-06-12_193725_4203210.6227735227988497.png)

**2.2 觸發(fā)動作配置**

觸發(fā)動作支持添加多個動作，主要用于觸發(fā)流程執(zhí)行

![](/media/202406/2024-06-12_193812_0729060.5475348059006601.png)

點擊添加動作，即可進行詳細的動作配置，配置基礎(chǔ)的動作描述信息以及入?yún)?
![截圖.png](/media/202308//1693378631.7628582.png)

觸發(fā)動作調(diào)用配置使用腳本進行請求參數(shù)的解析，目前支持 js 和 java 腳本，腳本輸入后點擊測試可檢測腳本是否正確運行

![截圖.png](/media/202308//1693378631.7903795.png)

上述內(nèi)容配置完成后，進行返回參數(shù)設(shè)置

![截圖.png](/media/202308//1693378631.8183331.png)

**2.3 執(zhí)行動作配置**

執(zhí)行動作的配置邏輯和觸發(fā)動作基本一致，定義請求字段和返回字段

![截圖.png](/media/202308//1693378631.8446596.png)

同樣進行執(zhí)行動作的基本信息進行設(shè)置，并配置輸入字段、調(diào)用動作、輸出字段

![截圖.png](/media/202308//1693378631.8750458.png)

## 四、腳本管理

數(shù)環(huán)通提供兩種示例腳本：加簽、數(shù)據(jù)推送，可直接編輯使用腳本，也可以新建腳本，參考 ‘腳本配置說明’

![截圖.png](/media/202308//1693378631.900665.png)

## 五、調(diào)試

配置完成的應(yīng)用，可以進行調(diào)試后再發(fā)布，以確保應(yīng)用開發(fā)無誤。調(diào)試需先進行賬戶授權(quán)，再選擇動作并配置參數(shù)

![截圖.png](/media/202308//1693378631.9238446.png)

點擊測試預(yù)覽可以驗證動作是否配置成功

![截圖.png](/media/202308//1693378631.950763.png)

**六、版本管理與發(fā)布**

**1.版本發(fā)布**

創(chuàng)建的應(yīng)用默認版本 v1.0.0，發(fā)布按鈕僅可發(fā)布最新的版本到正式環(huán)境，發(fā)布時將覆蓋舊版本。

**2.版本復(fù)制**

如果想要版本迭代，可復(fù)制舊版本為最新版本，并進行編輯，點擊【發(fā)布最新版本】，即可發(fā)布新版本到線上。注意：舊的流程仍使用舊版本，新的流程將只能選擇新的連接器版本。

![截圖.png](/media/202308//1693378631.9789617.png)

**3.版本切換**

點擊【查看】可查看其他版本，歷史版本僅可查看，可點擊頂部【恢復(fù)此版本】，復(fù)制為最新草稿并編輯

![截圖.png](/media/202308//1693378632.0021865.png)