「點一下按鈕,先查資料庫有幾筆,再決定下一步怎麼做」——這類需求在報表與資料平台的開發中非常常見。以 FineReport 為例,可以透過前端 JavaScript 直接呼叫後端的 SQL 函數來取得結果。
關鍵在於 FineReport 內建的 SQL 函數與前端 API FR.remoteEvaluate()。後者接受一個公式字串,回傳該公式的計算結果:
var a = FR.remoteEvaluate("sum(1+2)"); // a 的值為 3
把公式換成 SQL() 函數,就等於在瀏覽器端執行了一次資料庫查詢。
SQL() 函數的參數本身需要用雙引號包住資料集名稱與 SQL 語句,而這整段又是包在 JS 字串裡,因此必然遇到巢狀引號的問題。直接寫法如下,需用反斜線轉義:
var sql = "SQL(\"FRDemo\",\"Select count(*) from sales_basic\",1,1)";
更清爽的做法是把 SQL 語句獨立成變數,再用單引號包住外層,這樣內部的雙引號完全不必處理:
var sql = "select count(*) from sales_basic";
var res = FR.remoteEvaluate('sql("FRDemo","' + sql + '",1,1)');
這兩段等價,但後者在 SQL 較長、含條件子句時可讀性明顯更好,維護上也更不容易出錯。
在參數面板新增一個按鈕,於其點擊事件中寫入:
var sql = "SQL(\"FRDemo\",\"Select count(*) from sales_basic\",1,1)"; alert(sql); var Count = FR.remoteEvaluate(sql); alert(Count);

完成後切到分頁預覽,點擊按鈕即可看到實際回傳的筆數:


這個技巧很方便,但有兩點務必留意。第一,SQL() 的第四個參數(示例中的 1,1)與資料集連線設定有關,換環境時要確認對應正確,否則會拿到空值。第二,若查詢條件來自使用者輸入,切勿用字串拼接的方式送入 SQL,那等於把注入風險直接開在後端;正確做法是改用報表的參數機制,讓條件以參數形式傳遞。
以上就是這次的分享,希望對你的報表開發有所幫助。