html报表在JSP文件中用<prefix:html>标签来发布，prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示：
<%@taglib uri=”/WEB-INT/runqianReport4.tld” prefix=”report” %>
此定义语句必须写在JSP的开头，其中prefix的值可以自己指定，但tag标签中的前缀必须与其保持一致。然后在要发布报表的地方用上面介绍的tag标签来发布，如：
<report:html name=”…” reportFileName=”…” …./>
此标签的属性说明见下表：
(属性名都是大小写相关，属性值必须放在双引号中)
|
属性名 |
是否必填 |
属性含义 |
属性取值 |
缺省值 |
|
浏览式报表和单表填报式报表的公共属性 |
||||
|
name |
是 |
报表在网页中的ID标识 |
符合变量命名规则的字符串，在本网页中应是唯一的 |
无 |
|
srcType |
否 |
报表源的类型 |
见注1 |
file |
|
reportFileName |
否 |
当报表源类型为file时，要发布的报表文件 |
报表文件名 |
无 |
|
beanName |
否 |
当报表源类型为defineBean或reportBean时，已保存到request中的bean的名称 |
符合变量命名规则的字符串，与保存报表源bean时的名称一致 |
无 |
|
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 |
|
needSaveAsWord |
否 |
需要显示将报表存为Word的功能钮吗 |
yes或no |
No |
|
needSaveAsText |
否 |
需要显示将报表存为Text的功能钮吗 |
yes或no |
No |
|
needPrint |
否 |
需要显示打印报表的功能钮吗 |
yes或no |
No |
|
printLabel |
否 |
打印钮外观定义 |
html元素或文字 |
打印 |
|
needDirectPrint |
否 |
需要显示直接打印报表的Applet按钮 |
yes或no，当为yes时，如果定义了funcBarFontColor和functionBarColor, 那么应该用”#FFFFFF”之类的颜色值，printLabel应该只用文字 |
No |
|
needPrintPrompt |
否 |
直接打印报表前是否需要提示确认 |
yes或no |
no |
|
needSelectPrinter |
否 |
直接打印报表时可否选择打印机 |
yes或no |
no |
|
savePrintSetup |
否 |
是否将客户端电脑的打印设置发回服务器保存，以备下次打印这张报表时使用 |
yes或no，具体使用请参数本节注2 |
no |
|
printButtonWidth |
否 |
直接打印的Applet按钮的宽度 |
整数象素值 |
40 |
|
printButtonHeight |
否 |
直接打印的Applet按钮的高度 |
整数象素值 |
16 |
|
printedRaq |
否 |
被打印的报表文件名，用于打印与显示的报表不是同一张时的情况 |
报表文件名(.raq)，相对于reportFileHome |
无 |
|
excelLabel |
否 |
存为Excel钮外观定义 |
html元素或文字 |
存为Excel |
|
pdfLabel |
否 |
存为PDF钮外观定义 |
html元素或文字 |
存为PDF |
|
wordLabel |
否 |
存为Word钮外观定义 |
html元素或文字 |
存为Word |
|
textLabel |
否 |
存为Text钮外观定义 |
html元素或文字 |
存为Text |
|
textDataSeparator |
否 |
存为Text时，同行单元格数据间的分隔符 |
字符 |
TAB键（\t） |
|
excelUsePaperSize |
否 |
存为EXCEL时：yes按报表设计时的纸张尺寸，no采用本TAG标签中指定的width，height值 |
yes或no |
no |
|
saveAsName |
否 |
报表另存为Excel、PDF或离线填报时的文件名（不用带扩展名） |
文本 |
与报表同名 |
|
excelPageStyle |
否 |
存为Excel时的分页方式，不指定此属性值，则系统弹出对话框让用户选 |
0（不分页）或1（分页） |
无 |
|
userFuncBarElements |
否 |
用户自定义的功能条中的功能元素 |
Html元素，可多个或多层组合，如<table><tr><td> <a href=”…”>xxx</a> </td></tr></table> |
无 |
|
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文件名 |
*.jar或者dir/…/*.jar |
runqianReportApplet.jar |
|
exceptionPage |
否 |
显示报表异常信息的JSP页面 |
页面相对于应用根目录的路径名 |
无 |
|
浏览式报表的属性 |
||||
|
width |
否 |
报表分页宽度 |
整数，单位为px,负数表示无穷大 |
报表设计页面宽度 |
|
height |
否 |
报表分页高度 |
整数，单位为px,负数表示无穷大 |
报表设计页面高度 |
|
columns |
否 |
报表分栏数 |
整数 |
报表设计分栏数 |
|
needPageMark |
否 |
是否显示报表页数及翻页功能 |
yes或no |
yes |
|
pageMarkLabel |
否 |
报表页数显示钮的外观定义 |
html元素或文字，用{currPage}表示当前页号，用{totalPage}表示总页数 |
第{currPage}页 共{totalPage}页 |
|
firstPageLabel |
否 |
翻到第一页的功能钮外观定义 |
html元素或文字 |
最前页 |
|
prevPageLabel |
否 |
翻到前一页的功能钮外观定义 |
html元素或文字 |
上一页 |
|
nextPageLabel |
否 |
翻到后一页的功能钮外观定义 |
html元素或文字 |
下一页 |
|
lastPageLabel |
否 |
翻到最后页的功能钮外观定义 |
html元素或文字 |
最后页 |
|
displayNoLinkPageMark |
否 |
是否显示无超链接的页码标识（如第一页时的”最前页”和”上一页” |
yes或no |
no |
|
单表填报式报表的属性 |
||||
|
submit |
否 |
提交按钮外观定义 |
html元素或文字 |
提交 |
|
needOfflineInput |
否 |
是否可以离线填报 |
yes或no |
no |
|
offline |
否 |
离线保存按钮定义 |
html元素或文字 |
保存到本机 |
|
needImportExcel |
否 |
是否可从Excel文件上载数据来填报 |
yes或no 或者”yes,0″表示可以上载到页面中，但禁止直接上载到数据库 |
no |
|
importExcelLabel |
否 |
导入Excel文件按钮定义 |
html元素或文字 |
从Excel导入 |
|
inputListener |
否 |
保存数据前后的java监听器类 |
java类名 |
|
|
backAndRefresh |
否 |
提交数据以后，是否返回录入页面并刷新页面 |
yes或no或URL，若为URL，则提交后将定位到此指定的URL |
yes |
|
selectText |
否 |
单元格获得焦点时，是否选中单元格的内容 |
yes或no |
no |
|
promptAfterSave |
否 |
是否弹出提示数据已保存 |
yes或no |
yes |
|
saveDataByListener |
否 |
是否由用户写的填报监听器来保存数据 |
yes或no，为yes时则报表系统不保存数据，由用户实现数据的保存。 |
no |
|
autoCalcOnlyOnSubmit |
否 |
只在提交数据时执行自动计算 |
yes或no，在填报表单元格很多造成移动光标慢时可设为yes |
no |
|
inputExceptionPage |
否 |
显示填报报表保存数据时的异常信息的JSP页面 |
页面相对于应用根目录的路径名 |
无 |
|
keyRepeatError |
否 |
插入新记录时，主键重复是否报错 |
yes或no，为yes时则报错，为no时则用新数据更新原记录 |
no |
注1：srcType的取值：
（1）如要发布的报表源为报表文件，其值为file。
（2）如要发布的报表源为经过API处理的报表设计对象，则其值为defineBean。
（3）如要发布的报表源为经过API计算后的报表结果对象，则其值为reportBean。
注2：savePrintSetup的使用：
使用这个属性需要增加一个servlet的配置如下：
#001 <servlet>
#002 <servlet-name>com.runqian.report4.usermodel.PrintSetupServlet</servlet-name>
#003 <servlet-class>com.runqian.report4.usermodel.PrintSetupServlet</servlet-class>
#004 </servlet>
#005
#006 <servlet-mapping>
#007 <servlet-name> com.runqian.report4.usermodel.PrintSetupServlet</servlet-name>
#008 <url-pattern>/servlet/PrintSetupServlet</url-pattern>
#009 </servlet-mapping>
红色字体部分”/servlet/PrintSetupServlet”是servlet的映射路径，不可更改。com.runqian.report.usermodel.PrintSetupServlet是润乾提供的一个缺省servlet实现，可以被替换。
