Dashboard

阅读（2520）点赞（0）标签: tag标签, 报表组,

本章主要介绍Dashboard的原理、用途及详细说明。

◆ 实例请参考TAG实例 / Dashboard

原理和用途：

在报表组中添加报表项，对各报表项进行Dashboard布局后在网页上展现。

详细说明：

Dashboard布局后的报表组文件在JSP文件中用<prefix: dashboard>标签来发布，prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示：

<%@taglib uri="/WEB-INF/ raqsoftReport.tld" prefix="report" %>

此定义语句必须写在JSP的开头，其中prefix的值可以自己指定，但tag标签中的前缀必须与其保持一致。

然后在要发布报表的地方用上面介绍的tag标签来发布，如：

<report:dashboard groupFileName=”…” …./>

此标签的属性说明见下表：

(属性名都是大小写相关，属性值必须放在双引号中)

属性名	是否必填	属性含义	属性取值	缺省值
浏览式Dashboard布局后的报表组的公共属性
groupFileName	否	要发布的报表组文件名	报表组文件名	无
srcType	否	报表组源的类型	见注1	file
beanName	否	当报表组源类型为bean时，已保存到request中的bean的名称	符合变量命名规则的字符串，与保存报表组源bean时的名称一致，且在整个web应用中应唯一	无
useCache	否	显示此报表组时是否从缓存系统中取已经计算好的报表	yes或no 如果含有实时报表，应该设为no	yes
contextName	否	用bean的方式发布报表时，计算出报表bean时用的Context对象，存在session中的名称	存储在session中的名称	无
timeout	否	从缓存系统中取多少分钟内产生的报表，如果没有此时间内的，则产生一个新报表	整数，表示分钟负数表示不限时间	-1
params	否	报表组所需要的参数	用户提交的报表组参数值	无
exceptionPage	否	显示报表异常信息的JSP页面	页面相对于应用根目录的路径名	无
needImportEasyui	否	是否需要引入easyui的js和css文件，如需修改easyui的主题风格可参考*修改easyui插件的主题*小节	yes或no	yes
theme	否	编辑控件的外观主题风格	default,black,bootstrap,gray,metro	default
width	否	dashboard控件的宽	象素或百分比	null
height	否	dashboard控件的高	象素或百分比	null
needTitle	否	各面板上是否显示标题栏	yes或no	yes
needBorder	否	各面板是否显示边框	yes或no	yes
paramCheck	否	是否对禁用参数值做校验。禁用参数值可通过在WEB-INF/raqsoftConfig.xml中的disallowedParamWordList 属性中配置	yes 或 no	yes
scrollSheets		需要固定表头的报表，用英文逗号分隔，可以是报表标题名或逻辑名。固定表头的报表忽略自适应设置。	报表标题名或逻辑名	null
pagedSheets	否	指定子报表分页展示。	子报表，比如：item1或者item1, item2

注1：

如tag标签中width和height为null，那么就按实际布局的大小生成dashboard；如果设置了width/height其中一个，那么另一个自动默认为100%；当设置了width或height时，会按照设置值的大小，对设计的布局进行按比例缩放。

注2：

paramCheck是否对禁用参数值做校验。默认是yes，会用内置的检测器做检查，如果不想对禁用参数值做校验，可以在预览的jsp中设置tag属性paramCheck = "no" 。