PhantomJS 配置指南

  • 文档创建者:susie
  • 编辑次数:25次
  • 最近更新:Leo.Tsai 于 2020-05-28
  • 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 进程,重启服务器即可。

    附件列表


    主题: 图表应用
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!