Overview of the Dashboards app UI

The main page of the Dashboards app consists of the following main components:

• Header bar (1)

• Sidebar (2)

• Details pane (3)

Dashboards app in DataMiner 10.4.5

The Dashboards app header bar

Dashboards app header bar in DataMiner 10.5.2

The header bar contains the following items, from left to right:

• Apps button: The button in the top-left corner provides quick access to other DataMiner web apps.

• Dashboards button: Click this button to return to the main page of the app at any time.

• Search box: The box in the middle of the header bar allows you to search the app. As soon as you activate the box, a list of suggestions is displayed below it. The list gets updated with new suggestions as you type. Select a suggestion in the list to open the corresponding dashboard or dashboard folder.

• WebSocket connection status: Available from DataMiner 10.3.0 [CU13]/10.4.0 [CU1]/10.4.4 up to DataMiner 10.4.0 [CU10]/10.5.1. This indicator shows the current status of your WebSocket connection. The available statuses include:

  • : A stable connection with instant updates.

  • : An offline connection.

  • : No real-time connection could be established. Updates will happen more slowly than usual.

  • : Re-establishing a WebSocket connection. Updates will happen more slowly than usual.

  From DataMiner 10.4.0 [CU11]/10.5.2 onwards, WebSocket connection issues are indicated via colored banners directly below the header bar instead. When the connection is successful, no banner is displayed. Other options include:

  • The connection is offline: A red banner with the message You are offline is displayed.

    Note

    If your connection is offline, a red "x" icon is also displayed on the user button.

  • The connection has been interrupted: An orange banner with the message Connection has been interrupted is displayed.

  • The connection is being re-established: An orange banner with the message Busy recovering connection... is displayed.

  • The connection has been re-established: A green banner with the message Connection recovered is displayed.

• User button: A button with the initials or an image of the current user is displayed in the top-right corner. Click this button to open a menu that provides access to the following options:

  • Settings: Allows you to manage any available dashboard theme (1) and configure whether specific actions are pinned to the dashboard header bar (2).

    
    Dashboard settings in DataMiner 10.4.10

  • About: Displays information about the app.

  • Help: Opens the DataMiner User Guide.

  • Sign out: Logs you out of the app and returns you to the logon screen.

The Dashboards app sidebar

The sidebar on the left contains icons that can be used to expand different panes:

Icon	Description
	Opens the navigation pane, which allows you to navigate through the different dashboard folders in the app. Click a folder or dashboard to view it in the details pane on the right.
	Displays a list of recent items.
	Displays a list of private dashboards. These are dashboards that can only be accessed by specific users (configured in the dashboard settings). This icon is displayed from DataMiner 10.2.7/10.3.0 onwards if there are private dashboards available.
	Displays a list of dashboards that have been shared via dataminer.services. This icon is displayed from DataMiner 10.2.7/10.3.0 onwards if there are shared dashboards available.

Right-click in either of the panes or click the ... button to open a menu with the following options:

• Open in new tab: Opens the selected dashboard in a new browser tab.

• Create folder or New folder: Adds a new folder in the selected folder.

• Create dashboard or New dashboard: Adds a new dashboard. By default, it will be added in the selected folder, but a different folder can be specified. See Creating a completely new dashboard.

• Import dashboard: Allows you to import an example dashboard. By default, it will be added in the selected folder, but a different folder can be specified. See Creating a dashboard based on an example.

• Edit: Available from DataMiner 10.2.0/10.1.12 up to DataMiner 10.3.0 [CU12]/10.4.3, if a dashboard folder is selected. Opens a pop-up window where you can rename the folder.

  The pop-up window also contains the option Preserve feed selections. When this option is selected, any selection you make in a dashboard in the folder is preserved when you navigate to another dashboard in the folder. Note that this only applies to the folder itself, not to any other folders it may contain.

• Rename: Only available if a non-shared dashboard is selected, or if a folder is selected prior to DataMiner 10.2.0/10.1.12. Allows you to rename the dashboard or folder. Obsolete from DataMiner 10.3.0 [CU12]/10.4.3 onwards.

• Settings: Available from DataMiner 10.3.0 [CU12]/10.4.3 onwards, if a dashboard or dashboard folder is selected. Opens a pop-up window where you can rename or move a dashboard or folder, or edit access to the dashboard or folder. See Managing dashboard folders.

  When a dashboard folder is selected and the parameter showAdvancedSettings=true has been added to the URL, the pop-up window also contains the option Preserve selections. Prior to DataMiner 10.3.0 [CU21]/10.4.0 [CU9]/10.4.12, this option is labeled Preserve feed selections. When this option is selected, any selection you make in a dashboard in the folder is preserved when you navigate to another dashboard in the folder. Note that this only applies to the folder itself, not to any other folders it may contain.

  Note

  Prior to DataMiner 10.3.0 [CU20]/10.4.0 [CU8]/10.4.11, the Preserve feed selections option is available in the settings pop-up window regardless of whether the showAdvancedSettings=true parameter is present in the URL.

• Duplicate or Copy: Only available if a dashboard is selected. See Duplicating a dashboard

• Move: Only available if a dashboard or folder is selected. See Managing dashboard folders. Obsolete from DataMiner 10.3.0 [CU12]/10.4.3 onwards.

• Delete: Only available if a dashboard or folder is selected. See Deleting a dashboard.

The Dashboards app details pane

The large pane on the right shows any folder or dashboard selected in the navigation pane.

If no dashboard is selected, buttons are available that allow you to create a new blank dashboard, to create a dashboard based on an example or to navigate to a recently used dashboard.

If an empty folder is selected, buttons are available that allow you to create or import a dashboard directly in that folder.

If a dashboard is selected, the header bar of this pane can display a number of buttons, depending on the dashboard and the settings of the app:

• Refresh button : Loads the most recent data in the displayed dashboard.

• Start editing: Allows you to start editing the dashboard. In edit mode, the navigation pane on the left will be hidden.

• Stop editing: Closes edit mode.

• Clear selections/Clear all: Only displayed if the dashboard contains at least one component. Clears the selection of all the data in the dashboard.

• PDF: Available from DataMiner 10.2.12/10.3.0 onwards. Only displayed in read mode. Allows you to export the dashboard as a PDF file.

• Share or Start sharing: Allows you to share the dashboard using dataminer.services. See Sharing a dashboard. This feature is only available in read mode, if the DataMiner System is connected to dataminer.services. See Connecting your DataMiner System to dataminer.services.

In the settings of the Dashboards app, you can configure whether the edit mode, clear selections, export as PDF, and share dashboard buttons are always displayed (i.e. “pinned” to the header bar) or instead accessible via a button in the top-right corner of a dashboard.

Dashboard settings in DataMiner 10.4.12

Note

• If the app is viewed on a small screen, no options to edit dashboards or dashboard settings will be available.
• Prior to DataMiner 10.3.0 [CU21]/10.4.0 [CU9]/10.4.12, the Clear selections option is called "Clear feeds".