Skip to content

Getting Started

Prerequisites

Before starting, please make sure you have:

  • Editor/admin access to Dashboard Designer
  • Some asset data in your current MindSphere set-up

Note

Please use either Chrome or Firefox Internet browsers, not Internet Explorer.

Best Way to Learn

Open another page of Dashboard Designer side-by-side with this tutorial so you can try out some steps.

Creating Dashboards

A dashboard gives you an at-a-glance view of your data and lets you track metrics through different visualizations.

Panels

Each panel on a dashboard represents a part of the story you want your dashboard to tell. A panel consists of a:

  • Query: defines which data to display
  • Visualization: defines how the data displays

CreateDialog

The Panel Edit Page

The Panel Edit page displays three tabs on the left:

  • Query: where you create the query to pull your data in Dashboard Designer. created the data query to this panel earlier in step 3.
  • Visualization: where you can select a plugin for visualizing the data. You can also change the visualization settings of the plugin.
  • General: displays the panel's title and settings, such as if the panel hyperlinks to another dashboard.

How to Create a New Dashboard

Follow these steps to create new dashboard:

  1. Hover over the + button on the side panel, and click "Dashboard" to create a blank dashboard with an empty panel.

  2. Click "Add Query" to open the panel edit page.

New_Panel

  1. If you have MindSphere asset data available, you can continue this tutorial with your MindSphere data; if not, you can use the provided test data.

Getting Your Data from MindSphere

Follow these steps to retrieve data from MindSphere:

  1. Click "select metric" or enter an asset name in the search field. Aspects included in the asset display.

Select_Asset

  1. Select an aspect. The aspect's variables display.

Select_Aspect

  1. Select a variable.

Select_a_Variable

Info

If no MindSphere data is available, it may be that the default time range may not contain data from your asset. Try selecting different time ranges from the time selector drop-down list. If you continue to experience issues in retrieving data, try using the generated test data for the next steps.

Note

Variables directly assigned to an asset type are not yet supported in Dashboard Designer.

Connecting to Data

If you are already getting MindSphere data, skip step 1 below; otherwise, follow these steps to connect data:

  1. Select testData from the drop-down list. Random data is used by default, but you can use other data scenarios.

  2. When your data shows, click the Esc key (or back button) to return to the dashboard page. Your dashboard displays with the new panel.

  3. To create another panel, click the "Add panel" button.

Adding a Visualization and Plugin

Follow these steps to add a visualization:

  1. Click the "Choose Visualization" option. The Visualization tab opens under the "Panel edit" page.

  2. Click the graph drop-down list and select "Gauge" from the list.

  3. Click the "Query" tab.

  4. Select some MindSphere or test data. When the data comes in, press the Esc key or the Back button to go back to the Dashboard page.

  5. Duplicate the panel using one of the methods discussed in "Additional Panel Actions", which appears right after the Visualization image below.

Your dashboard should now look similar to this:

choose_gauge

Additional Panel Actions

Some additional actions you can take with panels are:

  • Resize panel: click and drag the lower right corner of the panel to resize it up or down.
  • Duplicate: select "More" from the drop-down list at the top of the panel, then click "Duplicate". Alternatively, you can left-click anywhere on the panel, then press "p" and "d".

After duplicating the panel, we recommend trying a different query so different data displays.

Saving Your Panel(s)

Follow these steps to save your panel:

  1. Click anywhere on the panel and press "e" on your keyboard, or click the heading of the panel and select "Edit". The "panel edit" page displays.

  2. Navigate to the "General" tab, and enter a name for the panel. Repeat as needed for other panels in your dashboard.

Saving Your Dashboard

Follow these steps to save your dashboard:

  1. Click the 'save disc' icon in the top right corner of the dashboard. The save dialog displays.

  2. Enter a name for the dashboard.

  3. Select (optional) a folder to store the dashboard.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.


Last update: November 11, 2022