cboard使用方法以及用户交互的两种方式

原文地址

代码仓库

cboard github地址
cboard 中文文档

cboard安装

包括数据库表的创建，配置文件修改

数据库mysql

进入到项目根目录,登陆到mysql

 mysql > create database cboard;mysql > use cboard;mysql > source sql/mysql/mysql.sql;

修改配置文件

配置文件src/main/resources/config.properties

validationQuery=SELECT 1
jdbc_url=jdbc:\mysql://localhost:3306/cboard # 数据库地址
jdbc_username=root # 用户名
jdbc_password=111111 # 密码

修改好后启动项目，访问localhost:8080进入登陆界面，初始用户名:admin，初始密码：root123

cboard构成

由数据源(DataSource)、数据集(DataSet)、图表(Widget)、看板(DashBoard)这四部分构成；其中看板由多个图表拼接而成，图表显示的数据是数据集中的数据，数据集中的数据从数据源中获得，就mysql来说，数据源即代表一个数据库，数据集则是用sql语句从数据库查出来的数据。

cboard使用

由cboard构成可知，为了最终生成一个用于显示各种数据的看板，应该从Datasource->DataSet->Widget->DashBoard这种顺序依次构建。

构建数据源

打开左侧的Configration->DataSource，点击+按钮

对于mysql数据源，填好对应参数，点击test测试是否连接成功

若测试连接成功，点击save保存该数据源。

构建数据集

假设有一张名为billing_detail的表，用于记录个人每一笔钱的支出，总共有id,name,amount,category,create_at5个字段，如下表所示：

id	name	amout	category	create_at
1	吃饭	20.2	餐饮	2020-02-01 13:10
2	火车票	170.5	出行	2020-02-01 15:00

依次打开Configration->DataSet,点击添加按钮，新建一个数据集：

在上图中，Name选项填写数据集的名称，格式为：数据集类别/数据集名称；Datasource选择之前创建的数据源；Sql Text即一个sql表达式，用于从数据源中取出数据。填好上面三项后，点击Load Data按钮，若sql表达式正确无误，就会出现下半部分：左侧是数据集中的字段值，这些字段可以用拖拽的方式拖到右侧的栏目下面：Dimension即数据的维度，Measure是度量，Caculated Measure是聚合表达式，Filter Group是过滤器。填好后点击save就成功创建了一个数据集。

创建图表

有了数据集后就可以进行图表的创建，依次点击Configration->Widget,点击添加按钮+，就会出现下图的弹出框

在图中，点击Cube可以下拉选择数据集，Widget Name是图表的名称，命名方式为category/name,选好数据集之后就会出现下图，通过拖动左侧的参数到右侧合适的位置，就可以设计图表了

图表设计

在此，以之前创建好的数据集为基础，通过几个例子来演示图表的设计

1，按年月分类，用曲线显示每个月的总消费

在这个例子中，将左侧维度项（Dimension）下year,month的参数拖到右侧的Row栏目中，将左侧度量项（Measure）下的amount参数拖入到Value Axis这个栏目中，选择Widget Type栏目中的线型图表，点击Preview,可以看到，最终生成的图形中，横轴是Row栏目中两个参数year和month的组合，纵轴是Value Axis栏目中的amount的求和值，即sum(amount)，也就是说，Measure下的参数拖动到Value Axis栏目时，系统会自动为其添加sum聚合函数。点击View Query可以看到它生成的sql语句正是如此。

SELECT year, month ,SUM(amount)
FROM
(select 1 as `count`,name,`amount`,category,left(create_at,4)as `year`,substring(create_at,6,2)as `month` frombilling_detail
)
cb_view GROUP BY year, month

2,对比每个年份相同月份下的总消费

这个例子中，唯一与例1不同的地方就是把例1中的year这一项从Row这一栏拖到了Column这一栏。这样便每个年份显示一条曲线，横轴就是每年下的每个月份。Column这栏能分成几类，结果就有几条曲线。可以查看它生成的sql和例1完全相同，对比可发现加到Column和Row这两个栏目下的所有参数都会在生成sql语句时加入到group by后面进行聚合。

SELECT year, month ,SUM(amount)
FROM
(select 1 as `count`,name,`amount`,category,left(create_at,4)as `year`,substring(create_at,6,2)as `month` frombilling_detail
)
cb_view GROUP BY year, month

3，按年月分类，用线型图显示平均消费，用柱状图显示总消费

在这个例子中，同时存在柱状图和线形图。Value Axis这一栏比前两个例子多了一行，且这一行是将左侧Caculated Measure这一项下的avgAmount，这是之前提前定义的计算平均值的聚合表达式参数。

4,统计每个年份的消费占比，按饼图显示

这个例子中，按年份统计消费占比，只需将year这个变量拖到Row这一栏中

5,统计每个消费类别的占比

这个例子中，按年份统计消费占比，只需将category这个变量拖到Row这一栏中

看板设计

设计看板时先添加一个看板分类，否则只能选择默认(default)的分类。依次选择Configuration->DashBoard Category进行添加

创建好自己的看板分类后就可以添加看板了，依次选择Configration->DashBoard，对于网格布局来说，在看板中首先要添加行,即Add Row，每行又可添加多个列。列宽总和为12。添加列时可以选择已经创建好的图表于该列中。如下图

将之前示例中的几个图都添加到看板中，点击save，保存后就可以在看板选项中查看自己的看板了,如下图：

用户交互

cboard中，用户交互的方式有两种，一种是添加看板参数，另一种是图表之间的关联

利用看板参数进行交互

编辑看板，点击添加看板参数(Add Param Row)按钮,就会出现下图

点击添加参数（Add Param）按钮就会弹出可以选择添加的参数选项，选择自己需要添加的参数

这个参数是我们之前定义好的数据集中的参数，它的变化将影响所有依赖于该数据集的图表。参数添加成功后点击保存，查看看板

可以通过修改看板参数的值来使图形发生变化。

利用图表关联进行交互

在前面提到的例4，例5两个例子中，例4展示了每个年份的消费占比，例5展示了每个消费类别的占比。如果需求是点击例4饼图中不同年份对应的位置，例5则相应的切换到统计该年份下的各类消费的占比，这就用到图表之间的关联。

如上图所示，例4和例5两个图表已加入到看板中，点击例4上的链接按钮，就会出现一个关联图表的选项

第一个参数Widget Fields表示当前图表要关联的变量，按要求选择年份year，第二个参数Correlation Widget表示要关联的目的图表，第三个参数Correlation Widget Fields表示关联目的图表的变量。填好后点击Save保存。查看看板是否正确。