html 模式发布报表

属性名

是否必填

属性含义

属性取值

缺省值

浏览式报表和单表参数报表的公共属性

name

是

报表在网页中的ID标识

符合变量命名规则的字符串，在本网页中应是唯一的

无

srcType

否

报表源的类型

见注1

file

reportFileName

否

当报表源类型为file时，要发布的报表文件

报表文件名

无

beanName

否

当报表源类型为defineBean或reportBean时，已保存到request中的bean的名称

符合变量命名规则的字符串，与保存报表源bean时的名称一致，且在整个web应用中应唯一

无

contextName

否

用bean的方式发布报表时，计算出报表bean时用的Context对象，存在session中的名称

存储在session中的名称

无

scale

否

报表缩放显示比例

实数

1.0

funcBarLocation

否

功能条的位置

top, bottom, both

top

separator

否

各功能钮间的分隔符

html元素或文字

空格

generateParamForm

否

是否生成缺省报表参数输入表单

yes或no

no

params

否

报表所需要的参数

用户提交的参数值

无

funcBarFontFace

否

功能条的字体

字体名称

宋体

funcBarFontSize

否

功能条的字体大小

与html文件中定义字体大小相同

13px

funcBarFontColor

否

功能条的字体颜色

html文件中使用的颜色

black

functionBarColor

否

功能条背景色

html文件中使用的颜色

无颜色

needSaveAsExcel

否

需要显示将报表存为Excel的功能钮吗

yes或no

no

needSaveAsPdf

否

需要显示将报表存为PDF的功能钮吗

yes或no

no

needSaveAsText

否

需要显示将报表存为Text的功能钮吗

yes或no

no

needSaveAsWord

否

需要显示将报表存为Word的功能钮吗

yes或no

no

needSaveAsPicture

否

需要显示将报表存为图片的功能钮吗

yes或no

no

needSaveAsOfd

否

需要显示将报表存为OFD的功能钮吗

yes或no

no

needPrint

否

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

yes或no

no

needPdfPrint

否

是否需要生成PDF打印的功能按钮

yes或no

no

pdfPrintLabel

否

PDF打印按钮的内容

html元素或文字

PDF打印

printLabel

否

打印按钮外观定义

html元素或文字

打印

needDirectPrint

否

需要显示直接打印报表的Applet按钮吗

yes或no，当为yes时，如果定义了funcBarFontColor和functionBarColor, 那么应该用”#FFFFFF”之类的颜色值，printLabel应该只用文字

no

directPrintLabel

否

直接打印钮外观定义

html元素或文字

直接打印

needPrintPrompt

否

直接打印报表前是否需要提示确认

yes或no

no

needSelectPrinter

否

直接打印报表时可否选择打印机

yes或no

no

savePrintSetup

否

是否将客户端电脑的打印设置发回服务器保存，以备下次打印这张报表时使用，该属性对直接打印也起作用

yes或no

no

printedRaq

否

被导出/打印的报表文件名，用于导出/打印与显示的报表不是同一张时的情况

报表文件名(.rpx)，相对于raqsoftConfig.xml文件下<Report>里的<home>属性所对应的路径

无

excelLabel

否

存为Excel钮外观定义

html元素或文字

存为Excel

pdfLabel

否

存为PDF钮外观定义

html元素或文字

存为PDF

textLabel

否

存为Text钮外观定义

html元素或文字

存为Text

wordLabel

否

存为Word钮外观定义

html元素或文字

存为Word

ofdLabel

否

存为OFD钮外观定义

html元素或文字

存为OFD

csvDataSeparator

否

存为csv时，同行单元格数据间的分隔符

字符

逗号

textDataSeparator

否

存为Text时，同行单元格数据间的分隔符

字符

TAB键（\t）

textDataLineBreak

否

存为Text时，自定义换行符

换行符

\n

exportDisp4text

否

导出Text文件时是否导出显示值

yes或no

no

excelUsePaperSize

否

存为Excel时：yes按报表设计时的纸张尺寸，no采用本tag标签中指定的width，height值

