自定义出错页面

编辑
文档创建者:susie (58814 )     浏览次数:3495次     编辑次数:7次     最近更新:yets11 于 2017-02-27     

1. 问题描述编辑

报表自带的抛错页面色调和整个应用的色调不一致如下图,项目里有自己统一的出错页面,因此需要使用自定义出错页面。
222

2. 实现思路编辑

服务器>服务器配置>出错模板定义直接调用自定义的出错页面如:/error.html,页面中可以通过模板出错参数message、charset、exception获取到报错信息。
222
在使用自定义出错页面的时候可以调用报表系统错误页面的参数,下面简单的列出参数以及说明。
  参数  说明
  message  提示错误信息
  charset  设置服务器的编码
  exception  错误异常堆栈信息
2.1 示例error.html页面
如上的参数可以通过${参数名}的形式调用。如在定义的error.html页面中调用参数message将提示错误信息显示在表格中,如下:
<html> <body> <table> <tr> <td> ${message} </td> </tr> </table> </body> </html>
2.2 报表中调用error.html页面
定义好的出错页面在服务器>服务器配置>出错模板定义的模板路径中调用,可以通过相对路径或绝对路径进行调用:
相对路径:自定义的出错页面error.html放在当前Web应用下,如WebReport目录下,通过相对路径进行调用,模板路径为:/error.html

绝对路径:自定义的出错页面error.html放在其他应用下,通过绝对路径进行调用,模板路径为:http://www.xxx.com/error.html


3、解决自定义出错页面中文乱码的问题编辑

在出错文字为中文的情况下,使用了${message},会出现乱码。比如找不到模板文件,错误代码:1304 没有找到模板文件:GettingStarted2.cpt

使用上述自定义出错信息的话,出错信息是这样的

222

后面的英文部分显示正常,中文部分却是乱码,显示不是我们需要的,那么如何解决呢?

1)出错的信息是通过FR进行转码过后的,中文会被显示成上述样式,为了还原,我们需要在error.html文件中使用FR.cjkDecode()来进行还原出错的信息,使用这个方法必须加

载finereport.js文件,路径为/WebReport/ReportServer?op=emb&resource=finereport.js,需要在html中引用,如下图:
222

     2)由于页面使用的${message}是在页面加载后完成的,所有js转码部分必须写在body内部,在${message}之后,为了获取此信息,我们加一组span标签,class设置为message,利用jquery中的$('.message').text()就可以获取和设置信息内容了,如下图:

    
222

注:在JS部分,不能直接使用${message}来获取出错信息内容,所以必须使用jquery或其他方法来获取span中的信息内容。

    

完整的源代码如下:

<html> <head> <script src="/WebReport/ReportServer?op=emb&resource=finereport.js"></script> </head> <body> <table> <tr> <td> <span class='message'>${message}</span> </td> <td></td> </tr> </table> <script> $('.message').text(FR.cjkDecode($('.message').text())); //因为错误信息是转码之后的,必须解码 </script> </body> </html> 
保存后再新刷新页面,即可看到新的出错信息了,如下图:

222

可以看到,已经正确地还原了出错信息了。

附件列表


主题: 操作指南
标签: 暂无标签 编辑/添加标签
如果您认为本文档还有待完善,请编辑

文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

此页面有帮助吗?