前端事件

簡介

功能簡介

前端事件是一種全新的資料取得的方式，可以在資料送出或者表單填報時，主動調用外部API，實現API取數、資料驗證、資料分析、觸發事件等一系列的操作。

前端事件功能所有版本皆可免費使用，無需啟用Jodoo API API，且無需編程即可完成前端事件的配置。如果企業具有開發能力，也可以自己封裝API，來實現想要的資料交互效果！

應用場景

前端事件可以應用於資料處理、資料驗證、資料取得，以及其他自訂的場景等。

預期效果

配置好前端事件後，在表單中選擇部門，即可展示部門成員信息。

設定入口

1. 在「表單設計 > 表單屬性 > 前端事件」處點擊「設定」，進入前段事件的設定頁面：

2. 如果未新增過前端事件，點擊「新增前端事件」進行新增：

3. 如果已經新增過前端事件，可以對之前新增的前端事件進行編輯、偵錯、刪除、開啟和停用操作，或點擊左上角的「新增前端事件」進行新增：

4. 當一個表單中新增了多個前端事件時，支援對列表中的前端事件進行拖曳排序，便於查看。

附註：

一個表單最多可設定 20 個前端事件。

設定內容

前端事件的設定內容主要包括：事件名稱、事件說明、觸發動作和執行動作。

事件名稱

事件名稱即前端事件的命名，必填。

事件說明

事件說明即前端事件的描述資訊，非必填。

觸發動作

觸發動作即觸發前端事件的條件。選擇觸發欄位，當觸發欄位的值被手動修改時，會觸發執行動作：

觸發動作支援選擇的欄位包括：

單行文字、多行文字、數字、日期時間、單選、複選、下拉單選、下拉複選框、定位、圖片、附件、手寫簽名、成員單選、成員多選、部門單選、部門多選、子表單子欄位。

執行動作

執行動作是指當發生觸發動作時，前端事件將調用 API，完成相應的執行操作。

執行動作支援設定為自訂請求或調用外掛。

儲存與偵錯

配置好前端事件的參數後，點擊「儲存」儲存設定，或點擊「儲存並偵錯」查看預期效果並進行測試：

進入偵錯頁面，在觸發欄位中輸入內容，點擊「發送請求」，右側偵錯資訊中將顯示請求內容和返回內容，並將返回內容按照返回值設定填寫進表單欄位中：

請求超時

如果使用前端事件時顯示請求超時，系統將會自動重新請求，每次請求時長 15 秒，共請求三次，如第三次再次超時，將不再請求。