yes或no

no

excelFormat

否

导出Excel的默认格式

导出Excel两种格式（xls，xlsx）中的一种

xls

saveAsName

否

报表另存为Excel、PDF、Word、Text的文件名（不用带扩展名）

文本

与报表同名

excelPageStyle

否

存为Excel时的分页方式，不指定此属性值，则系统弹出对话框让用户选

0（不分页）或1（分页）

无

pdfExportStyle

否

存为PDF时，导出的文件分页方式及导出类型，导出类型分为图形方式及Text方式。

属性值格式为: "文件类型,是否分页"

文件类型取值为：

graph: 将文字导出为图形方式

Text：将文字导出为文本方式

1表示要分页，0表示不分页

无

ofdExportStyle

否

存为OFD时，导出的文件分页方式及导出类型，导出类型目前仅支持图形方式。

属性值格式为: "文件类型,是否分页"

文件类型取值为：

graph: 将文字导出为图形方式

1表示要分页，0表示不分页

无

userFuncBarElements

否

用户自定义的功能条中的功能元素

html元素，可多个或多层组合，如<table><tr><td>

<a href=”…”>xxx</a>

</td></tr></table>

无

needScroll

否

是否固定上表头和左表头

固定表头后，页面报表不分页，分页方式设置无效

yes或no

no

needPagedScroll

否

固定表头后是否分页，needScroll为no时设置失效

yes或no

no

scrollWidth

否

固定表头报表的显示宽度

整数，象素值

或者百分数，如80%

600

scrollHeight

否

固定表头报表的显示高度

整数，象素值

或者百分数，如80%

400

scrollBorder

否

固定表头报表的边框

html的边框表示法，如：“border:1px solid red”，“border-top: 1px solid blue; border-left: 1px solid green;……”

无

appletJarName

否

用于报表打印的applet文件名

