润乾报表作为纯 JAVA 报表可以很方便地嵌入到 J2EE 页面中使用，目前润乾报表提供了多种发布方式供用户将报表嵌入到 JSP 页面。润乾报表包括参数报表和数据报表两种报表，下面分别看一下这两类报表的页面嵌入方式。

参数报表

由于参数报表大多数都和数据报表联合发布查询数据，所以这里只介绍联合使用方式（单独发布与数据报表一样）。参数报表嵌入页面时使用的标签为report:param，该标签的主要属性有 name、paramFileName 和 params。其中，name 指定了参数表单的名称，paramFileName 为参数报表模板文件名，params 为参数报表接收的参数，其格式要求为：参数名 1= 参数值 1; 参数名 2= 参数值 2…。具体使用可以参考如下书写方式：

<report:param

name="form1"

paramFileName="demo_arg.rpx"

params=""

/>

数据报表

数据报表嵌入页面使用的标签为report:html，常用属性包括 name（表格名称）、srcType（源类型，可以是 file、defineBean 或 reportBean）、funcBarLocation（是否包含工具条）、needPageMark（是否需要页码）、params（报表参数，同参数报表中 params）、exceptionPage（错误提示页面）等。

属性 srcType 的不同值指定了不同的报表发布方式，以满足不同场景的需要。下面分别来看一下。

file方式

当 srcType=”file”时为 file 方式发布报表，通过 reportFileName 属性指定报表模板名称完成报表发布。此方式为最常用的报表发布方式，具体使用可以参考如下书写方式：

<report:html

srcType=”file”

name="report1"

reportFileName="demo.rpx"

funcBarLocation="top"

needPageMark="yes"

params="d\_year=2014;u\_id=10001"

exceptionPage="/reportJsp/myError2.jsp"

/>

defineBean 方式

除了直接指定报表文件，还可以发布程序读入的报表定义（ReportDefine），使用这中方式需要指定 srcType=“defineBean”，具体使用可以参考如下书写方式：

<%  //读入报表定义

String reportPath = request.getRealPath("/reportFiles/api/wangge.rpx");

ReportDefine rd = (ReportDefine)ReportUtils.read(reportPath);

request.setAttribute("reportDefine",rd);

%>

<!—发布报表 -->

<report:html

name="report1"

srcType="defineBean"

beanName="reportDefine"

exceptionPage="/reportJsp/jsp/myError.jsp"

/>

reportBean 方式

除了直接指定报表模板和接收报表定义，有时还需要直接使用程序计算好的报表（IReport）进行发布，此时需要指定 srcType=“reportBean”，使用时可以参考如下写法：

<%  //程序计算报表

String reportPath = request.getRealPath("/reportFiles/api/wangge.rpx");

ReportDefine rd = (ReportDefine)ReportUtils.read(reportPath);

Context cxt = new Context();    

Engine engine = new Engine(rd, cxt);

IReport iReport = engine.calc();

request.setAttribute("report", iReport);

%>

<!—发布报表 -->

<report:html name="report1"

    srcType="reportBean"

    beanName="report"

    exceptionPage="/reportJsp/jsp/myError.jsp"

/>

context 方式

除了上述三种方式，还可以自定义 context 后传递给 tag 去发布，利用 context，可以传递参数和宏，还可以指定数据源、数据库连接工厂等。使用时可以参考如下写法：

<%

Context context = new Context();

//传递参数、数据源等，此处省略

request.setAttribute( “myContext”, context );

%>

<report:html ……..

  contextName=”myContext”

/>

常见属性配置效果

1.功能条

配置 funcBarLocation="top" 和 needPageMark="yes" 可以在报表上方显示功能条及翻页按钮等。

2.导出打印按钮

配置 needSaveAsWord="yes"needSaveAsExcel="yes"needSaveAsPdf="yes"needPrint=“yes” 可以显示导出 Word、Excel、Pdf 及打印按钮。

3.固定表头

配置 needScroll=“yes” scrollWidth=“100%” scrollHeight="100%" 可以将报表表头固定。

附 1 <report:param/> 标签属性列表

(属性名都是大小写相关，属性值必须放在双引号中)

附 2 <report:param/> 标签属性列表

(属性名都是大小写相关，属性值必须放在双引号中)

注 1：srcType 的取值：

（1）如要发布的报表源为报表文件，其值为 file。

（2）如要发布的报表源为经过 API 处理的

com.raqsfot.report.model.ReportDefine 对象，则其值为 defineBean。

（3）如要发布的报表源为经过 API 处理的

com.raqsoft.report.usermodel.IReport 对象，则其值为 reportBean。

注 2：如果调用 TAG 前，是用 API 生成的 Context 对象来运算报表，那么应将此对象传给 TAG，示例如下：

<%

……..

Context context = new Context();

…….

request.setAttribute( “myContext”, context );

%>

<report:html ……..

contextName=”myContext”

/>

注 3：如果 scrollWidth 和 scrollHeight 采用百分比的格式，那么滚动区域的高度和宽度是根据 jsp 中报表外面的元素的高度和宽度而定的，如果报表外面的元素没有指定高度和宽度，可能会出问题。

举例如下，在自定义的 jsp 中，首先定义在报表外面 table 元素的 width 和 height，这样可以保证滚动区域正常显示。

<table style="width:40%; height:80%;overflow:hidden;table-layout:fixed">

<tr><td valign=top>

<report:html name="report1" reportFileName="<%=file%>"

needScroll="yes"

scrollWidth="80%"

scrollHeight="50%"

......

/>

</td></tr></table>

更多集成部署相关问题请查看：集成部署相关问题分类导航

• 润乾与 springBoot 集成
• 润乾报表集群缓存同步功能介绍
• 乱码问题总结
• tomcat8 部署润乾 v2018 完整过程