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 文件进行编辑，可使用电脑默认的文本编辑器，新增部分如下图红框所示：
完成后重启报表工程。
