数据准备

点击【打开编辑】，进入数据准备页面，页面主要分为菜单栏、组件类型选择、数据集、报表设置、布局+报表编辑设置几个区域。

1：菜单栏；2：组件类型选择；3：数据集设置；4：报表设置；5：布局+报表编辑；

数据集

DBD中数据集支持DQL表、数据库查询(DQL/SQL)、spl文件/脚本、填报文件(json)类型的数据集。

 

当需要将某个数据文件作为数据集时，可以直接通过文件菜单打开数据文件，数据文件的结果集会自动用作当前Dashboard页面的默认数据集。

 

当通过文件菜单打开数据文件，选择导入到当前页数据集时，当前Dashboard页面会增加一个打开数据文件导入的数据集。

 

添加网格报表

添加报表时需先选择组件类型为网格报表，布局区会自动添加网格报表组件。右侧数据集下拉列表中选择当前组件要使用的数据集，然后将鼠标移至所要展示的字段上，按住左键，将字段拖拽到指标数据区(图表内容)以显示报表。

点击指标数据区中字段旁的小三角，通过选择相应的功能，对字段进行不同的操作：

（1）排序：选择“升序”、“降序”、“不排序”，对字段进行排序操作，字段状态默认为“不排序”；

（2）编辑：对字段名称进行编辑；

（3）数据过滤：详细请见特殊复杂条件；

（4）显示格式：通过选择或手动输入，对数据的显示格式进行设置，如将小数显示为百分比的格式、设置小数保留小数点后几位、设置日期格式为“yyyy-MM-dd”等；

（5）显示值：将字段的显示值设置为DQL表中某字段的值；

（6）删除：删除报表中的某个字段。

注：

点击指标数据区的绿色加号，进入分析指标界面，根据需求选择分析指标，填写查找条件表达式，点击确定即可得到所求数据。具体使用说明可参考跨行组计算。

点击拖拽字段同行的绿色加号，打开编辑计算字段界面，根据需求添加计算字段。具体使用说明可参考添加计算字段。

交叉报表

通过拖拽字段至左表头和上表头，形成交叉报表，更细化的展示数据。

此时指标数据区显示的数据为交叉分析的数据，点击指标数据区中字段旁的小三角，可以选择分析数据的计算方法，默认为“计数”。

注意： “计数”与“值计数”的区别：

计数相当于SQL里的COUNT()函数；值计数相当于SQL里的去重计数COUNT( DISTINCT() )。

 

点击上表头/左表头中字段旁的小三角可以对字段做如上操作，这里只介绍“维源字段”：

（1）维源字段：对上表头/左表头中的维字段设置取值来源。

例如：设置维源字段为“订单.雇员”，结果如下图（左）；设置维源字段为“订单.雇员.上级”，结果如下图（右）：

   

特殊复杂条件

通过设置查询条件，过滤掉不符合条件的数值，即不符合条件的数据在报表中不再显示。Dashboard中有三种方式可以设置过滤条件。

数据集过滤

对数据集添加过滤条件后，其他布局格再引用该同名数据集时，也会自动加上过滤条件。

点击数据集参数对数据集添加过滤条件。

 

数据过滤

可以选择对多个字段进行过滤条件的拼接。

在报表块点击右上角报表参数图标，打开设置查询条件界面。

例如：过滤出在某报表中，商品类别为饮料、调味品和点心的商品数据。

 

分组过滤

适用于给某一字段进行数据过滤，如果需要对多个字段进行过滤，则需要一一进行设置。

在指标区字段后面点击，选择，此处设置数据过滤条件仅对当前字段有效。

例如：展示SALARY大于10000的数据；

字段下面的用于拼接过滤条件。例如：展示入库数量大于10000并且小于15000的数据；

 

注：

a.点击条件后的可以删除条件；

b.在设置过滤条件的时候要留意调整条件的层次，点击条件前的绿色箭头即可自由调整层级，相当于SQL语句括号，也就是最左侧的字段相当于在括号的最外层，点击右键头往右移一位相当于嵌套一层括号；

c.勾选“ 简洁显示 ”，会隐藏掉“新增条件、调整条件层次”的功能，更能凸显条件之间的层次关系；

d.如需清除所有条件，点击界面右下角即可。

另：使用DQL表时，想要对分组后的字段进行过滤，在指标数据区字段处点击下拉列表，选择，对分组后的结果数据进行过滤条件的设置。

参数

设计报表时，常常需要根据一些条件来过滤出我们想要的数据。这就需要通过参数的形式控制报表中的数据。

