本章主要介绍填报表的原理、用途及详细说明。
◆ 实例请参考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 |
是 |
要发布的报表文件 |
填报表文件名*.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 |
|
noDfx |
否 |
设置填报数据存储方式 |
yes或者no,yes时以文件方式自动存取数据;no时用户自定义存取数据的dfx;假如未指定,则数据来源和数据去向都缺失时,采用yes |
yes |
|
fixedHeader |
否 |
设置填报表是否固定表头 |
yes或者no |
yes |
|
file |
否 |
自动存取数据的文件 |
文件名 |
无 |
|
outerDim |
否 |
参数作为外部维,以逗号分隔的参数名 |
以逗号分隔的参数名 |
无 |
|
fileType |
否 |
设置保存数据文件内容的类型 |
json或binary |
json |
|
exceptionPage |
否 |
设置错误异常信息页面 |
jsp文件名 |
inputErrorPage.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 |
|