报表组

阅读(1119) 标签: group标签, tag标签,

本章主要介绍报表组的原理、用途及详细说明。

◆ 实例请参考TAG实例 / html模式发布报表 / 报表组

原理和用途:

通过报表组在网页上生成类似Excel的页签。

详细说明:

报表组在JSP文件中用<prefix:group>标签来发布,prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示:

<%@taglib uri="/WEB-INT/ 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对象,存在request中的名称

存储在request中的名称

无

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

needPrint

否

需要显示打印报表的功能钮吗

yes或no

No

needImportEasyui

否

是否需要引入easyui的js和css文件,如需修改easyui的主题风格可参考《润乾报表V2018应用开发教程》3.2.4小节

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

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

浏览式报表组的属性

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的第一页,其余页会在点击翻页按钮时加载。