Building a Dashboard

DivePort offers many types of portlets that you can use to display KPIs on a dashboard. This section provides an example of how a dashboard page is developed.

Before you begin:

  • Determine the KPIs that you want to display, and the manner (type of portlets) in which you want to display them.
  • Determine the metrics that provide the most meaningful data to spot trends that you want to monitor.
  • Consider using a mockup portlet to preview the page layout.
  • Review Tips for Effective Dashboard Design.

This example supposes a scenario in which a distributor wants to use a dashboard to monitor the following KPIs:

  • Current month sales, in dollars, compared to last month's sales, especially for red wine, active products, and promotional products.
  • Current month product shipments, in cases, compared to last month.
  • Current inventory compared to last month.
  • Trends for the last 12 months.

The developer has determined that they must create 10 objects using the following measures:

  • Total Sales
  • Red Still Wine Sales
  • Total Active Product Sales
  • Total Promotional Product Sales
  • Total Cases Shipped
  • Total Decimal Cases Shipped
  • Total Promotional Cases Shipped
  • Ending Inventory
  • Ending Active Items on Hand
  • Ending Items on Hand

Planning the Layout

Because the total sales is the most important, it will be placed at the top of the Closeddashboard. The other nine objects will be added beneath it, in a pattern of three rows each containing three objects.

Example of a dashboard mockup.

Determine if you want to include QuickViews or labels at the top of the page, and be sure to include these items when planning the layout.

The next step is to calculate the size of the objects. DI recommends a maximum dashboard width of 1320px to avoid a horizontal scroll bar. Also, plan for a 20px margin and 20-30px space between objects. Following these guidelines, you can begin to create the objects.

TIP: On the Page Settings dialog box, set the Snap-to-grid pixels option to 10 to ensure consistent object alignment.

Total Sales Object

This object will display three indicator portlets, two chart portlets, and six text background portlets on a rectangle background portlet.

  1. Add a rectangle background portlet.
  2. On the Portlet Instance Settings Closeddialog box, set the size to the value that you calculated. In this example, 1150x180px.

    Portlet Instance Settings dialog box.

  3. Move the portlet to provide a 20px left margin.

    NOTE: Be sure to reserve space at the top for any planned QuickView portlets or page labels.

  4. Add a text background Closedportlet to the upper left corner of the rectangle to label the portlet Total Sales.

    Portlet sample

  5. Add another three text background Closedportlets as labels for the Current, Previous, and % +/- data values.

    NOTE: Because these labels require less prominence, a lighter font color is used.

    Portlet sample.

  6. Add three text indicator Closedportlets to show the Total Sales value of the current complete month, previous complete month, and the percent variance between the two.

    NOTE: Notice the larger font for the current value, and threshold colors to indicate positive or negative variance.

    Portlet sample.

  7. Add a chart Closedportlet to show the changes of monthly sales over the last 12 months, and compare the data with the same time period last year.

    Sample chart portlet.

  8. Add a pie Closedchart to show the percent sales of types of wine.

    Pie chart.

  9. Add text background Closedportlets to label the charts.

    Sample dashboard.

  10. Save the page.

    Sample dashboard

Sales Objects

Each sales object shows the current value, previous value, % deviation and a chart.

  1. Add a rectangle background portlet.
  2. On the Portlet Instance Settings dialog box, set the size to the value that you calculated for the sales object. In this example, 370x300px.

  3. Move the portlet to provide a 20px left margin and 20px padding between it and the Total Sales portlet.

  4. Add a text background portlet to the upper left corner of the rectangle to label the portlet Red Still Wine Sales.

  5. Beneath the text background portlet, add another three text background Closedportlets as labels for the Current, Previous, and % +/- data values.

    NOTE: Because these labels require less prominence, a lighter font color is used.

    Portlet sample.

  6. Move the labels to provide even spacing between them.
  7. Add three text indicator Closedportlets to show the Total Red Still Wine Sales value of the current complete month, previous complete month, and the percent variance between the two.

    NOTE: Use a larger font for the current value, and threshold colors to indicate positive or negative variance.

    Portlet sample.

  8. Add a line chart Closedportlet to show the changes of monthly Total Red Still Wine Sales over the last 12 months.

    Sample chart portlet.

  9. Save the page.

Remaining objects

The other eight dashboard objects are similar to the Red Still Wine Sales object, but they each display a different measure. Repeat the steps described in Sales Objects but instead of using the Total Red Still Wine Sales measure in steps 4, 7, and 8, use one of the following measures for each object.

  • Total Active Product Sales
  • Total Promotional Product Sales
  • Total Cases Shipped
  • Total Decimal Cases Shipped
  • Total Promotional Cases Shipped
  • Inventory
  • Active Items on Hand
  • Total Promotional Products on Hand

Dashboard objects.

Optional Steps