填報修改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）將提供的「finedb欄位修改」範本掛載到平台目錄中，用於填報修改 FINE_CONF_ENTITY 的表欄位。

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

5）重啟工程。

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

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

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

管理者登入 FineBI 系統，點選「管理系統>系統管理>標準」。

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

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

建立一個資料連結，資料連結名稱為 FineDB ，資料庫相關配置資訊可根據上文獲取，建立資料連結步驟請參考：FineDB 資料 。

注：資料連結名稱不可修改，否則下面的範本可能無法使用。

1）點選下載範本：finedb欄位修改 .cpt

2）將範本儲存至工程的%FineBI%\webapps\webroot\WEB-INF\reportlets資料夾下。

3）點選「管理系統>目錄管理」，新增該範本，類型選擇「填報」，展示終端無需勾選（勾選可能會導致其他非管理使用者看到）。

「填報預覽」指在 Web 端預覽用來填報資料的範本，一般在只需要錄入修改資料的時候使用，也可用來查看資料。

1）在「管理系統>目錄管理」中，預覽該範本，如下圖所示：

2）在參數欄中輸入需要修改的欄位，點選「查詢」。本文以「CustomConfig.printWidget」欄位為例。

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

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

注：若 fine_conf_entity 表中不存在配置項，在填報頁面中新增記錄，輸入參數和相應參數值即可，如下圖所示：

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

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

7.1 還原平台配置

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

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

如果出現在修改 FINE_CONF_ENTITY 表欄位前能夠正常登入 FineBI 系統，修改後無法登入的情況，可參考以下步驟重置平台配置：

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

1）根據第二節設定的備份路徑，找到備份檔案，進行平台配置的還原。

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

2）重啟工程。