下面，根据前面在Dashboard页面添加的报表，我们加入参数使它变成一张更灵活的报表。

参数控件提供了通用、数字、时间、字段选择四种控件类型。

l  通用：

选择通用类型，可以添加普通编辑框类型的参数。

第一步：选择参数控件类型

第二步：选择当前参数控件要关联的共享参数，也可通过增加参数添加共享参数

点击保存，保存参数。

 

第三步：点击确定，完成参数组件的设置，效果如图所示：

  为过滤按钮，点击后图标变亮，将鼠标移到某个报表组件中，会变成带加号的指针，此时代表提取值，点击某个单元格，它会获取点击的单元格中的值，填到参数编辑框中。

为刷新按钮，改变参数编辑框中的参数值，点击这个图标，刷新报表。

第四步：与网格组件做参数关联

点击网格组件右上角过滤按钮，添加过滤条件，过滤条件的取值从共享参数获取。

点击保存，保存过滤条件设置，完成参数报表的设置。

 

l  数字：

滑块

设置参数控件类型为滑块，操作如下，点击数字—>滑块，选择要关联的共享参数，设置滑块的各属性值，点击【确定】按钮即可。

为过滤按钮，点击后图标变亮，将鼠标移到某个报表组件中，会变成带个加号的指针，此时代表提取值，点击某个单元格，它会获取点击的单元格中的值，填到参数编辑框中。

 

最小值：滑块的最小值

最大值：滑块的最大值

滑动间隔值：滑动时，每刻度中的间隔值

显示间隔值：标签显示的间隔

宽度[像素]：滑块的宽度

微调器

 

设置参数控件类型为微调器，操作如下，点击数字—>微调器，选择要关联的共享参数，设置滑块的各属性值，点击【确定】按钮即可。

为过滤按钮，点击后图标变亮，将鼠标移到某个报表组件中，会变成带个加号的指针，此时代表提取值，点击某个单元格，它会获取点击的单元格中的值，填到参数编辑框中。

为刷新按钮，改变参数编辑框中的参数值，点击这个图标，刷新报表。

增量值：点击一次增加，增加的数量

警示最小值：指定最小值，小于该值时，编辑框显示红框警告

警示最大值：指定最大值，大于该值时，编辑框显示红框警告

l  时间：

日期

设置参数控件类型为日期时间，操作如下，点击日期时间—>日期时间，选择要关联的共享参数，点击【确定】按钮即可。

为过滤按钮，点击后图标变亮，将鼠标移到某个报表组件中，会变成带个加号的指针，此时代表提取值，点击某个单元格，它会获取点击的单元格中的值，填到参数编辑框中。

注意：日期控件暂时只支持yyyy-MM-dd格式的参数值。

日期时间

设置参数控件类型为日期时间，操作如下，点击时间—>日期时间，选择要关联的共享参数，点击【确定】按钮即可。

  为过滤按钮，点击后图标变亮，将鼠标移到某个报表组件中，会变成带个加号的指针，此时代表提取值，点击某个单元格，它会获取点击的单元格中的值，填到参数编辑框中。

  为刷新按钮，改变参数编辑框中的参数值，点击这个图标，刷新报表。

注意：日期时间控件暂时只支持yyyy-MM-dd 00:00:00格式的参数值。

l  字段选择：

设置参数控件类型为字段选择，可直接将数据集的某个表字段展现在下拉框中，方便用户选择。操作如下，点击字段—>值下拉，选择要关联的共享参数，点击【确定】按钮即可。

为过滤按钮，点击后图标变亮，将鼠标移到某个报表组件中，会变成带个加号的指针，此时代表提取值，点击某个单元格，它会获取点击的单元格中的值，填到参数编辑框中。

参数表单

参数表单控件支持添加多个参数组件。

注：参数表单不支持设置滑块组件。

 

点击参数表单设置按钮，可以调整参数表单中控件的相对位置、参数表单的显示与隐藏、添加查询按钮以及查询按钮的显示与隐藏。

从左侧已添加的控件中拖拽，移动到右侧的相应网格中，点击应用布局按钮，保存对应修改。在右侧面板中可通过双击控件来删除。如下图：

 

已开启参数表单/实际效果隐藏参数表单：仅在预览或展现时，控制参数表单组件是否显示。

已显示查询按钮/已隐藏查询按钮：添加查询按钮后，仅在预览或展现时，控制参数表单中查询按钮是否显示。

