本章主要介绍Dashboard的原理、用途及详细说明。
◆ 实例请参考TAG实例 / Dashboard
原理和用途：
在报表组中添加报表项，对各报表项进行Dashboard布局后在网页上展现。
详细说明：
Dashboard布局后的报表组文件在JSP文件中用<prefix: dashboard>标签来发布，prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示：
<%@taglib uri="/WEB-INT/ 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对象，存在request中的名称 |
存储在request中的名称 |
无 |
|
timeout |
否 |
从缓存系统中取多少分钟内产生的报表，如果没有此时间内的，则产生一个新报表 |
整数，表示分钟 负数表示不限时间 |
-1 |
|
params |
否 |
报表组所需要的参数 |
用户提交的报表组参数值 |
无 |
|
exceptionPage |
否 |
显示报表异常信息的JSP页面 |
页面相对于应用根目录的路径名 |
无 |
|
needImportEasyui |
否 |
是否需要引入easyui的js和css文件，如需修改easyui的主题风格可参考《润乾报表V2018应用开发教程》3.2.4小节 |
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 |
注：
如tag标签中width和height为null，那么就按实际布局的大小生成dashboard；如果设置了width/height其中一个，那么另一个自动默认为100%；当设置了width或height时，会按照设置值的大小，对设计的布局进行按比例缩放。