1. 概述
1.1 应用场景
用户希望访问平台时，访问路径中没有/webroot/decision。
用户希望只通过 IP 或者域名访问 Tomcat 工程。
用户希望访问平台的 URL 能够变短一些，或者访问模板的地址能够变短一些。
1.2 功能简介
通常在 Tomcat 服务器部署 完成之后，启动服务器，用户需要访问 URL：http://localhost:8080/webroot/decision 方可进入数据决策系统。
有时用户希望可以直接通过 IP 就能访问数据决策系统。
通过修改端口号并建立虚拟目录来实现访问 IP（例如：http://localhost）即可直接进入数据决策系统。
注：本文仅介绍如何通过 IP 访问工程，如需通过域名访问，请根据实际情况，将IP与域名绑定，本文不再赘述。
2. 操作步骤
以访问http://localhost为例进行介绍。
2.1 修改端口号
如果没有其他网络程序占用端口号 80，可以将 Tomcat 服务器的端口号设置为 80。
80 端口为默认端口，用户访问报表页面时就不需要再加上 Tomcat 服务器的端口号。
1）打开%tomcat_home%\conf\server.xml文件，修改端口号，如下图所示：
代码如下所示：
<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
2）重启 Tomcat 服务器，访问http://localhost/webroot/decision即可进入数据决策系统。
2.2 设置欢迎界面
每个 Web 服务器都有默认的欢迎界面，通过修改欢迎界面，以显示平台页面。
在%Tomcat_home%\webapps\webroot目录下新建 a.jsp文件，作为 Web 服务器的默认主页。
2.2.1 PC 端和 App 端设置界面
文件下载：a.jsp
「a.jsp」调用 iframe 集成平台产品演示界面，代码如下所示：
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<html>
<head>
<title>FineReport报表</title>
<link rel="stylesheet" type="text/css" href="/decision/file?path=/com/fr/web/core/css/leaflet.css&type=plain&parser=plain"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1, maximum-scale=1.0, user-scalable=no">
</head>
<body leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<iframe id="reportFrame" src="decision" allowfullscreen="true"
name="itemslist" frameborder="0" width="100%" height="100%"></iframe>
</body>
</html>
注：<link rel="stylesheet" type="text/css" href="/decision/file?path=/com/fr/web/core/css/leaflet.css&type=plain&parser=plain"/> 这行代码用于解决决策系统中图表工具栏全屏后地图显示异常的问题。
重启 Tomcat 服务器，访问http://localhost/webroot/a.jsp即可显示数据决策系统登录页面。
2.2.2 HTML5 端设置界面
文件下载：a.jsp
「a.jsp」调用 iframe 集成平台产品演示界面，代码如下所示：
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<html>
<head>
<title>FineReport报表</title>
<link rel="stylesheet" type="text/css" href="/decision/file?path=/com/fr/web/core/css/leaflet.css&type=plain&parser=plain"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1, maximum-scale=1.0, user-scalable=no">
</head>
<body leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<iframe id="reportFrame" src="decision" allowfullscreen="true"
name="itemslist" frameborder="0" width="100%" height="100%"></iframe>
</body>
</html>注：HTML5 端设置时需要安装 HTML5 移动端展现插件
2.3 建立虚拟目录
通过修改配置文件建虚拟目录。
2.3.1 调整工程路径
报表工程 webroot 默认放在%Tomcat_home%\webapps目录下，启动服务器时会加载该工程。建立虚拟目录后，启动 Tomcat 服务器时，通过配置文件会再次加载 webroot 工程。webroot 工程加载两次，会出现报错、服务器闪退等情况。
因此用户需要将%Tomcat_home%\webapps目录下的 webroot 文件夹移动到 Tomcat 部署目录以外的位置，并且需要与 Tomcat 工程在相同路径的磁盘下。
本文将%Tomcat_home%\webapps\webroot文件夹移动到E:\webroot路径。如下图所示：
注：不是复制 webroot 而是移动，原%Tomcat_home%\webapps下不应有 webroot 文件。
2.3.2 修改 server.xml 文件
修改%tomcat_home%\conf\server.xml文件，在 server.xml 文件中 host 标签之间添加上代码，如下图所示：
代码如下所示：
<Context path="" docBase="D:\webroot" debug="0" reloadable="false" />
说明：
| 参数 | 说明 |
|---|---|
| path | 虚拟目录的名字 如果希望输入 IP 地址就显示主页，则该键值留为空 |
| docBase | 虚拟目录的路径 本文 2.3.1 步骤中设置的 webroot 路径，本文为E:\webroot |
| debug | 0 |
| reloadable | false |
2.3.3 修改 web.xml 文件
先检查 %tomcat_home%\conf\web.xml 路径下有无 web.xml 文件。
如果有 web.xml 文件，直接编辑文件，在文件末尾 </web-app> 标签之前，添加一段代码显示自定义欢迎界面 a.jsp，代码如下：
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>a.jsp</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
如果没有 web.xml 文件，需要在webroot\WEB-INF 目录下新建 web.xml 文件：web.xml，如下图所示：
代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<web-app
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">
<display-name>Template WebApp</display-name>
<mime-mapping>
<extension>msi</extension>
<mime-type>application/x-msi</mime-type>
</mime-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>a.jsp</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
2.4 效果预览
2.4.1 PC端
重启 Tomcat 服务器，访问 http://localhost，（本文访问本机，因此使用http://localhost，实际访问地址为 http://IP 。）即可进入 a.jsp 页面，即可访问数据决策系统，如下图所示：
2.4.2 移动端（HTML5 端访问）
重启 Tomcat 服务器，访问 http://IP ，如下图所示：
注：App 端访问请参见本文 3.2 节。
3. 输入服务器地址
3.1 远程设计
远程设计 输入服务器地址的时候，webroot 需省去，decision 要保留。
| 选项 | 值 |
|---|---|
| 主机名/IP | 根据实际情况填写 |
| 端口号 | 80 |
| Web应用 | 空 |
| Serverlet | decision |
| 用户名\密码 | 根据实际情况填写 |
配置工作目录如下图所示：
3.2 移动端
App 端、H5 端、微信和钉钉集成环境下，输入服务器地址的时候，webroot 需要省去，但是 decision 一定要保留。
| 选项 | 值 |
|---|---|
| 主机名/IP | 根据实际情况填写 |
| 端口号 | 80 |
| Web应用 | 空 |
| Serverlet | decision |
| 用户名\密码 | 根据实际情况填写 |
配置工作目录如下图所示：
4. 注意事项
4.1 IE9 浏览器下页面显示不完全
问题描述
按照上述配置部署好后， IE9 浏览器下，页面显示不完全。
解决方案
将本文2.2 步骤中的 a.jsp 文件代码修改如下：
<html>
<head>
<title>FineReport</title>
<meta http-equiv="X-UA-Compatible" content="chrome=1,IE=edge"/>
<link rel="stylesheet" type="text/css" href="/decision/file?path=/com/fr/web/core/css/leaflet.css&type=plain&parser=plain"/>
<style type="text/css">
html, body
{
margin: 0px 0px;
width: 100%;
height: 100%;
}
iframe
{
margin: 0px 0px;
width: 100%;
height: 100%;
}
</style>
</head>
<body>
<iframe id="reportFrame" src="decision" name="itemslist" frameborder="0"></iframe>
</body>
</html>