添加查询按钮：在参数表单中添加查询按钮。

修改 / 删除报表

修改报表名：

点击报表块左上角报表名，可以重命名报表名称，按回车确认修改。

注：报表名称尽量不要使用除了短横线（-）、下划线（_）、点（.）以外的特殊符号。

 

修改报表内容：

将光标移至报表组件块，当报表获取焦点后，右侧会自动出来报表编辑模块，可对数据集修改、字段拖拽、排序、分组等。

 

删除报表：

点击右上角，可将当前选中的报表组件从当前Dashboard页面中删除。

预览

预览当前数据准备中报表的展示效果。

返回数据：返回到数据编辑页面

保存 / 打开

Dashboard分析页面对报表块添加报表后，可以通过菜单栏的【保存】将布局、报表、参数保存成dbd文件，还可以通过【文件】菜单栏打开dbd文件。

保存

点击页面菜单中的【保存】，出现下图界面：

勾选“下载到本地”：将“文件名.dbd”文件下载到本地；

勾选“保存到服务器”：将“文件名.dbd”保存到服务器，缺省会将文件保存至【应用根目录】/report/web/webapps/demo/WEB-INF/files/dbd目录下。

注：“下载到本地”和“保存到服务器”两个复选框可同时勾选，但至少要选择一个。

打开

通过【文件】菜单栏选择打开dbd文件的标签方式，有如下三种方式选择：

选择打开方式后，出现下图界面：

 

打开本地：打开本地任意位置.dbd格式的文件；

打开服务器文件：打开存放在服务器中的.dbd文件。缺省目录为：【应用根目录】/report/web/webapps/demo/WEB-INF/files/dbd。

自定义布局

数据准备初始化页面添加组件时，布局+报表编辑区的组件面板高为150px，宽度占满屏，可调节的宽度单位是1/9。

鼠标位于组件右下角时，可拖拉改变组件宽高。

鼠标选中报表选择区时，可拖动改变组件位置。

共享参数

设计数据集时，常常需要根据一些条件来过滤出我们想要的数据。如果多个数据集有共性过滤时，使用共享参数就可以成为一种有效的方式，而不必为每个数据集一一修改过滤条件。共享参数仅作用于所有数据集过滤。

 

接下来我们用一个示例来说明共享参数的具体用法。

第一步：添加共享参数

点击菜单栏中 共享参数，添加共享参数：

第二步：新建网格报表组件

第三步：新建数据集

输入数据集名称和sql语句，点击查询数据，缓存入文件，然后保存，sql数据集就创建完成了。

 

第四步：选择数据集，拖拽查询字段

第五步：点击数据集参数，添加查询条件

添加过滤条件时，可在【设置查询条件】弹出框的右侧下拉选择过滤条件值对应的参数。编辑条件：订单金额大于argMin，并且小于argMax，如下图：

 

然后点击【保存】，此时用到同一个数据集的都会刷新，只显示订单金额大于2000并且小于4000的数据。

统计图

Dashboard中不仅支持使用默认的表格样式，还可以自定义模板，针对个性定制报表设置独有的报表模板。

选择统计图，添加统计图组件。

选择要使用的数据集，然后在自定义模板的下拉列表中选择要使用模板：

模板缺省存放目录为[安装根目录]\raqsoft\report\web\webapps\demo\WEB-INF\files\rpx。关于报表模板的制作可参考报表自定义模板小节。

 

页面 / 样式

页面

页面底色：

背景图片：

背景图上传：点击上传图片按钮，将本地图片上传到服务器，上传的图片存放目录为【安装根目录】\report\web\webapps\demo\raqsoft\guide\dbd2.0\img\dbdStyleImage

选择背景图：图片上传后，从列表选择框中选择图片，作为页面背景图。

注：仅支持平铺

 

清空背景：

用于清除当前页面主体的背景颜色和背景图片。

 

样式

样式用于单独设置每一个组件的显示样式，组件间相互独立。

边框：

  

 

隐藏标题：

勾选隐藏标题菜单，预览后组件将不展现标题。

 

纯色背景：

  

图片背景：

背景图上传：点击上传图片按钮，将本地图片上传到服务器，上传的图片存放目录为【安装根目录】\report\web\webapps\demo\raqsoft\guide\dbd2.0\img\dbdStyleImage

选择背景图：图片上传后，从列表选择框中选择图片，作为组件中报表的背景图。

注：仅支持平铺

 

清空背景设置：

用于清除当前组件中报表的背景颜色和背景图片。