當前為5.1版本文檔,更多實例內容將在最新幫助文檔中展現,點選跳轉至 最新版幫助文檔

資源遷移目錄

1. 概述

1.1 版本

FineBI 版本JAR 包      新增功能
5.1
2019-01-15
-
5.12020-01-15支援將 Excel 資料集的原始 Excel 附件一起匯出
5.1.11-新增「同時匯出超連結跳轉範本」按鈕,支援將目錄子範本一起匯出
5.1.15-資源匯入時,自動檢查匯入資源與當前工程版本是否一致

1.2 應用場景

在使用數據決策系統時,往往會先使用測試環境系統進行部署開發,確定完全沒問題後再遷移至正式系統。

因此就需要從測試環境往正式環境增量遷移儀錶板、業務包等。

使用 FineBI 數據決策系統時,一般先在測試環境系統上進行開發部署,應答無誤後再遷移到正式系統中。

FineBI 支援將範本檔案和平台配置從測試系統增量遷移到正式系統。

1.3 功能簡介

超管登入數據決策系統,點選「管理系統」>「智慧維運」>「資源遷移」,分為「資源匯出」、「資源匯入」兩部分。

本文僅介紹遷移資源型別為「目錄」時的操作方法。

1658279959711958.png

1.4 注意事項

1)資源遷移功能僅超級管理者支援,即使給次級管理者分配了智慧維運的權限,也不能進行資源遷移。

2)正式工程需購買「智慧維運」功能點才可使用「資源遷移」功能。

3)請確定在資源遷移過程中,沒有其他人使用超級管理者帳號,否則部分執行請求可能被取消。

4)不建議在個人 PC 端工程開發範本後,再以資源遷移的形式同步到公司工程。

      因為個人 PC 端沒有管理者維護,經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗,維運成本會很高。

2. 準備工作

2.1 應答版本

資源遷移之前,請確定資源匯入和匯出的 FineBI 工程使用的版本一致。

管理者可在「管理系統」>「登入管理」>「版本資訊」下查看版本號,如下圖所示:

若版本不一致,可透過升級來確定版本一致,詳情參見:升級指南索引

1658280137654413.png

注:5.1.15 及之後版本的 BI 工程,在資源匯入時,若上傳資源對應的工程和當前工程版本不一致,則無法上傳。

       提示:無法匯入,即將匯入的資源需要的工程版本:XXX。當前工程版本:XXX。請確定工程版本一致!

1_1.jpg


2.2 系統備份

資源匯入前建議對測試系統和正式系統均進行 系統備份,如下圖所示:

注:備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。

1658280432313554.png

2.3 應答資料庫大小寫

若系統配置了 配置外接資料庫 ,在資源遷移前,請確定正式系統和測試系統的「資料庫預設字元校驗規則」都為「大小寫敏感」。

以 Mysql 為例:

2.3.1 進行設定

設定方式:若配置了外接資料庫,連結 FineDB 資料庫,開啟 FINE_CONF_ENTITY 表,設定字元校驗規則為 utf8_bin,輸入命令如下:

ALTER TABLE fine_conf_entity MODIFY id VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_bin; 
#設定欄的預設校驗規則
ALTER TABLE fine_conf_entity DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;  
#設定表的校驗規則

2.3.2 查看設定結果

如下圖所示:

1579240842669112.png

2.4 應答資料連結

  • 若需要進行資料連結遷移,需要在資源遷移匯入前,保證正式系統已建立好了資料連結,且該資料連結名需與測試系統一致,否則資源無法遷移成功。

  • 若遷移的是伺服器資料集建立的儀錶板,則在遷移前需要保證正式系統上建立好相同名稱的伺服器資料集。

2.5 應答使用者型別

在資源遷移過程中,需要儀錶板的建立者的使用者型別保持一致。

比如測試系統中儀錶板建立者為 BI 資料分析使用者,那麼在正式系統中也需要將其新增到 BI 資料分析使用者中。

2.6 遷移自訂地圖

若範本中呼叫了自訂地圖,需要將地圖 json 檔案copy到正式工程下。

%FineBI%/webroot/WEB-INF/assets/map/image 路徑下,將需要遷移的 json 檔案copy到正式工程對應路徑下,如下圖所示:

1658281129241430.png

3. 測試系統下資源匯出

3.1 選擇目錄

管理者登入系統後,進入「管理系統」>「智慧維運」>「資源遷移」,選擇「資源匯出」,選擇需要匯出的目錄/儀錶板,如下圖所示:

可匯出的資源有:

  • 儀錶板使用到的基礎表和自助資料集

  • 儀錶板的配置、原始名、轉義名、所屬使用者、掛載目錄、是否公共連結、分享情況等

注:並非系統下的所有儀錶板/資料都會被匯出。如不掛出儀錶板,則不存在於匯出的資源中。請務必先 掛出儀錶板 再進行操作。

1658281308770041.png

3.2 選擇依賴資源

選擇目錄後,需要選擇依賴資源。如下圖所示:

比如將某儀錶板從測試系統遷移到正式系統中,使用者 alice有查看該儀錶板及業務包的使用權限,使用者 demo 沒有,因此需要先將其資源進行匯出。

1658281468497480.png


此時會獲取該儀錶板所使用的資料表(包含基礎表和自助資料集)資源資訊。如下圖所示:

可選擇對應的資料表資源同時匯出。若正式系統已存在儀錶板需要的資料表資源,在此處可不選擇匯出。

