1. 概述
在 FineBI 中，管理者角色分為系統的超級管理者與次級管理者，其角色和對應職責如下所示：
| 管理者型別 | 管理範圍 | 描述 |
|---|---|---|
| 超級管理者 | 數據決策系統 | 即 初始化設定 時的使用者，通常為企業 IT 人員，負責統籌整個系統的工作，配置系統人員、角色、權限等 |
| 次級管理者 | 子資料/系統項 | 通常為企業下屬分公司的管理者，由超級管理者下放一定的權限，管理本分公司/部門範圍內的資料、人員、角色、權限等 |
超級管理者可將系統的部分權限根據需求分配給次級管理者，比如分配部門業務包權限給對應部門次級管理者，次級管理者自己對本部門的業務/分析人員進行權限分配，減少總部 IT 人員的工作量，及以 IT 為主導的溝通量。
本文將介紹管理者需要掌握的相關功能知識。
2. 資料準備
2.1資料連結管理
進行資料分析前，由管理者（一般為 IT 人員）準備好資料，即定義資料連結。
2.1.1 建立資料連結
進入管理系統>資料連結>資料連結管理，可以看到建立資料連結和已經建立的資料連結，點選建立資料連結，如下圖所示：
2.1.2 輸入資料連結資訊
詳情請參見：配置資料連結
注：資料連結名不能輕易修改，更改後資料庫表會因為找不到資料庫而報錯，因此需要提前規劃好資料連結名稱。更改資料連結名後，SQL 資料集需要重新選擇資料連結，儘量用 SQL 新增基礎表而不是資料庫表。
2.2 業務包和分組管理
管理者制定搭建業務包及分組的模式，儘量規範命名，有助於使用者的使用，比如可以按照基礎表，部門等進行劃分。
2.2.1 建立業務包和分組
詳情請參見：業務包管理
FineBI 的業務包是 BI 分析的資料基礎，由管理者建立並將資料庫中的表新增進去，以供分析人員使用。為方便對資料進行調理的管理，FineBI 提供了建立不同分組，不同分組下建立對應型別的業務包，並在每個業務包下新增相應的分析表的功能。
進入資料準備介面，點選新增分組可在資料列表下建立新的分組，點選新增業務包即可在對應分組下建立新的業務包，如下圖所示：
2.2.2 管理業務包
管理者可以對業務包進行重命名、刪除、移動等操作，
1）重命名如下圖所示：
2）移動銷售DEMO業務包至行業資料分組下，如下圖所示：
3）刪除業務包如下圖所示：
2.3 新增資料表
在這些業務包中新增對應的表。
詳情請參見：新增資料表
注：資料庫表、SQL資料、EXCEL 資料集是企業原有的資料源。
自助資料集是對以上三種包括自身的表進行資料的處理和合並等操作，幫助不會寫 SQL 的業務人員進行表的處理合並。
自助資料集相關操作請參見：自助資料集（資料處理使用者）
2.4 表的取數方式
2.4.1 實時資料
實時資料為 FineBI 提供了直連資料庫取數的方式，在基礎表為實時資料以後，該表將不再需要將資料更新到本地，直接連結資料庫透過 SQL 取數，獲取的都為即時資料。
詳情參見：實時資料
實時資料注意事項：
實時資料不建議做自助資料集。推薦抽取資料，將資料更新到本地。
實時資料儘量使用 SQL 資料集的方式，減少實時資料使用自助資料集處理資料的場景。
2.4.2 抽取資料
FineBI 的資料更新是指將資料庫中的資料抽取到引擎儲存，本地模式使用本地磁碟儲存。儲存路徑為：%FineBI\bin\ROOT\db。
| 現象 | 注意結果 |
|---|---|
| 表 A 來自於資料庫表，自助資料集來自於 A 。修改資料庫的表的欄位名 | 更新表 A 會報錯，表異常標紅，編輯表 A 後更新 A ，A 可以更新成功。 自助資料集更新不會成功，需要手動調整自助資料集的欄位 |
| 分析表 B 來自於基礎表 A ，基礎表 A 更新後，編輯取消某個欄位，不更新 | 分析表 B 更新，可以正常更新。因為 A 未更新，配置未變化。編輯 B ，會提示沒有勾選的欄位沒有權限—因為權限是從 A 那實時獲取的 |
| 分析表的更新資訊 | 顯示的是基礎表更新的資訊，更新進度顯示的是當前更新後的情況 |
| 表編輯介面欄位型別的獲取 | 儲存一次之後，就不會再去獲取資料庫中的欄位型別 |
| 上傳 Excel | 臨時檔案是儲存到安裝路徑的：%FineBI\webapps\webroot\WEB-INF\assets\temp_attach資料夾下，該檔案不能刪除 |
| 表 A 更新後，資料庫中新增欄位 | 表編輯介面可以看到新增的欄位，預設不勾選；不需要單表更新。勾選後，需要單表更新才能獲取到對應的資料 |
| 自動轉義 | 只能在透過業務包/資料庫且第一次新增表的時候自動獲取；轉義透過獲取資料中的表名和欄位名的註釋來實現 |
| 基礎表更新成功，但是聯動更新失敗 | 不會傳送更新失敗的訊息通知 |
| 基礎表更新成功，但是分析表更新失敗 | 會傳送更新失敗的訊息提示 |
| 刪除表或者聯動 | 只有更新後，對應的資料儲存檔案才會被刪除 |
| 定時更新，設定簡單重複執行，每隔一天 | 是指每隔24小時執行。如果真的需要隔一天再更新，那需要設定為每隔兩天（48小時） |
| 分析表的基礎表，全部更新失敗 | 則對應的分析表此次不會觸發更新。全局更新介面會顯示更新失敗 |
| 增量更新 | 增量sql不能為空 |
| 系統管理中，週開始日期改變 | 重啓之後會觸發全局更新 |
| 建議時間相近的表放到一起更新 | 只要一起更新，會自動去重，不會出現重複更新的問題 |
| 儘量採用全局更新，每天晚上更新一次的方式 | |
| 每次更新的時間間隔越遠越好 | 更新量比較小( 根據其背後的表 )的話，可以在1小時，如果更新量比較大，就要幾個小時才更新一次，或者按天夜間更新 |
2.5 手動建立表間聯動
2.5.1 概念介紹
通常資料庫的表與表之間存在聯動關係，將資料庫表新增到業務包的過程中，系統會自動讀取表間聯動；沒有聯動關係的，可以手動建立表間聯動關係。
詳情參見：聯動檢視表
2.5.2 設定規則
1）1 端欄位中的資料值不允許有重複值或者空值。
2）儘量減少使用 1:1 聯動，可以用 1:N 或者 N:1 代替。
3）「我的自助資料集」分組下所有的表都不支援建立聯動。
4）聯合聯動左右欄位一一對應。
5）配置完欄位聯動後，若選擇抽取資料，需要點選更新資訊>單表更新進行該表的更新操作，抽取資料儲存到本地才能使用。
3. 管理系統
3.1 目錄管理
支援對範本的批量增加刪除等操作，支援對首頁的設定。
詳情參見：目錄管理
3.1.1 設定介面
點選管理系統>目錄管理，設定介面如下圖所示：
3.1.2 注意事項
1）系統首頁預設所有部門的使用者都能看到。
2）置 BI 範本顯示為首頁，則該範本在首頁將自動隱藏儀表板上方的另存為和匯出的按鈕。
3）形式可以是相對路徑或者絕對路徑，絕對路徑需要新增http:// 。
3.2 使用者管理
詳情參見：使用者管理
3.2.1 新增使用者
1）手動新增使用者
進入管理系統>使用者管理，支援手動新增使用者和批量匯入使用者，手動新增方式為：點選「新增使用者」（比如使用者 a ），輸入使用者資訊，點選確定，該使用者即被新增，如下圖所示：
2）同步使用者資料集
詳情參見：使用者同步資料集
進入管理系統>使用者管理，點選使用者同步，選擇使用者來源，輸入對應使用者資訊表等，點選確定，如下圖所示：
注意事項：
| 內容 | 解譯 |
|---|---|
| 同步使用者建議一開始就選好 | 兩種使用者不同的模式，使用者做的表和分析的儀表板，不通用，即使是一樣的帳號密碼職位等 |
| 對於手動新增使用者中的匯入伺服器資料中的使用者資訊 | 開啓了資料集同步後，使用者資訊將跟隨資料集同步，動態改變、實時更新，即若資料庫資訊改變後，決策系統中的使用者資訊也會隨之改變 |
| FineBI支撐多使用者來源 | 在使用者同步資料集時並不會清空原先的資料，若同步的使用者資料與原先內建有衝突，將不會顯示 |
| 同步使用者集同步設定完成後要重新登入 | 原因是切換了登入的方式，原先的登入資料需要清除，如果不重新登入會產生很多無法估計的錯誤，比如多人登入時由於登入方式切換，各種參數的儲存位置會發生混亂等 |
| 使用者資料集所有使用者及機構部門都是從資料庫自動生成的 | 不能進行修改 |
3.2.2 管理使用者
手動新增的使用者可以編輯、禁用和刪除使用者，同步進來的使用者可禁用。如下圖所示：
3.2.3 機構部門、角色新增
1）機構部門
點選管理系統>使用者管理>機構部門，新增部門和職務，並對應新增使用者，如下圖所示：
2）角色
注：部門可以分級，角色不能分級。
3.2.4 平台使用使用者
為了限制查看與編輯的併發量及做分析時的資料量，加快計算和展示的速度，需將使用者進行型別劃分——查看使用者和設計使用者（包括分析使用者和處理使用者），處理使用者的權限高於分析使用者，具備配置聯動和新增資料庫表的權限。
兩者的異同請參見：BI設計使用者
1）設定介面
進入管理系統>使用者管理>平台使用使用者，選擇BI使用使用者，如下圖所示：
2）注意事項
一個使用者只能被新增到 BI 查看使用者、BI 資料處理使用者或者BI資料分析使用者中的一個，使用者新增到 BI 設計使用者中預設會擁有查看的權限。超級管理者預設為資料處理使用者。
注冊檔案為不限制使用者數，則在平台使用使用者中需要先開啓限制使用使用者，否則預設所有的使用者均有平台使用、BI查看、BI設計及行動平台權限。
3.3 權限管理
管理者在管理系統>權限管理中對各使用者的權限範圍進行管理，使用者可以且僅能存取被授予權限的內容。
詳情參見：權限管理
權限管理介面如下圖所示：
3.3.1 管理系統
分配對應節點權限，使用者能夠看到管理系統中的對應節點。
3.3.2 業務包權限
可以將 IT 準備的基礎業務包分配給使用者，並建為使用者所在部門或者業務線建立業務包分組，為初期的業務分析建立環境。
詳情參見：業務包權限管理
1）權限配置頁面如下圖所示：
2）注意事項
| 權限配置注意事項 |
|---|
| 在配置完目錄的查看權限後，需配置目錄儀表板對應業務包的使用權限，否則會報錯沒有資料查看權限 |
開啟業務包某個分組的管理權限，使用者可對此業務包分組下建業務包，對此業務包分組進行重命名和刪除； 開啟業務包的管理權限，使用者能夠對此業務包及業務包內的表進行編輯，重命名，移動，刪除，並且能夠建立表 |
| 只有超管可以新增業務包分組 |
| 權限設定可進行對錶的行列權限進行設定 |
| 部門和角色分配的權限是並集關係 |
3.3.3 資料連結權限
使用者擁有對資料連結使用、管理和授權的權限。詳情參見：資料連結控制
注：開啟資料連結控制權限需要在全局設定下開啟分級授權和資料連結控制按鈕。
1）配置介面如下圖所示：
2）權限說明
使用權限：擁有某資料連結的使用權限，使用者登入後可在資料準備>業務包中使用該資料連結新增資料。
管理權限：擁有某資料連結的管理權限，使用者登入後可在管理系統>資料連結下，對該資料連結進行編輯、複製、修改、刪除等操作。
授權權限：擁有某資料連結的授權權限，使用者登入後可在管理系統>權限管理>資料連結中，將該資料連結的相應權限分配給可管理的使用者。
3.3.4 儀表板權限控制
提供功能可以對使用者是否有分享權限，以及可分享給哪些部門角色進行權限控制。避免使用者將範本隨便進行分享，或者分享給不合適的使用者。
詳情參見：儀表板分享權限 。
2020-01-15版本的 BI 提供公共連結的權限控制，可以按照部門角色使用者設定哪些人可以設定公共連結。
詳情參見：公共連結權限 。
設定介面如下圖所示：
3.4 範本管理
管理系統的範本管理下顯示的是當前系統中的所有普通使用者建立的範本，申請掛出的範本也在其中，管理者可快速掛出。
詳情參見：範本管理
3.5 注冊管理
注冊管理用於查看當前數據決策系統的一些版本資訊以及購買的功能列表。
詳情參見：注冊管理
3.6 智慧維運
3.6.1 記憶體管理
詳情參見：記憶體管理
當點開沒有面積圖，可能是 Websocket 埠4 8888 沒開或者沒轉發。影響登入時常等，建議開啓。詳情參見：Websocket 埠被佔用/無法使用
3.6.2 備份還原
FineBI 提供了備份還原的功能，支援備份內容如下表所示：
| 資料夾 | 備份內容 |
|---|---|
| config | 平台配置資訊 |
| reportlets | 報表範本 |
| dashboards | BI 範本 |
| jar | JAR包 |
| plugins | 插件 |
詳情參見：備份還原
進入管理系統>智慧維運>備份還原，如下圖所示：
| 備份還原注意事項 |
|---|
| 平台資料庫為內建資料庫時，不支援備份還原功能，若需使用備份還原功能請配置外接資料庫 |
| 還原後，還原版本消失，當前版本自動備份 |
| 還原需謹慎，還原會丟失還原前後這段之間所做的資料集或範本 |
| 還原前確定自己想還原的部分，平台配置只能還原配置資訊，範本不還原，啟動後會報錯範本資訊丟失 |
| 整體工程的還原步驟一般為：平台配置和 webroot 都進行還原 |
| 請日常定期手動備份工程：webroot |
3.6.3 平台日誌
對系統的各項情況進行監視
詳情參見：平台日誌
4. 日常維運
4.1 BI系統部署情況
詳情參見：FineBI安裝與啟動 、FineBI伺服器配置推薦
應知應會：伺服器系統(linux/win)/伺服器記憶體/伺服器cpu核數/磁碟大小，BI安裝路徑/BI記憶體(%/bin/finebi.vmoptions)/資料儲存路徑/是否外接資料庫/使用者並數，資料庫型別/資料庫效能/資料量/併發
4.1.1 Linux 中啟動 BI
詳情參見：Linux 中啟動 FineBI
1）啟動
切換到 BI 安裝路徑下，如安裝在 opt 目錄下的，命令如下所示：
cd /opt/FineBI/bin
直接執行啟動命令，如下所示：
nohup ./finebi &
2）重啓
使用命令來查看 JAVA 進程對應的 PID ，命令如下所示：
ps -ef | grep finebi
使用命令將該進程殺掉，FineBI 服務即關閉，如下所示：
kill -9 13807
隨後參考上述進入 FineBI 目錄中，使用命令 nohup ./finebi &啟動即可。
啟動成功後，就可以在瀏覽器中輸入位址http://IP:37799/webroot/decision存取了。
注：其中 IP 為對應安裝伺服器的 IP 。若外網存取不了，可藉助第三方工具：例如花生殼、fcn、frp 等實現內網穿透。
4.1.2 平台外接資料庫
詳情參見：配置外接資料庫
外接資料庫 FAQ
| 問題 | 回答 |
|---|---|
配置外接資料庫的原因 | HSQL 是FineBI內建資料庫，但由於 HSQL 不能多執行緒存取、資料量大後不穩定等原因，導致碰到叢集或者資料量比較大時，必須要遷移才能保證系統的穩定性。透過配置外接資料庫，可將內建系統配置等資料遷移至外接的資料庫，保證系統使用的效能 |
內外接資料庫存的資料跟企業自己的存業務生產資料庫有什麼聯絡？內外接資料庫會儲存業務生產庫的資料麼？ | 內外接資料庫存的是系統的使用配置，比如在BI系統中新增一張表，內外接資料庫中只儲存表名，欄位名，聯動關係及建立者資訊等，不存實際的資料值。 企業自己的存業務生產資料庫會透過建資料連結來取數 |
| 內建和外接資料庫，只能選一種麼？ | 是的，選內建，系統的使用配置資訊就存在安裝路徑下的%FineBI%\webroot\WEB-INF\embed\finedb。選擇外接資料庫，配置好連結資訊成功匯入後，就存在資料庫表中 |
| 如何判斷是否外遷？ | 查看管理系統>系統管理>標準>外接資料庫是否顯示已配置，若已配置可以點進去可以看到外遷的資料庫。 |
或者查看%FineBI%\webapps\webroot\WEB-INF\config下的db.properties，如果有就說明已經外遷。以SQL server為例，可以看到資料庫 URL 模式、帳號、密碼是加密的 |
4.2 FineBI工程目錄結構
詳情參見：FineBI工程目錄結構
| 檔案 | 存放內容 |
|---|---|
| backup | 存放工程備份的資訊 |
| %FineBI%\webapps\webroot\WEB-INF | BI工程主目錄；工程備份的資料夾 |
| Web組件.html | 這是一個 Web 組件，寫入的超連結位址即可。比如這是一個自訂的 HTML 檔案，內建在工程內部%FineBI%/webroot/這個目錄之下 |
| %FineBI%\webapps\webroot\WEB-INF\dashboards | BI 範本儲存資料夾 |
| %FineBI%\webapps\webroot\WEB-INF\embed | 內建資料庫配置目錄；可外遷 |
| %FineBI%\webapps\webroot\WEB-INF\config | 系統參數，外遷資料庫資訊 |
| %FineBI%\webapps\webroot\WEB-INF\lib | BI工程依賴的 JAR 包資料夾 |
4.3 報錯日誌
詳情參見：日誌類別
4.3.1 調整日誌級別
點選管理系統>智慧維運>平台日誌，選擇全局設定，點選系統日誌級別下拉框進行調整，如下圖所示：
注：日常將日誌級別調到 INFO 。
4.3.2 日誌儲存位置
日誌路徑在%FineBI5.1%\logs下按天儲存。如下圖所示：
4.3.3 更新報錯日誌關鍵詞
| 功能 | 關鍵詞 | 備註 |
|---|---|---|
表開始執行 | table load start 資料集名: {} | 建議直接搜資料集名+錶轉義名來搜 |
表執行成功 | table load success 資料集名: {} | |
表執行失敗 | table load fail 資料集名: {} | 補充一般表失敗，透過搜相同執行緒名稱，往上看一般可以看到拋的異常是什麼，用來進一步分析 |
全局更新成功 | global Load finish! |
4.4 系統參數說明
詳情參見：標準參數 、BI/Spider參數
| 參數 | 說明 |
|---|---|
| 資料存取量 | 設定預覽時存取資料庫的資料量 |
| 快取設定 | 開啓關閉快取 |
| 快取時間(秒) | 快取時單位秒，設定成0，表示快取始終生效，實時資料會一直讀取快取，不會生成新的快取 |
| 分析使用者自助資料集磁碟佔用大小（儲存格） | 預設值：50,000,000； 參數說明：快速分析生成過程中支援的最大儲存格數量，超出則生成失敗 |
4.5 系統升級策略
4.5.1 同版本升級
詳情參見：5.1升級指南
升級 JAR 包流程如下所示：
外接資料庫務必先進入管理系統->智慧維運→備份還原，手動做下平台備份。
1）linux下升級 JAR 包的操作方式
| 步驟 | 內容 |
|---|---|
| 1 | 關閉 BI 服務 進入目錄%FineBI%/bin/ 查進程號：ps -ef | grep FineBI 殺死進程：kill -9 ****（進程號） |
| 2 | 備份 WEB-INF 資料夾 |
| 3 | 把壓縮包解壓 |
| 4 | JAR 包更換到%FineBI%\webapps\webroot\WEB-INF\lib資料夾下 |
| 5 | 重啓 BI ，執行命令：nohup ./FineBI & |
2）Windows下升級 JAR 包的操作方式
| 步驟 | 內容 |
|---|---|
| 1 | 關閉 BI 服務 |
| 2 | 備份 WEB-INF 資料夾 |
| 3 | 把壓縮包解壓 |
| 4 | JAR 包更換到%FineBI%\webapps\webroot\WEB-INF\lib資料夾下 |
| 5 | 重啓 BI |
4.5.2 不同版本升級
詳情參見：5.1.x 升級指南
注：升級務必聯絡技術支援。
5. 當機相關
詳情參見：BI當機問題排查步驟