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,示例如下: