历史版本12 :服务器配置 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 基本配置编辑

点击菜单服务器>服务器配置,会弹出服务器设置的界面,如下图所示:

222

注:在服务器配置处设置的分页预览,填报预览,数据分析的属性是适用于整个服务器下的模板的,但是在模板web属性处设置的则是针对单个模板的,并不适用与其他模板。

2. 出错模板定义编辑

服务器配置相对模板 Web 属性,增加了出错模板定义功能。

2.1 描述

报表自带的抛错页面色调如下图,但是客户项目可能有自己的色调和统一的出错页面,与我们提供的不一致,因此需要使用自定义出错页面。


222

2.2 实现思路

服务器>服务器配置>出错模板定义直接调用自定义的出错页面如:/error.html,页面中可以通过模板出错参数 message、charset、exception 获取到报错信息。

222

在使用自定义出错页面的时候可以调用报表系统错误页面的参数,下面简单的列出参数以及说明。

  参数

  说明

  message  提示错误信息
  charset  设置服务器的编码
  exception  错误异常堆栈信息

如上的参数可以通过${参数名}的形式调用。如在定义的 error.html 页面中调用参数 message 将提示错误信息显示在表格中,如下:

<html>   
        <body>   
                <table>  
                        <tr>   
                            <td>  
                                ${message}   
                            </td>  
                        </tr>   
                 </table>   
        </body>   
</html>

2.3 报表中调用 error.html 页面

定义好的出错页面在服务器>服务器配置>出错模板定义的模板路径中调用,可以通过相对路径或绝对路径进行调用:

相对路径:自定义的出错页面 error.html 放在当前 Web 应用下,如 webroot 目录下,通过相对路径进行调用,模板路径为:/error.html

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

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

3.1 问题描述

在出错文字为中文的情况下,使用了 ${message},会出现乱码。

比如找不到模板文件,错误代码:1304 没有找到模板文件:GettingStarted2.cpt

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

222

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

3.2 解决方案

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

载 finereport.js 文件,路径为/webroot/decision/view/report?op=emb&resource=finereport.js,需要在 HTML 中引用,如下图:

222

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

222

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

完整的源代码如下:

<html>  
  <head>  
    <script src="/webroot/decision/view/report?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

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