［App］配置服務器訪問報表/工程

1.1 版本

1.2 應用場景

用戶可在數據分析 App 中，預覽 FineReport 設計器中制作的單張模板。

用戶可在數據分析 App 中，配置自己的服務器，浏覽整個報表工程。

1.3 功能描述

打開數據分析 App，點擊登錄界面左下角的服務器按鈕，即可進入服務器列表，如下圖所示：

數據分析 App 中，内置了 FineReport 和 FineBI Demo 服務器，用戶可預覽示例模板，了解帆軟産品功能。

用戶可在數據分析 App 中，切換、修改、新增、删除自有服務器。

本章将主要講解如何在數據分析 App 中加載自有報表服務器，浏覽整個工程。

2.1 PC 端配置

2.1.1 環境确認

将 PC 設備與移動設備切換至同一網絡環境下。有三種方法：

1）手機給電腦開熱點

2）手機和電腦連接同一熱點

3）給服務器配置外網可連接的環境

注：爲防止電腦 IP 未切換到無線網絡的 IP，請拔掉有線網。

2.1.2 平台配置二維碼

管理員登錄數據決策系統，點擊管理系統>移動平台>二維碼配置，輸入服務器名稱和服務器地址，點擊生成二維碼，即可在二維碼方框中生成一個二維碼。如下圖所示：

注1：登錄數據決策系統的步驟請參見：決策系統簡介

注2：服務器地址格式爲：http://ip:端口号/工程名/decision，其中的 IP 和端口号需與實際網絡環境一緻。

2.1.3 配置賬号密碼

如需在移動端訪問模板，需要擁有一個數據決策系統的賬号密碼，具體設置方式請參見：決策系統簡介

初始化成功後，本文以 FineReport 設計器内置用戶 Alice 爲例，其賬号和密碼分别爲：Alice，123456。

2.2 App 配置服務器

注：App 下載及安裝請參考：App 使用

APP 下載 安裝後，打開數據分析 App，點擊服務器>新建服務器，掃描 2.1.2 節配置的二維碼。

确認服務器信息，點擊右上角√号，即可在服務器列表新增該工程，自動跳轉到登錄頁。如下圖所示：

注1：用戶可掃描相冊中保存的二維碼。

注2：用戶可手動輸入服務器信息，服務器地址爲：http://ip:端口号/工程名/decision 。

注3：爲提升安全性，用戶希望客戶端與服務器通信時數據進行加密。若服務器已使用 https SSL 加密，App 添加服務器時也支持 https 協議。

2.3 App 登錄服務器

在登錄頁輸入管理員的賬号和密碼，即可進入該工程移動端首頁，如下圖所示：

注1：若輸入 FineReport 内置的用戶賬号和密碼（非管理員），需要爲該用戶分配查看目錄的權限，詳情請參見：根據用戶分配權限

注2：FineReport10.0 平台采用了 AccessToken 驗證，勾選自動登錄後，AccessToken 有效期爲 14 天，超過 14 天需要重新登錄。

本章将主要講解如何在數據分析 App 中訪問單張模板，以方便制作者調整模板效果。

3.1 PC 端配置

3.1.1 平台配置賬号密碼

如需在移動端訪問模板，需要擁有一個數據決策系統的賬号密碼，具體設置方式請參見：決策系統簡介

初始化成功後，本文以 FineReport 設計器内置用戶 Alice 爲例，其賬号和密碼分别爲：Alice，123456。

3.1.2 環境準備

将 PC 設備與移動設備切換至同一網絡環境下。有兩種方法：

1）手機給電腦開熱點

2）手機和電腦連接同一熱點

注：爲防止電腦 IP 未切換到無線網絡的 IP，請拔掉有線網。

3.1.3 模板預覽

1）在設計器中打開模板： %FR_HOME%\webapps\webroot\WEB-INF\reportlets\demo\phone\basic\産品明細-phone.cpt

點擊移動端預覽，如下圖所示：

2）點擊移動端預覽後，PC 端浏覽器顯示頁面如下圖所示：

3.2 App 配置服務器

注：App 下載及安裝請參考：App 使用

打開 App，點擊服務器>新建服務器，直接掃描本文3.1.3 節中生成的二維碼，如下圖所示：

注1：若服務器列表中有當前模板鏈接的服務器地址，跳轉至已有服務器登錄界面。

注2：若存在多個不同名稱的相同服務器則選擇第一個。

3.3 App 登錄服務器

點擊「新建服務器」右上角符号，确認新建服務器信息；在 App 登錄頁輸入用戶名和密碼。

App 登錄成功後，即可跳轉到模板頁面，效果如下圖所示：

注1：FineReport10.0 平台采用了 AccessToken 驗證，勾選自動登錄後，AccessToken 有效期爲 14 天，超過 14 天需要重新登錄。

注2：若開啓了 模板權限 ，則判斷登錄用戶是否有權限訪問，若沒有則彈出「沒有權限」的提示。  

内置的 Demo 服務器不支持編輯，右邊沒有編輯按鈕。

用戶添加的服務器提供編輯，點擊右邊的編輯按鈕，進入手動編輯服務器界面，其他操作與添加服務器一緻，如下圖所示：

1）内置的 FineReport 服務器以及自己添加的服務器，都可以删除

2）手指左滑，就可以删除

3）手指不放往右滑動，可以取消删除

4）點擊删除按鈕，彈出提示“是否确定删除該服務器”，點擊确定則删除，點擊取消不進行任何操作

1）在服務器列表，單擊服務器後切換到該服務器的登錄界面

2）再點擊服務器，則當前登錄界面對應的服務器處於選中狀态 

問題描述：

移動端預覽時，掃描二維碼後提示服務器連接失敗或無法打開網頁。如下圖所示：

7.1 未配置網絡環境

原因分析：未配置移動設備與與電腦處於同一網絡環境下。

解決方法：詳情請參見本文2.1.1 節。

7.2 識别 IP 錯誤

原因分析：由於電腦短期内連接了多個網絡，二維碼鏈接中 IP 地址對應的網絡與移動設備所連接的網絡并不相同的。

解決方案：

1）CMD 命令提示窗口下輸入：ipconfig /all

 即可查看本機實際 IP 地址，如下圖所示：

2）将所查到的 IPv4 地址與報表所生成二維碼下方鏈接中的 IP 地址比較，如下圖所示：

 3）若不一緻，修改網頁鏈接中的localhost爲正确的 IP，點擊回車鍵即可重新生成二維碼，使用移動設備重新掃碼預覽即可。

7.3 防火牆阻攔

原因分析：若确認已經按照文檔流程操作且應用配置符合要求，該報錯可能是由 Windows 防火牆引起。

解決方案：用戶可直接關閉 Windows 防火牆，再進行移動端預覽操作即可。或按照下文設置 Windows 防火牆打開未允許端口。

1）打開Windows安全中心>防火牆和網絡保護>高級設置，選擇入站規則>新建規則，如下圖所示：

2）設置規則類型爲端口，協議爲TCP，端口爲特定本地端口8075。保存即可，如下圖所示：