报表展示标签

原理和用途

通过定义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 ”两个参数必须设置一个,并且只能有一个。