## 一、連接器工具介紹

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

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

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

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

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

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

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

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

① 源碼開(kāi)發(fā)：通過(guò) JSON Schema 定義進(jìn)行開(kāi)發(fā)接入

② 可視化開(kāi)發(fā)：通過(guò)填寫授權(quán)設(shè)置、觸發(fā)動(dòng)作、執(zhí)行動(dòng)作等，進(jìn)行連接器的開(kāi)發(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)

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

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

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

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

**1.1 連接器代碼**

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

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

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

通過(guò)填寫授權(quán)設(shè)置、觸發(fā)動(dòng)作、執(zhí)行動(dòng)作等，進(jìn)行連接器的開(kāi)發(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)方式后，進(jìn)行授權(quán)詳細(xì)信息配置

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 四、腳本管理

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

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

## 五、調(diào)試

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

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

點(diǎn)擊測(cè)試預(yù)覽可以驗(yàn)證動(dòng)作是否配置成功

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

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

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

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

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

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

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

**3.版本切換**

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

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