Dashboard Builder

The Dashboard Builder is a full featured web application which allows non-technical users to visually create business dashboards. Dashboard data can be extracted from heterogeneous sources of information such as JDBC databases or regular text files. Some ready-to-use sample dashboards are provided for demo and learning purposes.

It features:

  • Visual configuration of dashboards (Drag & Drop).

  • Graphical representation of KPIs (Key Performance Indicators).

  • Configuration of interactive report tables.

  • Data export to Excel and CSV format.

  • Filtering and search, both in-memory or SQL based.

  • Data extraction from external systems, through different protocols.

  • Granular access control for different user profiles.

  • Look and feel customization tools.

  • Pluggable chart library architecture.

Where are we?

demo dashboard.png

Dashboard Builder Workflow

We are creating a Financial Dashboard based on the models of the Federated Data Layer. The steps of creating a dashboard is described below:

Dashboard flow

  • First we need to define an external connection which can be either a flat file or a database

  • Next step is to create a data provider based on the external connection. The data provider contains the definition of the data to be displayed in the dashboard.

  • A dashboard in Dashboard Builder contains one or more Workspaces

  • Each Workspace contains one or more Pages

  • Each Page contains one or more Panels

  • Each Panel is connected to a component

  • There are three component categories

    • Dashboard (I.e. HTML editor, KPI)

    • Navigation (I.e. Tree menu, Bread crumb, Logout panel…​)

    • System (I.e. System related components like Data source manager…​)

How this is accomplished in Dashboard Builder

  1. Start Dashboard Builder

Go to a browser window and type in the following URL

http://localhost:8080/dashboard and you should see the following screen:

Dashboard Builder login page

Login with username/password: dashboardAdmin/redhat1!

11.2 dashboard.png

By default we provide some sample dashboards in the dashboard. Have a look at these sample dashboards first before creating your own dashboard.

  1. Create an external connection

First we are going to create an external connection to be able to get the Financial data into the dashboard.

11.3 data provider.png

Note
Make sure that the Showcase workspace is the selected workspace. See top-left corner in picture above.

Select the following menu option menu:Administration[External connections] and the following screen should appear.

11.3 data provider.connection.png

Now we have to add a new external connection. Click the btn:[+ Create new DataSource].

11.3 data provider.external connection2.png

Select JNDI as the type of the datasource and fill in the details of the Financials VDB as shown in the figure above. To verify the connection details of the datasource click btn:[Check DataSource]. This will try to connect using the provided connection details. If the connection is successfully made the following screen should appear:

11.3 data provider.external connection3.png

Tip
Make sure that the JNDI entry java:/Financials is configured in the JBoss EAP environment and make sure that the Financials VDB is deployed in order to connect successfully.

Click btn:[Save] to save the external connection.

11.3 data provider.external connection4.png

  1. Create a data provider

Next step is to create a data provider based on the previous created external connection. Select menu:Administration[Data providers] and the following screen should appear.

11.3 create data provider.png

To create a new data provider select btn:[+ Create new data provider]. The following screen should appear:

11.3 create data provider query.png

Enter a name for the data provider and select Financials as the Datasource. Furthermore you have to specify the query to get the relevant data from the Financials VDB. After you have specified the query click btn:[Attempt data load] to validate the query. If the query is executed successfully the following screen should appear.

11.3 create data provider query2.png

Click btn:[Save] to save the data provider definition. The following screen should appear. In this screen one can change the definition of the column names as required by the dashboard.

11.3 create data provider query3.png

Update the column names as necessary and click btn:[Save].

  1. Create a workspace

The top bar contains several button options to create the dashboard. The picture below explains the buttons in more detail.

11 dashboard menu.png

We are ready to create a Financials dashboard based on the Financials data we created in the previous labs.

11.4 create workspace.png

Click btn:[Create workspace] to create the Financials workspace.

11.4 create workspace completed.png

Now we have completed the creation of the workspace we can add pages to it to create a full functioning dashboard.

  1. Create a page

Now we are going to create our first page in the Financials workspace.

11.5 create page.png

Use the settings as described above.

11.5 create page2.png

Now that the page is successfully created we can add a panel to it.

  1. Add a panel

11.6 add panel.png

Select component "Tree menu" in the Navigation option and drag and drop the Create panel to the LEFT_TOP region of the page. The page should look similar to the following screen:

11.6 add panel2.png

Add other components in the same way in the page like:

  • "Logout panel" in the HEADER_RIGHT-TOP region

  • "HTML Editor" in the CENTER_1 region

The HTML editor component provides the functionality (free HTML) to create a nice landing page in the dashboard.

  1. Add KPI

Select component Key Performance Indicator in the Dashboard option and drag and drop the Create panel to the CENTER_2 region. The page should look similar to the following screen:

11.7 add kpi.png

Select FinancialsData as the Data provider. Type a name in the KPI’s name field i.e. #customers per country. Select country for Domain aka X Axis. Select customerid for Range aka Y Axis. Select NVD3 for Renderer. Select Value for Sort Interval By. Select Ascendant for Sort Order.

11.7 add kpi2.png

11.7 dashboard.png

Now try to add some extra pages/panels yourself.

Financials Dashboard Demo

Existing dashboards can exported/imported in Dashboard Builder. To showcase the Dashboard Builder features, we provide a sample Financials Dashboard.

  1. Import Workspace

Go to the Showcase workspace as the active workspace. Select menu:Administration[Import and Export] and the following screen appears.

11.8 import.png

Click the Export/Import Workspaces tab and the following screen should appear.

11.8 import ws.png

Click the btn:[Choose file] in the Import region. Select the 2-WorkspaceFinancials.cex file in the DVWorkshop/dv-docker/demo/dashboard directory.

11.8 import ws2.png

Click btn:[Import]. In the next screen you get the Select objects to import step. Make sure WORKSPACE: 0 is selected.

11.8 import ws3.png

Click btn:[Import] in the Select objects to import region. The import of the workspace should be successful and the screen should look like the following.

11.8 import ws finish.png

  1. Import Dashboards

Select the Showcase workspace as the active workspace. Select menu:Administration[Import and Export] and the following screen appears. Click the btn:[Choose file] in the Import dashboards region. Select the 3-CustomerReports.kpiex file in the DVWorkshop/dv-docker/demo/dashboard directory.

11.8 import dash1.png

Click btn:[Import]. The import of the dashboard should be successful and the screen should like the following.

11.8 import dash1a.png

Repeat these steps for the other two dashboards:

  • 4-AccountReports.kpiex

  • 5-AccountHoldings.kpiex

  1. Financials Demo Dashboard

Since we imported the workspace and the corresponding dashboard into the Financials Demo workspace we can now show the dashboard. Select the Financials Demo workspace as the active workspace. In the navigation menu select menu:Demo Dashboards[] and in this menu option we should have three menu items.

  1. Customer Reports

11.8 show custrep.png

  1. Account Reports

11.8 show accrep.png

  1. Account Holdings Reports

11.8 show acchrep.png

Navigate through the dashboards and discover how it is setup. Dashboard Builder provides a very easy way to visualize your data.

Congratulations, you have now completed this lab.

results matching ""

    No results matching ""