填報修改fine_conf_entity

1.1 版本

1.2 應用場景

平台中的大部分的配置項都儲存在 FineDB 中的 FINE_CONF_ENTITY 表中。

部分配置項未提供前台配置介面，或無法透過 FINE_CONF_ENTITY視覺化配置 進行修改，只能透過修改 FINE_CONF_ENTITY 表的方式進行更改。

注1：修改 FineDB 檔案，有可能造成不可修復的 BUG，因此非必要請勿修改 FineDB 檔案。

注2：請優先使用前台配置介面或 FINE_CONF_ENTITY視覺化配置 方式修改配置項。

注3：FINE_CONF_ENTITY 表中部分配置項的值固定，不支援修改，即使成功進行了填報修改，也會按照原固定邏輯生效。

1.3 功能簡介

本文透過一個簡單的範例來介紹如何透過填報的方式修改 FINE_CONF_ENTITY 的表欄位。

範例：

修改 FineDB 中 FINE_CONF_ENTITY 表中的「CustomConfig.printWidget」欄位，將欄位值改為「true」。

步驟：

1）備份平台配置。

2）連結 FineDB 資料庫，用於獲取需要修改的 FINE_CONF_ENTITY 表。

3）建立一張填報範本，用於填報修改 FINE_CONF_ENTITY 的表欄位。

4）修改表欄位，並提交入庫到 FineDB 中。

5）重啟工程。

注：若使用者無法登入數據決策系統，可前往工程%FR _HOME%/webapps/webroot/WEB-INF/embed資料夾下，手動備份 finedb 檔案。

建議在修改 FINE_CONF_ENTITY 的表欄位前，透過手動或自動的方式備份平台配置項，備份方式請參考：備份還原 。

以手動備份平台配置為例，管理者登入數據決策系統，在「管理系統>智慧維運>備份還原>平台配置」中選中手動備份。

預設備份路徑為：../backup，備份檔案儲存在工程的 %FR_HOME%/webapps/webroot/backup 資料夾下，如下圖所示：

3.1 獲取 FineDB 資料庫資訊

管理者登入數據決策系統，點選「管理系統>系統管理>標準」。

• 若外接資料庫顯示「待配置」，則 FineDB 資料庫資訊可參見 FineDB 資料庫簡介。

• 若外接資料庫顯示「已配置」，點選即可查看外接 FineDB 資料庫的資訊。

3.2 連結 FineDB 資料庫

建立一個資料連結，資料連結名稱為 FineDB，資料庫相關配置資訊可根據 3.1 節獲取。如下圖所示：

注1：「內建 FineDB 資料庫」為HSQL資料庫，使用時會建立記憶體資料庫，資料量大時會佔用大量記憶體

        因此非必要請勿在 FineReport 工程中建立「內建 FineDB 資料庫」的資料連結。

注2：本文僅簡介設計器連結內建 FineDB 資料庫的方式，平台連結方式請參見文檔： [平台]HSQL資料連結 。

具體連結資訊如下表：

注：伺服器新增 FineDB 資料連結後，務必控制 資料連結的使用權限，否則存在被越權存取並修改配置資料庫的風險。

建立一張填報範本，用於填報修改 FINE_CONF_ENTITY 的表欄位。

4.1 資料準備

建立資料查詢 ds1，選擇資料連結為 FineDB，輸入 SQL 語句：SELECT * FROM PUBLIC.FINE_CONF_ENTITY WHERE ID ='CustomConfig.printWidget'，獲取需要修改的表欄位。如下圖所示：

4.2 設計報表

1）設定主體內容

建立一張普通報表，設定 A2～B2 儲存格縱向擴展，B2 儲存格的左父格為 A2 儲存格。範本樣式如下圖所示：

2）設定填報元件

由於需要填報修改「CustomConfig.printWidget」欄位，因此需要設定 B2 儲存格為正文元件。如下圖所示：

4.3 設定填報屬性

點選菜單欄「範本>報表填報屬性>提交」，新增「內建SQL」。

1）選擇資料庫為「FineDB」，表為「FINE_CONF_ENTITY」。

2）將儲存格與資料庫表中的資料列進行綁定，並選擇「ID」作為主鍵。如下圖所示：

1）點選「儲存」按鈕，儲存報表。點選「下拉框」，選擇「填報預覽」查看報表。

2）將「CustomConfig.printWidget」欄位值由「false」修改為「true」。

點選「提交」，彈窗提示「成功」後，修改後的資料已經入庫 FineDB。如下圖所示：

3）填報提交成功後，重啟工程，配置生效。

重啟步驟請參見：關閉或重啟FineReport工程 。

在資料查詢 ds1 中，點選「預覽」，FINE_CONF_ENTITY 表中「CustomConfig.printWidget」欄位值已修改為「true」。如下圖所示：

7.1 還原平台配置

若使用者在修改欄位值後未出現預期效果，想要還原平台配置，可登入數據決策系統對本文第二節的備份檔案進行還原，詳情請參考：備份還原 。

7.2 修改後無法登入數據決策系統

注：如果使用者在修改表欄位前無法登入數據決策系統，使用以下步驟重置平台配置無效。

如果出現在修改 FINE_CONF_ENTITY 表欄位前能夠正常登入數據決策系統，修改後無法登入或無法填報預覽範本的情況，可參考以下步驟重置平台配置：

1）根據第二節設定的備份路徑，找到備份 finedb 檔案，並更換現有 finedb 檔案，即可還原平台配置。

以手動備份為例，在%FR_HOME%/webapps/webroot/backup/config/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將備份的 config.zip 解壓得到的 finedb，更換%FR _HOME%/webapps/webroot/WEB-INF/embed下的 finedb 檔案。

2）重啟工程。