报表展示标签

原理和用途

通过定义Tag 标签的属性及其值,在不需用户调用皕杰API 情况下,用tag标签完成报表的解析及运算,并按用户配置的属性要求将HTML 文件流输出到客户端。

详细说明

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

<%@ taglib prefix="bios" uri="http://www.bijetsoft.com/BiosReportTags" %> 

此定义语句必须写在JSP的开头,其中prefix的值可以自己指定,但tag标签中的前缀必须与其保持一致。

然后在要发布报表的地方用上面介绍的tag标签来发布,如:

<bios:report rpt="<%=rpt%>" params="<%=params%>" ……/> 

此标签的属性(属性名都是大小写相关,属性值必须放在双引号中)说明见下表:

参数名

是否必填

参数说明

参数值

缺省值

rpt

是

指定报表模板

报表模板的路径

无

brf

否

报表模板是否为brf文件

true或false(见注1)

 

brd

否

是否读取保存的报表的数据集缓存

true或false

 

rptobj

否

指定Object类型的报表模板

Object对象(见注5)

无

params

否

报表模板中的用户自定义参数

参数名1=参数值1;参数名2=参数值2;……

同报表模板中的参数名和默认值

vars

否

报表模板中的用户自定义变量

变量名1=变量值1;变量名2=变量值2;……

同报表模板中的参数名和默认值

rfscache

否

是否刷新缓存

true或false

false

pagecap

否

html页面上每页显示的行数

正整数

同设计器中报表模板的设置

rptwidth

否

报表在web上的输出宽度

整数、百分比、脚本表达式

采用report_config.xml中的配置

rptheight

否

报表在web上的输出高度

整数、百分比、脚本表达式

采用report_config.xml中的配置

rptskin

否

报表在web上的显示的皮肤颜色

见注2

无

rptmargin

否

报表在web上显示的外边距宽度

正整数

同设计器中报表模板的设置

offlinebtn

否

报表在web上显示的离线填报的按钮

true或false

true

validatebtn

否

填报报表工具条上是否显示校验按钮

true或false

true

hlayout

否

水平对齐选项(左侧、居中、拉伸)

left | center | fitwidth

left

toolbardisplay

否

是否显示工具条

top-在表格上方显示

below-在表格下方显示

bottom-在表格底端显示

none-不显示工具条

(见注3)

xlsbtn

否

工具条中是否显示整页导出Excel按钮

true或false

true

xlsbtn1

否

工具条中是否显示分页导出Excel按钮

true或false

true

pdfbtn

否

工具条中是否显示导出PDF按钮

true或false

true

docbtn

否

工具条中是否显示导出DOC按钮

true或false

true

printbtn

否

工具条中是否显示打印按钮

true或false

true

excelVersion

否

报表运行时,设置导出excel的文件格式

xls或xlsx

xls

name

否

reportSet标签中,report元素需设置该属性,做为tab标签页的标题

字符串

无

formmode

否

web上的表单模式

0-表示只读模式

1-表示可填报模式,控件显式显示

2-表示可填报模式,控件隐式显示

2

forwardurl

否

提交填报表单后,转向的位置,默认停留在本页

url地址

无

errorforward

否

提交填报表单失败时,转向的位置,默认停留在本页

url地址

无

saveprintconfig

否

可在web打印预览界面中显示” 保存设置”按钮。

true或false

false

printconfig

否

预设打印配置方案

print_config.xml中某个打印设置方案的id

 

注意

  1. 当“brf=true”时,rpt参数的参数值所指向的报表模板应为brf文件。
  2. 该参数对应于报表服务器的report_res目录下对应的skin文件的后缀名称。例如:“&rptskin=red”,对应于【skin-red】文件夹。
    如果你想要增加样式主题,具体步骤:①、可以复制【skin-red】文件夹 ②、把red修改为你设置的名称,例如“green” ③修改复制后的文件夹下的css样式表中的属性。再调用参数值的时候只需要调用【-】后的名称,例如:“&rptskin=green”。
  3. 在展现报表中默认值为below。在填报报表中默认值为top。
  4. forwardurl和errorforward只能在填报的时候使用。
  5. “ rpt”和“rptobj ”两个参数必须设置一个,并且只能有一个。