多產品連結工具插件

1.1 版本說明

1.2 應用場景

FineBI、FineReport、FineDataLink 分開部署時，需從不同入口進入平台進行操作，使用者希望它們可聯合登入，統一門戶進行存取。

可透過安裝「多產品連結工具」插件來實現，配置好後可以直接多平台切換，如下圖所示：

2.1 插件安裝

插件下載請點選：多產品連結工具

插件安裝方法參見：插件管理

2.2 配置入口

插件安裝後平台「管理系統」下會新增一個「產品連結」入口，點進去後可以配置多平台切換。

2.3 插件說明

• 在哪個平台配置插件，那個平台就作為主伺服器，插件配置裏連結的其他平台都是從伺服器。

• 只能在 FineRpeort 或 FineBI 配置插件，也就是只有這兩個能作為主伺服器，FineDataLink 是不能作為主伺服器去配置插件的。
  

• 該插件僅供超級管理者配置主從伺服器，且主從伺服器的超管帳號需要相同，也就是這幾個平台的超管帳號要一致，密碼可以不一致。

• 無法將配置主從伺服器的權限分配給普通使用者，但普通使用者可以正常切換平台。

• 普通使用者切換時，必須保證這幾個平台裏都有該使用者的帳號，這樣使用者登入工程後，才能正常切換平台。
  

• FineReport 和 FineBI 的整合平台也可以透過插件切換，整合介紹參見文檔：BI&FR整合工程

• 插件配置時對工程並沒有限制，可以任意搭配，例如：FR 為主伺服器，BI 為從伺服器；FR 為主伺服器，FR 為從伺服器；BI 為主伺服器，FR 為從服務等等。

• 配置插件的平台作為主伺服器，不支援配置自己作為從伺服器，也就是不能自己連自己。

• 主伺服器和從伺服器需要關掉 安全防護 中的「點選劫持攻擊防護」按鈕和「內容嗅探攻擊防護」按鈕。

• 從伺服器可以設定：Ajax 跨域非同步單點登入、iframe跨域單點登入、參考 後臺單點登入 文檔設定的後臺單點登入，不支援 CAS單點登入

• 從伺服器地址只支援：http://ip:port/webroot/decision，不支援直接用  ip 存取的路徑。

• 主從伺服器使用協定需相同，只能 http 切換 http ，https 切換 https，http 和 https 不能互相切換，因為瀏覽器禁止 https 頁面內生產 http 請求。

• 主從伺服器不能跨大版本連結，必須保證都是 FineReport10.0 或 FineReport11.0 。

• 主從伺服器如果配置了 nginx 轉發，那 nginx.conf 中不要配置access-control-allow-Origin指定域，插件中已配置該項，nginx 如果再配置會導致重複，瀏覽器不允許重複配置。

• 主伺服器用 ip 存取，然後安裝插件進行主從伺服器配置，此時從伺服器中自動生成的主伺服器地址就是 ip 存取的 URL 。配置完成後，主伺服器只能用 ip 存取，然後去切換從伺服器，主伺服器不能使用域名存取再去切換從伺服器。

• 從伺服器不能配置 filter 單點攔截，否則切換平台將會失敗。

• 從伺服器不支援掛載主伺服器的範本。

本文範例中，FineReport 本地工程作為主伺服器，FineBI 本地工程和 FineDataLink 工程作為從伺服器。FineBI 作為主伺服器時同理配置即可。

3.1 前期準備

1）本文範例準備的兩個工程分別如下，且必須保證三個工程的超管帳號一致，密碼可以不同。

• FineBI 本地工程

• FineReport 本地工程

• FineDataLink 工程
  

2）啟動這三個工程，且這三個工程都安裝了「FineBI 與 FineReport 連結工具」插件。

3）從伺服器 FineBI 和 FineDataLink 需要關閉「點選劫持攻擊防護」按鈕和「內容嗅探攻擊防護」按鈕。操作如下圖所示：

4）若使用谷歌瀏覽器進入平台，需要關閉 samesite 屬性，具體可參考：谷歌瀏覽器單點登入注意事項

3.2 連結從伺服器

