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

FineBI与FineReport连接工具插件

1. 概述

1.1 版本說明

插件版本版本依賴功能變動
V1.0

FineRpeort 版本:11.0

FineBI 版本:5.1.10

App 版本:10.4.986

HTML5 移動端展現插件版本:10.4.986

-
V2.0

FineRpeort 版本:11.0.4

FineBI 版本:5.1.22

App 版本:10.4.986

HTML5 移動端展現插件版本:10.4.986

主服務器可挂載 BI 模板,詳情參見本文 3.5 節

1.2 應用場景

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

可透過安裝「FineBI 與 FineReport 連結工具」插件來實現,配置好後可以直接多平台切換,如下圖所示:

2. 插件介紹

2.1 插件安裝

插件下載請點選:FineBI 與 FineReport 連結工具

伺服器安裝插件方法請參見:伺服器插件管理

設計器安裝插件方法請參見:設計器插件管理

2.2 配置入口

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

2.3 插件說明

  • 該插件僅供超級管理者配置主從伺服器,主從伺服器的超管帳號需要相同;無法將配置主從伺服器的權限分配給普通使用者,但普通使用者可以正常切換平台。

  • 兩個工程需要有相同的帳號,使用者登入工程後,才能正常切換平台。

  • 兩個工程,不限制是否是純 BI 或者純 FR ,也可以為 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 存取,然後去切換從伺服器,主伺服器不能使用域名存取再去切換從伺服器。

3. 操作步驟

本文範例中,FineBI 本地工程作為從伺服器,FineReport 本地工程作為主伺服器。

3.1 前期準備

1)本文範例準備的兩個工程分別為:FineBI 本地工程和FineReport 本地工程

2)啟動兩個工程。

3)兩個工程都安裝了【FineBI 與 FineReport 連結工具】插件。

4)從伺服器需要關閉【點選劫持攻擊防護】按鈕和【內容嗅探攻擊防護】按鈕。如下圖所示。

5)若使用谷歌瀏覽器進入平台,需要關閉 samesite 屬性,具體可參考:谷歌瀏覽器單點登入注意事項

3.2 連結從伺服器

1)超級管理者進入數據決策系統,點選管理系統 > BI&FR連結管理,介面如圖所示。

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

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

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

注:主伺服器測試連結成功並儲存時,會自動將本機資訊及設定資訊寫入到從伺服器中;從伺服器中所有設定項灰化,不能修改。

3.3 切換平台

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

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

1)點選【切換管理平台】按鈕中的從伺服器名稱,無需登入將自動進入從伺服器,如下圖所示。

2)主伺服器和從伺服器只要有相同的帳號(密碼不用相同),切換平台時無需輸入帳號和密碼;切換平台時 密碼策略 不起作用。

3)主伺服器存在 a 使用者,從伺服器沒有該使用者,主伺服器切換到從伺服器時,將無法登入從伺服器,會提示使用者不存在。 

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

3.4 加密說明

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

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

4. 掛載範本

4.1 掛載從伺服器FR範本

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

1)點選「管理系統>目錄管理>新增範本(來自從伺服器)」,如下圖所示:

2)可新增從伺服器中的範本,新增範本具體步驟可參見文檔:新增範本

注1:從伺服器沒有【新增範本(來自從伺服器)】按鈕。。

注2:若從伺服器為 BI 工程,只能新增 BI 工程中的 FineReport 範本。

需要注意以下幾點:

  • 範本參數型別不顯示,預設字串型別。

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

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

  • 主伺服器有使用者 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. 注意事項

5.1 插件未安裝

問題描述

主從伺服器都是 Tomcat 伺服器且插件都已安裝的情況下,建立連結時提示彈窗內容:插件未安裝

解決方案

應答 %Tomcat_HOME%\conf\web.xml ,是否包含 <http-method>OPTIONS</http-method> ,若包含此行命令,則刪除此行命令,重啓報表工程或 BI ,重新測試連結即可。

附件列表


主題: 部署集成
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 评价文档,奖励 1 ~ 100 随机 F 豆!