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 平台配置QRCODE

管理者登入數據決策系統，點選「管理系統」>「行動平台」>「APP配置」，在「登入設定」輸入「伺服器名稱」和「伺服器地址」，點選「生成QRCODE」，即可在QRCODE方框中生成一個QRCODE。如下圖所示：

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

注2：伺服器地址格式為：http://ip:埠號/工程名/decision，其中的 IP 和埠號需與實際網路環境一致。

2.1.3 配置帳號密碼

如需在行動端存取範本，需要擁有一個數據決策系統的帳號密碼，具體設定方式請參見：決策系統簡介

2.2 App 配置伺服器

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

APP 下載 安裝後，開啟資料分析 App，點選「伺服器」>「建立伺服器」，掃描「2.1.2 節」配置的QRCODE。

確認伺服器資訊，點選右上角√號，即可在伺服器列表新增該工程，自動跳轉到登入頁。

如下圖所示：

注1：使用者可掃描相冊中儲存的QRCODE。

注2：使用者可手動輸入伺服器資訊，伺服器地址為：http://ip:埠號/工程名/decision 。

注3：為提升安全性，使用者希望用戶端與伺服器通訊時資料進行加密。若伺服器已使用 https SSL 加密，App 新增伺服器時也支援 https 協定。

2.3 App 登入伺服器

在登入頁輸入管理者的帳號和密碼，即可進入該工程行動端首頁，如下圖所示：

注1：若輸入 FineReport 內建使用者帳號和密碼（非管理者），需要為該使用者分配查看目錄的權限，詳情請參見：根據使用者分配權限

注2：FineReport11.0 平台採用了 AccessToken 驗證，勾選自動登入後，AccessToken 有效期為 14 天，超過 14 天需要重新登入。

本章將主要講解如何在資料分析 App 中存取單張範本，以方便製作者調整範本效果。

3.1 PC 端配置

3.1.1 平台配置帳號密碼

如需在行動端存取範本，需要擁有一個數據決策系統的帳號密碼，具體設定方式請參見：決策系統簡介

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 節」中生成的QRCODE。

確認伺服器資訊，點選右上角√號，即可在伺服器列表新增該工程，自動跳轉到登入頁。

注1：若伺服器列表中有當前範本連結的伺服器地址，跳轉至已有伺服器登入介面。

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

3.3 App 登入伺服器

在 App 登入頁輸入帳號和密碼。App 登入成功後，即可跳轉到範本頁面

效果如下圖所示：

注1：FineReport11.0 平台採用了 AccessToken 驗證，勾選自動登入後，AccessToken 有效期為 14 天，超過 14 天需要重新登入。

注2：若開啟了 範本認證 ，則判斷登入使用者是否有權限存取，若沒有則彈出「沒有權限」的提示。  

內建 Demo 伺服器不支援編輯，右邊沒有編輯按鈕。

使用者新增的伺服器提供編輯，點選右邊的編輯按鈕，進入手動編輯伺服器介面，其他操作與新增伺服器一致，如下圖所示：

1）內建 FineReport 伺服器以及自己新增的伺服器，都可以刪除

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

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

4）點選刪除按鈕，彈出提示“是否確定刪除該伺服器”，點選確定則刪除，點選取消不進行任何操作

1）在伺服器列表，按伺服器後切換到該伺服器的登入介面

2）再點選伺服器，則當前登入介面對應的伺服器處於選中狀態 

問題描述：

行動端預覽時，掃描QRCODE後提示伺服器連結失敗或無法開啟網頁。如下圖所示：

7.1 未配置網路環境

原因分析：未配置行動裝置與與電腦處於同一網路環境下。

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

7.2 識別 IP 錯誤

原因分析：由於電腦短期內連結了多個網路，QRCODE連結中 IP 地址對應的網路與行動裝置所連結的網路並不相同的。

解決方案：

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

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

2）將所查到的 IPv4 地址與報表所生成QRCODE下方連結中的 IP 地址比較，如下圖所示：

 3）若不一致，修改網頁連結中的localhost為正確的 IP，點選return 鍵即可重新生成QRCODE，使用行動裝置重新掃碼預覽即可。

7.3 防火牆阻攔

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

解決方案：使用者可直接關閉 Windows 防火牆，再進行行動端預覽操作即可。或按照下文設定 Windows 防火牆開啟未允許埠。

1）開啟「Windows安全中心」>「防火牆和網路保護」>「進階設定」，選擇「輸入規則」>「新增規則」，如下圖所示：

2）設定規則類型為「連接埠」，協定為「TCP」，埠為特定本地連接埠「8075」。「儲存」即可，如下圖所示：