設計器升級指南

1.1 版本

1.2 功能簡介

為滿足客戶的新需求以及完善之前版本某些功能的不足之處，我們的產品在不斷地更新疊代。升級分為設計器升級和伺服器升級。

• 伺服器升級：操作物件一般為系統管理者，負責將公司測試環境和正式環境工程進行升級，以便修復之前版本中存在的一些問題及增加新的產品功能。

如需進行伺服器工程升級，請參考：工程升級指南

• 設計器升級：操作物件一般為設計範本的使用者，為了保持和公司系統的一致，對本地設計器進行升級。

不提供跨大版本（例如FineReport10.0升級FineReport11.0）的設計器升級方案，請直接重新下載並安裝設計器。

本文主要介紹設計器在小版本內（例如FineReport11.0.5升級FineReport11.0.9）升級的兩種升級情況，請根據實際情況選擇適用方案。

本節方案：FineReport11.0低版本設計器，線上升級到FineReport11.0最新版本

2.1 備份設計器

在進行設計器升級前，為避免升級失敗出現檔案丟失的情況，請務必對設計器工程進行備份後再升級。

推薦直接備份%FineReport_HOME%\webapps\webroot資料夾。

2.2 線上更新

1）開啟設計器。

2）確定從遠端設計狀態切換為本地預設環境，遠端設計狀態下不支援「更新升級」功能。

3）點選選單「幫助>更新升級」，查看「立即更新」按鈕是否可點選，灰化則說明當前已處於最新版本，無需升級。

4）點選「立即更新」按鈕。由於設計器更新時要獲取比對 JS 並解析，會出現幾秒的延遲，獲取更新資訊中，請耐心等待。

2.3 重啟設計器

1）關閉設計器。

2）如從11.0.9以下版本版本升級至11.0.9及之後版本，請手動刪除%FR_HOME%/webapps/webroot/WEB-INF/lib下netty相關jar包。

11.0.9及之後版本，產品內建了netty-all-4.1.78.Final.jar相關功能，因此需要刪除額外的jar，否則可能無法正常啟動工程。

如需從高版本回退至11.0.9以下版本，需要額外在設計器 %FR_HOME%/webapps/webroot/WEB-INF/lib目錄下加上netty相關jar包。

點選下載JAR包：netty-all-4.1.78.Final.jar

3）啟動設計器。

2.4 檢查升級是否成功

重啟設計器後，點選選單「幫助>更新升級」。

提示「當前已是最新版本」，且「立即更新」按鈕灰化，說明設計器更新成功。如下圖所示：

本節方案：FineReport11.0低版本設計器，手動升級到FineReport11.0最新/指定版本

3.1 備份設計器

在進行設計器升級前，為避免升級失敗出現檔案丟失的情況，請務必對設計器工程進行備份後再升級。

推薦直接備份%FineReport_HOME%\webapps\webroot資料夾。

3.2 獲取JAR包

1）如需獲取指定版本JAR包，一般都是為了遠端連結，可先查看下需要遠端連結的伺服器工程版本。

登入遠端工程，點選「管理系統>註冊管理>版本資訊」，記錄下伺服器工程的小版本號（精確到日期）。

2）付費使用者請聯絡帆軟技術支援，索要最新/指定版本的JAR包。技術支援聯絡方式：帆軟官方服務渠道使用説明 。

一般包括 14 個升級 JAR 包：

fine-accumulator-11.0.jar、fine-activator-11.0.jar、fine-core-11.0.jar、fine-datasource-11.0.jar、fine-decision-11.0.jar、fine-decision-report-11.0、fine-report-designer-11.0.jar、fine-report-engine-11.0.jar、fine-schedule-11.0.jar、fine-schedule-report-11.0.jar、fine-swift-log-adaptor-11.0.jar、fine-third-11.0.jar、fine-webui-11.0.jar、fine-cbb-11.0.jar

3.3 手動更新

1）關閉設計器。

2）將fine-report-designer-11.0 JAR 包，放到 %FR_Home%/lib 下。

3）將其餘 JAR 包，放到%FR_Home%/webapps/webroot/WEB-INF/lib下。

注：11.0.3 之前版本不存在 fine-cbb-11.0.jar ，只有12個JAR包。如果回退版本，請刪除該JAR。

4）如從11.0.9以下版本版本升級至11.0.9及之後版本，請手動刪除%FR_HOME%/webapps/webroot/WEB-INF/lib下netty相關jar包。

11.0.9及之後版本，產品內建了netty-all-4.1.78.Final.jar相關功能，因此需要刪除額外的jar，否則可能無法正常啟動工程。

如需從高版本回退至11.0.9以下版本，需要額外在設計器工程 %FR_HOME%/webapps/webroot/WEB-INF/lib目錄下加上netty相關jar包。

點選下載JAR包：netty-all-4.1.78.Final.jar

5）如從11.0.20以下版本升級至11.0.20及之後版本

請手動刪除%FR_HOME%/lib下jxbrowser相關jar包。

請根據設計器所在環境，選擇合適的7.26版本的jxbrowser相關jar包聯集傳至%FR_HOME%/lib下

6）啟動設計器。

3.4 檢查升級是否成功

重啟設計器後，點選選單「幫助>更新升級」。可查看當前JAR版本，確認是否是自己所需的設計器版本。如下圖所示：

以下兩種場景下，會觸發升級。

4.1 插件管理觸發升級

設計器開啟了「使用新插件管理器」，如下圖所示：

點選伺服器，插件管理，若檢查到 jxbrowser 的 JAR 包不存在，則彈出強制升級提示框，如下圖所示：

點選確定或關閉提示框，將跳轉至更新升級介面，後續升級步驟如上文所示。

4.2 遠端連結版本不一致

伺服器上和設計器上的 JAR 的版本要保持一致，否則可能會導致某些範本本地看預覽效果正常，伺服器下預覽出現問題。

當設計器切換工作區間至遠端伺服器時，若伺服器和設計器的 JAR 包不匹配時，將出現彈窗提示。

點選「同步至本地」，將從伺服器上獲取不一致的內容資訊並下載對應jar包和插件並更換本地 JAR 包，更換完成後將重啟設計器並再次遠端到伺服器。如下圖所示：

詳情請參見：JAR包不匹配常見問題