JS實現回呼函式中自訂提示

1.1 問題描述

元件新增「提交入庫」類型的事件，即可實現點選或編輯元件後填報入庫。該方式在提交後預設不傳回成功和失敗的結果提示，如果希望在進行填報時傳回結果提示，或者根據提交成功與否執行一些自訂的方法，應該如何操作呢？

1.2 實現思路

在使用「提交入庫」類型事件的時候，可透過「設定回呼函式」的方式，來進行填報成功或失敗之後的下一步操作。如下圖所示：

1.3 API介紹

回呼函式中傳回參數 fr_submitinfo 來判斷填報是否成功， fr_submitinfo.success 的回傳值為 true 表示填報成功，false 表示填報失敗。當填報失敗時，fr_submitinfo.failinfo傳回具體報錯資訊。

以下透過實現一個自訂按鈕提交入庫，並且填報成功或失敗都傳回回執訊息的範例，來講解如何使用回呼函式的回傳值。

2.1 設計報表樣式

建立範本，如下圖所示設計報表樣式，其中 A3-F3 儲存格中都新增「正文元件」，G2 儲存格中新增一個「按鈕元件」。

2.2 設定填報屬性

點選 G2 儲存格中「按鈕元件」，為該按鈕元件新增一個「點選」事件，事件類型為「提交入庫」，綁定資料列，設定填報屬性，如下圖所示：

2.3 設定回呼函式

設定填報屬性後，點選「設定回呼函式」，新增 JS 事件，事件內容為填報成功則提示填報成功，填報失敗則提示填報失敗，如下圖所示：

JavaScript 程式碼如下：

if (fr_submitinfo.success) {
	FR.Msg.toast('提交成功');
} else {
	FR.Msg.toast('提交失敗，錯誤資訊為：' + fr_submitinfo.failinfo);
}

注：success 只表示後臺程式執行沒有異常，最終入庫結果會受到設定的影響，可能和預期的不一致。

2.4 預覽效果

儲存範本，點選「填報預覽」，在報表頁面填入資料，點選提交按鈕，若成功提交，則提示提交成功；反之則提示提交失敗。

注：不支援行動端

已完成的模板，可參見：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\JS\填報預覽JS實體\57-元件回呼事件的回傳值.cpt

點選下載範本：57-控件回调事件的返回值.cpt