目錄
- 報表命名規範
-
- 資料集命名規則
- 參數命名規則
- 條件屬性命名規則
- 超連結命名規範
- 決策報表元件命名規則
- 普通報表懸浮元素命名規則
- 使用者權限
- 模版版本管理
- FineDB
-
- 内置資料庫
- 外置資料庫
-
- 配置外接資料庫
-
- 建立資料庫
- 外接資料庫配置入口
- 配置外接資料庫
- 資料表
-
- 權限控制：使用者-部門職位-角色
- 系統管理：配置
報表命名規範
參見： 報表開發規範手冊
資料集命名規則
-
參數面闆資料集：以para_開頭
例如：地區選擇下拉框的資料集para_area
-
資料字典資料集：以dic_開頭
例如：産品映射字典資料集dic_product
-
報表主體資料集：以report_開頭
例如：客戶銷售資料report_customerSaleData
-
圖表資料集：以chart_開頭
例如：産品占比圖表chart_productRatio
參數命名規則
- 不能以數字、$ 符号開頭。
- 變量名隻能是字母 (a-z A-Z)、數字 (0-9)、下劃線(_)、(@) 或中文的組合，并且之間不能包含空格。
- 變量名中不能含有 ? * . - +/等字元和空格。
-
變量名是不區分大小寫的, 但不能用保留字
比如true、false；FALSE、TRUE，因為寫公式引用的時候容易搞錯，跟保留字沖突
-
全局參數：以g開頭
例如：gSaleGroup，gProduct，gPerson
-
模闆參數：以p開頭
例如：pDate，pCurrency，pUnit
-
資料集參數：以s開頭
例如：sCompany，sProject
條件屬性命名規則
- 建議使用簡短的中文命名，友善業務和開發
-
格式：條件類型_具體功能
例如：列寬_隐藏projguid列
超連結命名規範
- 建議使用簡短的中文命名，友善業務和開發
-
格式：超連結類型_具體功能
例如：網絡報表_跳轉到明細
決策報表元件命名規則
-
不允許使用複制元件自動填充的名稱
例如：report0_c、report0_c_c
-
每個元件應按照元件類型+序号的形式，友善後期維護調整
例如：report0、report1、chart0
-
每個元件名稱中加上實際用途
例如：report0_sale_detail、chart0_sale_summary_column_chart
普通報表懸浮元素命名規則
-
每個懸浮元素名稱中加上實際用途，友善後期維護調整
例如：Float0_sale_detail_line_chart
使用者權限
參見： 權限細粒度控制
-
擷取登入系統的使用者名：$fine_username
例如登入使用者名為 Anna
$fine_username=Anna
-
擷取登入系統的姓名（使用者名）：$fine_display_name
例如登入使用者名為 安娜(Anna)
fine_display_name=安娜(Anna)
-
擷取登入系統的姓名（使用者名）：$user_name
例如登入使用者名為 安娜(Anna)
$user_name=安娜
注：此為新增伺服器參數：公示
LEFT($fine_display_name, FIND(“(”, $fine_display_name) - 1)
-
擷取登入系統的角色：$fine_role
1）若登入使用者為超級管理者
$fine_role=superusers
2）若登入使用者角色為角色資料架構師
$fine_role=資料架構師
3）若登入使用者無角色
該參數值為空
-
擷取部門職位：$fine_position
傳回值為一個由部門和職位組成的數組
1）若登入使用者為「人力資源-部長」
$fine_position={“departments”:“人力資源”,“jobTitle”:“部長”}
2）若登入使用者為「人力資源-部長」兼「上司部-部長」
$fine_position={“departments”:“人力資源”,“jobTitle”:“部長”},{“departments”:“上司部”,“jobTitle”:“部長”}
3）若登入使用者無部門職位
該參數值為空
模版版本管理
參見： 模闆版本管理
- 開啟版本功能，在「檔案>選項>常用」中，「版本管理」設定中勾選「儲存自動生成版本」，預設為勾選狀态；
FineReport使用報表命名規範使用者權限模版版本管理FineDB - 不勾選「儲存自動生成版本」時，則關閉版本功能，版本選項灰化不可操作；
FineReport使用報表命名規範使用者權限模版版本管理FineDB -
每［ ］分鐘每個使用者同個模闆最多保留一個版本
勾選：在規定周期内自動删除前一個版本，隻保留目前版本；
不勾選：則每個版本都會保留；
-
設定備注的版本不會被自動清理
勾選：設定備注的版本不會被删除，其餘不變；
不勾選：則設定備注的版本與無備注的版本一緻；
-
模闆版本控制存儲優化
勾選：設計器在這兩種情況下可進行模闆版本控制存儲優化，
1）設計器啟動時，運作一次對模闆版本控制存儲的優化；
2）點選「立即清理」按鈕，點選後立即進行模闆版本控制存儲優化，并彈出正在優化進度提示框，優化完成後提示已減小版本檔案大小xxxKB。
不勾選：設計器不可定期對模闆版本控制存儲進行優化，「立即清理」選項灰化不可操作；
- 版本還原：還原版本的時候，會将目前沒儲存的模闆自動生成一個版本，是以無需擔心未儲存模闆意外丢失的問題。
FineDB
參見： FineDB 資料庫簡介
内置資料庫
- FineReport 報表工程内置了一個 HSQL 資料庫，作為 FineDB 資料庫；
- 内置 FineDB 資料庫」為HSQL資料庫，使用時會建立記憶體資料庫，資料量大時會占用大量記憶體，是以配置完外接資料庫後，請檢查資料連接配接中是否存在「内置 FineDB 資料庫」的資料連接配接。若存在相關資料連接配接，請及時删除，否則會持續占用伺服器記憶體。
- 非必要請勿在 FineReport 工程中建立「内置 FineDB 資料庫」的資料連接配接。
- 儲存在 %FR_Home%/webapps/WEB-INF/embed 目錄下；
- 設計器連接配接 FineDB
FineReport使用報表命名規範使用者權限模版版本管理FineDB
外置資料庫
配置外接資料庫
參見：FineDB 外接資料庫
建立資料庫
- 建立一個資料庫，用于存儲平台相關資料。
外接資料庫配置入口
- 管理者登入資料決策系統，點選「管理系統>系統管理>正常>外接資料庫>待配置」，可為系統第一次配置外接資料庫。
FineReport使用報表命名規範使用者權限模版版本管理FineDB
配置外接資料庫
進入到外接資料庫配置界面後，選擇資料庫類型，輸入實際資料庫相應的資訊即可
-
勾選「遷移資料至要啟用的資料庫」，新外接資料庫為空
點選「啟用新資料庫」後，會将原 finedb 資料庫的平台資料遷移到新外接資料庫中。
-
勾選「遷移資料至要啟用的資料庫」，新外接資料庫中已存在平台資料
點選「啟用新資料庫」後，跳出提示「該資料庫已存在平台資料，導入資料前将清空原有平台資料，确認連接配接該資料庫？」。
點選「确定」将清空原有平台資料，将原 finedb 資料庫的平台資料遷移到新外接資料庫中。
-
不勾選「遷移資料至要啟用的資料庫」，新外接資料庫為空
點選「啟用新資料庫」後，跳出提示「目标資料庫為新資料庫，将目前資料遷移至目标資料庫後方能使用」。
點選「确定」，将原 finedb 資料庫的平台資料遷移到新外接資料庫中。
-
不勾選「遷移資料至要啟用的資料庫」，新外接資料庫中已存在平台資料
點選「啟用新資料庫」後，工程會自動檢測目标資料庫中資料對應的 JAR 包版本和目前工程的 JAR 包版本是否一緻。
資料表
參見：FineDB 表結構
注：下述所列資料表為常用資料表，不是全部的
權限控制：使用者-部門職位-角色
- FINE_USER 使用者表
- FINE_DEPARTMENT 部門表
- FINE_POST 職位表
- FINE_DEP_ROLE 部門職位的中間表，使用者通過該表關聯部門與職務
- FINE_CUSTOM_ROLE 自定義角色表
- FINE_USER_ROLE_MIDDLE 使用者角色的中間表，使用者通過該表關聯到自定義角色和部門職務角色
系統管理：配置
- FINE_CONF_ENTITY 存儲配置類中的資料