润乾集算报表应用开发之页面嵌入
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
name="form1" paramFileName="demo_arg.rpx" params="" />
数据报表
数据报表嵌入页面使用的标签为<report:html>,常用属性包括 name(表格名称)、srcType (源类型,可以是 file、defineBean 或 reportBean)、funcBarLocation(是否包含工具条)、 needPageMark(是否需要页码)、params(报表参数,同参数报表中 params)、exceptionPage (错误提示页面)等。
无
file 无
无
无
1.0 top 空格 no 无 宋体 13px black 无颜色 no No No No 打印
yes 或 no,当为 yes 时,如
果定义了 funcBarFontColor
needDirectPrint
否
需 要 显 示 直 接 打 印 报 表 的 和 functionBarColor, 那 么
funcBarFontColor functionBarColor needSaveAsExcel
needSaveAsPdf
needSaveAsText needPrint printLabel
否 功能条的字体颜色
否 功能条背景色
否
需要显示将报表存为 Excel 的 功能钮吗
否
需要显示将报表存为 PDF 的功 能钮吗
布的报表文件
beanName
当报表源类型为 defineBean 或 否 reportBean 时 , 已 保 存 到
request 中的 bBiblioteka Baiduan 的名称
contextName
scale funcBarLocation separator generateParamFo rm params funcBarFontFace
当前窗体,_self
一些隐含的参数,
hiddenParams
否 如登录用户名、用 与 3.1 中的 params 取值相同 无
户身份等
是否需要自动生成
needSubmit
否 提交参数的按钮
Yes 或 no
yes
submitLabel
否 提交钮的外观定义 Html 元素或文字
查询
生成此参数表单时
params
//传递参数、数据源等,此处省略 request.setAttribute( “myContext”, context ); %> <report:html ……..
contextName=”myContext” />
常见属性配置效果
1. 功能条 配置 funcBarLocation="top"和 needPageMark="yes"可以在报表上方显示功能条及翻页按
的 bean 的名称或 时的名称一致
报表缓存池中的缓
存 ID
contextName
否 同 html 单表参数模 变量名 版式报表
无
resultPage
提交参数后,显示 相对于应用根目录的页面
否
当前页面
报表结果的页面 URL
target
否
显示结果的窗体名
与 html form 的 target 属性取 值相同
润乾集算报表应用开发之页面嵌入
润乾集算报表作为纯 JAVA 报表可以很方便嵌入到 J2EE 页面中使用,目前集算报表提供 了多种发布方式供用用户将报表嵌入到 JSP 页面时使用。集算报表中报表有参数报表和数据 报表两种,下面来看一下这两类报表的页面嵌入方式。
参数报表
由于参数报表大多数都和数据报表联合发布查询数据,所以这里只介绍联合使用方式 (单独发布与数据报表一样)。参数报表嵌入页面时使用的标签为<report:param>,该标签的 主要属性有 name、paramFileName 和 params,name 指定了参数表单的名称,paramFileName 为参数报表模板文件名,params 为参数报表接收的参数,其格式要求为:参数名 1=参数值 1;参数名 2=参数值 2…。具体使用可以参考如下书写方式: <report:param
用 bean 的方式发布报表时,计 否 算出报表 bean 时用的 Context
对象,存在 request 中的名称 否 报表缩放显示比例 否 功能条的位置 否 各功能钮间的分隔符
是否生成缺省报表参数及宏输 否 入表单 否 报表所需要的参数 否 功能条的字体
funcBarFontSize 否 功能条的字体大小
srcType=”file” name="report1" reportFileName="demo.rpx" funcBarLocation="top" needPageMark="yes" params="d_year=2014;u_id=10001" exceptionPage="/reportJsp/myError2.jsp" />
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"
附 1 <report:param/>标签属性列表
(属性名都是大小写相关,属性值必须放在双引号中)
是
属性名
否 属性含义
必
属性取值
缺省值
填
name
是 参数表单 form 在网 符 合 变 量 命 名 规 则 的 字 符 无
页中的 ID 标识
串,在本网页中应是唯一的
srcType
否 参数表单源的类型 同 html 报表
excelFormat
否 导出 excel 的默认格式
(2003,2007,openXML) 2003
中的一种
saveAsName
否
报表另存为 Excel、PDF 的文件 名(不用带扩展名)
属性 srcType 的不同值指定了不同的报表发布方式,以满足不同场景的需要。下面分别 来看一下。
file 方式
当 srcType=”file”时为 file 方式发布报表,通过 reportFileName 属性指定报表模板名称完 成报表发布。此方式为最常用的报表发布方式,具体使用可以参考如下书写方式: <report:html
Applet 按钮吗
应该用”#FFFFFF”之类的颜 No
色值,printLabel 应该只用
文字
directPrintLabel 否 直接打印钮外观定义
html 元素或文字
打印
直接打印报表前是否需要提示
needPrintPrompt
否 确认
yes 或 no
no
needSelectPrinter
否
直接打印报表时可否选择打印 机
defineBean 方式
除了直接指定报表文件,还可以发布程序读入的报表定义(ReportDefine),使用这中方 式需要指定 srcType=“defineBean”,具体使用可以参考如下书写方式: <% //读入报表定义 String reportPath = request.getRealPath("/reportFiles/api/wangge.rpx"); ReportDefine rd = (ReportDefine)ReportUtils.read(reportPath); request.setAttribute("reportDefine",rd); %> <!—发布报表 --> <report:html
srcType="reportBean" beanName="report" exceptionPage="/reportJsp/jsp/myError.jsp" />
context 方式
除了上述三种方式,还可以自定义 context 后传递给 tag 去发布,利用 context,可以传 递参数和宏,还可以指定数据源、数据库连接工厂等。使用时可以参考如下写法: <% Context context = new Context();
实数 top, bottom, both html 元素或文字 yes 或 no 用户提交的参数值 字体名称 与 html 文件中定义字体大 小相同 html 文件中使用的颜色 html 文件中使用的颜色 yes 或 no
yes 或 no
yes 或 no yes 或 no html 元素或文字
缺省值
excelLabel
否 存为 Excel 钮外观定义
html 元素或文字
存为 Excel
pdfLabel
否 存为 PDF 钮外观定义
html 元素或文字
存为 PDF
textLabel
否 存为 Text 钮外观定义
html 元素或文字
存为 Text
textDataSeparato r
否
存为 Text 时,同行单元格数据 间的分隔符
字符
TAB 键(\t)
textDataLineBrea 否 存为 Text 时,自定义换行符 换行符
\n
k
excelUsePaperSiz
存为 EXCEL 时:yes 按报表设计 否 时的纸张尺寸,no 采用本 TAG yes 或 no
no
e
标签中指定的 width,height 值
导 出 excel 三 种 格 式
file
paramFileName
否 生 成 参 数 表 单 的 报表文件名,如为""或"null", 无
RPX 文件名
则不生成表单
当参数表单源类型
为 defineBean 或
reportBean 时,已 符 合 变 量 命 名 规 则 的 字 符
beanName
否 保存到 request 中 串,与保存参数表单源 bean 无
需用到的报表参 否 数,一般用于下拉 与 html 报表中的 params 相 无
数据窗口中的数据 同
过滤条件
exceptionPage
显示参数表单异常 页面相对于应用根目录的路
否
无
信息的 JSP 页面 径名
是否需要使用报表
中设计的单元格样
needInputCssStyle
否 式,如字体、颜色 yes 或 no
yes 或 no
no
是否将客户端电脑的打印设置
发回服务器保存,以备下次打
savePrintSetup
否 印这张报表时使用,该属性对 yes 或 no
no
直接打印也起作用
printedRaq
否
被打印的报表文件名,用于打 印与显示的报表不是同一张时
报表文件名(.rpx),相对于
无
的情况
reportFileHome
否
需要显示将报表存为 Text 的功 能钮吗
否 需要显示打印报表的功能钮吗
否 打印钮外观定义
属性取值
符合变量命名规则的字符 串,在本网页中应是唯一 的 见注 1 报表文件名
符合变量命名规则的字符 串,与保存报表源 bean 时 的名称一致,且在整个 WEB 应用中应唯一
存储在 request 中的名称
yes
等
附 2 <report:html/>标签属性列表
(属性名都是大小写相关,属性值必须放在双引号中)
属性名
是否 必填
属性含义
浏览式报表和单表参数报表的公共属性
name
是 报表在网页中的 ID 标识
srcType reportFileName
否 报表源的类型 否 当报表源类型为 file 时,要发
钮等。
2. 导出打印按钮 配置 needSaveAsWord="yes" needSaveAsExcel="yes" needSaveAsPdf="yes" needPrint="yes"
可以显示导出 Word、Excel、Pdf 及打印按钮。
3. 固定表头 配置 needScroll="yes" scrollWidth="100%" scrollHeight="100%"可以将报表表头固定。
数据报表
数据报表嵌入页面使用的标签为<report:html>,常用属性包括 name(表格名称)、srcType (源类型,可以是 file、defineBean 或 reportBean)、funcBarLocation(是否包含工具条)、 needPageMark(是否需要页码)、params(报表参数,同参数报表中 params)、exceptionPage (错误提示页面)等。
无
file 无
无
无
1.0 top 空格 no 无 宋体 13px black 无颜色 no No No No 打印
yes 或 no,当为 yes 时,如
果定义了 funcBarFontColor
needDirectPrint
否
需 要 显 示 直 接 打 印 报 表 的 和 functionBarColor, 那 么
funcBarFontColor functionBarColor needSaveAsExcel
needSaveAsPdf
needSaveAsText needPrint printLabel
否 功能条的字体颜色
否 功能条背景色
否
需要显示将报表存为 Excel 的 功能钮吗
否
需要显示将报表存为 PDF 的功 能钮吗
布的报表文件
beanName
当报表源类型为 defineBean 或 否 reportBean 时 , 已 保 存 到
request 中的 bBiblioteka Baiduan 的名称
contextName
scale funcBarLocation separator generateParamFo rm params funcBarFontFace
当前窗体,_self
一些隐含的参数,
hiddenParams
否 如登录用户名、用 与 3.1 中的 params 取值相同 无
户身份等
是否需要自动生成
needSubmit
否 提交参数的按钮
Yes 或 no
yes
submitLabel
否 提交钮的外观定义 Html 元素或文字
查询
生成此参数表单时
params
//传递参数、数据源等,此处省略 request.setAttribute( “myContext”, context ); %> <report:html ……..
contextName=”myContext” />
常见属性配置效果
1. 功能条 配置 funcBarLocation="top"和 needPageMark="yes"可以在报表上方显示功能条及翻页按
的 bean 的名称或 时的名称一致
报表缓存池中的缓
存 ID
contextName
否 同 html 单表参数模 变量名 版式报表
无
resultPage
提交参数后,显示 相对于应用根目录的页面
否
当前页面
报表结果的页面 URL
target
否
显示结果的窗体名
与 html form 的 target 属性取 值相同
润乾集算报表应用开发之页面嵌入
润乾集算报表作为纯 JAVA 报表可以很方便嵌入到 J2EE 页面中使用,目前集算报表提供 了多种发布方式供用用户将报表嵌入到 JSP 页面时使用。集算报表中报表有参数报表和数据 报表两种,下面来看一下这两类报表的页面嵌入方式。
参数报表
由于参数报表大多数都和数据报表联合发布查询数据,所以这里只介绍联合使用方式 (单独发布与数据报表一样)。参数报表嵌入页面时使用的标签为<report:param>,该标签的 主要属性有 name、paramFileName 和 params,name 指定了参数表单的名称,paramFileName 为参数报表模板文件名,params 为参数报表接收的参数,其格式要求为:参数名 1=参数值 1;参数名 2=参数值 2…。具体使用可以参考如下书写方式: <report:param
用 bean 的方式发布报表时,计 否 算出报表 bean 时用的 Context
对象,存在 request 中的名称 否 报表缩放显示比例 否 功能条的位置 否 各功能钮间的分隔符
是否生成缺省报表参数及宏输 否 入表单 否 报表所需要的参数 否 功能条的字体
funcBarFontSize 否 功能条的字体大小
srcType=”file” name="report1" reportFileName="demo.rpx" funcBarLocation="top" needPageMark="yes" params="d_year=2014;u_id=10001" exceptionPage="/reportJsp/myError2.jsp" />
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"
附 1 <report:param/>标签属性列表
(属性名都是大小写相关,属性值必须放在双引号中)
是
属性名
否 属性含义
必
属性取值
缺省值
填
name
是 参数表单 form 在网 符 合 变 量 命 名 规 则 的 字 符 无
页中的 ID 标识
串,在本网页中应是唯一的
srcType
否 参数表单源的类型 同 html 报表
excelFormat
否 导出 excel 的默认格式
(2003,2007,openXML) 2003
中的一种
saveAsName
否
报表另存为 Excel、PDF 的文件 名(不用带扩展名)
属性 srcType 的不同值指定了不同的报表发布方式,以满足不同场景的需要。下面分别 来看一下。
file 方式
当 srcType=”file”时为 file 方式发布报表,通过 reportFileName 属性指定报表模板名称完 成报表发布。此方式为最常用的报表发布方式,具体使用可以参考如下书写方式: <report:html
Applet 按钮吗
应该用”#FFFFFF”之类的颜 No
色值,printLabel 应该只用
文字
directPrintLabel 否 直接打印钮外观定义
html 元素或文字
打印
直接打印报表前是否需要提示
needPrintPrompt
否 确认
yes 或 no
no
needSelectPrinter
否
直接打印报表时可否选择打印 机
defineBean 方式
除了直接指定报表文件,还可以发布程序读入的报表定义(ReportDefine),使用这中方 式需要指定 srcType=“defineBean”,具体使用可以参考如下书写方式: <% //读入报表定义 String reportPath = request.getRealPath("/reportFiles/api/wangge.rpx"); ReportDefine rd = (ReportDefine)ReportUtils.read(reportPath); request.setAttribute("reportDefine",rd); %> <!—发布报表 --> <report:html
srcType="reportBean" beanName="report" exceptionPage="/reportJsp/jsp/myError.jsp" />
context 方式
除了上述三种方式,还可以自定义 context 后传递给 tag 去发布,利用 context,可以传 递参数和宏,还可以指定数据源、数据库连接工厂等。使用时可以参考如下写法: <% Context context = new Context();
实数 top, bottom, both html 元素或文字 yes 或 no 用户提交的参数值 字体名称 与 html 文件中定义字体大 小相同 html 文件中使用的颜色 html 文件中使用的颜色 yes 或 no
yes 或 no
yes 或 no yes 或 no html 元素或文字
缺省值
excelLabel
否 存为 Excel 钮外观定义
html 元素或文字
存为 Excel
pdfLabel
否 存为 PDF 钮外观定义
html 元素或文字
存为 PDF
textLabel
否 存为 Text 钮外观定义
html 元素或文字
存为 Text
textDataSeparato r
否
存为 Text 时,同行单元格数据 间的分隔符
字符
TAB 键(\t)
textDataLineBrea 否 存为 Text 时,自定义换行符 换行符
\n
k
excelUsePaperSiz
存为 EXCEL 时:yes 按报表设计 否 时的纸张尺寸,no 采用本 TAG yes 或 no
no
e
标签中指定的 width,height 值
导 出 excel 三 种 格 式
file
paramFileName
否 生 成 参 数 表 单 的 报表文件名,如为""或"null", 无
RPX 文件名
则不生成表单
当参数表单源类型
为 defineBean 或
reportBean 时,已 符 合 变 量 命 名 规 则 的 字 符
beanName
否 保存到 request 中 串,与保存参数表单源 bean 无
需用到的报表参 否 数,一般用于下拉 与 html 报表中的 params 相 无
数据窗口中的数据 同
过滤条件
exceptionPage
显示参数表单异常 页面相对于应用根目录的路
否
无
信息的 JSP 页面 径名
是否需要使用报表
中设计的单元格样
needInputCssStyle
否 式,如字体、颜色 yes 或 no
yes 或 no
no
是否将客户端电脑的打印设置
发回服务器保存,以备下次打
savePrintSetup
否 印这张报表时使用,该属性对 yes 或 no
no
直接打印也起作用
printedRaq
否
被打印的报表文件名,用于打 印与显示的报表不是同一张时
报表文件名(.rpx),相对于
无
的情况
reportFileHome
否
需要显示将报表存为 Text 的功 能钮吗
否 需要显示打印报表的功能钮吗
否 打印钮外观定义
属性取值
符合变量命名规则的字符 串,在本网页中应是唯一 的 见注 1 报表文件名
符合变量命名规则的字符 串,与保存报表源 bean 时 的名称一致,且在整个 WEB 应用中应唯一
存储在 request 中的名称
yes
等
附 2 <report:html/>标签属性列表
(属性名都是大小写相关,属性值必须放在双引号中)
属性名
是否 必填
属性含义
浏览式报表和单表参数报表的公共属性
name
是 报表在网页中的 ID 标识
srcType reportFileName
否 报表源的类型 否 当报表源类型为 file 时,要发
钮等。
2. 导出打印按钮 配置 needSaveAsWord="yes" needSaveAsExcel="yes" needSaveAsPdf="yes" needPrint="yes"
可以显示导出 Word、Excel、Pdf 及打印按钮。
3. 固定表头 配置 needScroll="yes" scrollWidth="100%" scrollHeight="100%"可以将报表表头固定。