## 一、連接器工具介紹

連接器工具主要支持企業內部自有系統實現快速接入，可以根據接口文檔實現可視化/代碼化的應用接入。企業自有應用接入后可在流程配置中進行授權使用，實現和數環通其他上千個應用互聯互通

## 二、創建連接器

在數環通【工作臺】-【連接器開發工具】可以找到應用管理列表

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

點擊【新增應用】，可以創建新的連接器

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

### 1. 選擇開發方式

數環通支持兩種連接器開發方式：

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

② 可視化開發：通過填寫授權設置、觸發動作、執行動作等，進行連接器的開發

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

### 2. 填寫基本信息

填寫應用的名稱、描述，并選擇或上傳應用圖標

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

## 三、開發配置

### 1. 源碼開發

通過 JSON Schema 定義進行開發接入，主要涉及授權配置，觸發器配置、執行器配置，有事件觸發的需要進行事件開發接入。

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

**1.1 連接器代碼**

可根據示例代碼配置，具體查看幫助文檔http://www.ztnbzvn.cn/doc/126/
內置函數參考：http://www.ztnbzvn.cn/doc/132/

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

### 2. 可視化開發

通過填寫授權設置、觸發動作、執行動作等，進行連接器的開發

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

**2.1.授權配置**

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

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

選中授權方式后，進行授權詳細信息配置

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

**配置授權參數**

授權配置參數主要配置訪問字段、返回字段等信息。

在授權輸入配置中，添加需要發送的字段，配置的返回字段；

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

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

啟用 accessToken 配置為常規的請求配置，按照對應的接口參數填寫即可；${client_id} 會自動引用授權時輸入的參數數據；

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

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

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

**2.2 觸發動作配置**

觸發動作支持添加多個動作，主要用于觸發流程執行

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

點擊添加動作，即可進行詳細的動作配置，配置基礎的動作描述信息以及入參

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

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

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

上述內容配置完成后，進行返回參數設置

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

**2.3 執行動作配置**

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

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

同樣進行執行動作的基本信息進行設置，并配置輸入字段、調用動作、輸出字段

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

## 四、腳本管理

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

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

## 五、調試

配置完成的應用，可以進行調試后再發布，以確保應用開發無誤。調試需先進行賬戶授權，再選擇動作并配置參數

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

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

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

**六、版本管理與發布**

**1.版本發布**

創建的應用默認版本 v1.0.0，發布按鈕僅可發布最新的版本到正式環境，發布時將覆蓋舊版本。

**2.版本復制**

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

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

**3.版本切換**

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

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