html- viewReport-报表展现标签与API
目录

html

 

属性说明

(属性名都是大小写相关,属性值必须放在双引号中)

属性名 是否必填 属性含义 属性取值 缺省值
name 报表在网页中的ID标识 符合变量命名规则的字符串,在本网页中应是唯一的
reportFileName 当报表源类型为file时,要发布的报表文件 报表文件名
scale 报表缩放显示比例 实数 1
srcType 报表源的类型 如要发布的报表组源为报表文件,其值为file。
如要发布的报表组源为经过API处理的报表组设计对象,则其值为bean
file
beanName 当报表源类型为defineBean或reportBean时,已保存到request中的bean的名称 符合变量命名规则的字符串,与保存报表源bean时的名称一致,且在整个WEB应用中应唯一
contextName

见注1

变量名
useCache 显示此报表时是否从缓存系统中取已经计算好的报表 yes或no.如果是实时报表,应该设为no yes
timeout 从缓存系统中取多少分钟内产生的报表,如果没有此时间内的报表,则产生一个新报表 整数,表示分钟.负数表示不限时间 -1
width 报表分页宽度 整数,单位为px,负数表示无穷大 报表设计页面宽度
height 报表分页高度 整数,单位为px,负数表示无穷大 报表设计页面高度
columns 报表分栏数 整数 报表设计分栏数
needPageMark 是否显示报表页数及翻页功能 yes或no yes
funcBarLocation 功能条的位置 top, bottom, both top
funcBarFontFace 功能条的字体 字体名称 宋体
funcBarFontSize 功能条的字体大小 与html文件中定义字体大小相同 13px
funcBarFontColor 功能条的字体颜色 html文件中使用的颜色 black
needSaveAsExcel 需要显示将报表存为Excel的功能钮吗 yes或no no
needSaveAsPdf 需要显示将报表存为PDF的功能钮吗 yes或no No
needSaveAsWord 需要显示将报表存为Word的功能钮吗 yes或no No
needPrint 需要显示打印报表的功能钮吗 yes或no No
functionBarColor 功能条背景色 html文件中使用的颜色 无颜色
separator 各功能钮间的分隔符 html元素或文字 空格
pageMarkLabel 报表页数显示钮的外观定义 html元素或文字,用{currPage}表示当前页号,用{totalPage}表示总页数 第{currPage}页 共{totalPage}页
firstPageLabel 翻到第一页的功能钮外观定义 html元素或文字 最前页
prevPageLabel 翻到前一页的功能钮外观定义 html元素或文字 上一页
nextPageLabel 翻到后一页的功能钮外观定义 html元素或文字 下一页
lastPageLabel 翻到最后页的功能钮外观定义 html元素或文字 最后页
printLabel 打印钮外观定义 html元素或文字 打印
excelLabel 存为Excel钮外观定义 html元素或文字 存为Excel
pdfLabel 存为PDF钮外观定义 html元素或文字 存为PDF
wordLabel 存为Word钮外观定义 html元素或文字 存为Word
generateParamForm 是否生成缺省报表参数及宏输入表单 yes或no no
displayNoLinkPageMark 是否显示无超链接的页码标识(如第一页时的“最前页”和“上一页” yes或no no
params 报表所需要的参数 用户提交的参数值
saveAsName 报表另存为Excel、PDF或离线填报时的文件名(不用带扩展名) 文本 与报表同名
submit 提交按钮外观定义 html元素或文字 提交
submitTarget 显示提交结果的窗口名,如果取值不是_self,则当保存发生异常时,因当前输入页面还保留,故用户输入数据不会丢失 与html中的form的target属性相同 _self
needOfflineInput 是否可以离线填报 yes或no no
offline 离线保存按钮定义 html元素或文字 保存到本机
inputListener 保存数据前后的java监听器类 java类名 0
needImportExcel 是否可从Excel文件上载数据来填报 yes或no,或者“yes,0”表示可以上载到页面中,但禁止直接上载到数据库 no
importExcelLabel 导入Excel文件按钮定义 html元素或文字 从Excel导入
importExcelAppend 行式报表填报中是否采用追加行的方式导入excel文件中的数据区行 Yes或者No, 属性为yes时,在当前扩展区尾部追加excel文件中的所有数据区行。属性为no时,从当前光标所在行开始,用excel文件中的数据区行逐行替换当前扩展区的数据行。替换完以后,其余的行采用追加导入的方式。 yes
usePaperSizePrint 0 0 0 0
excelPageStyle 存为Excel时的分页方式,不指定此属性值,则系统弹出对话框让用户选 0(不分页)或1(分页)
pdfExportStyle 存为PDF时,导出的文件分页方式及导出类型,导出类型分为图形方式及text方式。 属性值格式为: "文件类型,是否分页".文件类型取值为:graph: 将文字导出为图形方式.text:将文字导出为文本方式.1表示要分页,0表示不分页
printedRaq 被打印的报表文件名,用于打印与显示的报表不是同一张时的情况 报表文件名(.raq),相对于reportFileHome
backAndRefresh 提交数据以后,是否返回录入页面并刷新页面 yes或no或URL,若为URL,则提交后将定位到此指定的URL yes
excelUsePaperSize 存为EXCEL时:yes按报表设计时的纸张尺寸,no采用本TAG标签中指定的width,height值 yes或no no
needSaveAsText 需要显示将报表存为Text的功能钮吗 yes或no No
textLabel 存为Text钮外观定义 html元素或文字 存为Text
textDataSeparator 存为Text时,同行单元格数据间的分隔符 字符 TAB键(\t)
textDataLineBreak 存为Text时,自定义换行符 换行符 \n
userFuncBarElements 用户自定义的功能条中的功能元素 Html元素,可多个或多层组合,如<table><tr><td>.<a href=”…”>xxx</a>.</td></tr></table>
selectText 单元格获得焦点时,是否选中单元格的内容 yes或no no
needDirectPrint 需要显示直接打印报表的Applet按钮吗 yes或no,当为yes时,如果定义了funcBarFontColor和functionBarColor, 那么应该用”#FFFFFF”之类的颜色值,printLabel应该只用文字 No
needPrintPrompt 直接打印报表前是否需要提示确认 yes或no no
needSelectPrinter 直接打印报表时可否选择打印机 yes或no no
savePrintSetup 是否将客户端电脑的打印设置发回服务器保存,以备下次打印这张报表时使用,该属性对直接打印也起作用 yes或no no
printButtonWidth 直接打印的Applet按钮的宽度 整数象素值 40
printButtonHeight 直接打印的Applet按钮的高度 整数象素值 16
promptAfterSave 是否弹出提示数据已保存 yes或no yes
autoCalcOnlyOnSubmit 只在提交数据时执行自动计算 yes或no,在填报表单元格很多造成移动光标慢时可设为yes no
needScroll 是否固定上表头和左表头.固定表头后,页面报表不分页,分页方式设置无效 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文件名见注3 *.jar或者dir/.../*.jar runqianReportApplet.jar
useJinit 0 0 0 0
exceptionPage 显示报表异常信息的JSP页面 页面相对于应用根目录的路径名
inputExceptionPage 显示填报报表保存数据时的异常信息的JSP页面 页面相对于应用根目录的路径名
keyRepeatError 插入新记录时,主键重复是否报错 yes或no,为yes时则报错,为no时则用新数据更新原记录 no
saveDataByListener 是否由用户写的填报监听器来保存数据 yes或no,为yes时则报表系统不保存数据,只向监听器返回一组SQL语句 no
insertRowLabel 插入行按钮外观定义 html元素或文字 插入
appendRowLabel 添加行按钮外观定义 html元素或文字 添加
deleteRowLabel 删除行按钮外观定义 html元素或文字 删除
paperType 纸张类型 纸张类型值,比如A4,B5 报表设计纸张类型
paperWidth 纸张宽度 整数(毫米,像素,英寸) 报表设计纸张宽度
paperHeight 纸张高度 整数(毫米,像素,英寸) 报表设计纸张高度
leftMargin 左边距 整数(毫米,像素,英寸) 报表设计左边距
rightMargin 右边距 整数(毫米,像素,英寸) 报表设计右边距
topMargin 上边距 整数(毫米,像素,英寸) 报表设计上边距
bottomMargin 下边距 整数(毫米,像素,英寸) 报表设计下边距
needLinkStyle 单元格有超链接属性时,是否用设计的字体属性显示 yes或no yes
validOnSubmit 是否在提交时进行有效性验证;1、设计单元格的有效性验证为立即校验2、tag中设属性validOnSubmit="no" 这样用户输入不合法值时会弹出信息提示错误,用户确定后可以修改或不修改,达到警告的目的,提交数据时也不会再校验。 yes或no yes
directPrintImgLabel 直接打印钮外观定义 图片相对于应用根目录的路径名 打印
calculateListener 报表计算前后的java监听器类 java类名
serverPagedPrint applet打印时是否采用服务器分页后再按页传输的方式。一般大数据量的报表采用此方式 yes或no yes
needPagedScroll 固定表头后是否分页,needScroll为no时设置失效 yes或no no
mirrorPrint 打印时是否使用镜像打印 取值为yes或no no
localPrint 是否使用本地打印程序来进行打印,需要证书中授权 取值为yes或no no
saveToLocal 是否允许将此报表在打印预览后存到客户机,只有在localPrint为yes时才起作用 取值为yes或no yes
reportAreaWidth 报表的显示宽度 整数,象素值.或者百分数,如80% 0
reportAreaHeight 报表的显示高度 整数,象素值.或者百分数,如80% 0
reportAlign 报表在页面中的显示位置 left,center,right left 
excelFormat 导出excel的方式 2003,2007,openXml 2003

 

注1:如果调用TAG前,是用API生成的Context对象来运算报表,那么应将此对象传给TAG,示例如下:

 

<%
……
Context context = new Context();
…….
request.setAttribute( “myContext”, context );
%>
<view:html
……
contextName=”myContext” />