*.jar或者dir/.../*.jar

raqsoftReportApplet.jar

exceptionPage

否

显示报表异常信息的JSP页面

页面相对于应用根目录的路径名

无

needLinkStyle

否

单元格有超链接属性时，是否用设计的字体属性显示

yes或no

yes

paperType

否

纸张类型

纸张类型值，比如A4，B5

报表设计纸张类型

paperWidth

否

纸张宽度

整数(毫米，像素，英寸)

报表设计纸张宽度

paperHeight

否

纸张高度

整数(毫米，像素，英寸)

报表设计纸张高度

leftMargin

否

左边距

整数(毫米，像素，英寸)

报表设计左边距

rightMargin

否

右边距

整数(毫米，像素，英寸)

报表设计右边距

topMargin

否

上边距

整数(毫米，像素，英寸)

报表设计上边距

bottomMargin

否

下边距

整数(毫米，像素，英寸)

报表设计下边距

serverPagedPrint

否

applet打印时是否采用服务器分页后再按页传输的方式。一般大数据量的报表采用此方式

yes或no

yes

mirrorPrint

否

打印时是否使用镜像打印

取值为yes或no

no

reportEnterUrl

否

访问此报表的url地址，当访问地址不是jsp时需要指定

访问报表的url地址

无

printerName

否

默认打印机名称

操作系统中显示的打印机名称

无

generateCellId

否

是否生成单元格ID

yes或no

no

isOlap

否

是否提供展开、收拢的功能，将该报表称为OLAP式折叠报表

yes 或 no

no

isTreeTable

否

是否以树形报表展现，将该报表称为树形报表

yes 或 no

no

foldType

否

设置折叠报表的行列折叠类型，适用于OLAP式折叠报表和树形报表

both(行列都折叠)、row(只有行向折叠)或col(只有列向折叠)

both

foldIcon

否

折叠图标的类型，适用于OLAP式折叠报表和树形报表

plus(加减号)或arrow(箭头)

plus

foldOnBegin

否

折叠报表初始展现时折叠到第几层，适用于OLAP式折叠报表和树形报表

yes(全折叠)、no(全展开)或整数(可以看见的层数)

no

base64Image

否

是否将图片或背景图输出为base64格式

yes 或 no

no

modifiable

否

是否可在web页面中修改单元格数据，此属性必须和报表中的“能否修改”属性同时使用，使用此属性时分页无效

yes 或 no

no

paramCheck

否

是否对禁用参数值做校验。

禁用参数值可通过在WEB-INF/raqsoftConfig.xml中的disallowedParamWordList 属性中配置

yes 或 no

yes

reportAlign

否

设置报表的横向显示位置，needScroll属性值为no时，本属性无效

left或center

center

matchScreen

否

报表的自适应方式。使用matchScreen属性时，jsp的语法应类似mobile/mbReport.jsp那样

数值0-8

0 按设计尺寸展现，不用适应容器。

1 始终用报表宽度适应容器宽度，报表高度同比例缩放

2 始终用报表高度适应容器高度，报表宽度同比例缩放

3 竖屏时，相当于mode=2；横屏时，相当于mode=1

4 竖屏时，相当于mode=1；横屏时，相当于mode=2

　 5 竖屏时，报表高和宽均分别适应容器的高和宽；横屏时，不需适应容器

 6 竖屏时，不需适应容器；横屏时，报表高和宽均分别适应容器的高和宽

 7 报表高和宽均分别适应容器的高和宽

8 按宽适应容器，报表高度保持不变

　　横屏定义为容器宽度大于高度，竖屏定义为容器高度大于宽度。

1

pdfPrintPages

否

PDF打印的页码编号

整数，比如"1,3"、"3-6,8,10-14"等

打印全部

tableLayout

否

设置表格的布局

auto：自动表格布局，列宽度由没有折行的单元格最宽内容设定。

fixed：固定表格布局，列宽由表格宽度和列宽度设定，与单元格内容无关。

fixed

directPrintCopies

否

applet直接打印时，指定打印几份

整数

1

directPrintPages

否

applet直接打印时，指定到打印的页码编号

整数，比如"1,3"、"3-6,8,10-14"等

打印全部

displayReport

否

是否显示报表

yes或no

yes

needImportEasyui

否

是否需要引入easyui的js和css文件，如需修改easyui的主题风格可参考修改easyui插件的主题小节

yes或no

yes

theme

否

编辑控件的外观主题风格

default,black,bootstrap,gray,metro

default

bigPage

否

当前报表是否始终用大页面机制展现。详见注5

yes或no或auto，默认no。当值为yes时，当前报表始终用大页面机制展现；当值为auto，则判断html长度大于50万时使用大页面机制。

no

mobileMode

否

指定报表是否使用手机模式渲染

yes或no，默认值为空。

yes：按照手机模式渲染。

no：按照电脑模式渲染。

无(不指定此参数时程序自动检测浏览器的user-agent来判断是手机浏览器还是电脑浏览器)

浏览式报表的属性

useCache

否

显示此报表时是否从缓存系统中取已经计算好的报表

yes或no

如果是实时报表，应该设为no

yes

timeout

否

从缓存系统中取多少分钟内产生的报表，如果没有此时间内的报表，则产生一个新报表

整数，表示分钟

负数表示不限时间

-1

width

否

报表分页宽度

整数，单位为px,负数表示无穷大

报表设计页面宽度

height

否

报表分页高度

整数，单位为px,负数表示无穷大

报表设计页面高度

columns

否

报表分栏数

整数

报表设计分栏数

needPageMark

否

是否显示报表页数及翻页功能

yes或no

yes

firstPageLabel

否

翻到第一页的功能钮外观定义

html元素或文字

最前页

prevPageLabel

否

翻到前一页的功能钮外观定义

html元素或文字

上一页

nextPageLabel

否

翻到后一页的功能钮外观定义

html元素或文字

下一页

lastPageLabel

否

翻到最后页的功能钮外观定义

html元素或文字

最后页

displayNoLinkPageMark

否

是否显示无超链接的页码标识（如第一页时的“最前页”和“上一页”

yes或no

no