1. 概述
1.1 版本
| 工程類别 | 工程版本 | JAR 包 | FineBI 與 FineReport 連接工具 |
|---|---|---|---|
| FineReport | 10.0.13 | 2021-01-25 | V1.0 |
| FineBI | 5.1.10 | 2020-02-05 |
1.2 應用場景
用戶有兩個工程，工程分開部署時，需從不同入口進入平台進行操作，用戶希望兩個工程可聯合登錄，統一門戶進行訪問。
可通過安裝「FineBI 與 FineReport 連接工具」插件來實現。
1.3 功能簡介
用戶的兩個工程有相同的用戶名，安裝「FineBI 與 FineReport 連接工具」插件，設置主服務器和從服務器後：
用戶登錄其中一個工程，可在平台點擊「切換管理平台」按鈕直接切換到另一個工程。
用戶可在主服務器的「目錄管理節點」中，添加從服務器中的模板。
2. 插件介紹
2.1 插件說明
該插件僅供超級管理員配置主從服務器，主從服務器的超管賬号需要相同；無法将配置主從服務器的權限分配給普通用戶，但普通用戶可以正常切換平台。
兩個工程需要有相同的用戶名，用戶登錄工程後，才能正常切換平台。
兩個工程，不限制是否是純 BI 或者純 FR ，也可以爲 BI&FR集成工程
兩個工程設置主從服務器時，對工程并沒有限制，可以任意搭配，例如：FR 爲主服務器，BI 爲從服務器；FR 爲主服務器，FR 爲從服務器；BI 爲主服務器，FR 爲從服務等。
不支持主服務器和從服務器爲相同工程。
從服務器需要關掉 安全防護 中的「點擊劫持攻擊防護」按鈕和「内容嗅探攻擊防護」按鈕。
從服務器無法設置單點登錄。
從服務器地址只支持：http://ip:port/webroot/decision，不支持直接用 ip 訪問的路徑。
主從服務器使用協議需相同，只能 http 切換 http ，https 切換 https，http 和 https 不能互相切換，因爲浏覽器禁止 https 頁面内生産 http 請求。
注：從服務器部署在 Tomcat 容器中，若 %Tomcat_HOME%\conf\web.xml 中禁用了 options 請求，使用該插件進行連接時将會報錯：「插件未安裝」。
2.2 安裝插件
插件下載請點擊：FineBI 與 FineReport 連接工具
設計器插件安裝方法請參見：設計器插件管理
服務器安裝插件方法請參見：服務器插件管理
2.3 新增管理系統目錄節點
安裝插件後，新增「BI&FR連接管理」目錄節點，如下圖所示：
3. 操作步驟
本文示例中，FineBI 本地工程作爲從服務器，FineReport 本地工程作爲主服務器。
3.1 前期準備
1）本文示例準備的兩個工程分别爲：
FineBI 本地工程
FineReport 本地工程
2）啓動兩個工程。
3）兩個工程都安裝了「FineBI 與 FineReport 連接工具」插件。
4）從服務器需要關閉「點擊劫持攻擊防護」按鈕和「内容嗅探攻擊防護」按鈕。如下圖所示：
5）若使用谷歌浏覽器進入平台，需要關閉 samesite 屬性，具體可參考：注意事項
3.2 配置主服務器
1）超級管理員進入數據決策系統，點擊「管理系統>BI&FR連接管理」，界面如下圖所示：
2）點擊「作爲主服務器」右側的按鈕，服務器設置完成後，點擊「測試連接并保存」，測試連接成功後，界面如下圖所示：
注：主服務器測試連接成功并保存時，會自動将本機信息及設置信息寫入到從服務器中；從服務器中所有設置項灰化，不能修改。
各設置項介紹如下表所示：
| 設置項 | 說明 |
|---|---|
| 當前服務器名稱 | 當前服務器名稱，決定「切換管理平台」按鈕中的當前服務器名稱 |
| 連接服務器地址 | 從服務器的工程路徑，格式爲：http://IP:port/工程名/decision |
| 連接服務器名稱 | 從服務器名稱，決定「切換管理平台」按鈕中的從服務器名稱 |
| AES加密KEY | 連接時傳輸 AES 加密的種子，默認值爲 16 位字符串，不可手動編輯，只能随機生成，點擊「随機生成并同步」按鈕，将同步到從服務器上 注：從服務器中沒有「随機生成并同步」按鈕 |
| 切換管理平台按鈕 | 主、從服務器同時新增該按鈕，點擊服務器名稱可切換管理平台。如下圖所示：
注：普通用戶也能看到切換管理平台按鈕 |
3.3 進入從服務器
點擊「切換管理平台」按鈕中的從服務器名稱，無需登錄将自動進入從服務器，如下圖所示：
需要注意以下幾點：
主服務器和從服務器只要有相同的用戶名（密碼不用相同），切換平台時無需輸入用戶名和密碼；切換平台時 密碼策略 不起作用。
主服務器存在 a 用戶，從服務器沒有該用戶，主服務器切換到從服務器時，将無法登錄從服務器，會提示用戶不存在。
從服務器不能配置 filter 單點攔截，否則切換平台将會失敗。
3.4 挂載從服務器模板
1）點擊「管理系統>目錄管理>添加模板（來自從服務器）」，如下圖所示：
注1：從服務器沒有「添加模板（來自從服務器）」按鈕。
注2：若從服務器爲 BI 工程，只能添加 BI 工程中的 FineReport 模板。
2）可添加從服務器中的模板，如下圖所示：
注：添加模板具體步驟請參見：添加模板
需要注意以下幾點：
模板參數類型不顯示，默認字符串類型。
主服務器中點擊「添加模板（來自從服務器）」按鈕時，模板選擇範圍由從服務器中配置的 模板認證 決定。
主服務器中，目前只有目錄管理節點可選擇從服務器模板，其他地方不能選擇。
主服務器有用戶 a ，從服務器沒有用戶 a 。主服務器添加一個從服務器不需要認證的模板，用戶 a 登錄預覽這個模板，會報錯user not exist 。
