# Dashboards

Dashboards are the end result of all the work that go into GravaMetrics they contain the insight that you are trying to give to your users. There are several ways to create dashboards but as with any business intelligence tool you should start with a question that you want answered and build the dashboard about answering that question. Be specific. Don't create a generic dashboard that contains all sort of odds and sods of information answer the question.

To create a dashboard you can:

  • Click the Plus icon on the dashboards section of the home page
  • Click the Create option from dashboards under the menu accessed from the top left of the page
  • Click the plus icon on the dashboard list page
  • Create a new datasource which will automatically take you to the dashboard create page

# Create

The dashboard create page will initially start with a large blank grid for you to place widgets onto:

Dashboard Create

The top part of this page has a toolbar with several options:

Option Icon Description
Add Chart Add Chart Icon Clicking this button will open up the Chart Editor and add the created chart to this dashboard.
Add Text Add Text Icon This will open up a markdown text editor and add this as a text widget to the dashboard.
Add Image Add Image Icon This will prompt for an image to be uploaded and add an image widget to the dashboard.
Customize Customize Icon This will bring up the customization popup.
Share Share Icon This opens the share popup.

On the right of the toolbar is the textbox for the dashboard name and the Save button. After any changes the dashboard must be saved, if the dashboard has not been created the save button will create the dashboard and will confirm this with a toast message.

# Widgets

A dashboard is a set of widgets. Each widget, once created, can be Resized, Edited, Copied or Deleted this is achieved through a toolbar and frame that are only shown in either create or edit mode:

Widget

The outer gray frame shows the outer edge of the widget the handle at the bottom right of the widget, indicated with a small arrow allows the user to resize the widget. The button allow the user to Edit / Copy / Delete the widget by clicking on them.

Widget Size

Please leave enough space within the widget for the contents to display. If the contents overflow the gray boundary the widget rendering may become distorted.

# Layout

Widgets can be moved around the grid by left clicking anywhere on the widget apart from the bottom right resize handle or the buttons. The widget will turn slightly red when in move mode and with the mouse button still clicked moving the mouse the widget will follow.

Layout

There is a layout grid that the widget will follow and snap to. If you require more vertical space drag the widget down the screen and the grid will automatically expand.

# Customization

Clicking on the Customize button on the Dashboard editor will show the Customize popup:

Customize

This popup allows the user to edit the following properties of the dashboard:

Name Description
Continuous Refresh When selected allows the dashboard to update every X seconds. Good for TV display dashboard that will automatically update when new data is received.
Background Color Changes the background color of the dashboard grid area.
Background Image Adds a background image to the dashboard grid area. Useful if you wish to create additional graphic to enhanced the feel of the dashboard.

# Share

Clicking on the Share button on the Dashboard editor will show the Share popup:

Share

This popup allows the user to share the dashboard either to others users / groups or to make the dashboard public. Click on the share button to be redirected to the share screen with the details pre-filled for sharing this dashboard. Click on the Make Public switch to allow the dashboard to be available publicly. The link Click Here will open the public link for the dashboard.

Public Dashboard Password

You can add a password if the dashboard is shared publicly which will prompt the user to enter this dashboard before viewing the dashboard.

# List

The Dashboards List can be access either through the top right menu or from the Dashboards text on the home page. This page will display a list of dashboards that the user has access to:

Dashboards List

The list can be filtered by entering text into the search box. The plus icon allows the user to create a new dashboard. The following columns are shown:

  • Name - The name of the dashboard
  • Owner - The user that created the dashboard
  • Widgets - The number of widgets on the dashboard
  • Created On - The date the dashboard was created / edited on
  • Actions - Button allowing various operation on the Dashboard

# Actions

The actions column allows various actions to be performed on the dashboard by clicking the buttons. These are:

  • View - View the dashboard
  • Copy - Create a copy of the dashboard with the name [Original Dashboard Name] (Copy)
  • Edit - Edit the dashboard
  • Delete - Delete the dashboard after confirmation