儀錶板依賴資源支援匯出範圍有:

  • 直接使用的分析表,基礎表

  • 使用的分析表、基礎表和在聯動路徑上經過的相關表。組件間的聯動和元件對組件的過濾,匯出最短路徑中的相關表

  • 若依賴的資源來自我的自助資料集,在匯出時也可以進行選擇。後續匯入時,也將匯入到對應使用者的我的自助資料集下

1658281648574166.png

3.3 同時匯出

使用者可自行選擇是否匯出以下內容:

1658281722119577.png

匯出設定説明
同時匯出原始excel附件

若儀錶板使用到 Excel 資料集製作,可勾選同時匯出原始excel附件,直接將原始Excel 附件與儀錶板資源一起匯出,這樣在後續的匯入中不需要再重新上傳 Excel 資料集,直接隨儀錶板匯入

注:若匯出的資料表原始名(即上圖資源中資料表括號內的名稱)與正式系統中一樣,將改寫掉正式系統中的資料表,因此此處需應答好再進行匯出匯入操作。

同時匯出超連結跳轉範本

如不勾選,僅匯出掛載在目錄中的範本,範本中跳轉的子範本不會同時匯出,在「正式系統」中點選對應超連結會報錯。

如勾選該選項,匯出掛載在目錄中的範本時,範本中跳轉的子範本會同時匯出,子範本中若存在下級子範本,也同時匯出,以此類推。

匯出權限配置

匯出權限配置會匯出該儀表闆對應的權限配置,包含 目錄權限 及對應的 業務包權限 。在後續匯入後,該儀表闆對應的權限設定則不會發生變化。

匯出後會生成 resources.zip 檔案,如下圖所示:

222


4. 正式系統下資源匯入

4.1 上傳檔案

超級管理者登入數據決策系統,選擇「管理系統」>「智慧維運」>「資源遷移」>「資源匯入」,如下圖所示:

注1:資源匯入前建議進行 系統備份,其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。

注2:單次只允許上傳單個壓縮檔案。

1658282653435745.png

系統會獲取匯入檔案所包含的資源,包含型別、平台路徑、物理資源、權限訊息及匯入方式。

1658282773424972.png

設定
説明
型別

型別包括首頁、目錄、BI範本、BI資料表、BI範本子範本、報表範本、報表範本子範本、上報標籤、連結

平台路徑平台路徑為「匯出系統」的目錄路徑,自動建立完整路徑
物理資源物理資源即為該範本/表在系統中實際存放的位置
權限訊息

點選「詳情」可查看權限資訊

其中會提示是否有部門/角色/使用者在被匯入系統中的缺失情況

匯入方式

在匯入時,系統會對資源進行檢查,檢查是否與系統現有資源有衝突。

衝突檢驗以資源的原始名與其在平台中的路徑名為準。

分為直接匯入和改寫匯入

直接匯入:與系統中已有資源沒有衝突,預設選中。

改寫匯入:與系統中已有資源有衝突,預設不選中且高亮,點選按鈕可以查看到詳細說明

注:匯入資料表的表名和被匯入工程中原有的資料表表名不同,匯入後卻提示表衝突需要改寫匯入。此時需要判斷匯入前後資料表建立表時的表名是否相同。

例:資源匯出工程 1 中的表建立時名稱叫自助資料集 1 ,後來改成了表 A  ;資源匯入的時候會跟被匯入工程中的自助資料集1衝突。

衝突檢查

在匯入時,系統會對資源進行檢查,檢查是否與系統現有資源有衝突,衝突檢驗以資源的原始名為準。

平台路徑:路徑衝突

物理資源:路徑衝突

注:匯入資料表的表名和被入工程中原有的資料表表名不同,入後卻提示表衝突需要改寫入。此時需要判斷入前後資料表建立表時的表名是否相同。

例:資源出時,表建立時名稱叫「分析表 1」 ,後來改成了「網際網絡分析渠道統計資料」 。資源入時,會跟被入工程中的「分析表 1」衝突。如下圖所示:

1658283307102417.png

4.2 匯入檔案

勾選需要上傳的資源,點選「匯入」,點選「確定」。如下圖所示:

1658283411190408.png

若匯入失敗,顯示失敗的原因(如:匯出工程和匯入工程中存在同名同路徑但是型別不同);

若匯入成功,則資源即時生效。如下圖所示:

1658283566320621.png

注:由於對應的環境配置不同 IP 埠號會改變,資源遷移後的儀錶板公共連結需要重新進行連結分享。

4.3 資料更新

若遷入的基礎表資源為「抽取資料」,匯入到新的系統中需要先進行資料更新,才能正常查看對應的儀錶板。

在對應業務包下進行 資料更新 ,或者直接進行 全局更新 。更新後則能看到匯入的資料表均正常顯示,如下圖所示:

注1:2020-01-15 之前的版本,若儀錶板使用的是 Excel 資料,需要進入到資源使用的資料業務包中,在對應資料表下選擇更新 Excel,並將源資料的 Excel 表重新上傳並更新。

注2:若匯入資料表為 Excel 資料集或者以 Excel 資料集為基礎表製作的自助資料集,則必須進行業務包更新或者全局更新。

         若匯入的資料表為資料庫表或者 SQL 資料集,則可以對匯入的表進行單表更新。

1658283864658187.png

如不進行資料更新操作,預覽相關儀錶板時,會提示「當前組件用到的自助資料集異常,無法正常顯示」。


附件列表


主題: 管理员指南
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 评价文档,奖励 1 ~ 100 随机 F 豆!