填报表

阅读（21）点赞（0）标签: html渲染填报表, input,

本章节主要介绍HTML渲染填报表的原理、用途、编写方式及属性说明。

原理和用途：

通过填报表可以录入数据，并将录入的数据保存到数据库或者文件中。声明式渲染填报表采用HTML标签属性驱动模式，在div元素上声明data-report-type="input"并配置相关属性。开发人员无需手动调用润乾报表API，由报表框架自动完成填报表的解析，根据配置将渲染生成的填报表HTML输出至客户端浏览器，实现填报表展示。

声明式渲染写法：

在页面中编写如下div元素，即可发布填报表：

<div id="reportContainer"

data-report-type="input"

data-report-id="input1"

data-report-src="填报表.sht" >

</div>

属性说明：

填报表渲染可用属性见下表：

(属性名大小写敏感，属性值必须放置在双引号内)

属性名	是否必填	属性含义	属性取值	缺省值
填报表的属性
data-report-id	是	填报表在网页中的ID标识	符合变量命名规则的字符串，在本网页中应是唯一的	无
data-report-src	是	要发布的填报表文件。文件路径可以是相对路径，也可以是绝对路径。相对路径在设计器中，是相对于填报 - 选项 - 文件中的【应用资源路径】；独立部署时，是相对于[web应用根目录]\WEB-INF\raqsoftConfig.xml 中Input里配置的home配置路径。	填报表文件名*.sht	无
data-report-paramMode	否	参数模式	i、 p或r 。i时params参数值不脱双引号；p时params参数值脱双引号；r时从request里获取参数值。	i
data-report-params	否	填报表所需要的参数	用户提交的参数值，多参数时以分号分隔	无
data-report-excel	否	是否显示Excel导入导出按钮	i、o或io。i时只显示Excel导入按钮；o时只显示Excel导出按钮；io时显示Excel导入和导出按钮。	io
data-report-theme	否	界面风格	default/bootstrap/black/gray/metro	default
data-report-needImportEasyui	否	是否需要引入easyui的js和css文件	yes或no	no
data-report-width	否	控件宽度	整数，像素值或者百分数，如80%，见注3	800
data-report-height	否	控件高度	整数，像素值或者百分数，如80%，见注3	600
data-report-tabLocation	否	sheet tab的位置	top或bottom	bottom
data-report-adp	否	设置填报数据存取方式	yes或者no，yes以文件方式自动存取数据，no用户自定义存取数据的方式(脚本、spl文件、多源sql）；假如未指定，则数据来源和数据去向都缺失时，采用yes	no
data-report-fixedHeader	否	设置填报表是否固定表头	yes或者no	yes
data-report-file	否	自动存取数据的文件	文件名	无
data-report-outerDim	否	参数作为外部维，以逗号分隔的参数名	以逗号分隔的参数名	无
data-report-fileType	否	设置保存数据文件内容的类型	json或binary。binary时需使用含有集文件功能点的润乾报表授权。	json
data-report-exceptionPage	否	显示填报表异常信息的html页面	可以是绝对路径或相对路径名，相对于当前使用的html页面所在路径。如：/demo/error.html或myError.html	无
data-report-saveAsName	否	填报表另存为Excel的文件名（不用带扩展名）	文本	与填报表同名
data-report-exportExcelExpType	否	导出Excel时，对自动计算公式选用什么处理方式	1、2或3，1时导出公式，有异常就直接抛出错误，终止导出；2时导出公式出错时导出值；3时只导出值。	1
data-report-sheetAlign	否	填报表水平对齐方式	left或center	left
data-report-paramCheck	否	是否对禁用参数值做校验。禁用参数值可通过在WEB-INF\raqsoftConfig.xml中的disallowedParamWordList 属性中配置	yes 或 no	yes
data-report-editable	否	填报表是否可编辑	yes 或 no	yes
data-report-parseParam	否	是否对传入的参数自动转换成不同的数据类型	yes或no	yes
data-report-hideRowHeight	否	导出Excel时，给高度为0的隐藏行重新设置高度	数值	0
data-report-autoRowHeight	否	导出Excel时，是否自动撑开行高，根据单元格文本内容动态计算行高度。	yes 或 no 见注2	yes
data-report-prompt	否	提交时弹出提示框，询问是否确认提交	yes 或 no	no
data-report-update	否	控制多源sql提交时使用的update函数的选项	u，i，a，k，l或d，各属性值含义参考集算器函数*db.update()*的对应选项	无
data-report-rounding	否	控制小数舍位规则	rounding1：四舍五入舍位规则 rounding2：四舍六入五成双舍位规则	rounding1
data-report-exportExcelHideRow	否	导出Excel时，高度为0的隐藏行是否导出。有计算格时，慎用【不导出隐藏行/列】，表格结构发生变化，可能导致计算格错误。	yes或no	yes
data-report-exportExcelHideCol	否	导出Excel时，宽度为0的隐藏列是否导出。有计算格时，慎用【不导出隐藏行/列】，表格结构发生变化，可能导致计算格错误。	yes或no	yes

注1：

data-report-paramCheck是否对禁用参数值执行校验。默认值为yes，框架会使用内置检测器进行校验；若不需要对禁用参数值校验，可在填报表div属性中配置data-report-paramCheck = "no" 。

注2：

data-report-autoRowHeight使用前置条件：单元格不能是合并单元格，单元格内容不为空，单元格属性设置自动换行，单元格行高不能设置为0。

注3：

若data-report-width和data-report-height使用百分比取值，必须在填报表渲染所在div元素上显式指定width与height；若填报表外层容器未设置宽高，会出现显示异常。示例如下：