本章主要介绍填报表的原理、用途及详细说明。
◆ 实例请参考TAG实例 / 填报表
原理和用途:
通过填报表,可以录入数据,并把所录入的数据保存到数据库或者文件中。
详细说明:
填报表在JSP文件中用<prefix: input >标签来发布,prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示:
<%@ taglib uri="/WEB-INF/raqsoftInput.tld" prefix="raqsoft" %>
此定义语句必须写在JSP的开头,其中prefix的值可以自己指定,但tag标签中的前缀必须与其保持一致。
最后就可以写tag标签的内容了:
然后在要发布报表的地方用上面介绍的tag标签来发布,如:
<raqsoft:input id="….." src="……" ……/>
此标签的属性说明见下表:
(属性名都是大小写敏感,属性值必须放在双引号中)
属性名 |
是否必填 |
属性含义 |
属性取值 |
缺省值 |
|
填报表的属性 |
|||||
id |
是 |
填报表在网页中的ID标识 |
符合变量命名规则的字符串,在本网页中应是唯一的 |
无 |
|
src |
是 |
要发布的填报表文件。文件路径可以是相对路径,也可以是绝对路径。相对路径在设计器中,是相对于填报 - 选项 - 文件中的【应用资源路径】;独立部署时,是相对于[web应用根目录]\WEB-INF\raqsoftConfig.xml 中Input里配置的home配置路径。 |
填报表文件名*.sht |
无 |
|
paramMode |
否 |
参数模式 |
i、 p或r 。i时params参数值不脱双引号;p时params参数值脱双引号;r时从request里获取参数值。 |
i |
|
params |
否 |
填报表所需要的参数 |
用户提交的参数值,多参数时以分号分隔 |
无 |
|
excel |
否 |
是否显示Excel导入导出按钮 |
i、o或io。i时只显示Excel导入按钮;o时只显示Excel导出按钮;io时显示Excel导入和导出按钮。 |
io |
|
theme |
否 |
界面风格 |
default/bootstrap/black/gray/metro |
default |
|
needImportEasyui |
否 |
填报表控件是否需要引入easyui库 |
yes或者no |
yes |
|
width |
否 |
控件宽度 |
整数,象素值 或者百分数,如80% |
800 |
|
height |
否 |
控件高度 |
整数,象素值 或者百分数,如80% |
600 |
|
tabLocation |
否 |
sheet tab的位置 |
top或bottom |
top |
|
adp |
否 |
设置填报数据存取方式 |
yes或者no,yes以文件方式自动存取数据,no用户自定义存取数据的方式(脚本、spl文件、多源sql);假如未指定,则数据来源和数据去向都缺失时,采用yes |
no |
|
fixedHeader |
否 |
设置填报表是否固定表头 |
yes或者no |
yes |
|
file |
否 |
自动存取数据的文件 |
文件名 |
无 |
|
outerDim |
否 |
参数作为外部维,以逗号分隔的参数名 |
以逗号分隔的参数名 |
无 |
|
fileType |
否 |
设置保存数据文件内容的类型 |
json或binary。binary时需使用含有集文件功能点的润乾报表授权。 |
json |
|
exceptionPage |
否 |
设置错误异常信息页面 |
jsp文件名 |
myError.jsp |
|
saveAsName |
否 |
填报表另存为Excel的文件名(不用带扩展名) |
文本 |
与填报表同名 |
|
exportExcelExpType |
否 |
导出Excel时,对自动计算公式选用什么处理方式 |
1、2或3,1时导出公式,有异常就直接抛出错误,终止导出;2时导出公式出错时导出值;3时只导出值。 |
1 |
|
sheetAlign |
否 |
填报表水平对齐方式 |
left或center |
left |
|
paramCheck |
否 |
是否对禁用参数值做校验。 禁用参数值可通过在WEB-INF\raqsoftConfig.xml中的disallowedParamWordList 属性中配置 |
yes 或 no |
yes |
|
editable |
否 |
填报表是否可编辑 |
yes 或 no |
yes |
|
parseParam |
否 |
是否对传入的参数自动转换成不同的数据类型 |
yes或no |
yes |
|
hideRowHeight |
否 |
导出Excel时,给高度为0的隐藏行重新设置高度 |
数值 |
0 |
|
autoRowHeight |
否 |
导出Excel时,高度为0的隐藏行是否根据内容自动撑高行高 |
yes 或 no |
yes |
|
prompt |
否 |
提交时弹出提示框,询问是否确认提交 |
yes 或 no |
no |
|
update |
否 |
控制多源sql提交时使用的update函数的选项 |
u,i,a,k,l或d,各属性值含义参考集算器函数db.update()的对应选项 |
无 |
|
rounding |
否 |
控制小数舍位规则 |
rounding1:四舍五入舍位规则 rounding2:四舍六入五成双舍位规则 |
rounding1 |
|
exportExcelHideRow |
否 |
导出Excel时,高度为0的隐藏行是否导出。 有计算格时,慎用【不导出隐藏行/列】,表格结构发生变化,可能导致计算格错误。 |
yes或no |
yes |
|
exportExcelHideCol |
否 |
导出Excel时,宽度为0的隐藏列是否导出。 有计算格时,慎用【不导出隐藏行/列】,表格结构发生变化,可能导致计算格错误。 |
yes或no |
yes |
|
注1:
paramCheck是否对禁用参数值做校验。默认是yes,会用内置的检测器做检查,如果不想对禁用参数值做校验,可以在预览的jsp中设置tag属性paramCheck = "no" 。