1. 概述
1.1 版本
| 報表伺服器版本 | 插件版本 |
|---|---|
| 11.0 | V2.14 |
注：JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上。
1.2 應用場景
FineReport 提供了簡單方便的連結各方資料的能力，要求客戶有基礎的 SQL 使用知識，通常的使用場景是客戶從其他地方獲取測試有效的 SQL 語句貼上到 FineReport ，比較麻煩。該插件提供了簡化 SQL 輸入，無縫對接 SQL 視覺化編輯工具的能力。
1.3 功能介紹
支援文法提示、自動補全(支援欄位名)和程式碼美化。
優化在 SQL 中加入帆軟公式支援。
支援視覺化的 SQL Builder。(只支援 mysql mssql oracle 等常用資料庫)。
視覺化生成參數過濾語句。
1.4 方案對比
| 對比項 | 當前方案 | 新方案 |
|---|---|---|
| 方案簡介 | 本文方法，透過安裝「進階資料庫查詢」插件實現 | 本文不做介紹 在 FineDataLink 中進行資料處理，一些視覺化算子，例如資料聯動、行轉列、列轉行、新增計算列，可幫您簡化 SQL 語句 |
| 介面對比 |
| SQL 編輯器介面更加美觀  |
| 其他 | 該方案中，在 FineReport 中使用複雜 SQL 獲得目標資料，可能會導致報表開發成本高、維護成本高、取數慢的問題 | 可使用 FineDataLink 視覺化方式完成 資料加工 並進行業務註釋，FR 報表資料集只需要保留 select * from table 的方式獲取結果指標資料，進而縮短 FR 資料集查詢時間，提升報表展示速度 |
2. 插件介紹
2.1 插件安裝
點選下載插件：進階資料庫查詢
插件安裝方法參照 設計器插件管理
伺服器安裝插件方法參照 伺服器插件管理
2.2 操作方法
在插件商店安裝「進階資料庫查詢」後，建立「資料庫查詢」類型的資料集，資料庫查詢介面會預設更換為進階資料庫查詢。
在菜單欄「伺服器 -> 進階資料庫」中取消勾選 使用進階sql編輯器直接替代fr自帶編輯器 則可還原為FR預設編輯器。
2.2.1 定義資料連結按鈕
可直接點選點選下圖的第一步驟按鈕，進行新增定義資料連結。如下圖所示：
2.2.2 查看資料連結下的資料表
①為資料源，②為資料連結重新整理按鈕，③資料連結下的資料表。
2.2.3 自動補全介紹
點選①所在的按鈕，會跳出自動補全設定
其中③設定自動補全快捷鍵
④，⑤新增高亮函式名和高亮關鍵字
⑥，⑦可自訂新增自動補全函式名，自動補全關鍵字。
②為是否開啟自動補全
2.2.4 視覺化 SQL 編輯器
點選①可進入視覺化編輯器，如下圖：
②為資料表，雙擊資料表可將此資料表的欄位新增到⑤中。
點選⑤中的勾選，可選用此欄位進行查詢。
點選⑥可對⑤所選的欄位進行重新命名，匯總，以及排序等。
④為文法選擇介面，可寫 SQL 語句進行操作，以及查看③操作過後的 SQL語句 。
2.2.5 參數注入
先書寫參數語句如①，然後再點選②重新整理顯示注入的參數。可在③查看參數是否新增成功，以及參數新增預設值。
視覺化插入參數注入
透過在②輸入[列名],[參數名]並選擇[元件類型]和是否[參數為空選擇全部]來生成參數注入語句,生成規則如下(會當前語句末尾是否有where或and來判斷是否生成and)
單選場景：
簡單參數篩選 列名='${參數名}'
參數為空選擇全部 ${if(len(參數名) == 0,"","and 列名 = '" + area + "'")}
多選場景：
簡單參數篩選 列名 in ('${replace(參數名,",","','")}')
參數為空選擇全部 ${if(len(參數名) == 0,"","and 列名 in ('" + replace(參數名,",","','") + "')")}
參數注入工具欄②預設顯示,可以透過點選①來顯示或隱藏
2.2.6 插入函式
點選①，進入②，使用 FR 的公式進行計算，點選確定後會將公式計算結果傳回給你資料集直接使用，如③。
2.2.7 其他按鈕介紹
①為SQL美化，②為使用分頁 SQL 編輯，③為查看執行SQL，④為 SQL 預覽按鈕，⑤為進階資料庫查詢最大化。
報表美化點選後 SQL 如下圖：
2.2.8 權限管理說明
權限管理用來配置在遠端設計器環境中，哪些人能夠看到哪些連結，哪些資料庫表，以便於進行報表設計。
管理者配置權限：
插件的安裝，遠端設計器，使用者本地設計器均需要安裝本插件
以管理者的身分連結遠端設計器
先到設計器的 伺服器--遠端設計權限管理 選單中配置哪些人能夠連結到遠端設計器
然後到 伺服器-進階資料庫查詢 選單中給這些能連結遠端設計器的人配置他們能看到哪些資料連結，哪些資料連結中的表
左邊會將有連結遠端設計器權限的人列出來，右邊是所有的資料連結以及連結下的資料表
左邊選中某人，右邊選擇他能看到的資料連結，資料表
也可以多選使用者，點選批量設定來批量授權
配置好之後，使用者以自己的身分連結遠端設計器。他在做報表設計時，資料集選擇資料庫查詢，介面中只能看到上面勾選的連結跟表
3. 預覽效果
4. 注意事項
4.1 操作問題
1）雙擊表名會顯示欄位名然後自動補全中可以使用欄位名。
2）當自動補全不出現的時候按下 ctrl + space。
3）遠端設計時，超管需要給非超管開通權限才能使用。詳情請參見：給使用者分配遠端設計權限範例
