历史版本25 :PhantomJS 配置指南 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 安装说明编辑

注:本文内容只适用于 2020-04-26 之前版本的 JAR 包, 因为 2020-04-26 及之后版本的 JAR 包,已经用 vancas 替代 phantomjs 了。详情参见文档:图表导出升级说明

1.1 Windows、macOS、Linux 用户

FineReport 图表内置了 phantomjs 环境,Windows、macOS、Linux 用户安装设计器或部署了工程后,就内置了 phantomjs 环境,无需另行安装。

注:如果不想使用内置的环境,也可以按照下面 2.自定义安装 的方法另行配置 phantomjs 环境。

1.2 Unix 用户

Unix 系统用户需要自行配置 phantomjs 环境,方法如下:

1)登入系统后,执行命令:sudo pkg install phantomjs,如果当前用户为管理员,执行命令: pkg install phantomjs

222

2)命令行执行命令:phantomjs --version,显示版本信息即安装成功。

222

3)用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 文件。

Snag_20368976.png

4)找到 PhantomConf.exe 节点配置,修改节点的值为default,如下图所示:

1590649891201435.png

2. 自定义安装编辑

如果用户不想用内置的 phantomjs 环境,可以按照下面的方法自行安装 phantomjs 。

2.1 Windows 用户

2.1.1 方法一

1)从 官网 下载对应版本的压缩包,解压到某个目录下,例如解压后的 phantomjs.exe D:\phantomjs\bin路径下,如下图所示:

222      

2)用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 文件。

Snag_20368976.png

3)找到 PhantomConf.exe 节点,修改节点的值为 phantomjs 可执行程序的路径,比如这里就是:D:\phantomjs\bin\phantomjs.exe

1590651286350813.png

2.1.2 方法二

1)在 官网 下载对应版本的压缩包解压,例如解压后的 phantomjs.exe 在D:\phantomjs\bin路径下。

222

2)配置 phantomjs 环境变量

右键我的电脑,点击属性>高级系统设置>高级>环境变量,在系统变量里找到 Path,将 phantomjs 添加到环境变量里。如下图所示:

示例添加的环境变量为:;D:\phantomjs\bin

222

3)控制台执行 phantomjs --version 命令,出现版本信息即安装成功。

222

4)用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 配置文件。

Snag_20368976.png

5)找到 PhantomConf.exe 节点配置,修改节点的值为default,如下图所示:

1590649891201435.png

2.2 Linux 用户

2.2.1 Ubuntu 系统

1)登入系统,执行命令:sudo apt-get install phantomjs,如果当前用户为管理员用户时,执行命令:apt-get install phantomjs

222

2)确保能在命令行执行命令:phantomjs --version

222

3)用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 配置文件。

4)找到 PhantomConf.exe 节点配置,修改节点的值为default

2.2.2 CentOS 系统

1)下载安装包并解压

下载 phantomjs 的 Linux 安装包到/phantomjs文件夹下

tar -xjvf phantomjs-2.1.1-linux-x86_64.tar.bz2解压文件

2)安装依赖环境,过程选项都直接 y

yum install fontconfig freetype2

3)配置环境变量

已配置 JDK 环境变量前提下,export PATH 这条后面加上:

:/phantomjs/phantomjs-2.1.1-linux-x86_64/bin

变成

export PATH=$JAVA_HOME/bin:$PATH:/phantomjs/phantomjs-2.1.1-linux-x86_64/bin

没有的话就如下:

export PATH=$PATH:/phantomjs/phantomjs-2.1.1-linux-x86_64/bin

source /etc/profile使改动生效

4)查看结果

输入 phantomjs --version,显示版本号,说明 phantomjs 安装成功。

5)修改 db.script 文件

用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 配置文件。

找到 PhantomConf.exe 节点配置,修改节点的值为default

3. 注意事项编辑

3.1 报表无法调用

1)问题描述

在 Linux 环境下,当手动启动 pahtomjs 成功,报表调用不到。

2)原因分析

未指定启动路径。

3)解决方案

需要指定启动路径:

打开 finedb 中的 fine_conf_entity 表把 phantomconf.exe 的值( 一般默认为inner server )改为具体工程路径:/usr/local/finereport/tomcat/webapps/webroot/WEB-INF/assist/phantomjs/phantomjs-linux64/bin/phantomjs,然后 kill 掉 tomcat 进程,重启服务器即可。