统计表

阅读（11）点赞（0）标签: html渲染统计表, 基准表, aggr,

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

原理和用途：

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

声明式渲染写法：

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

<div id="reportContainer"

data-report-type="aggr"

data-report-id="aggr1"

data-report-src="统计表.sht"

data-report-dataFiles="autoDataFiles/data1.json;autoDataFiles/data2.json"

data-report-fileType="json"

data-report-tabLocation="bottom" >

</div>

属性说明：

统计表渲染可用属性见下表：

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

属性名	是否必填	属性含义	属性取值	缺省值
统计表的属性
data-report-id	是	统计表在网页中的ID标识	符合变量命名规则的字符串，在本网页中应是唯一的	无
data-report-src	是	要发布的统计表模板文件	统计表文件名*.sht	无
data-report-mode	否	参数模式	i或r 。i时params参数值不脱双引号；r时从request里获取参数值。	i
data-report-dataFiles	是	设置统计表所需统计的数据文件	数据文件名，mode=i时，多个文件路径以分号分隔，最后的文件名支持通配符*和？，前面路径不支持；mode=r时，这里为request里的变量名	无
data-report-fileType	是	设置需要做统计的文件内容的类型，对应基准表存储的文件内容的类型。	json或binary。binary时需使用含有集文件功能点的润乾报表授权。	json
data-report-fixedHeader	否	设置统计表是否固定表头	yes或者no	yes
data-report-exceptionPage	否	显示统计表异常信息的html页面	可以是绝对路径或相对路径名，相对于当前使用的html页面所在路径。如：/demo/error.html或myError.html	无
data-report-theme	否	界面风格	default/bootstrap/black/gray/metro	default
data-report-needImportEasyui	否	是否需要引入easyui的js和css文件	yes或no	no
data-report-width	否	控件宽度	整数，像素值或者百分数，如80%，见注2	800
data-report-height	否	控件高度	整数，像素值或者百分数，如80%，件注2	600
data-report-tabLocation	否	sheet tab的位置	top或bottom	top
data-report-saveAsName	否	统计表另存为Excel的文件名（不用带扩展名）	文本	与统计表同名
data-report-exportExcelExpType	否	导出Excel时，对自动计算公式选用什么处理方式	1、2或3，1时导出公式，有异常就直接抛出错误，终止导出；2时导出公式出错时导出值；3时只导出值。	2
data-report-paramCheck	否	是否对禁用参数值做校验。禁用参数值可通过在WEB-INF\raqsoftConfig.xml中的disallowedParamWordList 属性中配置	yes 或 no	yes
data-report-hideRowHeight	否	导出Excel时，给高度为0的隐藏行重新设置高度	数值	0
data-report-autoRowHeight	否	导出Excel时，是否自动撑开行高，根据单元格文本内容动态计算行高度。	yes 或 no 见注3	yes
data-report-sheetAlign	否	统计表水平对齐方式	left或center	left

注1：

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

注2：

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

<div id="reportContainer" style="width:100%; height:100vh;"

data-report-type="aggr"

data-report-id="aggr1"

data-report-src="统计表.sht"

data-report-dataFiles="autoDataFiles/data1.json;autoDataFiles/data2.json"

data-report-fileType="json"

data-report-tabLocation="bottom"

data-report-width="80%"

data-report-height="60%" >

</div>

注3：

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