1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
| 11.0.6 | 1）新增次級管理者支援「資源遷移」功能。 2）超管進行「資源匯出」時「同時匯出權限配置」變更為預設不勾選。 |
1.2 應用場景
使用 FineReport 數據決策系統時，一般先在測試環境系統上進行開發部署，確認無誤後再遷移到正式系統中。
FineReport 支援將報表檔案和平台配置從測試系統增量遷移到正式系統。
1.3 功能簡介
超管登入數據決策系統，點選「管理系統>智慧維運>資源遷移」，分為「資源匯出」、「資源匯入」兩部分。
本文僅介紹遷移資源類型為「目錄」時的操作方法。
1.4 注意事項
1）資源遷移功能僅支援超級管理者，次級管理者。
2）次管在進行「資源匯出」時不支援「同時匯出權限配置」。
3）正式工程需購買「智慧維運」功能點才可使用「資源遷移」功能。
4）請確定在資源遷移程式中，沒有其他人使用超級管理者帳號，否則部分執行請求可能被取消。
5）不建議在個人 PC 端工程開發範本後，再以資源遷移的形式同步到公司工程。
因為個人 PC 端沒有管理者維護，經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗，維運成本會很高。
6）單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。
2. 準備工作
2.1 確認版本
資源遷移之前，請確定資源匯入和匯出的 FineReport 工程使用的版本一致（包括 JAR 包時間）。
管理者可在「管理系統>註冊管理>報表模組」下查看 JAR 包時間，如下圖所示：
若版本不一致，可透過升級來確定版本一致。
注：在資源匯入時，若上傳資源對應的工程和當前工程版本不一致，則無法上傳。
提示：無法匯入，即將匯入的資源需要的工程版本：XXX。當前工程版本：XXX。請確定工程版本一致！
2.2 系統備份
資源匯入前建議對測試系統和正式系統均進行 系統備份，如下圖所示：
注：備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。
3. 測試系統下資源匯出
超級管理者登入數據決策系統，選擇「管理系統>智慧維運>資源遷移>資源匯出」。
選擇資源類型為「目錄」，勾選目錄節點，選擇匯出，如下圖所示：
| 設定 | 簡介 |
|---|---|
| 資源類型 | 資源類型為目錄 可選的內容為掛載在系統目錄中的各個節點和範本。 匯出檔案（包括節點、節點設定、權限資訊）到本地，檔案名稱預設為：resource.zip。 |
| 同時匯出超連結跳轉範本 | 範本中有時存在子範本，例如儲存格子報表，超連結子報表。 如不勾選，僅匯出掛載在目錄中的範本，範本中的子報表子報表不會同時匯出，在「正式系統」中點選對應超連結/儲存格會報錯。 如勾選該選項，在匯出掛載在目錄中的範本，範本中的子報表會同時匯出，子報表中若存在下級子報表，也同時匯出，以此類推。 注：不支援網頁框子範本和js跳轉的子範本 |
| 同時匯出權限配置 | 如不勾選，範本匯入到「正式系統」中時，會繼承正式系統中父節點的權限。 如勾選該選項，範本匯出匯入時，會將「測試系統」中父節點的權限實體同時匯出匯入。 |
4. 正式系統下資源匯入
4.1 上傳檔案
超級管理者登入數據決策系統，選擇「管理系統>智慧維運>資源遷移>資源匯入」，如下圖所示：
注1：資源匯入前建議進行 系統備份，其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。
注2：單次只允許上傳單個壓縮檔案。
注3：單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。
系統會獲取匯入檔案所包含的資源，包含類型、平台路徑、物理資源、權限資訊及匯入方式。
| 設定 | 說明 |
|---|---|
| 類型 | 類型包括首頁、目錄、報表範本、報表範本子範本、上報標籤、連結 |
| 平台路徑 | 平台路徑為「匯出系統」的目錄路徑，自動建立完整路徑 |
| 物理資源 | 物理資源即為該範本在系統中實際存放的位置 |
| 權限資訊 | 點選「詳情」可查看權限資訊 其中會提示是否有部門/角色/使用者在被匯入系統中的缺失情況 |
| 匯入方式 | 在匯入時，系統會對資源進行檢查，檢查是否與系統現有資源有衝突。 衝突檢驗以資源的原始名與其在平台中的路徑名為準。 分為直接匯入和改寫匯入 直接匯入：與系統中已有資源沒有衝突，預設選中。 改寫匯入：與系統中已有資源有衝突，預設不選中且高亮，點選 |
| 衝突檢查 | 平台路徑：路徑衝突 物理資源：路徑衝突 |
4.2 匯入檔案
勾選需要上傳的資源，點選「匯入」，點選「確定」。
若匯入失敗，顯示失敗的原因（如：匯出工程和匯入工程中存在同名同路徑但是類型不同）；若匯入成功，則資源即時生效。如下圖所示：
