1. 概述
本文主要总结了Word报告插件在使用中经常出现的问题以及对应的解决方案。
2. 新建报告时出现问题
2.1 无法启动WPS
问题描述:
新建 Word 报表时,WPS 无法启动。
原因分析:
端口不通导致唤起失败。较低版本的浏览器导致前端无法显示 Word 报告的入口。
解决方案:
更新谷歌浏览器版本(最低版本:99版本)。
2.2 新建模板时点击保存卡住
问题描述:wps 新建一个模板时,点击保存卡住。
原因分析:wps 新创建的 word 要随便编辑下才能保存,否则就会卡住。
解决方案:先编辑一下,再点击保存。
3. Word报告预览异常
3.1 预览word报告制作的cpt文件,浏览器直接下载文件
原因分析:预览是以pdf的形式预览的,浏览器对于pdf的设置问题,导致触发下载。
解决方案:更改浏览器设置,以谷歌浏览器为例,将其设置修改为在 chrome 中打开 PDF 文件即可。如下图所示:
3.2 预览后报错
问题描述:Word 报告预览后报错 Compile template failed... ...
原因分析:暂只支持 .docx 后缀的 word 文件,.doc 后缀的 word 文件暂不支持。
解决方案:将word文件另存为 .docx,使用 .docx 制作 word 报表。
3.3 预览时中文乱码
问题描述:报表中的中文显示为口口口或导出 Word 时提示缺少字体。
原因分析:服务器缺少对应的字体。
解决方案:服务器安装缺失的字体,可以把本地字体同步到到服务器后重启工程。可参考帮助文档:服务器安装字体。
3.4 嵌入字体显示为默认字体
问题描述:嵌入字体显示为默认字体,如下图所示:
原因分析:
1)安装的字体为不可嵌入的。
2)保存 word 时没有勾选将字体嵌入文件。
解决方案:修改字体的嵌入属性为可安装。如下图所示:
3.5 导入其他字体后存在加粗和普通字体时显示异常
原因分析:1.0.13.3 版本之前插件在 pdf 展示下,word 报告插件内文字加粗展示存在问题。
解决方案:更新插件至 1.0.13.3 及之后版本。
3.6 禁止使用云字体
在WPS中编辑模板时,需要注意禁止使用云字体。如下图所示:
3.7 导入图表(包括引用报表区域)部分显示异常
问题描述:导入图表(包括引用报表区域)部分,不显示或者显示异常,如显示不全、重复显示。
原因分析:word 里的行距被修改成固定值,图片显示不下,所以显示异常。
解决方案:修改插入图表部分的行距。
3.8 导入图表或表格部分数据报错
问题描述:
1)导入图表部分数据,报错:TemplateRenderPolicy render
2)导入表格部分数据,报错:ThrowException(AbstractRenderPolicyjava:83), com.deepoove.poi.policy.AbstractRenderPolicy.render
原因分析:
1)图表数据来源于单元格,引用的单元格数据有空白列(或者空白值)。
2)引用的单元格中有空的单元格。
解决方案:
1)检查是否有空白列,删除后重新引用。
2)删除空的单元格引用或者单元格设置形态公式:$$$
3.9 预览报错 no docx file on this file
原因分析:安装目录下,plugins 文件夹下与%FR_HOME%\webroot\WEB-INF\plugins 文件夹下的word插件版本不一致。
解决方案:同步两个plugins文件夹下插件版本,保持版本一致。
3.10 WPS 提示保存失败
3.10.1 日志显示模板被锁定
问题描述:
WPS 中显示保存失败。
日志中显示模板被锁定,如下图所示:
原因分析:
远程设计修改 Word 报告,在设计器和WPS中同时打开了模板,导致模板被锁定。
解决方案:
关闭设计器中打开的模板,然后在 Word 端重新进行保存。
3.10.2 控件显示增强1.0.2版本插件问题
问题描述:
打开 Word 报告模板,引用设计器资源,点击保存,WPS 中显示保存失败。
原因分析:
1.0.2 版本的控件显示增强插件导致 WPS 无法保存。
解决方案:
该问题可通过升级插件解决,请升级控件显示增强插件至 1.0.3 版本。
3.11 Word 报告引用表格,表格中内容部分文字被挡住
问题描述:
CPT 中单元格已经设置为自动调整行高,但在 Word 报告中引用时无法自动调整行高,导致部分文字被挡住。
解决方案:
将被遮挡的表格中对应的CPT中的行高调高。
3.12 WPS 无法加载出模板目录
问题描述:
1)新建模板在设计器中可以预览,可以打开,在WPS的目录中找不到模板。
2)安装后新建模板,在WPS的目录中加载卡死。
原因分析:
1)存在单点时,WPS无法加载出模板目录。
2)模板目录 reportlets 下,有名称为reportlets的文件夹,文件夹名称重复,出现读取模板卡死。
3.13 动态图表挂载到决策系统中图表显示空白
问题描述:本地设计器单独开发的word报表模板其中图表正常,手动拷贝模板到服务器上挂载到决策系统预览图表数据空白。
原因分析:设计器中动态图表引用的模板的数据,与服务器中的模板位置不一致。
解决方案:将服务器模板位置与设计器中的模板位置调整成一致后再引用。
4. word报告登录异常
4.1 登录插件时登录页面空白
问题描述:登录插件时登录页面空白,用本机 IE 浏览器打开数据决策系统,同样是空白页。如下图所示:
解决方案:更新JAR包到11.0.5 及之后版本,并更新插件至 2.0.1及之后版本。
4.2 勾选记住用户名密码后登录异常
问题描述:WPS端勾选记住用户名和密码后,登录失败。
解决方案:勾选记住用户名及密码后,平台中支持保持登录选项也要开启,否则会登录失败。
5. 不支持同时打开多个报表
word 报告插件暂时不支持同时打开多个文档,打开多个 word 时其他已经打开的 cpt 再次上传就需要从新上传,此时上传为覆盖保存,覆盖保存会使模板的 sheet 和数据集丢失。
6. web.xml形式的cas认证
问题描述:
word报告插件,如果cas认证为web.xml形式(非插件)则无法使用。
原因分析:
wps打开时发送的请求不携带cookie信息,请求被重定向。
解决方案:
配置一个放行请求的拦截器(RemoteFilter.class),class 文件如下,请下载并解压后使用:
拦截器下载:RemoteFilter.class.zip
将 class 文件 放在工程路径 %FR_HOME%/webroot/WEB-INF/classes/com/fr 下,如下图所示:
对 %FR_HOME%/webapps/webroot/WEB-INF 目录下的 Web.xml 文件进行编辑,可使用电脑默认的文本编辑器,新增部分如下图红框所示:
完成后重启报表工程。