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。保存即可，如下图所示：