报表组
本章主要介绍报表组的原理、用途及详细说明。
◆ 实例请参考TAG实例 / html模式发布报表 / 报表组
原理和用途：
通过报表组在网页上生成类似Excel的页签。
详细说明：
报表组在JSP文件中用<prefix:group>标签来发布，prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示：
<%@taglib uri="/WEB-INF/ raqsoftReport.tld" prefix="report" %>
此定义语句必须写在JSP的开头，其中prefix的值可以自己指定，但tag标签中的前缀必须与其保持一致。
然后在要发布报表的地方用上面介绍的tag标签来发布，如：
<report:group groupFileName=”…” …./>
此标签的属性说明见下表：
(属性名都是大小写相关，属性值必须放在双引号中)
|
属性名 |
是否必填 |
属性含义 |
属性取值 |
缺省值 |
|
浏览式报表组的公共属性 |
||||
|
groupId |
是 |
报表组id |
与html元素id命名法相同 |
无 |
|
groupFileName |
否 |
要发布的报表组文件名 |
报表组文件名 |
无 |
|
srcType |
否 |
报表组源的类型 |
见注1 |
file |
|
beanName |
否 |
当报表组源类型为bean时，已保存到request中的bean的名称 |
符合变量命名规则的字符串，与保存报表组源bean时的名称一致，且在整个web应用中应唯一 |
无 |
|
scale |
否 |
报表缩放显示比例 |
实数 |
1.0 |
|
contextName |
否 |
用bean的方式发布报表时，计算出报表bean时用的Context对象，存在session中的名称 |
存储在session中的名称 |
无 |
|
border |
否 |
报表显示区边框 |
html边框表示法 |
4px double peachpuff |
|
margin |
否 |
报表与报表显示区边框的距离 |
整数 |
8 |
|
width |
否 |
报表组控件的宽 |
象素或百分比 |
100% |
|
height |
否 |
报表组控件的高 |
象素或百分比 |
400 |
|
funcBarLocation |
否 |
功能条的位置 |
top, bottom, both |
top |
|
separator |
否 |
各功能钮间的分隔符 |
html元素或文字 |
空格 |
|
params |
否 |
报表组所需要的参数 |
用户提交的报表组参数值 |
无 |
|
funcBarFontFace |
否 |
功能条的字体 |
字体名称 |
宋体 |
|
funcBarFontSize |
否 |
功能条的字体大小 |
与html文件中定义字体大小相同 |
13px |
|
funcBarFontColor |
否 |
功能条的字体颜色 |
html文件中使用的颜色 |
black |
|
functionBarColor |
否 |
功能条背景色 |
html文件中使用的颜色 |
无颜色 |
|
needSaveAsExcel |
否 |
需要显示将报表存为Excel的功能钮吗 |
yes或no |
no |
|
needSaveAsPdf |
否 |
需要显示将报表存为PDF的功能钮吗 |
yes或no |
no |
|
needSaveAsWord |
否 |
需要显示将报表存为Word的功能钮吗 |
yes或no |
no |
|
needSaveAsOfd |
否 |
需要显示将报表存为OFD的功能钮吗 |
yes或no |
no |
|
needPrint |
否 |
需要显示打印报表的功能钮吗 |
yes或no |
no |
|
needImportEasyui |
否 |
是否需要引入easyui的js和css文件，如需修改easyui的主题风格可参考修改easyui插件的主题小节 |
yes或no |
yes |
|
theme |
否 |
编辑控件的外观主题风格 |
default,black,bootstrap,gray,metro |
default |
|
needPaged |
否 |
是否分页 |
yes或no |
no |
|
needPageMark |
否 |
要分页时是否生成页码工具条 |
yes或no |
yes |
|
needScroll |
否 |
是否固定表头 固定表头后，页面报表不分页，分页方式设置无效 |
yes或no |
no |
|
firstPageLabel |
否 |
翻到第一页的功能钮外观定义 |
html元素或文字 |
最前页 |
|
prevPageLabel |
否 |
翻到前一页的功能钮外观定义 |
html元素或文字 |
上一页 |
|
nextPageLabel |
否 |
翻到后一页的功能钮外观定义 |
html元素或文字 |
下一页 |
|
lastPageLabel |
否 |
翻到最后页的功能钮外观定义 |
html元素或文字 |
最后页 |
|
printLabel |
否 |
打印钮外观定义 |
html元素或文字 |
打印 |
|
needSelectPrinter |
否 |
打印报表组时可否选择打印机 |
yes或no |
yes |
|
excelLabel |
否 |
存为Excel钮外观定义 |
html元素或文字 |
存为Excel |
|
printedRpg |
否 |
被导出/打印的报表组文件名，用于导出/打印与显示的报表组不是同一张时的情况 |
报表文件名(.rpg) |
无 |
|
excelFormat |
否 |
导出Excel的默认格式 |
导出Excel两种格式（xls，xlsx）中的一种 |
xls |
|
pdfLabel |
否 |
存为PDF钮外观定义 |
html元素或文字 |
存为PDF |
|
wordLabel |
否 |
存为Word钮外观定义 |
html元素或文字 |
存为Word |
|
ofdLabel |
否 |
存为OFD钮外观定义 |
html元素或文字 |
存为OFD |
|
saveAsName |
否 |
报表另存为Excel、PDF或离线填报时的文件名（不用带扩展名） |
文本 |
与报表同名 |
|
userFuncBarElements |
否 |
用户自定义的功能条中的功能元素 |
html元素，可多个或多层组合，如<table><tr><td> <a href=”…”>xxx</a> </td></tr></table> |
无 |
|
appletJarName |
否 |
用于报表打印的applet文件名，见注3 |
*.jar或者dir/.../*.jar |
runqianReportApplet.jar |
|
exceptionPage |
否 |
显示报表异常信息的JSP页面 |
页面相对于应用根目录的路径名 |
无 |
|
needLinkStyle |
否 |
单元格有超链接属性时，是否用设计的字体属性显示 |
yes或no |
yes |
|
maxTabLabelChars |
否 |
tab标题上最多显示几个字符，多余的变成... |
整数 |
20 |
|
tabLocation |
否 |
tab选项卡的位置 |
可选 top,bottom,left,right |
top |
|
sheetAlign |
否 |
报表组中设置报表对齐方式 |
可选值left,center |
left |
|
paramCheck |
否 |
是否对禁用参数值做校验。 禁用参数值可通过在WEB-INF/raqsoftConfig.xml中的disallowedParamWordList 属性中配置 |
yes 或 no |
yes |
|
lazyload |
否 |
是否延迟加载报表组的sheet |
yes 或 no |
no |
|
matchScreen |
|
报表自适应的方式。在页面设置matchScreen属性并在最后的script中添加脚本代码enableMatchGroup("group1"); |
数值0-8 0 按设计尺寸展现，不用适应容器。 6 竖屏时，不需适应容器；横屏时，报表高和宽均分别适应容器的高和宽 7 报表高和宽均分别适应容器的高和宽 8 按宽适应容器，报表高度保持不变 |
0 |
|
onlyExportDisplayedTabs |
否 |
只导出显示的sheet页。 与报表组关闭某个sheet页的js函数group_closeSheets结合使用，实现只导出未关闭的sheet页。 |
yes或no |
no |
|
exportPagedPdf |
否 |
导出PDF文件是否分页，默认分页。 |
yes或no |
yes |
|
exportPagedOfd |
否 |
导出OFD文件是否分页，默认分页。 |
yes或no |
yes |
|
浏览式报表组的属性 |
||||
|
useTabControl |
否 |
是否以TAB标签页的方式发布 |
yes或no，如为no，则首先显示第一个，然后用户可下拉选择显示哪一个 |
yes |
|
useCache |
否 |
显示此报表组时是否从缓存系统中取已经计算好的报表 |
yes或no 如果含有实时报表，应该设为no |
yes |
|
timeout |
否 |
从缓存系统中取多少分钟内产生的报表，如果没有此时间内的，则产生一个新报表 |
整数，表示分钟 负数表示不限时间 |
-1 |
注1：srcType的取值：
（1）如要发布的报表组源为报表文件，其值为file。
（2）如要发布的报表组源为经过API处理的报表组设计对象，则其值为bean。
注 2 :
groupId为必填属性，是为了允许在同一个页面中发布两个报表组，以此id作为标识，相关的导出、打印、翻页等功能会依据此标识。
注3 : 如果要打印含有集算器统计图的报表，则要将appletJarName属性设置为appletJarName="runqianReport4Applet.jar,dmGraphApplet.jar"。
注 4 ：lazyload属性：
（1）当属性值为yes时，表示刚开始展现时只加载报表组的第一个sheet，其他的sheet在第一次点击它所在的tab标题时才加载。
（2）当选择延迟加载时，sheet不再分页，而整页显示，needPaged这个属性的值会自动变为no。因为当sheet分页显示的，其实是另一种延迟加载方式，首次只加载sheet的第一页，其余页会在点击翻页按钮时加载。
注5：
paramCheck是否对禁用参数值做校验。默认是yes，会用内置的检测器做检查，如果不想对禁用参数值做校验，可以在预览的jsp中设置tag属性paramCheck = "no" 。