範本版本管理

1.1 版本

1.2 應用場景

• 使用版本控制插件建立不同的版本有利於 IT 部門記錄工作成果，儲存關鍵節點，方便驗收疊代等等，符合快速疊代的敏捷開發原則。

• 多種風格的快速切換，同一份報表在不同時間段對於不同的部門而言，可能需求類似，但是具體的細節不盡相同。重複使用的報表時，僅需要對企業特殊標籤進行修改即可以快速上線。

• 版本管理支援 FineReport 特色的遠端設計功能，遠端設計儲存版本時將會記錄下操作人的賬戶名稱和儲存的時間，管理人員透過制定版本儲存的原則，可以快速找到出錯點和對應的責任人。

• 單個範本單獨備份，相對於工程級別的備份更加靈活快速，使用者可以快速使用版本管理功能，將報表還原到任意狀態。

注1：範本版本控制功能不支援叢集環境。

注2：範本版本控制功能支援 FVS 插件 V1.15.1 及之後版本，但要求設計器版本為 11.0.17 及之後版本。

注3：使用者連結伺服器遠端設計時，若此時正在修改或儲存範本，請勿透過工作系統直接關閉遠端伺服器進程，否則會導致版本庫檔案損壞，無法正常儲存範本版本。

1.3 功能介紹

• 版本管理：使用者在設計、修改報表範本時需要控制範本的版本，進行版本的回退，控制範本的上線疊代。

• 歷史版本：支援對任意範本檔案儲存任意多個歷史版本，每個版本均支援填寫備註說明。在遠端設計時，還支援記錄此歷史版本的所屬使用者。

• 版本還原：支援對從任意歷史版本還原。當範本檔案出現意外損壞或者其他非必要修改時，可以透過還原功能還原到指定的歷史版本。

效果如下圖所示：

在「檔案>選項>常用」中，「版本管理」初始設定如下圖所示：

2.1 儲存自動生成版本

預設勾選：保存自動生成版本

1）勾選「保存自動生成版本」時，設計器可儲存自動生成的版本，同時可以進行版本的相關操作，如下圖所示：

2）不勾選「保存自動生成版本」時，則關閉版本功能，版本選項灰化不可操作，如下圖所示：

2.2 每［ ］分鐘每個使用者同個範本最多保留一個版本

預設勾選每［ ］分鐘每個使用者同個範本最多保留一個版本，設定時間週期為 60分鐘

1）勾選「每［ ］分鐘每個使用者同個範本最多保留一個版本」時，在規定週期內自動刪除前一個版本，只保留當前版本，如下圖所示：

2）不勾選「每［ ］分鐘每個使用者同個範本最多保留一個版本」，則每個版本都會保留，如下圖所示：

2.3 設定了備註的版本不會被自動清理

預設勾選設定備註的版本不會被自動清理，在勾選「每［ ］分鐘每個使用者同個範本最多保留一個版本」的前提下：

1）勾選「設定備註的版本不會被自動清理」，則設定備註的版本不會被刪除，其餘不變，如下圖所示：

2）不勾選「設定備註的版本不會被自動清理」，則設定備註的版本與無備註的版本一致。詳細請參見本文 2.2 節。

2.4 範本版本控制儲存優化

2.4.1 功能概述

1. 不勾選範本版本控制儲存優化時，設計器不可定期對範本版本控制儲存進行優化，「立即清理」選項灰化不可操作，如下圖所示：

2. 勾選範本版本控制儲存優化時，設計器有兩種情況下可進行範本版本控制儲存優化。

• 設計器啟動時，運作一次對範本版本控制儲存的優化。

• 點選「立即清理」按鈕，點選後立即進行範本版本控制儲存優化，並彈出正在優化進度提示框，優化完成後提示已減小版本檔案大小xxxKB。如下圖所示：

 注：如果減小版本檔案大小大於 1024KB，則單位為 MB；

        如果減小版本檔案大小大於 1024*1024KB，則單位為 GB，最多顯示兩位小數；

        如果減小版本檔案大小為 0KB 或者為負數，則顯示無可優化檔案。

2.4.2 注意事項

1）遠端連結，多人可以同時進行範本版本控制儲存優化

如果有 n 個人同時執行範本版本控制儲存優化，那麼一共執行了 1～n 次優化，屬於正常現象。

2）優化後減小版本檔案大小可能為負數

當歷史版本很少的時候，即可優化空間很少的時候，減小版本檔案大小可能為負數，屬於正常現象。

3）遠端連結，JAR 包保持一致

遠端連結時，設計器 JAR 包應儘量與遠端環境保持一致，否則有可能觸發需要更新遠端伺服器 JAR 包的提示，無法成功進行範本版本控制儲存優化。

4）中斷清理

手動點選立即清理後，如果立即關閉清理進度彈窗，優化任務尚未執行便被取消，優化將直接中斷。

5）版本升級

歷史範本版本儲存在%FR_HOME%\webapps\webroot\WEB-INF\assets\vcs目錄下。

在版本里選擇「篩選」，篩選的結果取時間和備註關鍵詞的交集，如下圖所示：

此處指定時間為「2023-7-21」，備註關鍵詞為「測試」。

選中某個範本的其中一個版本，點選右上角「編輯」按鈕，可以給當前選中的版本新增備註資訊。

選中某個範本的其中一個版本，點選右上角「還原」按鈕，會出現彈窗提示：是否還原此版本，選擇「是」可將當前範本還原到此版本，如下圖所示：

注：還原版本的時候，會將目前沒儲存的範本自動生成一個版本，所以無需擔心未儲存範本意外丟失的問題。

選中某個範本的其中一個版本，點選右上角「刪除」按鈕，會出現彈窗提示：確定刪除所選版本，選擇是可刪除當前選中的這個歷史版本。如下圖所示：

若設計器安裝了版本控制插件，則不允許進行版本控制設定，需刪除此插件，如下圖所示：

注：刪除插件詳情請參見  設計器插件管理