D10-02 FineBI與FineReport連結工具插件

1

版本。

2

應用場景。

1. 使用者有兩個工程，工程分開部署時，需從不同入口進入平台進行操作，使用者希望兩個工程可聯合登入，統一門戶進行存取。

2. 可透過安裝【FineBI 與 FineReport 連結工具】插件來實現。

3

功能簡介。

1. 使用者的兩個工程有相同的帳號，安裝【FineBI 與 FineReport 連結工具】插件，設定主伺服器和從伺服器。

2. 使用者登入其中一個工程，可在平台點選【切換管理平台】按鈕直接切換到另一個工程。
   

3. 使用者可在主伺服器的【目錄管理節點】中，新增從伺服器中的範本。
   

1

插件說明。

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

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

3. 兩個工程，不限制是否是純 BI 或者純 FR ，也可以為 BI&FR整合工程。

4. 兩個工程設定主從伺服器時，對工程並沒有限制，可以任意搭配，例如：FR 為主伺服器，BI 為從伺服器；FR 為主伺服器，FR 為從伺服器；BI 為主伺服器，FR 為從服務等。

5. 不支援伺服器自己連自己。

6. 從伺服器需要關掉 安全防護 中的【點選劫持攻擊防護】按鈕和【內容嗅探攻擊防護】按鈕。

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

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

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

10. 主從伺服器不能是 FineReport10.0 和 FineReport11.0 。

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

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

2

安裝插件。

1. 插件下載請點選：FineBI 與 FineReport 連結工具。

2. 伺服器安裝插件方法請參見：A11-18 伺服器-插件管理。

3

新增管理系統目錄節點。

1. 安裝插件後，新增【BI&FR連結管理】目錄節點，如下圖所示。

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

1

前期準備。

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

2. 啟動兩個工程。

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

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

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

2

配置主伺服器。

1. 超級管理者進入數據決策系統，點選【管理系統】→【BI&FR連結管理】，介面如圖1所示。

2. 點選【作為主伺服器】右側的按鈕，伺服器設定完成後，點選【測試連結並儲存】，測試連結成功後，介面如圖2所示。

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

1. 各設定項介紹如下表所示。

3

進入從伺服器。

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

2. 主伺服器和從伺服器只要有相同的帳號（密碼不用相同），切換平台時無需輸入帳號和密碼；切換平台時 密碼策略 不起作用。

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

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

4

掛載從伺服器範本。

1. 點選【管理系統】→【目錄管理】→【新增範本（來自從伺服器）】，如圖1所示。

2. 可新增從伺服器中的範本，如圖2所示。

注1：從伺服器沒有【新增範本（來自從伺服器）】按鈕。。

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

注3：新增範本具體步驟請參見：新增範本。

1. 範本參數型別不顯示，預設字串型別。

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

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

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

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

1

插件未安裝。

1. 問題描述：從伺服器部署在 Tomcat 容器中時，使用該插件進行連結時會報錯：【插件未安裝】，前臺排查顯示如下圖所示。

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