升級後須知

1.1 版本

1.2 應用場景

在進行大版本升級後，很多使用者不知道自己還應該做什麼，以及有哪些事項是需要注意的，本文將對大家有疑惑的點進行說明。

2.1 原伺服器配置了外接資料庫，升級後需要重新做遷移

升級工具處理後，平台是內建 finedb 模式，如果需要遷移到自己的資料庫，需要重新遷移相關文檔見：配置外接資料庫。

請按照對應資料庫的文檔，嚴格遵循建表的編碼等說明進行建表，否則會導致遷移失敗。常見外接庫的遷移報錯如下：外接資料庫配置常見問題 。

注1：升級工具不會修改原外接庫裏的任何資料，而是讀取資料生成內建庫進行升級修改的。
注2：為了和舊版本的外接庫互相獨立，不影響之前的環境，可以在原來所用外接庫的相同使用者下，建立一個資料庫做遷移。待後續 11 運作穩定，可以將原先 10 的外接庫刪除。

2.2 外接資料庫與資料連結的差別

1）資料連結
資料連結是報表範本所引用的資料。可以在設計器做範本中使用，儲存的一般都是使用者自己的業務資料。
2）外接資料庫
外接資料庫指的是將存有工程目錄、權限、使用者等資訊的配置庫 finedb，遷移到自己的資料庫裏，以提升效能或者方便管理。
該資料庫非常重要，不能隨意修改，finedb 的說明見相關文檔：FineDB 資料庫簡介

3.1 遠端設計

1）Finereport11 版本的工程只能用 Finereport11 版本的設計器進行連結。所以升級後需要安裝11版本的設計器，下載位址：https://www.finereport.com/tw/
2）遠端設計連結方法參見：遠端設計

3.2 11.0版本設計器同步10.0版本的資料以及範本

3.2.1 同步資料連結等配置

可以將 10.0 設計器 FineReport_10.0\webapps\webroot\WEB-INF\embed下的 finedb 資料夾，複製更換掉 11.0 設計器相同路徑：FineReport_11.0\webapps\webroot\WEB-INF\embed下的 finedb 檔案。更換好後重啟設計器即可。

3.2.2 同步報表範本檔案

可以將 10.0 設計器 FineReport_10.0\webapps\webroot\WEB-INF\reportles 下所有的範本檔案，複製到 11.0 設計器的相同路徑下：FineReport_11.0\webapps\webroot\WEB-INF\reportles 下。該動作不需要重啟。

3.3 同步設計器與伺服器的插件以及JAR包

使用者透過設計器遠端連結伺服器進行遠端設計時，設計器和伺服器 JAR 包版本要保持一致，否則在設計時，會引發一系列的問題。當伺服器和設計器的 JAR 包不匹配時，設計器切換工作區間至遠端伺服器時（直接在選單裏切換，和開啟配置工作區間彈窗後點選確定時切換）或設計器連着遠端伺服器啟動後，將出現彈窗提示“遠端設計環境不一致，部分功能將受到影響”。相關問題及解決方案可參考文檔： 伺服器和設計器的JAR包不匹配

Finereport10.0 App 無法新增 Finereport11.0 報表伺服器，需要重新下載 Finereport11.0 的 App，當前無法實現線上更新。如果做了 oem 客製的 app，需要重新客製，詳情參考：App打包。
1）資料分析V11下載：app store 下載
2）如果是帆軟市場打包的app也需要重新去打包，詳情參考：App打包

升級到 11 版本後，有小部分概率會出現微信或者釘釘整合，開啟報表應用需要手動登入的問題。解決方案如下：

5.1 更新插件

如果微信管理或者釘釘管理插件，左上角有紅色的 new 標籤，說明該插件版本不是最新版本，需要更新到最新請參考：設計器更新插件 。

5.2 手動更新微信或者釘釘整合的連結

1)「系統管理>微信管理（或者釘釘管理）>應用快捷配置」，點選生成對應的連結並複製，如下圖所示：

2）微信配置頁面：將上述生成的連結，複製更換掉原來配置好的應用主頁連結後儲存即可，配置完即可生效。如下圖所示：

3） 釘釘配置頁面：將上述生成的連結，複製更換掉原來配置好的應用首頁位址，修改好後，版本發佈與管理，點選儲存即可。如下圖所示：

11.0.3 及之後版本的工程，新增「報表檢查」功能，「報表前端異常提示」預設開啟，相關異常如圖所示，如需關閉，需要進入「管理系統>系統管理>標準>報表前端異常提示」，關閉即可不在提示，詳情見：標準  中第8節內容部分。

正式授權變更需要聯絡商務獲取遷移過程，商務郵箱：business@fanruan.com

7.1 升級前未對原工程的正式授權進行處理

需要按照如下格式給商務傳送郵件：
注：若有任何特殊情況，請在郵件中註明。

由於授權遷移需要正式授權在原工程上登入成功的截圖，升級前未對原工程的正式授權進行處理的，需要還原原來的工程，或者在伺服器上安裝部署包先將原正式授權登入成功才可進行遷移。該步驟較為繁瑣，可聯絡帆軟官方技術支援進行協助。

7.2 升級前已經對原授權進行銷燬

則按照升級團隊的要求，給商務傳送郵件即可。
請使用合同中指定的郵箱傳送登入資訊給 FineReport 商務business@fanruan.com，郵件格式如下：
注：若有任何特殊情況，請在郵件中註明。

如果是 10.0 版本升級至 11.0 版本的工程，報表存取方式沒有任何改變。如果是 9.0 或 8.0 版本升級至 11.0 版本的工程，平台以及範本存取連結會有變化。11.0 版本的報表存取方式如下：
1）平台存取URL：http://IP:埠/webroot/decision（其中 webroot 為工程名，decision 為 Servlet 名）
2）範本存取URL：http://IP:埠/webroot/decision/view/report?viewlet=xxx.cpt或者xxx.frm
3）管理者賬密：初始時自訂，如果忘記賬密可以參考：管理者修改密碼/忘記密碼
4）系統參數：系統參數
5）內建函式匯總：設計器函式匯總
6）報表工程重要配置檔案 finedb 表結構說明：finedb表結構
7）單點登入：前台單點登入API