1）使用超級管理者帳號登入 FineReport 數據決策系統（主伺服器），點選「管理系統>產品連結」，介面如下圖所示：

2）點選「作為主伺服器」按鈕，開啟插件配置功能，彈出的設定項中依次填寫主伺服器名稱、FineBI 從伺服器連結地址、FineBI 從伺服器名稱。

填寫完後，點選右下角「測試連結並儲存」按鈕，出現“連結成功，已儲存，重新整理後生效”提示，即表示 FineBI 從伺服器連結成功，如下圖所示：

注：從伺服器地址只支援 http://ip:port/webroot/decision 格式 ，不支援直接用  ip 存取的路徑。

3）連結好的 FineBI 工程會顯示在配置介面，且右側提供了三個按鈕，可以實現再次測試連結、重新編輯配置，刪除該連結，如下圖所示：

4）再點選「新增連結伺服器」按鈕，重新整理增一個從伺服器連結，去連 FineDataLink 工程，如下圖所示：

5）連結好的兩個工程如下圖所示：

3.3 切換平台

點選 FineReport 決策系統右上角的切換按鈕，即可在幾個平台之間進行切換，如下圖所示：

注：從伺服器不能配置 filter 單點攔截，否則切換平台將會失敗。

3.4 加密說明

配置介面下方有個 AES加密KEY 功能，這個是連結時傳輸 AES 加密的種子，預設值為 16 位字串，不可手動編輯，只能隨機生成。

點選「隨機生成並同步」按鈕，將同步到從伺服器上，且只能在主伺服器生成，從伺服器未提供「隨機生成並同步」按鈕。

4.1 掛載從伺服器FR範本

如果從伺服器中有 FineReport 工程，那麼可以將該工程下的 FineReport 範本掛載到主伺服器的目錄下。具體操作方法如下：

1）點選「管理系統>目錄管理>新增範本（來自從伺服器）」，如下圖所示：

2）可新增從伺服器中的範本，新增範本具體步驟可參見文檔：新增範本

需要注意以下幾點：

• 範本參數類型不顯示，預設字串類型。
  

• 主伺服器中點選「新增範本（來自從伺服器）」按鈕時，範本選擇範圍由從伺服器中配置的 範本認證 決定。

• 主伺服器中，目前只有目錄管理節點可選擇從伺服器範本，其他地方不能選擇。

• 主伺服器有使用者 a ，從伺服器沒有使用者 a 。主伺服器新增一個從伺服器不需要認證的範本，使用者 a 登入預覽這個範本，會報錯user not exist。

• 如果要在 APP 上查看範本，必須同時更新 APP 和 H5 插件版本到 10.4.986 及之後版本才能實現。

4.2 掛載從伺服器BI儀表板

如果從伺服器有 BI 工程，那麼 2.0 及以上版本的插件可以將 BI 儀表板掛載到主伺服器的目錄上去。具體操作方法如下：

1）保證主從伺服器都是安裝的 2.0 版本以上的插件，且從伺服器必須有 BI 工程。

2）以主伺服器為 FR 為例，點選決策系統的「管理系統>目錄管理」選中某個目錄點選「BI範本（來自從伺服器）」，如下圖所示：

3）選擇 BI 伺服器下的某張儀表板，如下圖所示：

4）設定範本這一步採用預設即可，點選確定，如下圖所示：

5）回到目錄，可以看到儀表板已經掛載好了，點選可以直接查看：

掛載時需要注意兩點：

• BI 儀表板是否有權限，取決於從伺服器配置的範本認證權限，詳情參見：範本認證

• 如果從伺服器非 BI，則儀表板列表為空。

5.1 插件未安裝

問題描述：

主從伺服器都是 Tomcat 伺服器且插件都已安裝的情況下，建立連結時提示彈窗內容：「連結異常，請檢查連結伺服器是否安裝“FineBI與FineReport連結工具”插件」

解決方案

需要確認主伺服器和從伺服器的 %Tomcat_HOME%\conf\web.xml ，是否包含 <http-method>OPTIONS</http-method> 。

若包含此行命令，則刪除此行命令，重啟報表工程或 BI ，重新測試連結即可。