1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | -- |
1.2 應用場景
使用版本控制插件建立不同的版本有利於 IT 部門記錄工作成果，儲存關鍵節點，方便驗收疊代等等，符合快速疊代的敏捷開發原則。
多種風格的快速切換，同一份報表在不同時間段對於不同的部門而言，可能需求類似，但是具體的細節不盡相同。重複使用的報表時，僅需要對企業特殊標籤進行修改即可以快速上線。
版本管理支援 FineReport 特色的遠端設計功能，遠端設計儲存版本時將會記錄下操作人的賬戶名稱和儲存的時間，管理人員透過制定版本儲存的原則，可以快速找到出錯點和對應的責任人。
單個範本單獨備份，相對於工程級別的備份更加靈活快速，使用者可以快速使用版本管理功能，將報表還原到任意狀態。
注1：範本版本控制功能不支援叢集環境。
注2：範本版本控制功能支援 FVS 插件 V1.15.1 及之後版本，但要求設計器版本為 11.0.17 及之後版本。
注3：使用者連結伺服器遠端設計時，若此時正在修改或儲存範本，請勿透過工作系統直接關閉遠端伺服器進程，否則會導致版本庫檔案損壞，無法正常儲存範本版本。
1.3 功能介紹
版本管理：使用者在設計、修改報表範本時需要控制範本的版本，進行版本的回退，控制範本的上線疊代。
歷史版本：支援對任意範本檔案儲存任意多個歷史版本，每個版本均支援填寫備註說明。在遠端設計時，還支援記錄此歷史版本的所屬使用者。
版本還原：支援對從任意歷史版本還原。當範本檔案出現意外損壞或者其他非必要修改時，可以透過還原功能還原到指定的歷史版本。
效果如下圖所示：
1.4 使用說明
11.0.19 及之後版本的新工程，預設使用新範本版本管理，詳情請參考：新範本版本管理 。
從11.0.19 之前版本升級至11.0.19 及之後版本的工程：
若工程%FR_HOME%\webapps\webroot\WEB-INF\assets路徑下不存在vcs資料夾或歷史版本資訊，則使用新範本版本管理。
若工程%FR_HOME%\webapps\webroot\WEB-INF\assets資料夾下存在vcs資料夾或歷史版本資訊，則使用舊範本版本管理，且出現彈窗提示：版本管理存在更新，如下圖所示：
注：支援從舊範本版本管理更新、並遷移歷史版本資料至新範本版本管理，操作步驟請參考：新範本版本管理
2. 版本管理
在「檔案>選項>常用」中，「版本管理」初始設定如下圖所示：
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目錄下。
3. 版本篩選
在版本里選擇「篩選」，篩選的結果取時間和備註關鍵詞的交集，如下圖所示：
此處指定時間為「2023-7-21」，備註關鍵詞為「測試」。
4. 版本編輯
選中某個範本的其中一個版本，點選右上角「編輯」按鈕，可以給當前選中的版本新增備註資訊。
5. 版本還原
選中某個範本的其中一個版本，點選右上角「還原」按鈕，會出現彈窗提示：是否還原此版本，選擇「是」可將當前範本還原到此版本，如下圖所示：
注：還原版本的時候，會將目前沒儲存的範本自動生成一個版本，所以無需擔心未儲存範本意外丟失的問題。
6. 版本刪除
選中某個範本的其中一個版本，點選右上角「刪除」按鈕，會出現彈窗提示：確定刪除所選版本，選擇是可刪除當前選中的這個歷史版本。如下圖所示：
